| USDTREE(1) | دستورهای کاربری | USDTREE(1) |
نام (NAME)
usdtree - نمایش ساختار درختی یک فایل USD
خلاصه دستور (SYNOPSIS)
usdtree [OPTIONS] inputPath
توضیحات (DESCRIPTION)
دستور usdtree ساختار درختی یک فایل USD را در خروجی مینویسد. حالت پیشفرض، بررسی یک فایل USD منفرد است. برای دیدن درخت Stage مسطحشده (یا ترکیبشده / composed)، از آرگومان --flatten استفاده کنید. فرادادههای (metadata) ویژهٔ 'kind' و 'active' در صورت تعریفشدن همواره نمایش داده میشوند، مگر آنکه گزینهٔ --simple مشخص شده باشد.
آرگومانهای موضعی (Positionals):
- inputPath TEXT REQUIRED
- فایل ورودی برای پردازش
گزینهها (OPTIONS)
- -h,--help
- نمایش این پیام راهنما و خروج
- --unloaded
- عدم بارگذاری payloadها.
- -a,--attributes
- نمایش مشخصههای (attributes) تعریفشده.
- -m,--metadata
- نمایش فرادادههای (metadata) تعریفشده (active و kind بخشی از برچسب هستند و به عنوان موارد جداگانه نمایش داده نمیشوند).
- -s,--simple
- تنها نمایش نامهای prim: بدون specifier، نوع (kind) یا وضعیت active.
- -f,--flatten
- ترکیب (Compose) استیج با فایل ورودی به عنوان لایهٔ ریشه (root layer) و نوشتن محتوای مسطحشده.
- --flattenLayerStack
- مسطحسازی پشتهٔ لایهها (layer stack) با لایهٔ ریشهٔ دادهشده. برخلاف --flatten، این گزینه کمانهای ترکیب (composition arcs، مانند ارجاعات/references) را مسطح نمیکند.
- --mask PRIMPATH[,PRIMPATH...]
- محدود کردن بارگذاری استیج (stage population) به این primها، فرزندان و نیاکان آنها. برای تعیین چندین مسیر، یا از کاما بدون فاصله استفاده کنید، یا آرگومان را درون علامت نقلقول قرار داده و مسیرها را با کاما و/یا فاصله از هم جدا کنید. نیازمند --flatten است.
| سپتامبر 2026 | usdtree 26.08 |