USDVIEW(1)                       User Commands                      USDVIEW(1)

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

توضیحات (DESCRIPTION)
       کاربرد: /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

   آرگومان‌های موضعی (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 population) به این primها و نوادگان
              و اجداد آن‌ها. برای مشخص کردن چند مسیر، یا از کاما بدون فاصله
              استفاده کنید یا آرگومان را درون گیومه قرار داده و مسیرها را با
              کاما و/یا فاصله جدا کنید.

       --clearsettings
              بازگرداندن تنظیمات usdview به حالت پیش‌فرض

       --config {}
              بارگذاری usdview با تنظیمات وضعیتی که در config مشخص شده است. در
              صورت عدم تعیین، از وضعیت ذخیره‌شده پیشین برنامه استفاده شده و
              وضعیت به‌طور خودکار هنگام خروج ذخیره می‌شود

       --defaultsettings
              اجرای usdview با تنظیمات پیش‌فرض

       --norender
              نمایش انحصاری مرورگر سلسله‌مراتب (hierarchy browser)

       --noplugins
              عدم بارگذاری پلاگین‌ها

       --unloaded
              عدم بارگذاری بار داده‌ها (payloads)

       --bboxStandin
              نمایش primهای بارگذاری‌نشده با جعبه‌های مرزی (bounding boxes)

       --timing
              چاپ آمار زمان‌بندی در کنسول. نکته: در صورتی که گزینه --memstats
              نیز استفاده شود، زمان‌بندی‌ها غیرقابل اعتماد خواهند بود

       --allow-async
              فعال‌سازی پردازش ناهمگام صحنه در Hydra

       --traceToFile TRACETOFILE
              آغاز ردیابی هنگام راه‌اندازی برنامه و نوشتن خروجی با قالب
              تعیین‌شده توسط --traceFormat در فایل رد مشخص‌شده هنگام بسته‌شدن
              برنامه

       --traceFormat {chrome,trace}
              قالب خروجی برای فایل رد تعیین‌شده با --traceToFile. فایل‌های
              'chrome' در مرورگر Chrome قابل مشاهده هستند، فایل‌های 'trace'
              گزارش‌های متنی ساده‌اند. (پیش‌فرض=chrome)

       --tracePython
              فعال‌سازی جمع‌آوری رد پایتون، نیازمند تنظیم گزینه --traceToFile
              است.

       --memstats {none,stage,stageAndImaging}
              استفاده از سیستم ارزیابی حافظه Pxr MallocTags برای پروفایل USD،
              ذخیره نتایج در یک فایل tmp، همراه با خلاصه‌ای در کنسول. در صورتی
              که MallocTags در نسخه نصب‌شده USD پشتیبانی نشود، هیچ تأثیری
              نخواهد داشت.

       --dumpFirstImage DUMPFIRSTIMAGE
              ذخیره نخستین تصویر تولیدشده در قالب یک فایل (به عنوان png)

       --viewportSize VIEWPORTSIZE
              ثابت نگه‌داشتن اندازه درگاه دید (viewport) بر روی ابعادی مشخص
              (WxH) برای رندر قطعی و تکرارپذیر، مانند 601x458

       --numThreads NUMTHREADS
              تعداد رشته‌های پردازشی (threads) مورد استفاده (۰ بیانگر حداکثر
              است، اعداد منفی بیانگر max - N هستند)

       --ff FIRSTFRAME
              تنظیم فریم نخست نمایشگر

       --lf LASTFRAME
              تنظیم فریم پایانی نمایشگر

       --cf CURRENTFRAME
              تنظیم فریم جاری نمایشگر

       --complexity, -c {low,medium,high,veryhigh}
              تنظیم پیچیدگی اولیه پالایش مش (low).

       --quitAfterStartup
              خروج فوری بلافاصله پس از راه‌اندازی اولیه

       --sessionLayer SESSIONLAYER
              در صورت مشخص شدن، صحنه (stage) به جای لایه ناشناس پیش‌فرض، با
              'sessionLayer' باز خواهد شد. با توجه به اینکه این کار لایه نشست
              را از حالت ناشناس به پایدار تبدیل می‌کند، آگاه باشید که لایه‌های
              ذخیره‌شده از Export Overrides شامل نظرات (opinions) موجود در لایه
              نشست پایدار خواهند بود.

       --mute MUTELAYERSRE
              شناسه‌های لایه‌ای که با این عبارت باقاعده (regex) مطابقت داشته
              باشند، پیش از بارگذاری و پس از آن در صحنه بی‌صدا (mute) خواهند
              شد. چندین عبارت را می‌توان با استفاده از عملگر جداساز | در عبارات
              باقاعده وارد کرد. همچنین می‌توان این آرگومان را چندین بار به کار
              برد.

   لایه‌های جداشده (Detached Layers):
              لایه‌هایی را مشخص می‌کند که باید هنگام بارگذاری از منبع داده‌های
              سریال‌سازی‌شده خود جدا شوند. این عمل ممکن است زمان بارگذاری و مصرف
              حافظه را افزایش دهد، اما از مشکلاتی نظیر اشغال دسته‌های فایل
              (open file handles) که مانع از رونویسی امن یک لایه بارگذاری‌شده
              توسط فرایندهای دیگر می‌شود، جلوگیری خواهد کرد.

       --detachLayers
              جدا کردن تمامی لایه‌ها

       --detachLayersInclude PATTERN[,PATTERN...]
              جدا کردن لایه‌هایی که شناسه‌های آن‌ها شامل هر یک از الگوهای داده‌شده
              باشد.

       --detachLayersExclude PATTERN[,PATTERN,...]
              مستثنی کردن لایه‌هایی با شناسه‌های شامل هر یک از الگوهای داده‌شده،
              از مجموعه لایه‌های جداشده‌ای که با آرگومان‌های --detachLayers یا
              --detachLayerIncludes تعیین شده‌اند.

usdview 26.08                   September 2026                      USDVIEW(1)