.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH USDTREE "1" "سپتامبر 2026" "usdtree 26.08" "دستورهای کاربری"
.SH "نام (NAME)"
usdtree \- نمایش ساختار درختی یک فایل USD
.SH "خلاصه دستور (SYNOPSIS)"
.B usdtree
[\fI\,OPTIONS\/\fR] \fI\,inputPath\/\fR
.SH "توضیحات (DESCRIPTION)"
دستور \fBusdtree\fR ساختار درختی یک فایل USD را در خروجی می‌نویسد. حالت
پیش‌فرض، بررسی یک فایل USD منفرد است. برای دیدن درخت Stage مسطح‌شده
(یا ترکیب‌شده / composed)، از آرگومان \fB\-\-flatten\fR استفاده کنید.
فراداده‌های (metadata) ویژهٔ \(aqkind\(aq و \(aqactive\(aq در صورت
تعریف‌شدن همواره نمایش داده می‌شوند، مگر آن‌که گزینهٔ \fB\-\-simple\fR مشخص
شده باشد.
.SS "آرگومان‌های موضعی (Positionals):"
.TP
inputPath TEXT REQUIRED
فایل ورودی برای پردازش
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR,\-\-help
نمایش این پیام راهنما و خروج
.TP
\fB\-\-unloaded\fR
عدم بارگذاری payloadها.
.TP
\fB\-a\fR,\-\-attributes
نمایش مشخصه‌های (attributes) تعریف‌شده.
.TP
\fB\-m\fR,\-\-metadata
نمایش فراداده‌های (metadata) تعریف‌شده (active و kind بخشی از برچسب هستند و به عنوان موارد جداگانه نمایش داده نمی‌شوند).
.TP
\fB\-s\fR,\-\-simple
تنها نمایش نام‌های prim: بدون specifier، نوع (kind) یا وضعیت active.
.TP
\fB\-f\fR,\-\-flatten
ترکیب (Compose) استیج با فایل ورودی به عنوان لایهٔ ریشه (root layer) و نوشتن محتوای مسطح‌شده.
.TP
\fB\-\-flattenLayerStack\fR
مسطح‌سازی پشتهٔ لایه‌ها (layer stack) با لایهٔ ریشهٔ داده‌شده. برخلاف \fB\-\-flatten\fR، این گزینه کمان‌های ترکیب (composition arcs، مانند ارجاعات/references) را مسطح نمی‌کند.
.TP
\fB\-\-mask\fR PRIMPATH[,PRIMPATH...]
محدود کردن بارگذاری استیج (stage population) به این primها، فرزندان و نیاکان آن‌ها. برای تعیین چندین مسیر، یا از کاما بدون فاصله استفاده کنید، یا آرگومان را درون علامت نقل‌قول قرار داده و مسیرها را با کاما و/یا فاصله از هم جدا کنید. نیازمند \fB\-\-flatten\fR است.