Sözdizimi
usdcat [girdiDosyalari]
Açıklama
usdcat, girdi dosyalarının içeriğini desteklenen diğer biçimlere dönüştürmek veya bunları stdout'a metin olarak görüntülemek için kullanılan bir yardımcı araçtır.
-h, --help Bir yardım mesajı yazdırır ve çıkar.
-o, --output Tek bir girdi dosyasını stdout yerine bu çıktı dosyasına yaz.
--usdFormat [usda | usdc] 'usd' uzantılı çıktı dosyaları için bu temel dosya biçimini kullan. Örneğin, bir metin dosyası olarak output.usd dosyasını iletmek. USD_DEFAULT_FILE_FORMAT çevre değişkeni, bunu başarmanın başka bir yoludur.
-l, --loadOnly Belirtilen girdi dosyalarını yüklemeyi dene ve her biri için 'OK' veya 'ERR' bildir. Tüm dosyalar işlendikten sonra, herhangi bir dosyanın yüklenmesi başarısız olduysa, bu betik sıfır olmayan bir çıkış koduyla çıkacaktır.
-f, --flatten Girdi dosyaları kök katmanlar olacak şekilde sahneleri birleştir (flatten).
--flattenLayerStack Verilen kök katmana sahip katman yığınını düzleştir (flatten) ve sonuçları yaz. --flatten seçeneğinin aksine bu seçenek, kompozisyon yaylarını (referanslar gibi) düzleştirmez.
--skipSourceFileComment Eğer --flatten belirtilmişse, çıktı katmanının belgelendirme alanına düzleştirilmiş katmanın kaynağıyla ilgili bir yorum eklemeyi atla.
--mask [PRIMPATH...] Sahne popülasyonunu bu prim'ler, bunların alt öğeleri ve üst öğeleri ile sınırlandır. Birden fazla yol belirtmek için, aralarında boşluk bırakmadan virgül kullanın veya argümanı tırnak içine alıp yolları virgül ve/veya boşluklarla ayırın. --flatten seçeneğini gerektirir.
--layerMetadata USD dosyasında yalnızca katman meta verilerini yükle. Bu seçenek --flatten veya --flattenLayerStack seçenekleriyle birleştirilemez.
--version Program sürüm bilgisini görüntüler ve çıkar.
Notlar
usdcat'e yapılan çoklu dosya girdisi, ayrı dosyalardaki içeriklerin herhangi bir şekilde birleştirilmesini (merge) gerçekleştirmez (ve henüz bunu yapacak böyle bir yardımcı araç yoktur... bu problemi parametrelendirmek ilginç bir meydan okumadır!); yalnızca her dosyanın içeriğini sırasıyla döker.
--flatten seçeneği, bekleneceği üzere tüm kompozisyon işleçlerinin etkilerini "içine işleyen" ve sonuçtaki işleçlerin kendilerini ortadan kaldıran sahne dışa aktarımını (Export) kullanır; bu hem referanslar, alt katmanlar (sublayers) ve varyantlar gibi ad alanı (namespace) işleçleri için hem de katman ve referans zaman kaymaları gibi değer çözünürlüğü işleçleri için geçerlidir. Bir sahneyi düzleştirmek, her prototipi üretilen katmana düzleştirerek ve her örnek (instance) üzerine karşılık gelen prototipine referanslar ekleyerek USD yerel örneklemesini (native instancing) korur. Bu nedenle, dışa aktarılan veriler katılan kaynak dosyalardakinden yapısal olarak farklı görünebilir, ancak kaynak dosyalarındakilerle tamamen aynı şekilde değerlendirilmeli/hesaplanmalıdır.
Örnekler
usdcat input.usd
input.usd içeriğini bir USDA gösterimi olarak görüntüler.
usdcat input.usd --flatten
input.usd içeriğini bir USDA gösterimi olarak görüntüler. Tüm kompozisyon
düzleştirilir.
usdcat input.usda -o output.usdc
input.usda dosyasını output.usdc dosyasına dönüştürür.
USDCAT()