Dela via

Hämta information om konverteringar

  • Artikel

Information om en konvertering: Resultatfilen

När konverteringstjänsten konverterar en tillgång skriver den en sammanfattning av eventuella problem till en resultatfil. Om en fil buggy.gltf till exempel konverteras innehåller utdatacontainern en fil med namnet buggy.result.json.

Resultatfilen visar eventuella fel och varningar som inträffade under konverteringen och ger en resultatsammanfattning, som är en av succeeded, failed eller succeeded with warnings. Resultatfilen är strukturerad som en JSON-matris med objekt, som var och en har en strängegenskap som är en av warning, error, internal warning, internal erroroch result. Det finns högst ett fel (antingen error eller internal error) och det finns alltid ett result.

Exempelresultatfil

I följande exempel beskrivs en konvertering som har genererat en arrAsset. Men eftersom det saknades en textur kanske den resulterande arrAsset inte är som avsett.

[
  {"conversionId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"},
  {"warning":"4004","title":"Missing texture","details":{"texture":"buggy_baseColor.png","material":"buggy_col"}},
  {"result":"succeeded with warnings"}
]

Kommentar

conversionId är ett internt ID som inte korrelerar med det ID som användes för att skapa konverteringen.

Information om en konverterad modell: Informationsfilen

ArrAsset-filen som skapas av konverteringstjänsten är endast avsedd för förbrukning av återgivningstjänsten. Det kan dock finnas tillfällen när du vill komma åt information om en modell utan att starta en renderingssession. För att stödja det här arbetsflödet placerar konverteringstjänsten en JSON-fil bredvid arrAsset-filen i utdatacontainern. Om en fil buggy.gltf till exempel konverteras innehåller utdatacontainern en fil som heter buggy.info.json bredvid den konverterade tillgången buggy.arrAsset. Den innehåller information om källmodellen, den konverterade modellen och om själva konverteringen.

Exempel på informationsfil

Här är ett exempel på en informationsfil som skapas genom att konvertera en fil med namnet 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
            ]
        }
    }
}

Information i informationsfilen

Avsnittet filer

Det här avsnittet innehåller de angivna filnamnen.

  • input: Namnet på källfilen.
  • output: Namnet på utdatafilen när användaren anger ett nondefault-namn.

Avsnittet konvertering Inställningar

Det här avsnittet innehåller en kopia av konverteringen Inställningar som angavs när modellen konverterades.

Avsnittet inputInfo

Det här avsnittet innehåller information om källfilformatet.

  • sourceAssetExtension: Filnamnstillägget för källfilen.
  • sourceAssetFormat: En beskrivning av källfilformatet.
  • sourceAssetFormatVersion: Versionen av källfilformatet.
  • sourceAssetGenerator: Namnet på verktyget som genererade källfilen, om det är tillgängligt.

Avsnittet materialOverrides

Det här avsnittet innehåller information om material som åsidosätter när en material åsidosättningsfil tillhandahölls till konverteringstjänsten. Det innehåller följande information:

  • numOverrides: Antalet åsidosättningsposter som lästs från den materiella åsidosättningsfilen.
  • numOverriddenMaterials: Antalet material som åsidosätts.

Det här avsnittet finns inte för punktmolnkonverteringar.

Avsnittet inputStatistics

Det här avsnittet innehåller information om källscenen. Det finns ofta skillnader mellan värdena i det här avsnittet och motsvarande värden i verktyget som skapade källmodellen. Sådana skillnader förväntas eftersom modellen ändras under export- och konverteringsstegen.

Innehållet i det här avsnittet skiljer sig åt för triangulära nät och punktmoln.

  • numMeshes: Antalet nätdelar, där varje del kan referera till ett enda material.
  • numFaces: Det totala antalet trianglar i källmodellen. Ett korrekt antal utdataprimitiver finns i numPrimitives posten i utdataavsnittet.
  • numVertices: Det totala antalet hörn i källmodellen.
  • numMaterial: Det totala antalet material i källmodellen.
  • numFacesSmallestMesh: Antalet trianglar/punkter i modellens minsta nät.
  • numFacesBiggestMesh: Antalet trianglar/punkter i modellens största nät.
  • numNodes: Antalet noder i modellens scendiagram.
  • numMeshUsagesInScene: Antalet gånger noder refererar till nät. Fler än en nod kan referera till samma nät.
  • maxNodeDepth: Maximalt djup för noderna i scendiagrammet.

Avsnittet outputInfo

Det här avsnittet innehåller allmän information om de genererade utdata.

  • conversionToolVersion: Version av modellkonverteraren.
  • conversionHash: En hash av data i arrAsset som kan bidra till rendering. Kan användas för att förstå om konverteringstjänsten ger ett annat resultat när den körs på samma fil igen.

Avsnittet outputStatistics

Det här avsnittet innehåller information som beräknas från den konverterade tillgången. Återigen innehåller avsnittet olika information för triangulära nät och punktmoln.

  • numPrimitives: Det totala antalet trianglar/linjer i den konverterade modellen. Det här talet bidrar till den primitiva gränsen i standardåtergivningsserverns storlek.
  • numMeshPartsCreated: Antalet nät i arrAsset. Det kan skilja sig från numMeshes i avsnittet inputStatistics eftersom instancing påverkas av konverteringsprocessen.
  • numMeshPartsInstanced: Antalet nät som återanvänds i arrAsset.
  • numMaterials: Det totala antalet unika material i modellen, efter materialdeduplicering.
  • recenteringOffset: När recenterToOrigin alternativet i Konvertering Inställningar är aktiverat, är det här värdet översättningen som skulle flytta den konverterade modellen tillbaka till sin ursprungliga position.
  • boundingBox: Modellens gränser.

Nästa steg