Získání informací o převodech
Informace o převodu: Výsledný soubor
Když služba převodu převede prostředek, zapíše do výsledného souboru souhrn všech problémů.
Pokud je například buggy.gltf soubor převeden, výstupní kontejner obsahuje soubor s názvem buggy.result.json.
Soubor výsledků zobrazí všechny chyby a upozornění, ke kterým došlo během převodu, a zobrazí souhrn výsledků, který je jedním z succeeded, failed nebo succeeded with warnings.
Výsledný soubor je strukturovaný jako pole objektů JSON, z nichž každý má řetězcovou vlastnost, která je jednou z warning, , errorinternal warning, internal errora result.
Existuje nejvýše jedna chyba (nebo error internal error) a vždy existuje jedna result.
Ukázkový soubor výsledků
Následující příklad popisuje převod, který úspěšně vygeneroval arrAsset. Protože však chybí textura, výsledná arrAsset nemusí být zamýšlená.
[
{"conversionId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"},
{"warning":"4004","title":"Missing texture","details":{"texture":"buggy_baseColor.png","material":"buggy_col"}},
{"result":"succeeded with warnings"}
]
Poznámka:
Jedná se conversionId o interní ID, které neodpovídá ID použitému k vytvoření převodu.
Informace o převedeného modelu: Informační soubor
Soubor arrAsset vytvořený službou převodu je určen výhradně ke spotřebě vykreslovací službou. Někdy se ale může stát, že chcete získat přístup k informacím o modelu bez spuštění relace vykreslování. Pro podporu tohoto pracovního postupu služba převodu umístí soubor JSON vedle souboru arrAsset do výstupního kontejneru. Pokud je například převeden soubor buggy.gltf , výstupní kontejner obsahuje soubor volaný buggy.info.json vedle převedeného prostředku buggy.arrAsset. Obsahuje informace o zdrojovém modelu, převedeného modelu a o samotném převodu.
Příklad informačního souboru
Tady je příklad informačního souboru vytvořeného převodem souboru s názvem 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
]
}
}
}
Informace v informačním souboru
Oddíl Soubory
Tato část obsahuje zadané názvy souborů.
input: Název zdrojového souboru.output: Název výstupního souboru, když uživatel určuje nedefaultní název.
Část převodu Nastavení
Tato část obsahuje kopii převodu Nastavení zadanou při převodu modelu.
Část inputInfo
Tato část zaznamenává informace o formátu zdrojového souboru.
sourceAssetExtension: Přípona souboru zdrojového souboru.sourceAssetFormat: Popis formátu zdrojového souboru.sourceAssetFormatVersion: Verze formátu zdrojového souboru.sourceAssetGenerator: Název nástroje, který vygeneroval zdrojový soubor, pokud je k dispozici.
Oddíl materialOverrides
Tato část obsahuje informace o přepsání materiálu při poskytnutí souboru přepsání materiálu službě převodu. Obsahuje následující informace:
numOverrides: Počet položek přepsání přečtených ze souboru přepsání materiálu.numOverriddenMaterials: Počet přepsaných materiálů.
Tato část není k dispozici pro převody cloudových bodů.
Oddíl inputStatistics
Tato část obsahuje informace o zdrojové scéně. Mezi hodnotami v této části a ekvivalentními hodnotami v nástroji, který vytvořil zdrojový model, často dochází k nesrovnalostem. Tyto rozdíly se očekávají, protože model se upraví během kroků exportu a převodu.
Obsah této části se liší pro trojúhelníkové mřížky a bodové mraky.
numMeshes: Počet částí sítě, kde každá část může odkazovat na jeden materiál.numFaces: Celkový počet trojúhelníků ve zdrojovém modelu. Přesný počet primitiv výstupu najdete vnumPrimitivespoložce výstupu.numVertices: Celkový počet vrcholů ve zdrojovém modelu.numMaterial: Celkový počet materiálů ve zdrojovém modelu.numFacesSmallestMesh: Počet trojúhelníků/bodů v nejmenší síti modelu.numFacesBiggestMesh: Počet trojúhelníků/bodů v největší síti modelu.numNodes: Počet uzlů v grafu scény modelu.numMeshUsagesInScene: Počet odkazů uzlů na sítě. Na stejnou síť může odkazovat více než jeden uzel.maxNodeDepth: Maximální hloubka uzlů v grafu scény.
Oddíl outputInfo
Tato část zaznamenává obecné informace o vygenerovaném výstupu.
conversionToolVersion: Verze převaděče modelů.conversionHash: Hodnota hash dat v rámci arrAsset, která může přispět k vykreslování. Dá se použít k pochopení, jestli služba převodu při opětovném spuštění ve stejném souboru vytvoří jiný výsledek.
Oddíl outputStatistics
Tento oddíl zaznamenává informace vypočítané z převedeného prostředku. Oddíl opět obsahuje různé informace pro trojúhelníkové mřížky a bodové mraky.
numPrimitives: Celkový počet trojúhelníků/čar v převedeného modelu. Toto číslo přispívá k primitivnímu limitu ve standardní velikosti vykreslovacího serveru.numMeshPartsCreated: Počet ok v arrAsset. Může se lišit odnumMeshesinputStatisticsčásti, protože proces převodu ovlivňuje vytváření instancí.numMeshPartsInstanced: Počet sítí, které se znovu používají v arrAsset.numMaterials: Celkový počet jedinečných materiálů v modelu po odstranění duplicit materiálu.recenteringOffset: Pokud je možnost v převodurecenterToOriginpovolena Nastavení je tato hodnota překlad, který by přesunul převedený model zpět do původní pozice.boundingBox: Hranice modelu.