Получение сведений о преобразованиях

Статья
04/17/2024

Сведения о преобразовании: файл результатов

При преобразовании ресурса служба преобразования записывает сводку о любых проблемах в результирующий файл. Например, если файл buggy.gltf преобразуется, выходной контейнер содержит файл с именем buggy.result.json.

В файле результатов перечислены все ошибки и предупреждения, возникшие во время преобразования, и дана сводка результатов, которая может быть одним из succeeded, failed и succeeded with warnings. Файл результатов структурирован как массив объектов JSON, каждый из которых имеет строковое свойство, которое может быть одним из warning, error, internal warning, internal error и result. Существует по крайней мере одна ошибка (либо error ) internal errorи всегда resultодна.

Пример файла результатов

В следующем примере описывается преобразование, которое успешно сгенерировало arrAsset. Однако из-за отсутствия текстуры результирующий объект arrAsset может быть не таким, как задумано.

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

Примечание.

Это conversionId внутренний идентификатор, который не коррелирует с идентификатором, который использовался для создания преобразования.

Информация о преобразованной модели: информационный файл

Файл arrAsset, созданный службой преобразования, предназначен исключительно для использования службой визуализации. Однако могут быть случаи, когда вы хотите получить доступ к информации о модели, не запуская сеанс рендеринга. Для поддержки этого рабочего процесса служба преобразования помещает файл JSON рядом с файлом arrAsset в выходной контейнер. Например, если файл buggy.gltf преобразуется, выходной контейнер содержит файл, который вызывается buggy.info.json рядом с преобразованным ресурсом buggy.arrAsset. Он содержит информацию об исходной модели, преобразованной модели и о самом преобразовании.

Пример файла сведений

Ниже приведен пример файла сведений, полученного при преобразовании файла с именем 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
            ]
        }
    }
}

Информация в файле сведений

Раздел файлы

Этот раздел содержит указанные имена файлов.

input: имя исходного файла.
output: имя выходного файла, когда пользователь задает недефакторное имя.

Раздел conversionSettings

В этом разделе содержится копия ConversionSettings, указанная при преобразовании модели.

Раздел inputInfo

В этом разделе записываются сведения о формате исходного файла.

sourceAssetExtension: расширение исходного файла.
sourceAssetFormat: описание формата исходного файла.
sourceAssetFormatVersion: версия формата исходного файла.
sourceAssetGenerator: имя инструмента, создавшего исходный файл, если он доступен.

Раздел materialOverrides

В этом разделе содержится информация о переопределении материала, когда в службу преобразования был предоставлен файл замены материала. В нем содержится следующая информация:

numOverrides: количество записей переопределения, прочитанных из файла переопределения материала.
numOverriddenMaterials: количество материалов, которые были переопределены.

Этот раздел отсутствует для преобразования в облако точек.

Раздел inputStatistics

В этом разделе представлена информация об исходной сцене. Часто существуют расхождения между значениями в этом разделе и эквивалентами в средстве, создавшего исходную модель. Такие различия ожидаются, потому что модель модифицируется на этапах экспорта и преобразования.

Содержимое этого раздела отличается для треугольных сеток и облаков точек.

Треугольные сетки
Точки облака

numMeshes: количество частей сетки, где каждая часть может ссылаться на один материал.
numFaces: общее количество треугольников в исходной модели. Точное количество выходных примитивов см numPrimitives . в записи в разделе выходных данных.
numVertices: общее количество вершин в исходной модели.
numMaterial: общее количество материалов в исходной модели.
numFacesSmallestMesh: количество треугольников или точек в наименьшей сетке модели.
numFacesBiggestMesh: количество треугольников или точек в самой большой сетке модели.
numNodes: количество узлов в графе сцены модели.
numMeshUsagesInScene: количество раз, когда узлы ссылаются на сетки. Более чем один узел может ссылаться на одну и ту же сетку.
maxNodeDepth: максимальная глубина узлов в графе сцены.

Раздел outputInfo

В этом разделе записывается общая информация о сгенерированном выходе.

conversionToolVersion: версия конвертера моделей.
conversionHash: хэш данных в arrAsset, которые могут способствовать отрисовке. Можно использовать для понимания того, создает ли служба преобразования другой результат при повторном запуске в одном файле.

Раздел outputStatistics

В этом разделе записывается информация, рассчитанная на основе преобразованного актива. Опять же, в разделе содержатся различные сведения о треугольных сетках и облаках точек.

Треугольные сетки
Точки облака

numPrimitives: общее количество треугольников или линий в преобразованной модели. Это число способствует примитивному ограничению в стандартном размере сервера отрисовки.
numMeshPartsCreated: количество ячеек в arrAsset. Он может отличаться от numMeshes в разделе inputStatistics, потому что на создание экземпляров влияет процесс преобразования.
numMeshPartsInstanced: количество сеток, которые повторно используются в arrAsset.
numMaterials: общее количество уникальных материалов в модели после дедупликации материалов.
recenteringOffset: когда параметр recenterToOrigin в ConversionSettings включен, это значение является переводом, который вернет преобразованную модель в исходное положение.
boundingBox: границы модели.

numPoints: общее количество точек в преобразованной модели. Это число способствует примитивному ограничению в стандартном размере сервера отрисовки.
recenteringOffset: когда параметр recenterToOrigin в ConversionSettings включен, это значение является переводом, который вернет преобразованную модель в исходное положение.
boundingBox: границы модели.

Поделиться через