| TESTUSDVIEW(1) | User Commands | TESTUSDVIEW(1) |
نام (NAME)
testusdview - برگه راهنمای ابزار testusdview نسخه 26.08
توضیحات (DESCRIPTION)
کاربرد: /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
آرگومانهای موضعی (POSITIONAL ARGUMENTS):
- usdFile
- فایل مورد نظر برای مشاهده (اختیاری)
گزینهها (OPTIONS):
- -h, --help
- نمایش این پیام راهنما و خروج
- --renderer, -r {Storm,Embree,GL}
- بکاند رندر مورد استفاده (همانطور که در منو نامگذاری شده است). در حال حاضر 'GL' و 'Storm' نامهای مستعاری برای رندرکننده یکسان، یعنی Storm هستند.
- --select PRIMPATH
- یک مسیر prim برای انتخاب اولیه و کادربندی (frame)
- --camera, -cam CAMERA
- دوربینی که نما هنگام باز شدن روی آن تنظیم میشود - میتواند تنها به صورت نام prim دوربین (یعنی فقط آخرین بخش در مسیر prim) یا به عنوان یک مسیر کامل prim مشخص شود. توجه داشته باشید که اگر تنها از نام prim استفاده شود و بیش از یک دوربین با آن نام وجود داشته باشد، دوربینی که استفاده میشود عملاً تصادفی خواهد بود (پیشفرض=None)
- --mask PRIMPATH[,PRIMPATH...]
- محدود کردن بارگذاری stage به این primها، فرزندان و نیاکان آنها. برای مشخص کردن چند مسیر، یا از کاما بدون فاصله استفاده کنید یا آرگومان را داخل علامت نقلقول قرار داده و مسیرها را با کاما و/یا فاصله از هم جدا کنید.
- --clearsettings
- بازگردانی تنظیمات usdview به مقادیر پیشفرض
- --config {}
- بارگذاری usdview با تنظیمات وضعیتِ موجود در پیکربندی مشخصشده. اگر ارائه نشود، از وضعیت ذخیرهشده قبلی برنامه استفاده میشود و هنگام بسته شدن، وضعیت به صورت خودکار ذخیره خواهد شد
- --defaultsettings
- راهاندازی usdview با تنظیمات پیشفرض
- --norender
- نمایشِ صرف مرورگر سلسلهمراتب (hierarchy browser)
- --noplugins
- عدم بارگذاری افزونهها (plugins)
- --unloaded
- عدم بارگذاری بار دادهها (payloads)
- --bboxStandin
- نمایش primهای بارگذارینشده با جعبههای مرزی (bounding boxes)
- --timing
- چاپ آمار زمانبندی در کنسول. نکته: زمانبندیها هنگام استفاده همزمان از گزینه --memstats غیرقابل اعتماد خواهند بود
- --allow-async
- فعالسازی پردازش ناهمگام صحنه Hydra
- --traceToFile TRACETOFILE
- شروع ردگیری (tracing) در زمان راهاندازی برنامه و نوشتن خروجی با قالب مشخصشده توسط --traceFormat در فایل ردگیری مشخصشده هنگام خروج از برنامه
- --traceFormat {chrome,trace}
- قالب خروجی برای فایل ردگیری مشخصشده توسط --traceToFile. فایلهای 'chrome' در مرورگر Chrome قابل مشاهده هستند، و فایلهای 'trace' گزارشهای متنی ساده هستند. (پیشفرض=chrome)
- --tracePython
- فعالسازی جمعآوری ردگیری پایتون؛ نیازمند تنظیم بودن --traceToFile است.
- --memstats {none,stage,stageAndImaging}
- استفاده از سامانه تحلیل حافظه Pxr MallocTags برای پروفایل USD، ذخیره نتایج در یک فایل tmp، همراه با خلاصه در کنسول. در صورتی که MallocTags در نسخه نصبشده USD پشتیبانی نشود، هیچ اثری نخواهد داشت.
- --dumpFirstImage DUMPFIRSTIMAGE
- ذخیره (dump) نخستین تصویر در یک فایل (به صورت png)
- --viewportSize VIEWPORTSIZE
- تثبیت اندازه درگاه دید (viewport) بر روی اندازه مشخص (WxH) برای رندر قطعی و تکرارپذیر، مانند 601x458
- --numThreads NUMTHREADS
- تعداد رشتههای (threads) استفادهشده برای پردازش (۰ حداکثر است، اعداد منفی بیانگر max - N هستند)
- --ff FIRSTFRAME
- تنظیم فریم نخست نمایشگر
- --lf LASTFRAME
- تنظیم فریم پایانی نمایشگر
- --cf CURRENTFRAME
- تنظیم فریم فعلی نمایشگر
- --complexity, -c {low,medium,high,veryhigh}
- تنظیم پیچیدگی اولیه پالایش مش (mesh refinement) (پیشفرض: low).
- --quitAfterStartup
- خروج فوری پس از راهاندازی
- --sessionLayer SESSIONLAYER
- در صورت مشخص شدن، stage با 'sessionLayer' به جای لایه ناشناس (anonymous) پیشفرض باز خواهد شد. از آنجا که این کار لایه نشست را از ناشناس به ماندگار (persistent) تغییر میدهد، توجه داشته باشید لایههایی که از طریق Export Overrides ذخیره میشوند شامل نظرات (opinions) موجود در لایه نشست ماندگار خواهند بود.
- --mute MUTELAYERSRE
- شناسههای لایهای که با این عبارت باقاعده مطابقت داشته باشند، قبل و بعد از بارگذاری در stage بیصدا (mute) خواهند شد. با استفاده از عملگر جداکننده | در عبارتهای باقاعده میتوان چندین عبارت را تعیین کرد. همچنین میتوان این آرگومان را چندین بار به کار برد.
- --testScript TESTSCRIPT
- اسکریپت آزمایشی برای اجرا پس از بارگذاری. این اسکریپت باید انتظار دریافت یک آرگومان تنها را داشته باشد
لایههای جداشده (DETACHED LAYERS):
- مشخص کردن لایههایی که هنگام بارگذاری، از منبع دادههای سریالسازیشدهشان جدا میشوند. این ممکن است زمان بارگذاری و میزان مصرف حافظه را افزایش دهد، اما از مشکلاتی نظیر جلوگیری دستگیرههای باز فایل (open file handles) از بازنویسی امن لایه بارگذاریشده توسط دیگر فرایندها جلوگیری میکند.
- --detachLayers
- جدا کردن تمام لایهها
- --detachLayersInclude PATTERN[,PATTERN...]
- جدا کردن لایههایی که شناسه آنها شامل هر یک از الگوهای ارائهشده باشد.
- --detachLayersExclude PATTERN[,PATTERN,...]
- مستثنی کردن لایههایی که شناسه آنها شامل هر یک از الگوهای ارائهشده است از مجموعه لایههای جداشده که توسط آرگومانهای --detachLayers یا --detachLayersInclude مشخص شدهاند.
| September 2026 | testusdview 26.08 |