Teilen über


Festlegen des Layouts von Dateien für die Konvertierung

Um eine Ressource ordnungsgemäß zu verarbeiten, muss der Konvertierungsdienst alle Eingabedateien finden können. Diese bestehen aus der zu konvertierenden Hauptressourcendatei und in der Regel aus anderen Dateien, auf die in den Pfaden innerhalb der Ressourcendatei verwiesen wird. Die Anforderung zum Konvertieren einer Ressource erhält zwei Parameter, die bestimmen, wie der Konvertierungsdienst diese Dateien findet: Die settings.inputLocation.blobPrefix (optional) und die settings.inputLocation.relativeInputAssetPath. Sie sind vollständig auf der Seite Verwenden der REST-API für die Modellkonvertierung dokumentiert. Für das Dateienlayout ist wichtig zu beachten, dass der BlobPrefix einen kompletten Satz von Dateien festlegt, die bei der Verarbeitung der Ressource für den Konvertierungsdienst verfügbar sind.

Hinweis

Der Dienst lädt alle Dateien unter dem input.BlobPrefix herunter. Vergewissern Sie sich, dass Dateinamen und Pfade die Windows-Grenzwerte für die Pfadlänge nicht überschreiten, um Probleme mit dem Dienst zu vermeiden.

Platzieren von Dateien, sodass diese gefunden werden können

Wenn eine Quellressource externe Dateien nutzt, werden Pfade zu diesen Dateien in der Ressource gespeichert. Der Konvertierungsdienst muss diese Pfade in ein Dateisystem übersetzen, das sich vom ursprünglichen Dateisystem der Ressource unterscheidet. Wenn die Pfade als relative Pfade gespeichert werden und die relative Position zwischen der Quellressource und der Datei, auf die sie verweist, unverändert ist, ist es für den Konvertierungsdienst leicht, die referenzierte Datei zu finden.

Hinweis

Sie sollten Dateien im Eingabecontainer platzieren, damit die relativen Speicherorte der Dateien dieselben sind wie beim Erstellen der Ressource.

Hinweis

Es wird empfohlen, Ressourcen mit relativen Pfaden zu erstellen. Das Tutorial zum Einrichten von Materialien für 3ds Max enthält ein 3ds Max-Beispiel dafür, wie Sie sicherstellen, dass eine Ressource relative Pfade verwendet.

Suchen von Texturen

Aufgrund der zahlreichen Möglichkeiten, Ressourcen zu generieren, muss der Konvertierungsdienst flexibel sein. Insbesondere muss er Situationen bewältigen, in denen die Pfade in der Ressource und im Speicherort von Texturen nicht exakt zueinander passen. Ein Beispiel hierfür ist das Generieren von Ressourcen, die absolute Pfade enthalten, da diese Pfade niemals dem vom Konvertierungsdienst verwendeten Dateisystem entsprechen. Um unter anderem diese Situation zu bewältigen, verwenden wir einen Ansatz mit bestmöglicher Leistung für die Suche nach Texturen.

Der Algorithmus zum Auffinden von Texturen lautet wie folgt: Da ein Pfad in einem Objekt gespeichert ist, suchen Sie das längste Unterpfadsuffix, das, wenn er als relativer Pfad vom Speicherort der Quellressource verwendet wird, auf eine Datei abzielt, die vorhanden ist. Wenn kein solcher Unterpfad (einschließlich des gesamten Pfads) auf eine Datei weist, wird die Textur als fehlend betrachtet.

Sehen Sie sich das folgende erfundene Dateisystem an:

G:\CONVERSION
├───Assets
│   │   myAsset.fbx
│   │   myTexture.png            <- A
│   │
│   └───Textures
│       │   myTexture.png        <- B
│       │
│       └───MyAssetTextures
│               myTexture.png    <- C
│
└───Textures
    │   myTexture.png            <- D
    │
    └───MyAssetTextures
            myTexture.png        <- E

Wenn „myAsset.fbx“ auf eine Textur mit dem relativen Pfad ..\Textures\MyAssetTextures\myTexture.png verweist, verwendet der Konvertierungsdienst Datei „E“. Tatsächlich kann er alle Dateien „A“, „C“ und „E“ verwenden, wenn sie vorhanden sind, wobei Datei „E“ bevorzugt wird, da sie mit dem längsten Suffix gefunden wurde. Die Dateien „B“ und „D“ werden niemals verwendet, da Textures\myTexture.png nicht Teil eines Suffixes des gespeicherten Pfads ist. Wenn die Ressource stattdessen die Pfade H:\Foo\Bar\Textures\MyAssetTextures\myTexture.png oder ..\..\..\Foo\Bar\Textures\MyAssetTextures\myTexture.png enthielte, kann der Konvertierungsdienst die Dateien „A“ und „C“ finden, wenn sie vorhanden sind (wobei „C“ bevorzugt wird). „E“ kann jedoch nicht auf diese Weise gefunden werden, und die Datei muss verschoben werden. Dies könnte durch Verschieben des Ordners „Textures“ neben die Ressource korrigiert werden.

Hinweis

Wenn Texturen nicht gefunden werden, kann zur Problembehandlung sichergestellt werden, dass die Ressource ein Element ist, das einer Teilstruktur gleich geordnet ist, die die Texturen enthält.

Nächste Schritte