Informazioni sulle conversioni

Informazioni su una conversione: file di risultati

Quando il servizio di conversione converte un asset, scrive un riepilogo di eventuali problemi in un file di risultato. Ad esempio, se un file buggy.gltf viene convertito, il contenitore di output contiene un file denominato buggy.result.json.

Il file di risultato elenca eventuali errori e avvisi che si sono verificati durante la conversione e fornisce un riepilogo dei risultati, ovvero uno di succeededo failed succeeded with warnings. Il file di risultato è strutturato come matrice JSON di oggetti, ognuno dei quali ha una proprietà stringa che è uno di warning, errorinternal warning, internal error, e result. Al massimo si verifica un errore ( error o internal error) ed è sempre presente un resulterrore .

File di risultati di esempio

Nell'esempio seguente viene descritta una conversione che ha generato correttamente un oggetto arrAsset. Tuttavia, poiché c'era una trama mancante, l'arrAsset risultante potrebbe non essere come previsto.

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

Informazioni su un modello convertito: file di informazioni

Il file arrAsset prodotto dal servizio di conversione è destinato esclusivamente all'utilizzo da parte del servizio di rendering. In alcuni casi, tuttavia, quando si desidera accedere alle informazioni su un modello senza avviare una sessione di rendering. Per supportare questo flusso di lavoro, il servizio di conversione inserisce un file JSON accanto al file arrAsset nel contenitore di output. Ad esempio, se un file buggy.gltf viene convertito, il contenitore di output contiene un file denominato buggy.info.json accanto all'asset buggy.arrAssetconvertito. Contiene informazioni sul modello di origine, sul modello convertito e sulla conversione stessa.

File di informazioni di esempio

Ecco un file di informazioni di esempio generato convertendo un file denominato 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
            ]
        }
    }
}

Informazioni nel file di informazioni

Sezione dei file

Questa sezione contiene i nomi file specificati.

• input: nome del file di origine.
• output: nome del file di output, quando l'utente specifica un nome non predefinito.

Sezione conversion Impostazioni

Questa sezione contiene una copia della conversione Impostazioni specificata quando il modello è stato convertito.

Sezione inputInfo

In questa sezione vengono registrate informazioni sul formato del file di origine.

• sourceAssetExtension: estensione del file di origine.
• sourceAssetFormat: descrizione del formato di file di origine.
• sourceAssetFormatVersion: versione del formato del file di origine.
• sourceAssetGenerator: nome dello strumento che ha generato il file di origine, se disponibile.

Sezione materialOverrides

In questa sezione vengono fornite informazioni sull'override del materiale quando è stato fornito un file di override del materiale al servizio di conversione. Sono incluse le seguenti informazioni:

• numOverrides: numero di voci di override lette dal file di override del materiale.
• numOverriddenMaterials: numero di materiali sottoposti a override.

Questa sezione non è presente per le conversioni cloud punto.

Sezione inputStatistics

In questa sezione vengono fornite informazioni sulla scena di origine. Spesso esistono discrepanze tra i valori in questa sezione e i valori equivalenti nello strumento che ha creato il modello di origine. Tali differenze sono previste, perché il modello viene modificato durante i passaggi di esportazione e conversione.

Il contenuto di questa sezione è diverso per le mesh triangolari e le nuvole di punti.

Sezione outputInfo

In questa sezione vengono registrate informazioni generali sull'output generato.

• conversionToolVersion: versione del convertitore di modelli.
• conversionHash: hash dei dati all'interno di arrAsset che può contribuire al rendering. Può essere usato per comprendere se il servizio di conversione produce un risultato diverso quando viene rieseguita nello stesso file.

Sezione outputStatistics

In questa sezione vengono registrate le informazioni calcolate dall'asset convertito. Anche in questo caso, la sezione contiene informazioni diverse per le mesh triangolari e le nuvole di punti.

Passaggi successivi

• Conversione di modelli
• Configurare la conversione del modello