.TH out123 1 "26 Apr 2020"
.SH "نام (NAME)"
out123 \- ارسال داده‌های صوتی خام PCM یا الگوی شکل‌موج به یک دستگاه خروجی
.SH "خلاصه دستور (SYNOPSIS)"
\fBcat \fRaudio.raw \fR| \fBout123 \fR[ \fR- \fR] [ \fIoptions \fR ]

\fBout123 \fR[ \fIoptions \fR] \fIfilename \fR[ \fIfilename \fR... ]

\fBout123 \fR--wave-freq \fIfreq1\fR[,\fIfreq2\fR,...] [ \fIoptions \fR]

\fBout123 \fR--source \fRgeiger \fR[ \fIoptions \fR]

.SH "توضیحات (DESCRIPTION)"
.B out123
داده‌های خام PCM را (با ترتیب بایت میزبان یا host byte order) از ورودی استاندارد می‌خواند
و آن را روی دستگاه صوتی مشخص‌شده توسط گزینه‌های ارائه‌شده پخش می‌کند.
همچنین می‌تواند خودش سیگنال‌های دوره‌ای یا تصادفی را برای بازپخش تولید کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های
.B out123
می‌توانند گزینه‌های تک‌حرفی سنتی POSIX یا گزینه‌های طولانی به سبک GNU باشند.
گزینه‌های به سبک POSIX با یک «\-» شروع می‌شوند، در حالی که گزینه‌های طولانی GNU با «\-\^\-» آغاز می‌گردند.
آرگومان‌های گزینه‌ها (در صورت نیاز) با فاصله (و نه با «=») پس از گزینه قرار می‌گیرند.
توجه داشته باشید که در صورت غیرفعال بودن برخی گزینه‌ها در فرآیند ساخت، ممکن است آن گزینه‌ها در نسخهٔ نصب‌شدهٔ شما وجود نداشته باشند.
.TP
\fB\-\^\-name \fIname
تنظیم نام این نمونه، که ممکن است در جاهای مختلف استفاده شود. این گزینه نام کلاینت را برای خروجی JACK تنظیم می‌کند.
.TP
\fB\-o \fImodule\fR, \-\^\-\fBoutput \fImodule\fR
انتخاب ماژول خروجی صوتی. می‌توانید فهرستی جداشده با کاما ارائه دهید تا از نخستین ماژول کارآمد استفاده شود.
همچنین \fB\-a\fR را ببینید.
.TP
\fB\-\^\-list\-modules
فهرست کردن ماژول‌های موجود.
.TP
\fB\-\^\-list\-devices
فهرست کردن دستگاه‌های خروجی موجود برای ماژول خروجی مشخص‌شده. اگر در ماژول انتخاب‌شده قابلیتی
برای فهرست کردن دستگاه‌ها وجود نداشته باشد، خطایی چاپ شده و out123 با یک کد غیر صفر خارج خواهد شد.
.TP
\fB\-a \fIdev\fR, \fB\-\^\-audiodevice \fIdev
مشخص کردن دستگاه صوتی مورد استفاده. مقدار پیش‌فرض و همچنین مقادیر ممکن به
خروجی فعال بستگی دارند. برای خروجی JACK، می‌توان فهرستی جداشده با کاما
از درگاه‌ها را جهت اتصال (برای هر کانال) تعیین کرد.
.TP
.BR \-s ", " \-\^\-stdout
نمونه‌های صوتی به جای پخش از طریق دستگاه صوتی، در خروجی استاندارد نوشته می‌شوند.
قالب خروجی همانند ورودی است... بنابراین در این حالت،
.B out123
مشابه ابزار استاندارد \fBcat\fR عمل می‌کند، احتمالاً به همراه برخی تبدیلات.
این میان‌بر معادل '-o raw -a -' است.
.TP
.BR \-S ", " \-\^\-STDOUT
این گونه علاوه بر این، داده‌ها را در خروجی استاندارد (stdout) می‌نویسد، در حالی که همچنان
آن‌ها را روی دستگاه خروجی پخش می‌کند. بنابراین بیشتر شبیه به نوعی از
\fBtee\fR عمل می‌کند تا \fBcat\fR.
.TP
\fB\-O \fIfile\fR, \fB\-\^\-outfile
نوشتن خروجی خام در یک فایل (به جای هدایت سادهٔ خروجی استاندارد به یک فایل با پوسته).
این میان‌بر معادل '-o raw -a \fIfile\fR' است.
.TP
\fB\-w \fIfile\fR, \fB\-\^\-wav
نوشتن خروجی به صورت فایل WAV در
.I file
یا در خروجی استاندارد در صورتی که از
.I -
یا رشتهٔ خالی به عنوان نام فایل استفاده شود. همچنین می‌توانید از
.I --au
و
.I --cdr
به ترتیب برای قالب‌های AU و CDR استفاده کنید. توجه داشته باشید که نوشتن WAV/AU در فایل‌های غیرقابل پرش (non-seekable) یا خروجی استاندارد هدایت‌شده نیازمند تأمل است. سرایند همراه با نخستین داده‌های واقعی نوشته می‌شود. نتیجهٔ رمزگشایی هیچ‌چیز به WAV/AU در صورتی که فایل قابل جست‌وجو (seekable) باشد، فایلی شامل صرفاً یک سرایند است و در صورتی که قابل جست‌وجو نباشد، واقعاً هیچ‌چیز نیست (حتی یک سرایند). نوشتن صحیح داده‌ها با سرایندهای پیشگویانه در stdout کار ساده‌ای نیست.
این میان‌بر معادل '-o wav -a \fIfile\fR' است.
.TP
\fB\-\^\-au \fIfile
نوشتن در
.I file
در قالب صوتی SUN. اگر از \- یا رشتهٔ خالی به عنوان نام فایل استفاده شود، فایل AU در
خروجی استاندارد نوشته می‌شود. برای ماجراهای سرایند با جریان‌های غیرقابل پرش، بند مربوط به نوشتن WAV را ببینید.
این میان‌بر معادل '-o au -a \fIfile\fR' است.
.TP
\fB\-\^\-cdr \fIfile
نوشتن در
.I file
به عنوان یک CDR (صدای CD-ROM، دقیق‌تر CDDA برای Compact Disc Digital Audio).
اگر از \- یا رشتهٔ خالی به عنوان نام فایل استفاده شود، فایل CDR در
stdout نوشته می‌شود.
این میان‌بر معادل '-o cdr -a \fIfile\fR' است.
.TP
\fB\-r \fIrate\fR, \fB\-\^\-rate \fIrate
تنظیم نرخ نمونه‌برداری به هرتز (پیش‌فرض: 44100). اگر این مقدار با نرخ نمونه‌برداری واقعی
ورودی مطابقت نداشته باشد، زیروبمی (pitch) صدا تغییر خواهد کرد. شاید این تغییر عمدی باشد ;-)
.TP
\fB\-R \fIrate\fR, \fB\-\^\-inputrate \fIrate
تنظیم نرخ نمونه‌برداری ورودی به یک مقدار متفاوت. در صورتی که نرخ خروجی واقعاً
متفاوت باشد، این کار بازنمونه‌برداری (resampling) را فعال می‌کند. \fB\-\^\-resample\fR را ببینید.
.TP
\fB\-\^\-speed \fIfactor
افزایش یا کاهش سرعت بازپخش با آن ضریب با استفاده از بازنمونه‌برداری. \fB\-\^\-resample\fR را ببینید.
.TP
\fB\-\^\-resample \fImethod
این گزینه روش بازنمونه‌برداری میان نرخ‌های نمونه‌برداری متفاوت یا اعمال تغییر در
تمپو را انتخاب می‌کند. می‌توانید میان دو گونه از بازنمونه‌بردار syn123 انتخاب کنید: fine
(پیش‌فرض) و dirty. گونهٔ fine دارای محدودهٔ دینامیکی 108 dB و در بدترین حالت، ۸۴٪
پهنای باند است. گونهٔ dirty با کاهش محدودهٔ دینامیکی به 72 dB با بدترین حالت پهنای باند ۸۵٪،
زمان پردازندهٔ (CPU) اندکی کمتری مصرف می‌کند (البته نه چندان زیاد). ویژگی‌های دقیق بسته به نسبت
نرخ نمونه‌برداری متغیر است، زیرا درونیابی ضرایب فیلتر در آن دخیل است.
.TP
\fB\-c \fIcount\fR, \fB\-\^\-channels \fIcount
تنظیم تعداد کانال‌ها به مقدار داده‌شده.
.TP
\fB\-C \fIcount\fR, \fB\-\^\-inputch \fIcount
تنظیم تعداد کانال ورودی به مقداری متفاوت از خروجی. این احتمالاً به این معنی است که شما
خواهان مقداری ریمیکس کردن هستید. همچنین \fB\-\^\-mix\fR را ببینید.
.TP
\fB\-e \fIenc\fR, \fB\-\^\-encoding \fIenc
انتخاب کدگذاری نمونهٔ خروجی. مقادیر ممکن شبیه f32 (ممیز شناور ۳۲ بیتی)، s32 (عدد صحیح علامت‌دار ۳۲ بیتی)، u32 (عدد صحیح بدون علامت ۳۲ بیتی) و گونه‌هایی با تعداد بیت‌های مختلف (s24، u24، s16، u16، s8، u8) و همچنین گونه‌های خاص مانند ulaw و alaw هشت بیتی هستند.
برای مشاهدهٔ کدگذاری‌های در دسترس واقعی، خروجی longhelp برنامهٔ \fBout123\fR را ببینید.
پیش‌فرض s16 است.
.TP
\fB\-\^\-endian \fIchoice
انتخاب ترتیب بایت (endianess) خروجی. انتخاب‌ها عبارتند از big، little، یا native که پیش‌فرض است.
پردازش فقط می‌تواند در حالت native کار کند، بنابراین در صورتی که این مورد با دستگاه شما
مطابقت نداشته باشد، باید ترتیب بایت ورودی یا خروجی را مشخص کنید. این گزینه همچنین در صورتی که
ترتیب بایت ورودی جداگانه تنظیم نشده باشد، آن را نیز تعیین می‌کند. همچنین \fB\-\^\-inputend\fR و \fB\-\^\-byteswap\fR را ببینید.
.TP
\fB\-E \fIenc\fR, \fB\-\^\-inputenc \fIenc
مشخص کردن کدگذاری ورودی متفاوت از کدگذاری خروجی برای انجام تبدیل.
.TP
\fB\-\^\-inputend \fIchoice
انتخاب ترتیب بایت (endianess) ورودی. به طور پیش‌فرض همانند ترتیب بایت خروجی است.
\fB\-\^\-endian\fR را ببینید.
.TP
.BR \-\^\-byteswap
کلیدی برای جابه‌جایی بایت‌ها (byte swapping) درست پیش از خروجی، پس از انجام هر تبدیل دیگر.
این گزینه روی هر ترتیب بایتی که مشخص کنید اعمال می‌شود.
.TP
.BR \-m ", " \-\^\-mono "
تنظیم برای صدای تک‌کاناله (پیش‌فرض دو کانال، استریو است).
.TP
.BR \-\-stereo
انتخاب خروجی استریو (۲ کاناله، پیش‌فرض).
.TP
.BR \-\^\-list\-encodings
فهرست کردن نام‌های کوتاه و بلند کدگذاری‌های شناخته‌شده در خروجی استاندارد.
.TP
\fB\-\^\-mix \fImatrix
مشخص کردن ماتریس میکس میان کانال‌های ورودی و خروجی به صورت ضرایب خطی، فهرستی جداشده با کاما برای
ضرایب کانال ورودی جهت کانال خروجی ۱، سپس کانال خروجی ۲ و به همین ترتیب.
در صورت تطابق تعداد کانال‌ها، پیش‌فرض یک ماتریس همانی است؛ بنابراین برای ۳ کانال معادل
'\-\^\-mix 1,0,0,0,1,0,0,0,1' است. برای تبدیل استریو به مونو، پیش‌فرض ترکیب هر
دو کانال با دامنهٔ نصف‌شده است، یعنی '\-\^\-mix 0.5,0.5'. برای تقسیم مونو به استریو،
جهت حفظ تقارن معادل '\-\^\-mix 1,1' است.
.TP
\fB\-\^\-filter \fIcoeff
اعمال فیلتر(های) دیجیتال پیش از پیش‌تقویت (به \fB\-\^\-preamp\fR مراجعه کنید) با فهرست ضرایب
coeff به صورت
.ce
b_0,...,b_N,a_0,...,a_N
که در آن a_0=1 الزامی است و شاید تا حدی به درک ساختار کمک کند. فیلترهای چندگانه
با ':' از یکدیگر جدا می‌شوند.
.TP
\fB\-P \fIdbvalue \fB\-\^\-preamp \fIdbvalue
فعال کردن مرحلهٔ پیش‌تقویت که سیگنال را پیش از ارسال به خروجی با مقدار داده‌شده بر حسب dB تقویت می‌کند.
.TP
\fB\-\^\-offset \fIvalue
اعمال یک آفست PCM (مقدار ممیز شناور مقیاس‌شده در بازهٔ [-1:1]) در مرحلهٔ پیش‌تقویت.
به طور معمول، این کار برای اصلاح یک آفست DC شناخته‌شده در فایل ضبط‌شده انجام می‌شود.
.TP
\fB\-\^\-clip \fImode
انتخاب حالت برش دامنه (clipping): 'soft' یا 'hard' برای برش اجباری حتی برای
خروجی ممیز شناور، و 'implicit' (پیش‌فرض) برای برش سخت ضمنی در حین
تبدیل در صورت لزوم.
.TP
\fB\-\^\-dither
فعال کردن دیترینگ (dithering) برای تبدیلات به عدد صحیح؛ اگر اصرار دارید.
این صرفاً یک دیتر معمولی TPDF است. برای برخی افراد، این به اندازهٔ کافی جذاب نیست.
اکثر افراد نیز اهمیتی به این موضوع نمی‌دهند.
.TP
.BR \-\^\-test\-format
بررسی اینکه آیا قالب داده‌شده توسط درایور و دستگاه مشخص‌شده پشتیبانی می‌شود یا خیر (در خط فرمان پیش
از رسیدن به این گزینه)، و در صورت پشتیبانی، بازگرداندن بی‌صدای مقدار 0 به عنوان مقدار خروج.
.TP
.BR \-\^\-test\-encodings
چاپ نام‌های کوتاه کدگذاری‌های پشتیبانی‌شده در پیکربندی فعلی.
.TP
.BR \-\^\-query\-format
اگر درایور و دستگاه انتخاب‌شده قالب پیش‌فرض قابل قبولی را اعلام کنند، قطعه‌ای از خط فرمان را
برای تنظیم آن قالب در \fBout123\fR چاپ می‌کند، همیشه با این ترتیب:
\-\^\-rate <r> -\^\-channels <c> -\^\-encoding <e>
.TP
.BR "\-o h" ", " \-\^\-headphones
هدایت مستقیم خروجی صوتی به رابط هدفون (تنها در برخی سخت‌افزارها؛ AIX، HP، SUN).
.TP
.BR "\-o s" ", " \-\^\-speaker
هدایت مستقیم خروجی صوتی به بلندگو (تنها در برخی سخت‌افزارها؛ AIX، HP، SUN).
.TP
.BR "\-o l" ", " \-\^\-lineout
هدایت مستقیم خروجی صوتی به رابط line-out (تنها در برخی سخت‌افزارها؛ AIX، HP، SUN).
.TP
\fB\-b \fIsize\fR, \fB\-\^\-buffer \fIsize
استفاده از یک بافر خروجی صوتی به اندازهٔ
.I size
کیلوبایت. این برای دور زدن دوره‌های کوتاه فعالیت سنگین
سیستم که معمولاً باعث وقفه در خروجی صوتی می‌شود،
مفید است.
شما باید اندازهٔ بافری حداقل ۱۰۲۴
(یعنی ۱ مگابایت، که معادل حدود ۶ ثانیه دادهٔ صوتی معمول است) یا بیشتر تعیین کنید؛
مقادیر کمتر از حدود ۳۰۰ چندان منطقی نیستند. مقدار پیش‌فرض 0 است
که بافرسازی را خاموش می‌کند.
.TP
\fB\-\^\-preload \fIfraction
صبر کردن برای پر شدن بافر به میزان
.I fraction
پیش از شروع پخش (کسری بین 0 و 1). می‌توانید این پیش‌بافرسازی را طوری تنظیم کنید که صدا سریع‌تر به گوش شما برسد یا پخش رادیوی وب پایدارتر و بدون وقفه باشد.
پیش‌فرض 0.2 است (از نسخهٔ 1.23 به بعد از مقدار 1 تغییر یافته است).
.TP
\fB\-\^\-devbuffer \fIseconds
تنظیم بافر دستگاه بر حسب ثانیه؛ 0 => به معنای مقدار پیش‌فرض است. این بافر کوچک میان
برنامه و بک‌اند صوتی است که احتمالاً مستقیماً با بافرهای سخت‌افزاری ارتباط دارد.
.TP
\fB\-\^\-timelimit \fIsamples
تنظیم محدودیت زمان پخش بر حسب نمونه‌های PCM، در صورتی که مقداری بزرگ‌تر از صفر تعیین شود.
\fBout123\fR پس از رسیدن به آن تعداد نمونه، خواندن از stdin یا پخش از جدول موج
تولیدشده را متوقف خواهد کرد.
.TP
\fB\-\^\-seconds \fIseconds
تنظیم محدودیت زمانی به ثانیه به جای نمونه‌ها.
.TP
\fB\-\^\-source \fIname
انتخاب منبع سیگنال: 'file' (پیش‌فرض) برای پخش فایل(های) داده‌شده در خط فرمان
یا ورودی استاندارد در صورت نبود فایل، یا یکی از مولدهای 'wave' (به \fB\-\^\-wave\-freq\fR مراجعه کنید)،
'sweep' (به \fB\-\^\-wave\-sweep\fR مراجعه کنید)، 'pink' (به \fB\-\^\-ping\-rows\fR مراجعه کنید)،
geiger (به \fB\-\^\-geiger\-activity\fR مراجعه کنید)، یا صرفاً 'white' برای مقداری نوفهٔ سفید (white noise).
.TP
\fB\-\^\-wave\-freq \fIfrequencies
تنظیم بسامد مولد موج یا فهرستی از آن‌ها با تفکیک کاما جهت فعال‌سازی
یک سیگنال آزمایشی تولیدشده به جای ورودی استاندارد. مقادیر خالی مقدار
قبلی را تکرار می‌کنند.
.TP
\fB\-\^\-wave\-pat \fIpatterns
تنظیم الگوهای شکل‌موج برای امواج تولیدشده به صورت یک فهرست جداشده با کاما.
گزینه‌ها شامل sine، square، triangle، sawtooth، gauss، pulse و shot هستند.
مقادیر خالی مقدار قبلی را تکرار می‌کنند.
.TP
\fB\-\^\-wave\-phase \fIphases
تنظیم جابه‌جایی(های) فاز شکل‌موج به صورت فهرستی جداشده با کاما؛ مقادیر منفی
الگو را در زمان معکوس می‌کنند و مقادیر خالی مقدار قبلی را تکرار می‌نمایند. همچنین
گزینهٔ \fB\-\^\-wave\-direction\fR جهت منفی را بازنویسی می‌کند.
.TP
\fB\-\^\-wave\-direction\fR
تنظیم صریح جهت موج (علامت آن در نظر گرفته می‌شود).
.TP
\fB\-\^\-wave\-sweep \fIfrequency
جاروب فرکانسی یک موج تولیدشده به سمت بسامد داده‌شده، از
نخستین بسامد مشخص‌شده برای \fB\-\^\-wave\-freq\fR، همچنین با استفاده از
نخستین الگو و جهت موج.
.TP
\fB\-\^\-sweep\-time \fIseconds
تنظیم مدت زمان جاروب بسامد به ثانیه در صورتی که 0 < باشد. در صورت تعیین شدن،
پیش‌فرض آن محدودیت زمانی پیکربندی‌شده است، در غیر این صورت یک ثانیه است، چرا که
جاروب‌های بی‌پایان معقول نیستند.
.TP
\fB\-\^\-sweep\-count \fIcount
تنظیم محدودیت زمانی برای تولید دقیقاً همین تعداد جاروب فرکانسی (هموار).
.TP
\fB\-\^\-sweep\-type \fItype
تنظیم نوع جاروب: lin(ear) برای خطی، qua(d) (پیش‌فرض) برای درجه دوم، یا exp(onential)
برای تغییر نمایی بسامد با زمان.
.TP
\fB\-\^\-sweep\-hard
غیرفعال‌سازی هموارسازی پس از جاروب برای حالت دوره‌ای.
.TP
\fB\-\^\-genbuffer \fIbytes
تنظیم اندازهٔ بافر (محدودیت) برای مولدهای سیگنال؛
در صورتی که 0 < باشد (پیش‌فرض)، یک بافر دوره‌ای را
حتی برای سیگنال‌های غیردوره‌ای اعمال می‌کند، مزیت:
بار پردازشی (CPU overhead) کمتر در زمان اجرا، زیرا همه چیز به عنوان یک سیگنال دوره‌ای اجباری از پیش محاسبه می‌شود.
.TP
\fB\-\^\-wave\-limit \fIsamples
این یک نام مستعار برای \fB\-\^\-genbuffer\fR است.
.TP
\fB\-\^\-pink\-rows \fInumber
فعال‌سازی منبع نوفهٔ صورتی و انتخاب ردیف‌ها برای الگوریتم (مقادیر کمتر از ۱ پیش‌فرض را انتخاب می‌کنند).
این مولد از کدهای ارائه‌شده توسط Phil Burk (http://softsynth.com) پیروی کرده و از
روش Gardner استفاده می‌کند.
.TP
\fB\-\^\-geiger\-activity \fInumber
این گزینه شبیه‌سازی یک شمارشگر گایگر-مولر را به عنوان منبع پیکربندی می‌کند، با عدد داده‌شده
به عنوان میانگین رویدادها در ثانیه. با آن بازی کنید، سرگرم‌کننده است!
.TP
.BR \-t ", " \-\^\-test
حالت آزمایشی. جریان صوتی خوانده می‌شود، اما هیچ خروجی صورت نمی‌گیرد.
.TP
.BR \-v ", " \-\^\-verbose
افزایش سطح جزئیات پیام‌ها.
.TP
.BR \-q ", " \-\^\-quiet
حالت بی‌صدا. سرکوب پیام‌های تشخیصی.
.TP
\fB\-\^\-aggressive
تلاش برای دریافت اولویت بالاتر.
.TP
.BR \-T ", " \-\-realtime
تلاش برای دریافت اولویت بلادرنگ (realtime). این گزینه معمولاً برای اعمال اثر،
نیازمند امتیازات ریشه (root) است.
.TP
.BR \-? ", " \-\^\-help
نمایش راهنمای استفادهٔ کوتاه.
.TP
.BR \-\^\-longhelp
نمایش راهنمای استفادهٔ کامل و بلند.
.TP
.BR \-\^\-version
چاپ رشتهٔ نسخه.
.SH "نویسندگان (AUTHORS)"
.TP
نگه‌دارنده:
.br
Thomas Orgis <maintainer@mpg123.org>, <thomas@orgis.org>
.TP
سازنده (ریشهٔ کدهای درون mpg123):
.br
Michael Hipp
.TP
استفاده از کدها یا ایده‌های افراد مختلف؛ فایل AUTHORS همراه با کد منبع را ببینید.
.SH "مجوز (LICENSE)"
.B out123
تحت مجوز گنو کمتر/کتابخانه‌ای عمومی (LGPL)، نسخهٔ 2.1 دارای مجوز است.
.SH "وب‌گاه (WEBSITE)"
http://www.mpg123.org
.br
http://sourceforge.net/projects/mpg123