Sözdizimi
usdchecker [girdiDosyalari]
Açıklama
usdchecker, bir dosyanın uyumlu bir USD dosyası olduğunu doğrulayan bir yardımcı araçtır.
Zaman örneklemli herhangi bir ilgili özniteliğin yalnızca ilk zaman örneği kontrol edilir.
Genel USD kontrolleri her zaman gerçekleştirilir. --arkit belirtilerek ek bir kontrol kümesi etkinleştirilebilir. Bu, dosyanın dağıtılabilir tüketici içeriği olarak kullanılabilir olmasını sağlamaya çalışan kontrolleri etkinleştirir.
-h, --help Bir yardım mesajı yazdırır ve çıkar.
-o, --out [çıktı] Başarısız olan tüm kontrollerin yazdırılacağı dosya. Belirtilmezse, başarısız olan kontroller stdout'a çıktı olarak verilir. Eğer stderr sağlanırsa, terminal renklendirmesi bastırılacaktır.
-s, --skipVariants Belirtilirse, yalnızca varsayılan (yani seçili) varyantlarda bulunan prim'ler kontrol edilir. Bu seçenek belirtilmediğinde, varyant seçimlerinin olası tüm kombinasyonlarındaki prim'ler kontrol edilir.
-p, --rootPackageOnly Yalnızca belirtilen paketi kontrol et. Yuvalanmış paketler, bağımlılıklar ve bunların içerikleri doğrulanmaz.
--noAssetChecks Belirtilirse, sahnenin veya paketin toplu sahnelere kolayca ve güvenli bir şekilde referans verilebilmesini sağlamaya yardımcı olan ek kontrolleri GERÇEKLEŞTİRME.
--arkit Verilen USD sahnesinin, RealityKit'in USD desteğiyle uyumlu olup olmadığını kontrol et. Bu varlıklar, daha genel kurum içi kullanımlara yönelik usdz dosyalarına göre daha büyük kısıtlamalar altında çalışır ve bu seçenek bu kısıtlamaların karşılanmasını sağlamaya çalışır.
-d, --dumpRules Verilen seçenekler kümesi için kontrol edilmekte olan kurallar kümesini listeler.
-v, --verbose Ayrıntılı çıktı modunu etkinleştirir.
-t, --strict Daha sıkı uyumluluk için yalnızca uyarılar verilmiş olsa bile başarısızlık kodu döndür.
--variants Doğrulanacak variantSets listesi. Verilen variantSets için tüm varyantlar doğrulanır. Bu, açıkça belirtilen variantSets varyantlarıyla kombinasyon halinde verilen varyantları doğrulamak için --variants ile de kullanılabilir. Bu seçenek yalnızca yeni doğrulama çerçevesi kullanılırken geçerlidir.
--variantSets Doğrulanacak ',' ile ayrılmış variantSet:variant çiftlerinin listesi. Listedeki her varyant kümesi ayrı ayrı doğrulanır. Örnek: --variants foo:bar,baz:qux, foo:bar ve baz:qux'i birlikte doğrulayacaktır ancak --variants foo:bar --variants baz:qux, foo:bar ve baz:qux'i ayrı ayrı doğrulayacaktır. Bu, açıkça belirtilen variantSets varyantlarıyla kombinasyon halinde verilen varyantları doğrulamak için --variantSets ile de kullanılabilir. Bu seçenek yalnızca yeni doğrulama çerçevesi kullanılırken geçerlidir.
--disableVariantValidationLimit Varyant doğrulama çağrılarının sayısını sınırlamak için ayarlanan limiti devre dışı bırak. Bu seçenek, varyant sayısı çok fazla olduğunda ve varyantların tüm olası kombinasyonlarını doğrulamak istediğimizde kullanışlıdır. Varsayılan olarak doğrulama çağrılarının sayısı 1000 ile sınırlıdır. Bu seçenek yalnızca yeni doğrulama çerçevesi kullanılırken geçerlidir.
--version Program sürüm bilgisini görüntüler ve çıkar.
Doğrulama Testleri Aşağıdaki doğrulama testleri mevcuttur. Bazıları yalnızca --arkit seçeneği sağlandığında çalışabilir ve bazıları diğer bağlamlara bağlı olarak ekstra katılık sağlayabilir.
Doğrulama testlerinin listesi ve davranışları bu aracın gelecekteki sürümlerinde değişebilir.
usdGeomValidators:StageMetadataChecker Tüm sahneler 'upAxis' ve 'metersPerUnit' değerlerini bildirmelidir.
usdGeomValidators:SubsetFamilies Bir Imageable prim altında oluşturulan tüm geom alt küme ailelerini doğrular.
usdGeomValidators:SubsetParentIsImageable GeomSubset prim'lerinin bir Imageable prim'inin doğrudan alt öğeleri olduğunu doğrular.
usdShadeValidators:EncapsulationRulesValidator Bağlanabilir prim'ler (örneğin Shader, Material vb.) yalnızca diğer Konteyner benzeri Bağlanabilir prim'lerin içine yuvalanabilir. Konteyner benzeri prim'ler arasında Material, NodeGraph, Light, LightFilter yer alır. Shader, Konteyner benzeri bir prim değildir.
usdShadeValidators:MaterialBindingApiAppliedValidator Bir prim'in malzeme bağlama ilişkisi varsa, MaterialBindingAPI'sinin uygulanıp uygulanmadığını doğrulayın.
usdShadeValidators:MaterialBindingCollectionValidator Bir malzeme bağlamasını tanımlayan koleksiyonun düzgün biçimlendirilmiş olduğunu doğrulayın.
usdShadeValidators:MaterialBindingRelationships 'material:binding' olarak adlandırılan veya bu ad alanındaki tüm özellikler ilişki olmalıdır.
usdShadeValidators:NormalMapTextureValidator Bir UsdPreviewSurface'in inputs:normals girdisini besleyen UsdUVTexture düğümleri, verilerin düzgün şekilde kodlandığından ve ölçeklendiğinden emin olmalıdır. Özellikle, normallerin [(-1,-1,-1), (1,1,1)] aralığında olması beklendiğinden, Dokulu düğüm 8-bitlik dokuları [0..1] aralığından dönüştürmek için inputs:scale değerini (2, 2, 2, 1) ve inputs:bias değerini (-1, -1, -1, 0) olarak ayarlamalıdır. Normal harita verilerinin genellikle doğrusal kodlanmış olması beklenir. Ancak birçok görüntü yazma aracı, üç kanallı, 8-bitlik görüntülerin profilini otomatik olarak SRGB olarak ayarlar. İstenmeyen bir dönüşümü önlemek için UsdUVTexture'ın inputs:sourceColorSpace değeri raw olarak ayarlanmalıdır.
usdShadeValidators:ShaderSdrCompliance Shader prim'inin girdi türleri, ilgili sdr shader'ındaki uygun sdf türleriyle uyumlu olmalıdır.
usdShadeValidators:SubsetMaterialBindFamilyName Oluşturulmuş malzeme bağlamalarına sahip Geom alt kümeleri, 'materialBind' aile adına sahip olmalıdır.
usdShadeValidators:SubsetsMaterialBindFamily 'materialBind' ailesinin Geom alt kümeleri kısıtlı bir aile türüne sahip olmalıdır.
usdSkelValidators:SkelBindingApiAppliedValidator Bir prim'in UsdSkelBinding özelliği varsa, SkelBindingAPI'sinin uygulanıp uygulanmadığını doğrulayın.
usdSkelValidators:SkelBindingApiValidator SkelBindingAPI uygulanmış bir prim'in SkelRoot türünde olduğunu veya bir SkelRoot prim'inin alt öğesi olduğunu doğrulayın.
usdUtilsValidators:FileExtensionValidator Pakette yalnızca geçerli çekirdek katman uzantılarına (.usd, .usda, .usdc, .usdz), geçerli çekirdek doku uzantılarına (.exr, .jpg, .jpeg, .png) ve gömülü ses dosyalarına (.M4A, .MP3, .WAV) izin verilir.
usdUtilsValidators:MissingReferenceValidator Varsayılan varlık çözücü kullanıldığında, birleştirilmiş USD sahnesi (varlığın her olası varyasyonunda) çözülemeyen hiçbir varlık bağımlılığı içermemelidir.
usdUtilsValidators:PackageEncapsulationValidator Kök katman bir paket ise, birleştirilmiş sahnenin paket dışındaki dosyalara referanslar içermemesi önerilir. Paket bağımsız olmalıdır, aksi takdirde uyar.
usdUtilsValidators:UsdzPackageValidator Bir sahne içindeki tüm usdz paketlerindeki dosyalar sıkıştırılmamış veya şifrelenmemiş olmalı ve 64 bayta hizalanmalıdır.
usdValidation:CompositionErrorTest Doğrulayıcı, sahne birleştirilirken üretilen tüm kompozisyon hatalarını sağlamayı amaçlar.
usdValidation:StageMetadataChecker Referans verilebilir varlıklar olarak tüketilebilen sahnelerin geçerli bir 'defaultPrim' belirtmiş olması gerekir.
Notlar
usdchecker'dan başarıyla geçen bir dosya, doğrulayıcının farkında olmadığı başka sorunlara yine de sahip olabilir.
Örnekler
usdchecker --arkit input.usdz
Girdi USDZ dosyasını yaygın olarak bilinen sorunlar açısından kontrol eder.
USDCHECKER()