$ usdcat

Özet

usdcat [girdiDosyalari]

Açıklama

usdcat, girdi dosyalarının içeriğini desteklenen diğer biçimlere dönüştürmek veya bunları stdout üzerine 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ı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

input.usd içeriğini USDA gösterimi olarak görüntülemek:

usdcat input.usd

Kompozisyonu düzleştirerek görüntülemek:

usdcat input.usd --flatten

input.usda dosyasını output.usdc dosyasına dönüştürmek:

usdcat input.usda -o output.usdc

USDCAT()