Uzyskiwanie informacji o konwersjach
Informacje o konwersji: plik wynikowy
Gdy usługa konwersji konwertuje zasób, zapisuje podsumowanie wszelkich problemów w pliku wynikowym.
Na przykład jeśli plik buggy.gltf jest konwertowany, kontener wyjściowy zawiera plik o nazwie buggy.result.json.
Plik wynikowy zawiera listę błędów i ostrzeżeń, które wystąpiły podczas konwersji, i zawiera podsumowanie wyników, które jest jednym z succeededelementów , failed lub succeeded with warnings.
Plik wynikowy jest ustrukturyzowany jako tablica obiektów JSON, z których każda ma właściwość string, która jest jedną z warning, , errorinternal warning, internal errori result.
Występuje co najwyżej jeden błąd ( error lub internal error) i zawsze występuje jeden resultbłąd .
Przykładowy plik wyników
W poniższym przykładzie opisano konwersję, która pomyślnie wygenerowała zestaw arrAsset. Jednak ponieważ brakowało tekstury, wynikowy arrAsset może nie być zgodnie z oczekiwaniami.
[
{"conversionId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"},
{"warning":"4004","title":"Missing texture","details":{"texture":"buggy_baseColor.png","material":"buggy_col"}},
{"result":"succeeded with warnings"}
]
Uwaga
Jest conversionId to wewnętrzny identyfikator, który nie jest skorelowany z identyfikatorem użytym do utworzenia konwersji.
Informacje o przekonwertowanym modelu: plik informacyjny
Plik arrAsset utworzony przez usługę konwersji jest przeznaczony wyłącznie do użycia przez usługę renderowania. Czasami jednak może być konieczne uzyskanie dostępu do informacji o modelu bez uruchamiania sesji renderowania. Aby obsługiwać ten przepływ pracy, usługa konwersji umieszcza plik JSON obok pliku arrAsset w kontenerze wyjściowym. Na przykład jeśli plik buggy.gltf jest konwertowany, kontener wyjściowy zawiera plik o nazwie buggy.info.json obok przekonwertowanego zasobu buggy.arrAsset. Zawiera on informacje o modelu źródłowym, przekonwertowanym modelu i o samej konwersji.
Przykładowy plik informacyjny
Oto przykładowy plik informacyjny utworzony przez przekonwertowanie pliku o nazwie buggy.gltf:
{
"files": {
"input": "Buggy.gltf"
},
"conversionSettings": {
"recenterToOrigin": true
},
"inputInfo": {
"sourceAssetExtension": ".gltf",
"sourceAssetFormat": "glTF2 Importer",
"sourceAssetFormatVersion": "2.0",
"sourceAssetGenerator": "COLLADA2GLTF"
},
"inputStatistics": {
"numMeshes": 148,
"numFaces": 308306,
"numVertices": 245673,
"numMaterial": 149,
"numFacesSmallestMesh": 2,
"numFacesBiggestMesh": 8764,
"numNodes": 206,
"numMeshUsagesInScene": 236,
"maxNodeDepth": 3
},
"materialOverrides": {
"numOverrides": 4,
"numOverriddenMaterials": 4
},
"outputInfo": {
"conversionToolVersion": "3b28d840de9916f9d628342f474d38c3ab949590",
"conversionHash": "CCDB1F7A4C09F565"
},
"outputStatistics": {
"numMeshPartsCreated": 236,
"numMeshPartsInstanced": 88,
"numMaterials": 149,
"numPrimitives": 308306,
"recenteringOffset": [
-24.1,
-50.9,
-16.5974
],
"boundingBox": {
"min": [
-43.52,
-61.775,
-79.6416
],
"max": [
43.52,
61.775,
79.6416
]
}
}
}
Informacje w pliku informacyjnym
Sekcja plików
Ta sekcja zawiera podane nazwy plików.
input: nazwa pliku źródłowego.output: nazwa pliku wyjściowego, gdy użytkownik określa nazwę inną niż domyślna.
Sekcja konwersji Ustawienia
Ta sekcja zawiera kopię konwersji Ustawienia określoną podczas konwersji modelu.
Sekcja inputInfo
W tej sekcji są rejestrowane informacje o formacie pliku źródłowego.
sourceAssetExtension: rozszerzenie pliku źródłowego.sourceAssetFormat: opis formatu pliku źródłowego.sourceAssetFormatVersion: wersja formatu pliku źródłowego.sourceAssetGenerator: nazwa narzędzia, które wygenerowało plik źródłowy, jeśli jest dostępny.
Sekcja materialOverrides
Ta sekcja zawiera informacje o zastępowaniu materiału podczas przesłaniania pliku materiału do usługi konwersji. Zawiera ona następujące informacje:
numOverrides: liczba przesłonięć wpisów odczytanych z pliku przesłaniania materiału.numOverriddenMaterials: liczba przesłonięć materiałów.
Ta sekcja nie jest obecna w przypadku konwersji chmury punktowej.
Sekcja inputStatistics
Ta sekcja zawiera informacje o scenie źródłowej. Często występują rozbieżności między wartościami w tej sekcji a równoważnymi wartościami w narzędziu, które utworzyło model źródłowy. Takie różnice są oczekiwane, ponieważ model jest modyfikowany podczas wykonywania kroków eksportowania i konwersji.
Zawartość tej sekcji różni się w przypadku trójkątnych siatk i chmur punktowych.
numMeshes: liczba części siatki, w których każda część może odwoływać się do pojedynczego materiału.numFaces: całkowita liczba trójkątów w modelu źródłowym. Aby uzyskać dokładną liczbę elementów pierwotnych danych wyjściowych, zapoznaj się z wpisemnumPrimitivesw sekcji danych wyjściowych.numVertices: Całkowita liczba wierzchołków w modelu źródłowym.numMaterial: całkowita liczba materiałów w modelu źródłowym.numFacesSmallestMesh: liczba trójkątów/punktów w najmniejszej siatce modelu.numFacesBiggestMesh: liczba trójkątów/punktów w największej siatce modelu.numNodes: liczba węzłów na wykresie sceny modelu.numMeshUsagesInScene: liczba węzłów odwołują się do siatki. Więcej niż jeden węzeł może odwoływać się do tej samej siatki.maxNodeDepth: maksymalna głębokość węzłów na wykresie sceny.
Sekcja outputInfo
W tej sekcji są rejestrowane ogólne informacje o wygenerowanych danych wyjściowych.
conversionToolVersion: wersja konwertera modelu.conversionHash: skrót danych w zestawie arrAsset, który może przyczynić się do renderowania. Może służyć do zrozumienia, czy usługa konwersji generuje inny wynik podczas ponownego uruchamiania w tym samym pliku.
Sekcja outputStatistics
W tej sekcji są rejestrowane informacje obliczane na podstawie przekonwertowanego zasobu. Ponownie sekcja zawiera różne informacje dotyczące trójkątnych siatk i chmur punktowych.
numPrimitives: Ogólna liczba trójkątów/linii w przekonwertowanym modelu. Ta liczba przyczynia się do limitu pierwotnego w standardowym rozmiarze serwera renderowania.numMeshPartsCreated: liczba siatk w arrAsset. Może się to różnić odnumMeshesinputStatisticssekcji, ponieważ proces konwersji ma wpływ na instancing.numMeshPartsInstanced: liczba siatk, które są ponownie używane w zestawie arrAsset.numMaterials: ogólna liczba unikatowych materiałów w modelu po deduplikacji materiału.recenteringOffset: GdyrecenterToOriginopcja w konwersji Ustawienia jest włączona, ta wartość jest tłumaczeniem, które przeniesie przekonwertowany model z powrotem do oryginalnej pozycji.boundingBox: granice modelu.