.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH USDVIEW "1" "September 2026" "usdview 26.08" "User Commands"
.SH "نام (NAME)"
usdview \- ابزار مشاهده و بازبینی فایل‌های USD
.SH "توضیحات (DESCRIPTION)"
کاربرد: \fI\,/build/usd/pkg/usd/usr/bin/usdview\/\fP [\-h] [\-\-renderer {Storm,Embree,GL}]
.TP
[\-\-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]
.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 population) به این primها و نوادگان و اجداد آن‌ها. برای مشخص کردن چند مسیر، یا از کاما بدون فاصله استفاده کنید یا آرگومان را درون گیومه قرار داده و مسیرها را با کاما و/یا فاصله جدا کنید.
.TP
\fB\-\-clearsettings\fR
بازگرداندن تنظیمات usdview به حالت پیش‌فرض
.TP
\fB\-\-config\fR {}
بارگذاری usdview با تنظیمات وضعیتی که در config مشخص شده است. در صورت عدم تعیین، از وضعیت ذخیره‌شده پیشین برنامه استفاده شده و وضعیت به‌طور خودکار هنگام خروج ذخیره می‌شود
.TP
\fB\-\-defaultsettings\fR
اجرای usdview با تنظیمات پیش‌فرض
.TP
\fB\-\-norender\fR
نمایش انحصاری مرورگر سلسله‌مراتب (hierarchy browser)
.TP
\fB\-\-noplugins\fR
عدم بارگذاری پلاگین‌ها
.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
آغاز ردیابی هنگام راه‌اندازی برنامه و نوشتن خروجی با قالب تعیین‌شده توسط \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
ذخیره نخستین تصویر تولیدشده در قالب یک فایل (به عنوان 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}
تنظیم پیچیدگی اولیه پالایش مش (low).
.TP
\fB\-\-quitAfterStartup\fR
خروج فوری بلافاصله پس از راه‌اندازی اولیه
.TP
\fB\-\-sessionLayer\fR SESSIONLAYER
در صورت مشخص شدن، صحنه (stage) به جای لایه ناشناس پیش‌فرض، با \&'sessionLayer' باز خواهد شد. با توجه به اینکه این کار لایه نشست را از حالت ناشناس به پایدار تبدیل می‌کند، آگاه باشید که لایه‌های ذخیره‌شده از Export Overrides شامل نظرات (opinions) موجود در لایه نشست پایدار خواهند بود.
.TP
\fB\-\-mute\fR MUTELAYERSRE
شناسه‌های لایه‌ای که با این عبارت باقاعده (regex) مطابقت داشته باشند، پیش از بارگذاری و پس از آن در صحنه بی‌صدا (mute) خواهند شد. چندین عبارت را می‌توان با استفاده از عملگر جداساز | در عبارات باقاعده وارد کرد. همچنین می‌توان این آرگومان را چندین بار به کار برد.
.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\-\-detachLayerIncludes\fR تعیین شده‌اند.