| 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 تعیین شدهاند.
| September 2026 | usdview 26.08 |