.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH USDCAT "1" "سپتامبر 2026" "usdcat 26.08" "دستورهای کاربری"
.SH "نام (NAME)"
usdcat \- چاپ یا تبدیل فایل‌های USD به فرمت متنی یا فایل خروجی مشخص
.SH "خلاصه دستور (SYNOPSIS)"
.B usdcat
[\fI\,OPTIONS\/\fR] \fI\,inputFiles\/\fR...
.SH "توضیحات (DESCRIPTION)"
نوشتن فایل(های) usd به‌صورت متنی در stdout یا در یک فایل خروجی مشخص‌شده.
.SS "آرگومان‌های موضعی (Positionals):"
.TP
inputFiles ...
فهرستی از فایل‌های ورودی
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR,\-\-help
چاپ این پیام راهنما و خروج
.TP
\fB\-o\fR,\-\-out file
نوشتن یک فایل ورودی واحد در این فایل خروجی به‌جای stdout.
.TP
\fB\-\-usdFormat\fR usda|usdc
استفاده از این فرمت فایل پایه‌ای برای فایل‌های خروجی
با پسوند 'usd'. برای مثال، مشخص کردن
\&'\-o output.usd \fB\-\-usdformat\fR usda'
فایل output.usd را به‌صورت یک فایل متنی ایجاد خواهد کرد. متغیر
محیطی USD_DEFAULT_FILE_FORMAT روش دیگری برای رسیدن به این هدف است.
.TP
\fB\-l\fR,\-\-loadOnly
تلاش برای بارگذاری فایل‌های ورودی مشخص‌شده و گزارش 'OK'
یا 'ERR' برای هر کدام. پس از پردازش تمام فایل‌ها، در صورت عدم
موفقیت در بارگذاری هر یک از فایل‌ها، این اسکریپت با یک کد خروج غیرصفر
خارج خواهد شد.
.TP
\fB\-f\fR,\-\-flatten
ترکیب stageها با در نظر گرفتن فایل‌های ورودی به‌عنوان لایه‌های ریشه (root layers)
و نوشتن محتوای یکپارچه‌شده (flattened) آن‌ها.
.TP
\fB\-\-flattenLayerStack\fR
مسطح‌سازی پشته لایه‌ها (layer stack) با لایه ریشه داده‌شده، و
نوشتن نتایج. برخلاف \fB\-\-flatten\fR، این گزینه کمان‌های ترکیبی
(مانند ارجاع‌ها یا references) را یکپارچه نمی‌کند.
.TP
\fB\-\-skipSourceFileComment\fR
در صورت تعیین \fB\-\-flatten\fR، از افزودن یادداشت در رابطه با
منبع لایه مسطح‌شده در فیلد documentation لایه خروجی صرف‌نظر می‌شود.
.TP
\fB\-\-mask\fR PRIMPATH[,PRIMPATH...]
محدود کردن جمعیت stage به این primها، نوادگان و
نیاکان آن‌ها. برای مشخص کردن چندین مسیر، یا از کاما بدون
فاصله استفاده کنید، یا آرگومان را نقل‌قول کرده و مسیرها را با کاما
و/یا فاصله جدا نمایید. نیازمند \fB\-\-flatten\fR است.
.TP
\fB\-\-layerMetadata\fR
بارگذاری تنها فراداده‌های لایه (layer metadata) در فایل USD.
این گزینه نمی‌تواند همراه با \fB\-\-flatten\fR یا
\fB\-\-flattenLayerStack\fR استفاده شود.