Dönüştürmeler hakkında bilgi alma

Makale
05/22/2024

Dönüştürme hakkında bilgi: Sonuç dosyası

Dönüştürme hizmeti bir varlığı dönüştürdüğünde, sorunların özetini bir sonuç dosyasına yazar. Örneğin, bir dosya buggy.gltf dönüştürülürse, çıkış kapsayıcısı adlı buggy.result.jsonbir dosya içerir.

Sonuç dosyası, dönüştürme sırasında oluşan hataları ve uyarıları listeler ve veya 'den succeededfailed succeeded with warningsbiri olan bir sonuç özeti verir. Sonuç dosyası, her biri , error, internal warninginternal error, ve resultdize warningözelliğine sahip olan nesnelerin JSON dizisi olarak yapılandırılmıştır. En fazla bir hata ( error veya internal error) vardır ve her zaman bir resultvardır.

Örnek sonuç dosyası

Aşağıdaki örnekte başarıyla arrAsset oluşturan bir dönüştürme açıklanmaktadır. Ancak, eksik bir doku olduğundan, sonuçta elde edilen arrAsset amaçlandığı gibi olmayabilir.

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

Not

conversionId, dönüştürmeyi oluşturmak için kullanılan kimlikle bağıntısız bir iç kimliktir.

Dönüştürülen model hakkında bilgi: Bilgi dosyası

Dönüştürme hizmeti tarafından üretilen arrAsset dosyası yalnızca işleme hizmeti tarafından kullanıma yöneliktir. Ancak, işleme oturumu başlatmadan bir model hakkındaki bilgilere erişmek istediğiniz zamanlar olabilir. Dönüştürme hizmeti bu iş akışını desteklemek için çıkış kapsayıcısında arrAsset dosyasının yanına bir JSON dosyası yerleştirir. Örneğin, bir dosya buggy.gltf dönüştürülürse, çıkış kapsayıcısı dönüştürülen varlığın buggy.arrAssetyanında adlı buggy.info.json bir dosya içerir. Kaynak model, dönüştürülen model ve dönüştürmenin kendisi hakkında bilgiler içerir.

Örnek bilgi dosyası

Aşağıda adlı buggy.gltfbir dosya dönüştürülerek oluşturulan örnek bir bilgi dosyası verilmiştir:

{
    "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
            ]
        }
    }
}

Bilgi dosyasındaki bilgiler

Dosyalar bölümü

Bu bölüm, sağlanan dosya adlarını içerir.

input: Kaynak dosyanın adı.
output: Kullanıcı bilinmeyen bir ad belirttiğinde çıkış dosyasının adı.

Dönüştürme Ayarlar bölümü

Bu bölüm Ayarlar model dönüştürüldüğünde belirtilen Dönüştürme'nin bir kopyasını tutar.

inputInfo bölümü

Bu bölüm, kaynak dosya biçimiyle ilgili bilgileri kaydeder.

sourceAssetExtension: Kaynak dosyanın dosya uzantısı.
sourceAssetFormat: Kaynak dosya biçiminin açıklaması.
sourceAssetFormatVersion: Kaynak dosya biçiminin sürümü.
sourceAssetGenerator: Varsa, kaynak dosyayı oluşturan aracın adı.

materialOverrides bölümü

Bu bölüm, dönüştürme hizmetine bir malzeme geçersiz kılma dosyası sağlandığında malzeme geçersiz kılma hakkında bilgi verir. Aşağıdaki bilgileri içerir:

numOverrides: Malzeme geçersiz kılma dosyasından okunan geçersiz kılma girdilerinin sayısı.
numOverriddenMaterials: Geçersiz kılınan malzemelerin sayısı.

Bu bölüm, nokta bulutu dönüştürmeleri için mevcut değildir.

inputStatistics bölümü

Bu bölüm, kaynak sahne hakkında bilgi sağlar. Bu bölümdeki değerlerle kaynak modeli oluşturan araçtaki eşdeğer değerler arasında genellikle tutarsızlıklar vardır. Modelin dışarı aktarma ve dönüştürme adımları sırasında değiştirilmesi nedeniyle bu tür farklılıklar beklenir.

Bu bölümün içeriği üçgen çizgiler ve nokta bulutları için farklıdır.

Üçgen tireler
Nokta bulutları

numMeshes: Her parçanın tek bir malzemeye başvurabileceği örgü parçalarının sayısı.
numFaces: Kaynak modeldeki toplam üçgen sayısı. Doğru sayıda çıkış temeli için numPrimitives çıkış bölümündeki girişe bakın.
numVertices: Kaynak modeldeki köşelerin toplam sayısı.
numMaterial: Kaynak modeldeki toplam malzeme sayısı.
numFacesSmallestMesh: Modelin en küçük ağındaki üçgen/nokta sayısı.
numFacesBiggestMesh: Modelin en büyük ağındaki üçgen/nokta sayısı.
numNodes: Modelin sahne grafiğindeki düğüm sayısı.
numMeshUsagesInScene: Düğümlerin tirelere başvurma sayısı. Aynı ağa birden fazla düğüm başvurabilir.
maxNodeDepth: Sahne grafı içindeki düğümlerin maksimum derinliği.

outputInfo bölümü

Bu bölüm, oluşturulan çıkışla ilgili genel bilgileri kaydeder.

conversionToolVersion: Model dönüştürücüsünün sürümü.
conversionHash: arrAsset içindeki işlemeye katkıda bulunabilecek verilerin karması. Dönüştürme hizmetinin aynı dosyada yeniden çalıştırıldığında farklı bir sonuç oluşturup oluşturmadığını anlamak için kullanılabilir.

outputStatistics bölümü

Bu bölüm, dönüştürülen varlıktan hesaplanan bilgileri kaydeder. Bölüm yine üçgen ağlar ve nokta bulutları için farklı bilgiler barındırır.

Üçgen tireler
Nokta bulutları

numPrimitives: Dönüştürülen modeldeki genel üçgen/çizgi sayısı. Bu sayı, standart işleme sunucusu boyutundaki temel sınıra katkıda bulunur.
numMeshPartsCreated: arrAsset içindeki tire sayısı. Bu, dönüştürme işleminden inputStatistics etkilendiği için bölümünden farklı numMeshes olabilir.
numMeshPartsInstanced: arrAsset içinde yeniden kullanılan tire sayısı.
numMaterials: Yinelenen malzeme kaldırmadan sonra modeldeki benzersiz malzemelerin toplam sayısı.
recenteringOffset: Dönüştürme Ayarlar seçeneği etkinleştirildiğinderecenterToOrigin, bu değer dönüştürülen modeli özgün konumuna geri taşıyacak çeviridir.
boundingBox: Modelin sınırları.

Aracılığıyla paylaş