man/multimedia
man · Multimedya

$ usdchecker

Bölüm 1 · Multimedya

belirli bir USD sahnesinin veya USDZ paketinin uyumluluğunu kontrol eder

Özet

usdchecker [girdiDosyalari]

Açıklama

usdchecker, bir dosyanın uyumlu bir USD dosyası olduğunu doğrulayan yardımcı araçtır.

Zaman örneklemli ilgili özniteliklerde yalnızca ilk zaman örneği kontrol edilir. Genel USD kontrolleri her zaman gerçekleştirilir. --arkit belirtilirse dosyanın dağıtılabilir tüketici içeriği olarak kullanılabilir olmasını sağlamaya çalışan ek kontroller etkinleştirilir.

Seçenekler

  • -h, --help: Yardım mesajını yazdırır ve çıkar.
  • -o, --out [çıktı]: Başarısız olan kontrollerin yazdırılacağı dosya. Belirtilmezse sonuçlar stdout üzerine yazılır. stderr sağlanırsa terminal renklendirmesi bastırılır.
  • -s, --skipVariants: Yalnızca varsayılan, yani seçili, varyantlarda bulunan prim'leri kontrol eder.
  • -p, --rootPackageOnly: Yalnızca belirtilen paketi kontrol eder. Yuvalanmış paketler, bağımlılıklar ve bunların içerikleri doğrulanmaz.
  • --noAssetChecks: Sahnenin veya paketin toplu sahnelere kolay ve güvenli şekilde referans verilebilmesine yardımcı olan ek kontrolleri gerçekleştirmez.
  • --arkit: Verilen USD sahnesinin RealityKit USD desteğiyle uyumlu olup olmadığını kontrol eder.
  • -d, --dumpRules: Verilen seçenekler kümesi için kontrol edilen kurallar kümesini listeler.
  • -v, --verbose: Ayrıntılı çıktı modunu etkinleştirir.
  • -t, --strict: Yalnızca uyarılar verilmiş olsa bile daha sıkı uyumluluk için başarısızlık kodu döndürür.
  • --variants: Doğrulanacak variantSets listesini belirtir. Verilen variantSets için tüm varyantlar doğrulanır. Yalnızca yeni doğrulama çerçevesi kullanılırken geçerlidir.
  • --variantSets: Doğrulanacak, virgülle ayrılmış variantSet:variant çiftlerinin listesini belirtir. Listedeki her varyant kümesi ayrı ayrı doğrulanır.
  • --disableVariantValidationLimit: Varyant doğrulama çağrılarının sayısını sınırlayan limiti devre dışı bırakır. Varsayılan limit 1000 çağrıdır. 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ı bağlama göre daha sıkı davranabilir. Test 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'lerin yalnızca diğer konteyner benzeri bağlanabilir prim'lerin içine yuvalanabildiğini doğrular.
  • usdShadeValidators:MaterialBindingApiAppliedValidator: Malzeme bağlama ilişkisi olan prim'lerde MaterialBindingAPI uygulanıp uygulanmadığını doğrular.
  • usdShadeValidators:MaterialBindingCollectionValidator: Bir malzeme bağlamasını tanımlayan koleksiyonun düzgün biçimlendirilmiş olduğunu doğrular.
  • usdShadeValidators:MaterialBindingRelationships: material:binding olarak adlandırılan veya bu ad alanındaki tüm özelliklerin ilişki olmasını gerektirir.
  • usdShadeValidators:NormalMapTextureValidator: Bir UsdPreviewSurface nesnesinin inputs:normals girdisini besleyen UsdUVTexture düğümlerinde normal harita verilerinin doğru kodlandığını ve ölçeklendiğini doğrular.
  • usdShadeValidators:ShaderSdrCompliance: Shader prim'inin girdi türlerinin ilgili SDR shader içindeki uygun SDF türleriyle uyumlu olduğunu doğrular.
  • usdShadeValidators:SubsetMaterialBindFamilyName: Oluşturulmuş malzeme bağlamalarına sahip geom alt kümelerinin materialBind aile adına sahip olmasını gerektirir.
  • usdShadeValidators:SubsetsMaterialBindFamily: materialBind ailesinin geom alt kümelerinin kısıtlı bir aile türüne sahip olmasını gerektirir.
  • usdSkelValidators:SkelBindingApiAppliedValidator: UsdSkelBinding özelliği olan prim'lerde SkelBindingAPI uygulanıp uygulanmadığını doğrular.
  • usdSkelValidators:SkelBindingApiValidator: SkelBindingAPI uygulanmış bir prim'in SkelRoot türünde olduğunu veya bir SkelRoot prim'inin alt öğesi olduğunu doğrular.
  • usdUtilsValidators:FileExtensionValidator: Pakette yalnızca geçerli çekirdek katman, doku ve gömülü ses dosyası uzantılarına izin verildiğini doğrular.
  • usdUtilsValidators:MissingReferenceValidator: Varsayılan varlık çözücü kullanıldığında sahnede çözülemeyen varlık bağımlılığı bulunmamasını doğrular.
  • usdUtilsValidators:PackageEncapsulationValidator: Kök katman bir paket ise, birleştirilmiş sahnenin paket dışındaki dosyalara referans içermemesini önerir.
  • usdUtilsValidators:UsdzPackageValidator: Bir sahnedeki tüm USDZ paket dosyalarının sıkıştırılmamış, şifrelenmemiş ve 64 bayta hizalanmış olmasını gerektirir.
  • usdValidation:CompositionErrorTest: Sahne birleştirilirken üretilen kompozisyon hatalarını sağlamayı amaçlar.
  • usdValidation:StageMetadataChecker: Referans verilebilir varlıklar olarak tüketilebilen sahnelerin geçerli bir defaultPrim belirtmesini gerektirir.

Notlar

usdchecker aracından 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

Bu komut, girdi USDZ dosyasını yaygın olarak bilinen sorunlar açısından kontrol eder.

USDCHECKER()