Obter informações sobre conversões
Informações sobre uma conversão: o arquivo de resultado
Quando o serviço de conversão converte um ativo, ele grava um resumo dos problemas em um arquivo de resultado.
Por exemplo, se um arquivo buggy.gltf for convertido, o contêiner de saída conterá um arquivo chamado buggy.result.json.
O arquivo de resultado lista todos os erros e os avisos ocorridos durante a conversão e fornece um resumo de resultado, que é succeeded, failed ou succeeded with warnings.
Ele é estruturado como uma matriz JSON de objetos, cada um com uma propriedade de cadeia de caracteres que é warning, error, internal warning, internal error ou result.
Haverá, no máximo, um erro (error ou internal error) e sempre haverá um result.
Exemplo de arquivo de resultado
O exemplo a seguir descreve uma conversão que gerou com êxito um arrAsset. No entanto, como havia uma textura ausente, o arrAsset resultante talvez não seja o pretendido.
[
{"conversionId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"},
{"warning":"4004","title":"Missing texture","details":{"texture":"buggy_baseColor.png","material":"buggy_col"}},
{"result":"succeeded with warnings"}
]
Observação
É conversionId uma ID interna que não se correlaciona com a ID que foi usada para criar a conversão.
Informações sobre um modelo convertido: o arquivo de informações
O arquivo arrAsset produzido pelo serviço de conversão destina-se exclusivamente ao consumo do serviço de renderização. No entanto, pode haver ocasiões em que você deseje acessar informações sobre um modelo sem iniciar uma sessão de renderização. Para dar suporte a esse fluxo de trabalho, o serviço de conversão coloca um arquivo JSON ao lado do arquivo arrAsset no contêiner de saída. Por exemplo, se um arquivo buggy.gltf for convertido, o contêiner de saída conterá um arquivo chamado buggy.info.json ao lado do ativo convertido buggy.arrAsset. Ele contém informações sobre o modelo de origem, o modelo convertido e sobre a conversão em si.
Exemplo de arquivo de informações
Veja um exemplo de arquivo de informações produzido pela conversão de um arquivo chamado 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
]
}
}
}
Informações do arquivo de informações
A seção files
Essa seção contém os nomes de arquivo fornecidos.
input: o nome do arquivo de origem.output: O nome do arquivo de saída, quando o usuário especifica um nome não padrão.
A seção conversionSettings
Essa seção contém uma cópia das ConversionSettings especificadas quando o modelo foi convertido.
A seção inputInfo
Essa seção registra informações sobre o formato do arquivo de origem.
sourceAssetExtension: a extensão do arquivo de origem.sourceAssetFormat: uma descrição do formato do arquivo de origem.sourceAssetFormatVersion: a versão do formato do arquivo de origem.sourceAssetGenerator: o nome da ferramenta que gerou o arquivo de origem, se disponível.
A seção materialOverrides
Essa seção fornece informações sobre a substituição de material quando um arquivo de substituição de material foi fornecido ao serviço de conversão. Ela contém as seguintes informações:
numOverrides: o número de entradas de substituição lidas do arquivo de substituição de material.numOverriddenMaterials: o número de materiais que foram substituídos.
Esta seção não está presente para conversões de nuvem de pontos.
A seção inputStatistics
Essa seção fornece informações sobre a cena de origem. Muitas vezes há discrepâncias entre os valores nessa seção e os valores equivalentes na ferramenta que criou o modelo de origem. Essas diferenças são esperadas, pois o modelo é modificado durante as etapas de exportação e conversão.
O conteúdo desta seção é diferente para malhas triangulares e nuvens de pontos.
numMeshes: o número de partes de malha, em que cada parte pode referenciar um só material.numFaces: o número total de triângulos no modelo de origem. Para obter um número preciso de primitivos de saída, consulte a entradanumPrimitivesna seção de saída.numVertices: o número total de vértices no modelo de origem.numMaterial: o número total de materiais no modelo de origem.numFacesSmallestMesh: o número de triângulos/pontos na menor malha do modelo.numFacesBiggestMesh: o número de triângulos/pontos na maior malha do modelo.numNodes: o número de nós no grafo de cena do modelo.numMeshUsagesInScene: o número de vezes que os nós referenciam malhas. Mais de um nó pode referenciar a mesma malha.maxNodeDepth: a profundidade máxima dos nós dentro do grafo de cena.
A seção outputInfo
Essa seção registra informações gerais sobre a saída gerada.
conversionToolVersion: versão do conversor de modelo.conversionHash: um hash dos dados dentro do arrAsset que pode contribuir para a renderização. Pode ser usado para entender se o serviço de conversão produz um resultado diferente quando executado novamente no mesmo arquivo.
A seção outputStatistics
Essa seção registra as informações calculadas do ativo convertido. Novamente, a seção contém informações diferentes para malhas triangulares e nuvens de ponto.
numPrimitives: O número total de triângulos/linhas no modelo convertido. Esse número contribui para o limite primitivo no tamanho do servidor de renderização padrão.numMeshPartsCreated: o número de malhas do arrAsset. Ele pode ser diferente denumMeshesna seçãoinputStatistics, pois a criação de uma instância é afetada pelo processo de conversão.numMeshPartsInstanced: o número de malhas reutilizadas no arrAsset.numMaterials: O número total de materiais exclusivos no modelo, após a desduplicação do material.recenteringOffset: quando a opçãorecenterToOriginnas ConversionSettings está habilitada, esse valor é a conversão que move o modelo convertido novamente para a posição original.boundingBox: os limites do modelo.