Obtenir des informations sur les conversions

Article
05/28/2024

Informations sur une conversion : fichier de résultats

Lorsque le service de conversion convertit une ressource, il écrit un résumé des problèmes dans un fichier de résultats. Par exemple, si un fichier buggy.gltf est converti, le conteneur de sortie contient un fichier appelé buggy.result.json.

Le fichier de résultats répertorie les erreurs et les avertissements qui se sont produits pendant la conversion et fournit un résumé des résultats : succeeded, failed ou succeeded with warnings. Le fichier de résultats est structuré sous la forme d’un tableau JSON d’objets, dont chacun a une propriété de type chaîne : warning,error, internal warning, internal error et result. Il y a au plus une erreur ( error ou internal error) et il y a toujours une result.

Exemple de fichier de résultats

L’exemple suivant décrit une conversion qui a généré avec succès un arrAsset. Toutefois, étant donné qu’il existait une texture manquante, le arrAsset résultant ne peut pas être le même que prévu.

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

Remarque

conversionId est un ID interne qui ne correspond pas à l’ID utilisé pour créer la conversion.

Informations sur un modèle converti : fichier d’informations

Le fichier arrAsset produit par le service de conversion est destiné exclusivement à l’usage du service de rendu. Toutefois, il peut vous arriver de vouloir accéder à des informations sur un modèle sans démarrer de session de rendu. Pour prendre en charge ce workflow, le service de conversion place un fichier JSON à côté du fichier arrAsset dans le conteneur de sortie. Par exemple, si un fichier buggy.gltf est converti, le conteneur de sortie contient un fichier appelé buggy.info.json en regard de la ressource convertie buggy.arrAsset. Ce fichier contient des informations sur le modèle source, le modèle converti et la conversion proprement dite.

Exemple de fichier info

Voici un exemple de fichier info produit par la conversion d’un fichier nommé 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
            ]
        }
    }
}

Informations contenues dans le fichier info

Section files

Cette section contient les noms de fichiers fournis.

input: nom du fichier source.
output : nom du fichier de sortie, lorsque l’utilisateur spécifie un nom non défini.

Section conversionSettings

Cette section contient une copie des paramètres ConversionSettings spécifiés lors de la conversion du modèle.

Section inputInfo

Cette section enregistre des informations sur le format du fichier source.

sourceAssetExtension: extension de fichier du fichier source.
sourceAssetFormat: description du format de fichier source.
sourceAssetFormatVersion: version du format de fichier source.
sourceAssetGenerator: nom de l’outil qui a généré le fichier source, le cas échéant.

Section materialOverrides

Cette section fournit des informations sur le remplacement matériel lorsqu’un fichier de remplacement matériel a été fourni au service de conversion. Elle contient les informations suivantes :

numOverrides: nombre d’entrées de remplacement lues à partir du fichier de remplacement de matériel.
numOverriddenMaterials: nombre de matériaux remplacés.

Cette section n’est pas présente pour les conversions de cloud de point.

Section inputStatistics

Cette section fournit des informations sur la scène source. Il y a souvent des discordances entre les valeurs de cette section et les valeurs équivalentes dans l’outil qui a créé le modèle source. De telles différences sont attendues, car le modèle est modifié pendant les étapes d’exportation et de conversion.

Le contenu de cette section est différent pour les maillages triangulaires et les nuages de points.

Maillages triangulaires
Nuages de points

numMeshes: nombre de parties de maillage, où chaque partie peut référencer un matériau unique.
numFaces : le nombre total de triangles dans le modèle source. Pour obtenir un nombre précis de primitives de sortie, reportez-vous à l’entrée numPrimitives dans la section de la sortie.
numVertices : le nombre total de sommets dans le modèle source.
numMaterial : le nombre total de matériaux dans le modèle source.
numFacesSmallestMesh : Nombre de triangles/points dans le plus petit maillage du modèle.
numFacesBiggestMesh : Nombre de triangles/points dans le plus grand maillage du modèle.
numNodes: nombre de nœuds dans le graphique de scène du modèle.
numMeshUsagesInScene: nombre de fois où les nœuds référencent des maillages. Plusieurs nœuds peuvent référencer le même maillage.
maxNodeDepth: profondeur maximale des nœuds dans le graphique de scène.

Section outputInfo

Cette section enregistre des informations générales sur la sortie générée.

conversionToolVersion: version du convertisseur de modèle.
conversionHash: hachage des données dans l’arrAsset pouvant contribuer au rendu. Peut être utilisé pour déterminer si le service de conversion produit un résultat différent lors de la réexécution sur le même fichier.

Section outputStatistics

Cette section enregistre les informations calculées à partir de la ressources converti. Là encore, la section contient différentes informations pour les maillages triangulaires et les nuages de points.

Maillages triangulaires
Nuages de points

numPrimitives : nombre global de triangles ou de lignes dans le modèle converti. Ce nombre contribue à la limite primitive dans la taille de serveur de rendu standard.
numMeshPartsCreated: nombre de maillages dans l’arrAsset. Il peut différer de la valeur numMeshes dans la section inputStatistics, car l’instanciation est affectée par le processus de conversion.
numMeshPartsInstanced: nombre de maillages réutilisés dans l’arrAsset.
numMaterials : nombre global de matériaux uniques dans le modèle, après la déduplication des matériaux.
recenteringOffset: Quand l’option recenterToOrigin dans la section ConversionSettings est activée, cette valeur indique la translation qui ramènerait le modèle converti dans sa position d’origine.
boundingBox: limites du modèle.

Partager via