Obtención de información sobre conversiones
Información sobre una conversión: el archivo de resultados
Cuando el servicio de conversión convierte un recurso, escribe un resumen de los problemas en un archivo de resultados.
Por ejemplo, si se convierte un archivo buggy.gltf, el contenedor de salida incluye un archivo llamado buggy.result.json.
El archivo de resultados muestra los errores y las advertencias que se produjeron durante la conversión y proporciona un resumen del resultado, que puede ser succeeded, failed o succeeded with warnings.
El archivo de resultados está estructurado como una matriz JSON de objetos, cada uno de los cuales tiene una propiedad de cadena que puede ser warning, error, internal warning, internal error o result.
Hay como máximo un error (ya sea error o internal error) y siempre hay un result.
Ejemplo de archivo de resultados
En el siguiente ejemplo se describe una conversión que generó correctamente un archivo arrAsset. Sin embargo, puesto que faltaba una textura, el archivo arrAsset resultante podría no ser el 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 es un identificador interno que no se pone en correlación con el identificador que se usó para crear la conversión.
Información sobre un modelo convertido: el archivo de información
El archivo arrAsset generado por el servicio de conversión está diseñado exclusivamente para el consumo por parte del servicio de representación. Sin embargo, puede haber ocasiones en las que quiera acceder a información sobre un modelo sin iniciar una sesión de representación. Para admitir este flujo de trabajo, el servicio de conversión coloca un archivo JSON junto al archivo arrAsset en el contenedor de salida. Por ejemplo, si se convierte un archivo buggy.gltf, el contenedor de salida incluye un archivo denominado buggy.info.json junto al archivo convertido buggy.arrAsset. Este archivo contiene información sobre el modelo de origen, el modelo convertido y sobre la propia conversión.
Archivo de información de ejemplo
Este es un archivo de información de ejemplo generado al convertir un archivo llamado 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
]
}
}
}
Información en el archivo de información
La sección files
Esta sección contiene los nombres de archivo proporcionados.
input: el nombre del archivo de origen.output: el nombre del archivo de salida, cuando el usuario especifica un nombre no predeterminado.
La sección conversionSettings
En esta sección se incluye una copia de la sección ConversionSettings especificada cuando se convirtió el modelo.
La sección inputInfo
En esta sección se registra información sobre el formato de archivo de origen.
sourceAssetExtension: la extensión de archivo del archivo de origen.sourceAssetFormat: descripción del formato de archivo de origen.sourceAssetFormatVersion: la versión del formato del archivo de origen.sourceAssetGenerator: el nombre de la herramienta que generó el archivo de origen, si está disponible.
La sección materialOverrides
En esta sección se proporciona información acerca del reemplazo de materiales cuando se proporcionó un archivo de invalidación de material al servicio de conversión. Contiene la siguiente información:
numOverrides: el número de entradas de invalidación leídas del archivo de invalidación de material.numOverriddenMaterials: el número de materiales que se han reemplazado.
Esta sección no está presente para las conversiones de nubes de puntos.
La sección inputStatistics
Esta sección proporciona información sobre la escena de origen. Existen discrepancias entre los valores de esta sección y los valores equivalentes de la herramienta que creó el modelo de origen. Tales diferencias están previstas, ya que el modelo se modifica durante los pasos de exportación y conversión.
El contenido de esta sección es diferente para las mallas triangulares y las nubes de puntos.
numMeshes: el número de partes de la malla, donde cada parte puede hacer referencia a un único material.numFaces: número total de triángulos en el modelo de origen. Para obtener un número preciso de primitivos de salida, consulte la entradanumPrimitivesen la sección de salida.numVertices: número total de vértices en el modelo de origen.numMaterial: número total de materiales del modelo de origen.numFacesSmallestMesh: número de triángulos o puntos de la malla más pequeña del modelo.numFacesBiggestMesh: número de triángulos o puntos de la malla más grande del modelo.numNodes: el número de nodos del gráfico de escenas del modelo.numMeshUsagesInScene: el número de veces que los nodos hacen referencia a mallas. Más de un nodo puede hacer referencia a la misma malla.maxNodeDepth: la profundidad máxima de los nodos dentro del gráfico de escenas.
La sección outputInfo
En esta sección se registra información general sobre la salida generada.
conversionToolVersion: la versión del convertidor de modelos.conversionHash: un hash de los datos dentro del arrAsset que puede contribuir a la representación. Se puede usar para saber si el servicio de conversión produce un resultado diferente cuando se vuelve a ejecutar en el mismo archivo.
La sección outputStatistics
En esta sección se registra la información calculada a partir del recurso convertido. De nuevo, la sección contiene información diferente para las mallas triangulares y las nubes de puntos.
numPrimitives: el número total de triángulos/líneas en el modelo convertido. Este número contribuye al límite de primitivos en el tamaño del servidor de representación estándar.numMeshPartsCreated: el número de mallas en el arrAsset. Puede variar con respecto anumMeshesde la seccióninputStatistics, porque la creación de instancias se ve afectada por el proceso de conversión.numMeshPartsInstanced: el número de mallas que se reutilizan en el arrAsset.numMaterials: el número total de materiales únicos del modelo, después de la desduplicación de material.recenteringOffset: cuando está habilitada la opciónrecenterToOriginen ConversionSettings, este valor es el traslado que movería el modelo convertido de vuelta a su posición original.boundingBox: los límites del modelo.