변환 정보 가져오기
변환에 대한 정보: 결과 파일
변환 서비스는 자산을 변환할 때 모든 문제에 대한 요약을 결과 파일에 기록합니다.
예를 들어, 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는 전환 만들기에 사용된 ID와 관련이 없는 내부 ID입니다.
변환된 모델에 대한 정보: info 파일
변환 서비스에 의해 생성된 arrAsset 파일은 렌더링 서비스에서 사용하기 위한 것입니다. 그러나 렌더링 세션을 시작하지 않고 모델에 대한 정보에 액세스하려는 경우가 있을 수 있습니다. 이 워크플로를 지원하기 위해 변환 서비스는 출력 컨테이너의 arrAsset 파일 외에 JSON 파일을 배치합니다. 예를 들어, buggy.gltf 파일이 변환되면 출력 컨테이너에는 변환된 자산 buggy.arrAsset 옆에 buggy.info.json이라는 파일이 포함됩니다. 원본 모델, 변환된 모델 및 변환 자체에 대한 정보를 포함합니다.
info 파일 예
다음은 buggy.gltf라는 파일을 변환하여 생성된 info 파일 예입니다.
{
"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
]
}
}
}
정보 파일의 정보
files 섹션
이 섹션에는 제공된 파일 이름이 포함되어 있습니다.
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의 메시 수입니다. 인스턴싱은 변환 프로세스의 영향을 받기 때문에inputStatistics섹션의numMeshes와 다를 수 있습니다.numMeshPartsInstanced: ArrAsset에서 재사용되는 메시의 수입니다.numMaterials: 재질 중복 제거 후 모델의 고유 재질의 전체 수입니다.recenteringOffset: ConversionSettings에서recenterToOrigin옵션을 사용하는 경우 이 값은 변환된 모델을 원래 위치로 다시 이동하는 좌표 이동입니다.boundingBox: 모델의 경계입니다.