.TH "pw-cat" 1 "1.6.8" "PipeWire" \" -*- nroff -*-
.ad l
.nh
.SH "نام (NAME)"
pw-cat \- پخش و ضبط رسانه با PipeWire

.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP

.PP
\fBpw-cat\fP [\fIoptions\fP] [\fIFILE\fP | -]

.PP
\fBpw-play\fP [\fIoptions\fP] [\fIFILE\fP | -]

.PP
\fBpw-record\fP [\fIoptions\fP] [\fIFILE\fP | -]

.PP
\fBpw-midiplay\fP [\fIoptions\fP] [\fIFILE\fP | -]

.PP
\fBpw-midirecord\fP [\fIoptions\fP] [\fIFILE\fP | -]

.PP
\fBpw-midi2play\fP [\fIoptions\fP] [\fIFILE\fP | -]

.PP
\fBpw-midi2record\fP [\fIoptions\fP] [\fIFILE\fP | -]

.PP
\fBpw-dsdplay\fP [\fIoptions\fP] [\fIFILE\fP | -]

.PP
.SH "توضیحات (DESCRIPTION)"
.PP

.PP
دستور \fBpw-cat\fP ابزاری ساده برای بازپخش یا دریافت فایل‌های رسانه‌ای خام یا کدگذاری‌شده روی یک کارساز PipeWire است\&. این ابزار تمام قالب‌های فایل صوتی پشتیبانی‌شده توسط \fRlibsndfile\fP را برای دریافت و پخش PCM درک می‌کند\&. هنگامی که هیچ ظرفی (container) برای ضبط PCM مشخص نشده باشد، از پسوند نام فایل برای حدس زدن قالب فایل با پیش‌فرض قالب فایل WAV استفاده می‌شود\&.

.PP
این ابزار فایل‌های استاندارد MIDI و فایل‌های کلیپ MIDI 2\&.0 را برای پخش و ضبط درک می‌کند\&. این ابزار فایل‌های MIDI را رندر (پردازش صوتی) نمی‌کند، بلکه صرفاً رخدادهای MIDI را در دسترس گراف قرار می‌دهد\&. برای شنیدن صدای MIDI، به یک رندرکنندهٔ MIDI مانند qsynth، timidity یا یک رندرکنندهٔ سخت‌افزاری MIDI نیاز دارید\&.

.PP
پخش DSD با قالب فایل DSF پشتیبانی می‌شود\&. این ابزار تنها با سخت‌افزارهایی که ذاتا دارای قابلیت DSD هستند کار خواهد کرد و در صورتی که چنین سخت‌افزاری یافت نشود، خطایی تولید خواهد کرد\&.

.PP
هنگامی که مقدار \fIFILE\fP برابر - باشد، ورودی از STDIN خواهد بود\&. اگر هیچ قالبی مشخص نشده باشد، libsndfile تلاش خواهد کرد قالب را از STDIN تجزیه کرده و جریان‌بندی کند\&. برای برخی قالب‌ها این کار امکان‌پذیر نیست و libsndfile خطایی صادر خواهد کرد\&. قالب‌های Raw، MIDI و DSD همگی از STDIN قابل جریان‌بندی هستند\&.

.PP
هنگامی که مقدار \fIFILE\fP برابر - باشد، خروجی به STDOUT خواهد بود\&. اگر هیچ قالبی مشخص نشده باشد، به libsndfile دستور داده می‌شود که خروجی را در قالب \&.au تولید کند که قابلیت جریان‌بندی دارد و قالب، نرخ نمونه‌برداری و کانال‌ها را حفظ می‌کند\&. قالب‌های Raw و DSD همگی به STDOUT قابل جریان‌بندی هستند\&.

.PP
.SH "گزینه‌ها (OPTIONS)"
.PP

.PP
\fB-h | --help\fP
.RS 4
نمایش راهنما\&.
.RE
.PP
\fB--version\fP
.RS 4
نمایش اطلاعات نسخه\&.
.RE
.PP
\fB-v | --verbose\fP
.RS 4
عملیات با گزارش جزئیات کامل\&.
.RE
.PP
\fB-R | --remote=NAME\fP
.RS 4
نام نمونهٔ \fIremote\fP برای اتصال\&. در صورت نامشخص بودن، اتصال به نمونهٔ پیش‌فرض PipeWire برقرار می‌شود\&.
.RE
.PP
\fB-p | --playback\fP
.RS 4
حالت پخش\&. خواندن داده از فایل مشخص‌شده و پخش آن\&. اگر این ابزار تحت نام‌های \fBpw-play\fP، \fBpw-midiplay\fP یا \fBpw-midi2play\fP فراخوانی شود، این حالت پیش‌فرض است\&.
.RE
.PP
\fB-r | --record\fP
.RS 4
حالت ضبط\&. دریافت داده و نوشتن آن در فایل مشخص‌شده\&. اگر این ابزار تحت نام‌های \fBpw-record\fP، \fBpw-midirecord\fP یا \fBpw-midi2record\fP فراخوانی شود، این حالت پیش‌فرض است\&.
.RE
.PP
\fB-m | --midi\fP
.RS 4
حالت MIDI\&. مقدار \fIFILE\fP یک فایل MIDI است\&. اگر این ابزار تحت نام‌های \fBpw-midiplay\fP یا \fBpw-midirecord\fP فراخوانی شود، این حالت پیش‌فرض است\&. توجه داشته باشید که این برنامه رخدادهای MIDI را به نمونه‌های صوتی قابل شنیدن تبدیل \fIنمی‌کند\fP، بلکه صرفاً رخدادهای MIDI را در گراف فراهم می‌سازد\&. برای شنیدن صدای MIDI به یک رندرکنندهٔ جداگانه مانند qsynth، timidity یا یک رندرکنندهٔ سخت‌افزاری نیاز دارید\&.
.RE
.PP
\fB-c | --midi-clip\fP
.RS 4
حالت کلیپ MIDI 2\&.0\&. مقدار \fIFILE\fP یک فایل کلیپ MIDI 2\&.0 است\&. اگر این ابزار تحت نام‌های \fBpw-midi2play\fP یا \fBpw-midi2record\fP فراخوانی شود، این حالت پیش‌فرض است\&. توجه داشته باشید که این برنامه رخدادهای MIDI را به نمونه‌های صوتی قابل شنیدن تبدیل \fIنمی‌کند\fP، بلکه صرفاً رخدادهای MIDI را در گراف فراهم می‌سازد\&. برای شنیدن صدای MIDI به یک رندرکنندهٔ جداگانه مانند qsynth، timidity یا یک رندرکنندهٔ سخت‌افزاری نیاز دارید\&.
.RE
.PP
\fB-d | --dsd\fP
.RS 4
حالت DSD\&. مقدار \fIFILE\fP یک فایل DSF است\&. اگر این ابزار تحت نام \fBpw-dsdplay\fP فراخوانی شود، این حالت پیش‌فرض است\&. توجه داشته باشید که این برنامه صدای DSD را تبدیل (رندر) \fIنمی‌کند\fP\&. برای پخش محتوای DSD به دستگاهی با قابلیت پشتیبانی از DSD نیاز دارید، در غیر این صورت این برنامه با یک خطا خارج خواهد شد\&.
.RE
.PP
\fB-s | --sysex\fP
.RS 4
حالت SysEx\&. مقدار \fIFILE\fP فایلی است که شامل یک پیام خام SysEx MIDI می‌باشد\&. اگر این ابزار تحت نام \fBpw-sysex\fP فراخوانی شود، این حالت پیش‌فرض است\&. این فایل خوانده شده و به عنوان یک پیام کنترلی MIDI به گراف ارسال می‌شود\&.
.RE
.PP
\fB--media-type=VALUE\fP
.RS 4
تنظیم ویژگی نوع رسانه (پیش‌فرض بسته به حالت Audio/Midi است)\&. نوع رسانه توسط مدیر نشست برای انتخاب یک هدف مناسب جهت پیوند به کار می‌رود\&.
.RE
.PP
\fB--media-category=VALUE\fP
.RS 4
تنظیم ویژگی دسته‌بندی رسانه (پیش‌فرض بسته به حالت Playback/Capture است)\&. نوع رسانه توسط مدیر نشست برای انتخاب یک هدف مناسب جهت پیوند استفاده می‌شود\&.
.RE
.PP
\fB--media-role=VALUE\fP
.RS 4
تنظیم ویژگی نقش رسانه (پیش‌فرض Music است)\&. نوع رسانه توسط مدیر نشست برای انتخاب یک هدف مناسب جهت پیوند استفاده می‌شود\&.
.RE
.PP
\fB--target=VALUE\fP
.RS 4
تنظیم هدف گره (پیش‌فرض auto است)\&. این مقدار می‌تواند موارد زیر باشد:

.PP
.IP "\(bu" 2
\fBauto\fP: انتخاب خودکار (پیش‌فرض)
.IP "\(bu" 2
\fB0\fP: برای پیوند دادن این گره تلاش نکن
.IP "\(bu" 2
\fB<id>\fP: شناسهٔ object\&.serial یا node\&.name مربوط به گره هدف
.PP
.RE
.PP

.PP
\fB--latency=VALUE[\fIunits\fP]\fP
.RS 4
تنظیم میزان تاخیر گره (پیش‌فرض 100ms است)

.PP
میزان تاخیر حداقل زمانی را تعیین می‌کند که طول می‌کشد تا یک نمونه از برنامه به دستگاه (پخش) و از دستگاه به برنامه (ضبط) منتقل شود\&.

.PP
تاخیر، اندازهٔ بافرهایی را مشخص می‌کند که برنامه قادر به پر کردن آن‌ها خواهد بود\&. تاخیر کمتر به معنای بافرهای کوچک‌تر اما بار پردازشی بیشتر است\&. تاخیر بیشتر به معنای بافرهای بزرگ‌تر و بار پردازشی کمتر است\&.

.PP
واحدها می‌توانند \fBs\fP برای ثانیه، \fBms\fP برای میلی‌ثانیه، \fBus\fP برای میکروثانیه و \fBns\fP برای نانوثانیه باشند\&. اگر هیچ واحدی مشخص نشود، مقدار تاخیر بر حسب نمونه‌ها و با نرخ نمونه‌برداری فایل محاسبه می‌شود\&.
.RE
.PP

.PP
\fB-P | --properties=VALUE\fP
.RS 4
تنظیم ویژگی‌های اضافی جریان به عنوان یک شیء JSON\&.
.RE
.PP
\fB-q | --quality=VALUE\fP
.RS 4
کیفیت نمونه‌برداری مجدد (resampler)\&. هنگامی که نرخ نمونه‌برداری فایل مبدأ یا مقصد با نرخ نمونه‌برداری کارساز مطابقت نداشته باشد، داده‌ها دوباره نمونه‌برداری خواهند شد\&. کیفیت بالاتر از پردازندهٔ بیشتری استفاده می‌کند\&. مقادیر بین 0 تا 15 مجاز هستند، کیفیت پیش‌فرض 4 است\&.
.RE
.PP
\fB-a | --raw\fP
.RS 4
نمونه‌های خام خوانده یا نوشته خواهند شد\&. گزینه‌های --rate، --format، --channels و --channelmap می‌توانند برای تعیین قالب خام استفاده شوند\&.
.RE
.PP
\fB-M | --force-midi\fP
.RS 4
اجبار قالب midi، یکی از "midi" یا "ump" (پیش‌فرض ump است)\&. هنگام خواندن یا نوشتن midi، برای یکی از موارد midi یا UMP اعمال می‌شود\&.
.RE
.PP
\fB-n | --sample-count=COUNT\fP
.RS 4
توقف پس از COUNT نمونه\&.
.RE
.PP
\fB--rate=VALUE\fP
.RS 4
نرخ نمونه‌برداری، پیش‌فرض 48000 است\&.
.RE
.PP
\fB--channels=VALUE\fP
.RS 4
تعداد کانال‌ها، پیش‌فرض 2 است\&.
.RE
.PP
\fB--channel-map=VALUE\fP
.RS 4
نگاشت کانال‌ها (channelmap)\&. مقادیر مجاز یا چیدمان کانال نظیر \fBmono\fP، \fBstereo\fP، \fBsurround-21\fP، \fBquad\fP، \fBsurround-22\fP، \fBsurround-40\fP هستند، یا آرایه‌ای از نام کانال‌ها که با کاما جدا شده‌اند مانند \fBFL,FR\fP\&. برای دریافت فهرست کامل مقادیر ممکن گزینه‌های --list-layouts و --list-channel-names را مشاهده کنید\&.
.RE
.PP
\fB--list-layouts\fP
.RS 4
فهرست کردن تمام چیدمان‌های شناخته‌شدهٔ کانال\&. یکی از این موارد می‌تواند به عنوان مقدار --channel-map استفاده شود\&.
.RE
.PP
\fB--list-channel-names\fP
.RS 4
فهرست کردن تمام نام‌های شناخته‌شدهٔ کانال\&. آرایه‌ای از این موارد می‌تواند به عنوان مقدار --channel-map استفاده شود\&.
.RE
.PP
\fB--format=VALUE\fP
.RS 4
قالب نمونه برای استفاده\&. برخی از مقادیر ممکن عبارتند از: \fBu8\fP، \fBs8\fP، \fBs16\fP (پیش‌فرض)، \fBs24\fP، \fBs32\fP، \fBf32\fP، \fBf64\fP\&. برای دریافت فهرست کامل مقادیر گزینهٔ --list-formats را مشاهده کنید\&.
.RE
.PP
\fB--list-formats\fP
.RS 4
فهرست کردن تمام مقادیر شناخته‌شدهٔ قالب\&.
.RE
.PP
\fB--container=VALUE\fP
.RS 4
مشخص کردن ظرف (container) مورد استفاده هنگام ذخیره‌سازی\&. این مقدار معمولاً از پسوند نام فایل حدس زده می‌شود اما می‌تواند به طور صریح مشخص شود\&. هنگام استفاده از STDOUT اگر هیچ ظرفی مشخص نشده باشد، از ظرف AU استفاده خواهد شد\&. هنگام استفاده از نام فایل اگر ظرف مشخص نشده باشد و از نام فایل نیز قابل تشخیص نباشد، از ظرف WAV استفاده می‌شود\&.
.RE
.PP
\fB--list-containers\fP
.RS 4
فهرست کردن تمام مقادیر شناخته‌شده برای ظرف‌ها\&.
.RE
.PP
\fB--volume=VALUE\fP
.RS 4
حجم صدای جریان، پیش‌فرض 1\&.000 است\&. بسته به لوکالی که پیکربندی کرده‌اید، ممکن است از "," یا "\&." به عنوان جداکنندهٔ اعشار استفاده شود\&. با دستور \fBlocale\fP بررسی کنید\&.
.RE
.PP
.SH "نویسندگان (AUTHORS)"
.PP

.PP
توسعه‌دهندگان PipeWire <https://gitlab.freedesktop.org/pipewire/pipewire/issues>؛ PipeWire در <https://pipewire.org> در دسترس است\&.

.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP

.PP
\fBpipewire(1)\fP, \fBpw-mon(1)\fP,