Uzyskiwanie informacji o konwersjach

Artykuł
05/22/2024

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.

Trójkątne siatki
Chmury punktowe

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 wpisem numPrimitivesw 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.

Trójkątne siatki
Chmury punktowe

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ć od numMeshesinputStatistics sekcji, 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: Gdy recenterToOrigin opcja w konwersji Ustawienia jest włączona, ta wartość jest tłumaczeniem, które przeniesie przekonwertowany model z powrotem do oryginalnej pozycji.
boundingBox: granice modelu.

Share via