Condividi tramite

Informazioni sulle conversioni

  • Articolo

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 failedsucceeded 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"}
]

Nota

conversionId è un ID interno che non è correlato all'ID usato per creare la conversione.

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.

  • numMeshes: numero di parti mesh, in cui ogni parte può fare riferimento a un singolo materiale.
  • numFaces: numero totale di triangoli nel modello di origine. Per un numero accurato di primitive di output, vedere la numPrimitives voce nella sezione di output.
  • numVertices: numero totale di vertici nel modello di origine.
  • numMaterial: numero totale di materiali nel modello di origine.
  • numFacesSmallestMesh: numero di triangoli/punti nella mesh più piccola del modello.
  • numFacesBiggestMesh: numero di triangoli/punti nella mesh più grande del modello.
  • numNodes: numero di nodi nel grafico della scena del modello.
  • numMeshUsagesInScene: numero di volte in cui i nodi fanno riferimento alle mesh. Più nodi possono fare riferimento alla stessa mesh.
  • maxNodeDepth: profondità massima dei nodi all'interno del grafico della scena.

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.

  • numPrimitives: numero complessivo di triangoli/linee nel modello convertito. Questo numero contribuisce al limite primitivo nelle dimensioni del server di rendering standard.
  • numMeshPartsCreated: numero di mesh nell'oggetto arrAsset. Può differire dalla numMeshesinputStatistics sezione, perché la creazione di istanze è influenzata dal processo di conversione.
  • numMeshPartsInstanced: numero di mesh riutilizzate nell'oggetto arrAsset.
  • numMaterials: numero complessivo di materiali univoci nel modello, dopo la deduplicazione del materiale.
  • recenteringOffset: quando l'opzione recenterToOrigin nella conversione Impostazioni è abilitata, questo valore è la traduzione che sposta il modello convertito nella posizione originale.
  • boundingBox: limiti del modello.

Passaggi successivi