Obter informações sobre conversões
Informações sobre uma conversão: O arquivo de resultados
Quando o serviço de conversão converte um ativo, ele grava um resumo de quaisquer problemas em um arquivo de resultados.
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 resultados lista todos os erros e avisos que ocorreram durante a conversão e fornece um resumo do resultado, que é um dos succeededfailed , ou succeeded with warnings.
O arquivo de resultado é estruturado como uma matriz JSON de objetos, cada um dos quais tem uma propriedade string que é uma das warning, error, internal warning, internal errore result.
Há no máximo um erro (ou error internal errorou ) e há sempre um result.
Exemplo de arquivo de resultado
O exemplo a seguir descreve uma conversão que gerou com êxito um arrAsset. No entanto, uma vez que havia uma textura faltando, o arrAsset resultante pode não ser como pretendido.
[
{"conversionId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"},
{"warning":"4004","title":"Missing texture","details":{"texture":"buggy_baseColor.png","material":"buggy_col"}},
{"result":"succeeded with warnings"}
]
Nota
O conversionId é um Id interno que não se correlaciona com o Id que foi usado 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 pelo serviço de renderização. No entanto, pode haver momentos em que você queira 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 buggy.arrAssetconvertido. 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
Aqui está 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 no ficheiro de informações
A secção de ficheiros
Esta 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
Esta seção contém uma cópia das ConversionSettings especificadas quando o modelo foi convertido.
A seção inputInfo
Esta seção registra informações sobre o formato de arquivo de origem.
sourceAssetExtension: A extensão do arquivo de origem.sourceAssetFormat: Uma descrição do formato do ficheiro 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 materialSubstitui
Esta 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. 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 secção inputStatistics
Esta seção fornece informações sobre a cena de origem. Muitas vezes, há discrepâncias entre os valores nesta seção e os valores equivalentes na ferramenta que criou o modelo de origem. Tais diferenças são esperadas, porque 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, onde cada parte pode fazer referência a um único material.numFaces: O número total de triângulos no modelo de origem. Para obter um número exato de primitivos de saída, consulte anumPrimitivesentrada na 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 gráfico de cena do modelo.numMeshUsagesInScene: O número de vezes que os nós fazem referência a malhas. Mais de um nó pode fazer referência à mesma malha.maxNodeDepth: A profundidade máxima dos nós dentro do gráfico de cena.
A seção outputInfo
Esta seção registra informações gerais sobre a saída gerada.
conversionToolVersion: Versão do conversor de modelo.conversionHash: um hash dos dados no arrAsset que pode contribuir para a composição. Pode ser usado para entender se o serviço de conversão produz um resultado diferente quando executado novamente no mesmo arquivo.
A secção outputStatistics
Esta seção registra informações calculadas a partir do ativo convertido. Novamente, a seção contém informações diferentes para malhas triangulares e nuvens de pontos.
numPrimitives: O número total de triângulos/linhas no modelo convertido. Esse número contribui para o limite primitivo no tamanho padrão do servidor de renderização.numMeshPartsCreated: O número de malhas no arrAsset. Ele pode diferir da seção , porque ainputStatisticsinstanciação é afetada pelo processo denumMeshesconversão.numMeshPartsInstanced: O número de malhas que são reutilizadas no arrAsset.numMaterials: O número total de materiais únicos no modelo, após a desduplicação de material.recenteringOffset: Quando arecenterToOriginopção em ConversionSettings está ativada, esse valor é a conversão que moveria o modelo convertido de volta à sua posição original.boundingBox: Os limites do modelo.