.\" jack-stdin.1 written by Robin Gareus <robin@gareus.org>
.TH JACK-STDIN 1 "21 February 2019"
.SH "نام (NAME)"
jack-stdin \- خواندن داده‌های صوتی خام از ورودی استاندارد و نوشتن در درگاه صوتی JACK
.SH "خلاصه دستور (SYNOPSIS)"
.HP
.B jack-stdin
.RI [ OPTIONS ]
.RI port1
.RB [
.RI port2
.RB ...]
.SH "توضیحات (DESCRIPTION)"
.LP
دستور
\fBjack-stdin\fR
داده‌های صوتی خام را از ورودی استاندارد (standard-input) می‌خواند و آن‌ها را در یک درگاه صوتی JACK می‌نویسد.
.P
تعداد درگاه‌های داده‌شده، تعداد کانال‌های صوتی مورد استفاده را تعیین می‌کند.
اگر بیش از یک کانال مشخص شده باشد، داده‌های نمونه‌های صوتی ورودی باید به‌صورت درهم‌تنیده (interleaved) باشند.
.SH "گزینه‌ها (OPTIONS)"

.TP
\fB\-b\fR, \fB\-\-bitdepth \fIBITS\fR
.RS
عمق بیت (bit-depth) هر نمونه را مشخص می‌کند. برای کدگذاری عدد صحیح، این مقدار می‌تواند
16
یا
24
باشد. مقدار پیش‌فرض 16 است.
این تنظیم تنها برای کدگذاری عدد صحیح استفاده می‌شود؛ نمونه‌های ممیز شناور (floating-point) همواره دارای عرض 32 بیت خواهند بود.
.RE

.TP
\fB\-d\fR, \fB\-\-duration\fR \fISEC\fR
.RS
مدت زمانی را که
.B jack-stdin
باید اجرا شود، بر حسب ثانیه مشخص می‌کند.
مقداری کمتر از 1 به معنای اجرای نامحدود است. مقدار پیش‌فرض 0 است که تا رسیدن به انتهای فایل (end-of-file) به خواندن ادامه می‌دهد.
.RE

.TP
\fB\-e\fR, \fB\-\-encoding\fR \fIFORMAT\fR
.RS
قالب داده‌های ورودی را تعیین می‌کند: signed-integer (عدد صحیح علامت‌دار)، unsigned-integer (عدد صحیح بدون علامت)، floating-point (ممیز شناور).
(پیش‌فرض: signed)
.RE

.TP
\fB\-n\fR, \fB\-\-name\fR \fICLIENTNAME\fR
.RS
نام کلاینت JACK را تنظیم می‌کند.
(پیش‌فرض: jstdin)
.RE

.TP
\fB\-f\fR, \fB\-\-file\fR \fIFILENAME\fR
.RS
داده‌ها را به‌جای ورودی استاندارد از فایل مشخص‌شده می‌خواند.
.RE

.TP
\fB\-h\fR, \fB\-\-help\fR
.RS
نمایش اطلاعات خلاصه درباره نحوه استفاده از دستور.
.RE

.TP
\fB\-p\fR, \fB\-\-prebuffer\fR \fIPERCENT\fR
.RS
بافر را پیش از شروع ارسال خروجی صوتی به JACK از قبل پر می‌کند (پیش‌فرض 50.0%).
.br
\fBنکته:\fR برای پخش نمونه‌های صوتی بسیار کوتاه، پیش‌بافرسازی را غیرفعال کنید
(\fB\-p 0\fR)
یا از اندازه بافر کوچکتری استفاده نمایید.
.RE

.TP
\fB\-L\fR, \fB\-\-little-endian\fR
.RS
داده‌های ورودی با ترتیب بایت little-endian یا ممیز شناور با ترتیب بایت محلی (native-byte-order) هستند (این حالت پیش‌فرض است).
.RE

.TP
\fB\-B\fR, \fB\-\-big-endian\fR
.RS
داده‌های صوتی ورودی را با ترتیب بایت big-endian تفسیر می‌کند یا ترتیب بایت مقادیر ممیز شناور را جابه‌جا می‌نماید.
.RE

.TP
\fB\-q\fR, \fB\-\-quiet\fR
.RS
جلوگیری از نمایش خروجی‌های معمول برنامه.
این گزینه پیام‌های اطلاع‌رسانی و هشدارهای سرریز بافر را بی‌صدا می‌کند، اما خطاهای راه‌اندازی (setup) همچنان نمایش داده می‌شوند.
.RE

.TP
\fB\-S\fR, \fB\-\-bufsize\fR \fISAMPLES\fR
.RS
اندازه بافر داخلی را بر حسب تعداد نمونه‌ها تعیین می‌کند. اندازه پیش‌فرض 65536 است.
مقدار ارائه‌شده در تعداد کانال‌ها و عمق بیت ضرب می‌شود تا اندازه بافر حلقه‌ای (ring-buffer) محاسبه گردد.
.br
\fBنکته:\fR اندازه بافر باید بزرگ‌تر از اندازه دوره‌ای (period size) در JACK باشد.
.RE

.SH "مثال‌ها (EXAMPLES)"
.nf
  jack-stdout vlc_31994:out_1 vlc_31994:out_2 \\
	| sox \-t raw \-r 48k \-e signed \-b 16 \-c 2 \- \\
	      \-t raw \-r 48k \-e signed \-b 16 \-c 2 \- \\
	   tremolo 5 100 \\
	| ./jack-stdin system:playback_1 system:playback_2

  cat /dev/dsp \\
	| jack-stdin system:playback_1 system:playback_2
.fi
.SH "مشکلات شناخته‌شده (KNOWN ISSUES)"
.PP
دستور
.B jack-stdin
برای بازپخش فایل‌هایی که طول آن‌ها کوتاه‌تر از دو برابر اندازه دوره‌ای JACK باشد مناسب نیست.

.SH "نویسنده (AUTHOR)"
Robin Gareus <robin@gareus.org>.
.SH "همچنین ببینید (SEE ALSO)"
http://jackaudio.org