نام (NAME)

usdcat - چاپ یا تبدیل فایل‌های USD به فرمت متنی یا فایل خروجی مشخص

خلاصه دستور (SYNOPSIS)

usdcat [OPTIONS] inputFiles...

توضیحات (DESCRIPTION)

نوشتن فایل(های) usd به‌صورت متنی در stdout یا در یک فایل خروجی مشخص‌شده.

گزینه‌ها (OPTIONS)

-h,--help

چاپ این پیام راهنما و خروج

-o,--out file

نوشتن یک فایل ورودی واحد در این فایل خروجی به‌جای stdout.

--usdFormat usda|usdc

استفاده از این فرمت فایل پایه‌ای برای فایل‌های خروجی با پسوند 'usd'. برای مثال، مشخص کردن '-o output.usd --usdformat usda' فایل output.usd را به‌صورت یک فایل متنی ایجاد خواهد کرد. متغیر محیطی USD_DEFAULT_FILE_FORMAT روش دیگری برای رسیدن به این هدف است.

-l,--loadOnly

تلاش برای بارگذاری فایل‌های ورودی مشخص‌شده و گزارش 'OK' یا 'ERR' برای هر کدام. پس از پردازش تمام فایل‌ها، در صورت عدم موفقیت در بارگذاری هر یک از فایل‌ها، این اسکریپت با یک کد خروج غیرصفر خارج خواهد شد.

-f,--flatten

ترکیب stageها با در نظر گرفتن فایل‌های ورودی به‌عنوان لایه‌های ریشه (root layers) و نوشتن محتوای یکپارچه‌شده (flattened) آن‌ها.

--flattenLayerStack

مسطح‌سازی پشته لایه‌ها (layer stack) با لایه ریشه داده‌شده، و نوشتن نتایج. برخلاف --flatten، این گزینه کمان‌های ترکیبی (مانند ارجاع‌ها یا references) را یکپارچه نمی‌کند.

--skipSourceFileComment

در صورت تعیین --flatten، از افزودن یادداشت در رابطه با منبع لایه مسطح‌شده در فیلد documentation لایه خروجی صرف‌نظر می‌شود.

--mask PRIMPATH[,PRIMPATH...]

محدود کردن جمعیت stage به این primها، نوادگان و نیاکان آن‌ها. برای مشخص کردن چندین مسیر، یا از کاما بدون فاصله استفاده کنید، یا آرگومان را نقل‌قول کرده و مسیرها را با کاما و/یا فاصله جدا نمایید. نیازمند --flatten است.

--layerMetadata

بارگذاری تنها فراداده‌های لایه (layer metadata) در فایل USD. این گزینه نمی‌تواند همراه با --flatten یا --flattenLayerStack استفاده شود.