USDVIEW(1) User Commands USDVIEW(1)

usdview - ابزار مشاهده و بازبینی فایل‌های USD

کاربرد: /build/usd/pkg/usd/usr/bin/usdview [-h] [--renderer {Storm,Embree,GL}]

[--select PRIMPATH]
[--camera CAMERA] [--mask PRIMPATH[,PRIMPATH...]] [--clearsettings] [--config {}] [--defaultsettings] [--norender] [--noplugins] [--unloaded] [--bboxStandin] [--timing] [--allow-async] [--traceToFile TRACETOFILE] [--traceFormat {chrome,trace}] [--tracePython] [--memstats {none,stage,stageAndImaging}] [--dumpFirstImage DUMPFIRSTIMAGE] [--viewportSize VIEWPORTSIZE] [--numThreads NUMTHREADS] [--ff FIRSTFRAME] [--lf LASTFRAME] [--cf CURRENTFRAME] [--complexity {low,medium,high,veryhigh}] [--quitAfterStartup] [--sessionLayer SESSIONLAYER] [--mute MUTELAYERSRE] [--detachLayers] [--detachLayersInclude PATTERN[,PATTERN...]] [--detachLayersExclude PATTERN[,PATTERN,...]] [usdFile]

نمایش یک فایل USD

فایل مورد نظر برای نمایش (اختیاری)

نمایش این پیام راهنما و خروج
انتخاب زیرساخت رندر مورد استفاده (همان‌گونه که نام آن در منو نمایش می‌یابد). در حال حاضر 'GL' و 'Storm' نام‌های مستعار یک رندرکننده یکسان، یعنی Storm هستند.
مسیر prim برای انتخاب اولیه و قاب‌بندی (frame) روی آن
دوربینی که نما هنگام باز شدن روی آن تنظیم می‌شود - می‌تواند تنها با نام prim دوربین (یعنی فقط بخش انتهایی مسیر prim) یا به صورت مسیر کامل prim مشخص شود. توجه داشته باشید که اگر تنها از نام prim استفاده شود و بیش از یک دوربین با آن نام موجود باشد، انتخاب دوربین عملاً تصادفی خواهد بود (پیش‌فرض=None)
محدود کردن گستره صحنه (stage population) به این primها و نوادگان و اجداد آن‌ها. برای مشخص کردن چند مسیر، یا از کاما بدون فاصله استفاده کنید یا آرگومان را درون گیومه قرار داده و مسیرها را با کاما و/یا فاصله جدا کنید.
بازگرداندن تنظیمات usdview به حالت پیش‌فرض
بارگذاری usdview با تنظیمات وضعیتی که در config مشخص شده است. در صورت عدم تعیین، از وضعیت ذخیره‌شده پیشین برنامه استفاده شده و وضعیت به‌طور خودکار هنگام خروج ذخیره می‌شود
اجرای usdview با تنظیمات پیش‌فرض
نمایش انحصاری مرورگر سلسله‌مراتب (hierarchy browser)
عدم بارگذاری پلاگین‌ها
عدم بارگذاری بار داده‌ها (payloads)
نمایش primهای بارگذاری‌نشده با جعبه‌های مرزی (bounding boxes)
چاپ آمار زمان‌بندی در کنسول. نکته: در صورتی که گزینه --memstats نیز استفاده شود، زمان‌بندی‌ها غیرقابل اعتماد خواهند بود
فعال‌سازی پردازش ناهمگام صحنه در Hydra
آغاز ردیابی هنگام راه‌اندازی برنامه و نوشتن خروجی با قالب تعیین‌شده توسط --traceFormat در فایل رد مشخص‌شده هنگام بسته‌شدن برنامه
قالب خروجی برای فایل رد تعیین‌شده با --traceToFile. فایل‌های 'chrome' در مرورگر Chrome قابل مشاهده هستند، فایل‌های 'trace' گزارش‌های متنی ساده‌اند. (پیش‌فرض=chrome)
فعال‌سازی جمع‌آوری رد پایتون، نیازمند تنظیم گزینه --traceToFile است.
استفاده از سیستم ارزیابی حافظه Pxr MallocTags برای پروفایل USD، ذخیره نتایج در یک فایل tmp، همراه با خلاصه‌ای در کنسول. در صورتی که MallocTags در نسخه نصب‌شده USD پشتیبانی نشود، هیچ تأثیری نخواهد داشت.
ذخیره نخستین تصویر تولیدشده در قالب یک فایل (به عنوان png)
ثابت نگه‌داشتن اندازه درگاه دید (viewport) بر روی ابعادی مشخص (WxH) برای رندر قطعی و تکرارپذیر، مانند 601x458
تعداد رشته‌های پردازشی (threads) مورد استفاده (۰ بیانگر حداکثر است، اعداد منفی بیانگر max - N هستند)
تنظیم فریم نخست نمایشگر
تنظیم فریم پایانی نمایشگر
تنظیم فریم جاری نمایشگر
تنظیم پیچیدگی اولیه پالایش مش (low).
خروج فوری بلافاصله پس از راه‌اندازی اولیه
در صورت مشخص شدن، صحنه (stage) به جای لایه ناشناس پیش‌فرض، با 'sessionLayer' باز خواهد شد. با توجه به اینکه این کار لایه نشست را از حالت ناشناس به پایدار تبدیل می‌کند، آگاه باشید که لایه‌های ذخیره‌شده از Export Overrides شامل نظرات (opinions) موجود در لایه نشست پایدار خواهند بود.
شناسه‌های لایه‌ای که با این عبارت باقاعده (regex) مطابقت داشته باشند، پیش از بارگذاری و پس از آن در صحنه بی‌صدا (mute) خواهند شد. چندین عبارت را می‌توان با استفاده از عملگر جداساز | در عبارات باقاعده وارد کرد. همچنین می‌توان این آرگومان را چندین بار به کار برد.

لایه‌هایی را مشخص می‌کند که باید هنگام بارگذاری از منبع داده‌های سریال‌سازی‌شده خود جدا شوند. این عمل ممکن است زمان بارگذاری و مصرف حافظه را افزایش دهد، اما از مشکلاتی نظیر اشغال دسته‌های فایل (open file handles) که مانع از رونویسی امن یک لایه بارگذاری‌شده توسط فرایندهای دیگر می‌شود، جلوگیری خواهد کرد.
جدا کردن تمامی لایه‌ها
جدا کردن لایه‌هایی که شناسه‌های آن‌ها شامل هر یک از الگوهای داده‌شده باشد.
مستثنی کردن لایه‌هایی با شناسه‌های شامل هر یک از الگوهای داده‌شده، از مجموعه لایه‌های جداشده‌ای که با آرگومان‌های --detachLayers یا --detachLayerIncludes تعیین شده‌اند.
September 2026 usdview 26.08