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