| USDRECORD(1) | دستورات کاربر | USDRECORD(1) |
نام (NAME)
usdrecord - تولید و ضبط تصاویر از فایل‌های USD
توضیحات (DESCRIPTION)
usage: usdrecord [-h] [--mask PRIMPATH[,PRIMPATH...]]
- [--purposes PURPOSE[,PURPOSE...]] [--sessionLayer SESSIONLAYER] [--disableGpu] [--disableDrawMode] [--disableCameraLight] [--resolverContext {root,inherit}] [--camera CAMERA] [--defaultTime | --frames FRAMESPEC[,FRAMESPEC...]] [--complexity {low,medium,high,veryhigh}] [--colorCorrectionMode {disabled,sRGB,openColorIO}] [--renderer {Storm,Embree,GL}] [--imageWidth IMAGEWIDTH] [--enableDomeLightVisibility] [--renderPassPrimPath RPPRIMPATH] [--renderSettingsPrimPath RSPRIMPATH] [--traceToFile TRACETOFILE] [--traceFormat {chrome,trace}] [--memstats] [--abortOnError] usdFilePath outputImagePath
تولید تصاویر از یک فایل USD.
آرگومان‌های موضعی (Positional Arguments):
- usdFilePath
- فایل USD برای ضبط و تولید تصویر.
- outputImagePath
- مسیر تصویر خروجی. برای بازه‌های فریم، مسیر باید دقیقاً شامل یک جای‌نگه‌دار شماره فریم به فرم "###" یا "###.###" باشد. توجه داشته باشید که تعداد علامت‌های هش در هر گروه متغیر است.
گزینه‌ها (OPTIONS):
- -h, --help
- نمایش این پیام راهنما و خروج.
- --mask PRIMPATH[,PRIMPATH...]
- محدود کردن بارگذاری استیج به این پریم‌ها، نوادگان و نیاکان آن‌ها. برای تعیین چند مسیر، یا از کاما بدون فاصله استفاده کنید یا آرگومان را داخل نقل‌قول قرار داده و مسیرها را با کاما و/یا فاصله جدا کنید.
- --purposes PURPOSE[,PURPOSE...]
- مشخص کردن اینکه کدام اهداف (purposes) مربوط به UsdGeomImageable باید در رندرها گنجانده شوند. هدف "default" به‌طور خودکار لحاظ می‌شود، بنابراین تنها نیاز است اهداف *اضافی* را مشخص کنید. اگر بیش از یک هدف اضافی می‌خواهید، یا از کاما بدون فاصله استفاده کنید یا آرگومان را داخل نقل‌قول قرار داده و اهداف را با کاما و/یا فاصله جدا کنید.
- --sessionLayer SESSIONLAYER
- در صورت تعیین، استیج به‌جای لایه ناشناس (anonymous layer) پیش‌فرض، با 'sessionLayer' باز خواهد شد.
- --disableGpu
- مشخص می‌کند که پردازنده گرافیکی (GPU) نباید برای رندر استفاده شود. در صورت تنظیم، این گزینه نه‌تنها موتورهای رندر را به مواردی که منحصراً روی CPU اجرا می‌شوند محدود می‌کند، بلکه از اجرای هر وظیفه‌ای که نیاز به GPU داشته باشد نیز جلوگیری می‌نماید.
- --disableDrawMode
- غیرفعال کردن پشتیبانی از حالت‌های رسم (draw modes) در USD. در صورت تنظیم، حالت‌های رسم UsdGeomModelAPI نادیده گرفته می‌شوند و هیچ هندسه‌ای با مدل جانشین (standin) حالت رسم جایگزین نخواهد شد. همه‌چیز به‌گونه‌ای رندر می‌شود که گویی applyDrawMode = false است.
- --disableCameraLight
- مشخص می‌کند که نورهای پیش‌فرض دوربین نباید برای رندر استفاده شوند.
- --resolverContext {root,inherit}
- مشخص می‌کند که از کدام بافت تفکیک‌کننده (resolver context) استفاده شود. انتخاب "root" یک تفکیک‌کننده بر پایه rootLayer ایجاد می‌کند. انتخاب "inherit" تفکیک‌کننده ورودی را از محیط به ارث می‌برد.
- --camera, -cam CAMERA
- تعیین دوربینی که باید استفاده شود - می‌تواند تنها به‌صورت نام پریم دوربین (یعنی فقط آخرین جزء در مسیر پریم) یا به‌صورت یک مسیر کامل پریم مشخص شود. توجه داشته باشید که اگر تنها از نام پریم استفاده شود و بیش از یک دوربین با آن نام وجود داشته باشد، دوربین انتخاب‌شده عملاً تصادفی خواهد بود (پیش‌فرض: None).
- --defaultTime, -d
- اجرای صریح در کد زمانی پیش‌فرض (Default time code)؛ رفتار پیش‌فرض این است که روی startTimeCode ثبت‌شده در UsdStage اجرا شود که مقدار پیش‌فرض آن 0.0 است.
- --frames, -f FRAMESPEC[,FRAMESPEC...]
- مشخص کردن FrameSpec(های) کدهای زمانی برای پردازش - یک FrameSpec شامل حداکثر سه مقدار ممیز شناور برای کد زمانی شروع، کد زمانی پایان، و گام (stride) بازه زمانی است. می‌توان یک کد زمانی منفرد را مشخص کرد، یا کدهای زمانی شروع و پایان را که با دونقطه (:) جدا شده‌اند تعیین نمود. هنگامی که کدهای زمانی شروع و پایان مشخص شدند، گام نیز می‌تواند به‌صورت اختیاری با جدا شدن توسط (x) از کدهای زمانی شروع و پایان مشخص گردد. چندین FrameSpec را می‌توان به‌صورت فهرستی جداشده با کاما ترکیب کرد. نمونه‌هایی از FrameSpecهای معتبر عبارتند از: 123 - 101:105 - 105:101 - 101:109x2 - 101:110x2 - 101:104x0.5
- --complexity, -c {low,medium,high,veryhigh}
- سطح جزئیات و پالایش هندسه (refinement) برای استفاده (پیش‌فرض: low).
- --colorCorrectionMode, -color {disabled,sRGB,openColorIO}
- حالت تصحیح رنگ مورد استفاده (پیش‌فرض: sRGB).
- --renderer, -r {Storm,Embree,GL}
- پلاگین رندر هیدرا (Hydra) برای استفاده هنگام تولید تصاویر. در حال حاضر "GL" و "Storm" نام‌های مستعار یک موتور رندر یکسان، یعنی Storm هستند.
- --imageWidth, -w IMAGEWIDTH
- عرض تصویر خروجی. ارتفاع بر اساس این مقدار و نسبت ابعاد (aspect ratio) دوربین محاسبه خواهد شد (پیش‌فرض: 960). توجه داشته باشید که این گزینه فقط بر تصویر خروجی خط فرمان اثر می‌گذارد و بر هیچ‌یک از محصولات رندر (render products) در توصیف صحنه تأثیری ندارد.
- --enableDomeLightVisibility
- نمایش پس‌زمینه نور گنبدی (dome light) در خروجی رندرشده. اگر این گزینه درج نشود و یک نور گنبدی در استیج وجود داشته باشد، نورپردازی مبتنی بر تصویر (IBL) آن برای روشنایی استفاده می‌شود اما در پس‌زمینه رسم نخواهد شد.
- --renderPassPrimPath, -rp RPPRIMPATH
- مشخص کردن پریم RenderPass برای استفاده. این گزینه هرگونه renderSettingsPrimPath تعیین‌شده در متادیتای استیج را بازنویسی می‌کند.
- --renderSettingsPrimPath, -rs RSPRIMPATH
- مشخص کردن پریم RenderSettings برای استفاده. این گزینه هرگونه renderSettingsPrimPath تعیین‌شده در متادیتای استیج را بازنویسی می‌کند.
- --traceToFile TRACETOFILE
- شروع ردیابی (tracing) همزمان با راه‌اندازی برنامه و نوشتن خروجی با فرمت تعیین‌شده در --traceFormat در فایل رد مشخص‌شده هنگام خروج برنامه.
- --traceFormat {chrome,trace}
- فرمت خروجی برای فایل ردیابی مشخص‌شده توسط --traceToFile. فایل‌های 'chrome' در مرورگر کروم قابل خواندن هستند و فایل‌های 'trace' گزارش‌های متنی ساده می‌باشند (پیش‌فرض: chrome).
- --memstats
- استفاده از سیستم حسابرسی حافظه Pxr MallocTags برای پروفایل USD، ذخیره نتایج در یک فایل موقت (tmp)، همراه با خلاصه در کنسول. اگر MallocTags در نسخه نصب‌شده USD پشتیبانی نشود، هیچ اثری نخواهد داشت.
- --abortOnError
- لغو ضبط و بازگرداندن کد خروج غیرصفر در صورتی که در حین رندر، خطای Tf رخ دهد.
| September 2026 | usdrecord 26.08 |