Bagikan melalui

Dapatkan informasi tentang konversi

  • Artikel

Informasi tentang konversi: File hasil

Saat layanan konversi mengonversi aset, layanan tersebut menulis ringkasan masalah apa pun ke dalam file hasil. Misalnya, jika file buggy.gltf dikonversi, kontainer output berisi file yang disebut buggy.result.json.

File hasil mencantumkan kesalahan dan peringatan apa pun yang terjadi selama konversi dan memberikan ringkasan hasil, yang merupakan salah satu dari succeeded, failed, atau succeeded with warnings. File hasil disusun sebagai larik objek JSON, yang masing-masing memiliki properti string yaitu salah satu dari warning, error, internal warning, internal error, dan result. Paling banyak ada satu kesalahan (baik error atau internal error) dan selalu ada satu result.

Contoh file hasil

Contoh berikut menjelaskan konversi yang berhasil menghasilkan arrAsset. Namun, karena ada tekstur yang hilang, arrAsset yang dihasilkan mungkin tidak sesuai dengan yang diinginkan.

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

Catatan

conversionId adalah Id internal yang tidak berkorelasi dengan Id yang digunakan untuk membuat konversi.

Informasi tentang model yang dikonversi: File info

File arrAsset yang dihasilkan oleh layanan konversi hanya dimaksudkan untuk dikonsumsi oleh layanan penyajian. Namun, ada kalanya Anda ingin mengakses informasi tentang model tanpa memulai sesi penyajian. Untuk mendukung alur kerja ini, layanan konversi menempatkan file JSON di samping file arrAsset dalam kontainer keluaran. Misalnya, jika file buggy.gltf dikonversi, kontainer output berisi file yang disebut buggy.info.json di samping aset buggy.arrAssetyang dikonversi . Hal ini berisi informasi tentang model sumber, model yang dikonversi, dan tentang konversi itu sendiri.

Contoh file info

Berikut ini contoh file info yang dihasilkan dengan mengonversi file bernama 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
            ]
        }
    }
}

Informasi dalam file info

Bagian file

Bagian ini berisi nama file yang disediakan.

  • input: Nama file sumber.
  • output: Nama file output, ketika pengguna menentukan nama nondefault.

Bagian conversionSettings

Bagian ini menyimpan salinan ConversionSettings yang ditentukan saat model dikonversi.

Bagian inputInfo

Bagian ini merekam informasi tentang format file sumber.

  • sourceAssetExtension: Ekstensi file dari file sumber.
  • sourceAssetFormat: Deskripsi format file sumber.
  • sourceAssetFormatVersion: Versi format file sumber.
  • sourceAssetGenerator: Nama alat yang menghasilkan file sumber, jika tersedia.

Bagian materialOverride

Bagian ini memberikan informasi tentang ambil alih materi saat file mengambil alih materi yang diberikan ke layanan konversi. Hal ini berisi informasi berikut:

  • numOverrides: Jumlah entri yang mengambil alih dibaca dari file ambil alih materi.
  • numOverriddenMaterials: Jumlah materi yang diambil alih.

Bagian ini tidak ada untuk konversi cloud titik.

Bagian inputStatistics

Bagian ini memberikan informasi tentang adegan sumber. Sering kali ada perbedaan antara nilai di bagian ini dan nilai yang setara dalam alat yang membuat model sumber. Perbedaan seperti itu diharapkan, karena model akan dimodifikasi selama langkah ekspor dan konversi.

Konten bagian ini berbeda untuk jala segitiga dan awan titik.

  • numMeshes: Jumlah bagian jala, di mana setiap bagian dapat merujuk satu materi.
  • numFaces: Jumlah total segitiga dalam model sumber. Untuk jumlah primitif output yang akurat, lihat numPrimitives entri di bagian output.
  • numVertices: Jumlah total simpul dalam model sumber.
  • numMaterial: Jumlah total bahan dalam model sumber.
  • numFacesSmallestMesh: Jumlah segitiga/titik dalam jala terkecil dari model.
  • numFacesBiggestMesh: Jumlah segitiga/titik dalam jala terbesar model.
  • numNodes: Jumlah simpul dalam grafik pemandangan model.
  • numMeshUsagesInScene: Frekuensi simpul referensi jala. Lebih dari satu simpul dapat mereferensikan jala yang sama.
  • maxNodeDepth: Kedalaman maksimum simpul dalam grafik pemandangan.

Bagian outputInfo

Bagian ini merekam informasi umum tentang output yang dihasilkan.

  • conversionToolVersion: Versi konverter model.
  • conversionHash: Sebuah hash dari data dalam arrAsset yang dapat berkontribusi pada penyajian. Dapat digunakan untuk memahami apakah layanan konversi menghasilkan hasil yang berbeda saat dijalankan ulang pada file yang sama.

Bagian outputStatistics

Bagian ini merekam informasi yang dihitung dari aset yang dikonversi. Sekali lagi, bagian ini menyimpan informasi yang berbeda untuk jala segitiga dan awan titik.

  • numPrimitives: Jumlah keseluruhan segitiga/garis dalam model yang dikonversi. Angka ini berkontribusi pada batas primitif dalam ukuran server penyajian standar.
  • numMeshPartsCreated: Jumlah jala di arrAsset. Hal ini dapat berbeda dari numMeshes di bagian inputStatistics, karena pembuatan instans dipengaruhi oleh proses konversi.
  • numMeshPartsInstanced: Jumlah jala yang digunakan kembali di arrAsset.
  • numMaterials: Jumlah keseluruhan bahan unik dalam model, setelah deduplikasi material.
  • recenteringOffset: Bila opsi recenterToOrigin di ConversionSettings diaktifkan, nilai ini adalah terjemahan yang akan mengembalikan model yang dikonversi ke posisi semula.
  • boundingBox: Batas model.

Langkah berikutnya