TESTUSDVIEW(1) User Commands TESTUSDVIEW(1)

testusdview - برگه راهنمای ابزار testusdview نسخه 26.08

کاربرد: /build/usd/pkg/usd/usr/bin/testusdview [-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,...]] --testScript TESTSCRIPT [usdFile]

مشاهده یک فایل usd

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

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

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