.TH AMIXER 1 "11 Aug 2000"
.SH "نام (NAME)"
amixer \- میکسر خط فرمان برای راه‌انداز کارت صدای ALSA
.SH "خلاصه دستور (SYNOPSIS)"
\fBamixer\fP [\fI\-option\fP] [\fIcmd\fP]
.SH "توضیحات (DESCRIPTION)"
دستور \fBamixer\fP امکان کنترل خط فرمانی میکسر را برای راه‌انداز کارت صدای ALSA فراهم می‌کند.
\fBamixer\fP از چندین کارت صدا پشتیبانی می‌کند.

اجرای \fBamixer\fR بدون هیچ آرگومانی، تنظیمات فعلی میکسر را برای کارت صدا و دستگاه پیش‌فرض نمایش می‌دهد. این روش مناسبی برای دیدن فهرست کنترل‌های سادهٔ میکسر قابل استفاده است.

.SH "دستورات (COMMANDS)"

.TP
\fIhelp\fP
سینتکس و نحوهٔ استفاده را نمایش می‌دهد.

.TP
\fIinfo\fP
اطلاعات مربوط به یک دستگاه میکسر را نمایش می‌دهد.

.TP
\fIscontrols\fP
فهرست کاملی از کنترل‌های سادهٔ میکسر را نمایش می‌دهد.

.TP
\fIscontents\fP
فهرست کاملی از کنترل‌های سادهٔ میکسر به همراه محتویات آن‌ها را نمایش می‌دهد.

.TP
\fIset\fP یا \fIsset\fP <\fISCONTROL\fP> <\fIPARAMETER\fP> ...
محتویات کنترل سادهٔ میکسر را تنظیم می‌کند. پارامتر می‌تواند بلندی صدا بر حسب درصد از 0% تا 100% با پسوند \fI%\fP، بهرهٔ دسی‌بل با پسوند \fIdB\fP (مانند \-12.5dB) یا یک مقدار سخت‌افزاری دقیق باشد.
بهرهٔ دسی‌بل تنها برای عناصر میکسر دارای اطلاعات dB در دسترس قابل استفاده است.
هنگامی که نویسهٔ مثبت (+) یا منفی (\-) پس از مقدار بلندی صدا افزوده شود، بلندی صدا به ترتیب نسبت به مقدار فعلی افزایش یا کاهش می‌یابد.

پارامترهای \fIcap, nocap, mute, unmute, toggle\fP برای تغییر وضعیت ضبط (capture/recording) و بی‌صدا کردن (muting) برای گروه مشخص‌شده به کار می‌روند.

تغییردهنده‌های اختیاری می‌توانند به عنوان پارامترهای اضافی قبل از مقدار قرار گیرند تا جهت استریم یا کانال‌های مورد نظر را مشخص کنند.
تغییردهنده‌های \fIplayback\fP و \fIcapture\fP جهت جریان را تعیین می‌کنند، و تغییردهنده‌های \fIfront, frontleft, frontright, frontcenter, center, rear, rearright, rearleft, woofer\fP برای تعیین کانال‌هایی که باید تغییر کنند به کار می‌روند.

باید یک کنترل سادهٔ میکسر مشخص شود. در هر لحظه تنها یک دستگاه قابل کنترل است.

.TP
\fIget\fP یا \fIsget\fP <\fISCONTROL\fP>
محتویات کنترل سادهٔ میکسر را نمایش می‌دهد.

باید یک کنترل سادهٔ میکسر مشخص شود. در هر لحظه تنها یک دستگاه قابل کنترل است.

.TP
\fIcontrols\fP
فهرست کاملی از کنترل‌های کارت را نمایش می‌دهد.

.TP
\fIcontents\fP
فهرست کاملی از کنترل‌های کارت به همراه محتویات آن‌ها را نمایش می‌دهد.

.TP
\fIcset\fP <\fICONTROL\fP> <\fIPARAMETER\fP> ...
محتویات کنترل کارت را تنظیم می‌کند. شناسه شامل این بخش‌هاست: iface, name, index, device, subdevice, numid. آرگومان بعدی مقدار کنترل را مشخص می‌کند.

.TP
\fIcget\fP <\fICONTROL\fP>
محتویات کنترل کارت را نمایش می‌دهد. شناسه دارای همان ساختار و سینتکس دستور \fIcset\fP است.

.SH "دستورات پیشرفته (ADVANCED COMMANDS)"

.TP
\fIsevents\fP
رویدادهای مربوط به کنترل‌های سادهٔ میکسر را نمایش می‌دهد.

.TP
\fIevents\fP
رویدادهای مربوط به کنترل‌های میکسر را نمایش می‌دهد.

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

.TP
\fI\-c\fP card

شمارهٔ کارت را برای کنترل انتخاب می‌کند. نام دستگاه ایجادشده از این پارامتر دارای ساختار 'hw:N' است که در آن N شمارهٔ کارت مشخص‌شده است.

.TP
\fI\-D\fP device

نام دستگاه را برای کنترل انتخاب می‌کند. نام کنترل پیش‌فرض 'default' است.

.TP
\fI\-s\fP | \fI\-\-stdin\fP

از ورودی استاندارد (stdin) می‌خواند و دستور را روی هر خط به صورت متوالی اجرا می‌کند.
هنگامی که این گزینه مشخص شود، دستور موجود در آرگومان‌های خط فرمان نادیده گرفته می‌شود.

تنها sset و cset پذیرفته می‌شوند. سایر دستورها نادیده گرفته می‌شوند.
دستورهای ارسال‌شده به شناسه‌های تطبیق‌نیافته نیز بدون ایجاد خطا نادیده گرفته می‌شوند.

.TP
\fI\-f\fP file | \fI\-\-file\fP file

از فایل داده‌شده می‌خواند و دستور را روی هر خط به صورت متوالی اجرا می‌کند.
هنگامی که این گزینه مشخص شود، دستور موجود در آرگومان‌های خط فرمان نادیده گرفته می‌شود.

تنها sset و cset پذیرفته می‌شوند. سایر دستورها نادیده گرفته می‌شوند.
دستورهای ارسال‌شده به شناسه‌های تطبیق‌نیافته نیز بدون ایجاد خطا نادیده گرفته می‌شوند.

.TP
\fI\-h\fP
راهنما: نمایش سینتکس و نحوهٔ استفاده.

.TP
\fI\-q\fP
حالت ساکت (Quiet). نتایج حاصل از تغییرات را نمایش نمی‌دهد.

.TP
\fI\-R\fP
استفاده از مقدار خام (raw) برای ارزیابی نمایش درصدی.
این حالت پیش‌فرض است.

.TP
\fI\-M\fP
استفاده از بلندی صدای نگاشت‌شده (mapped) برای ارزیابی نمایش درصدی همانند \fBalsamixer\fR، تا برای گوش انسان طبیعی‌تر باشد.

.SH "مثال‌ها (EXAMPLES)"

.TP
\fBamixer \-c 1 sset Line,0 80%,40% unmute cap\fR
بلندی صدای ورودی خطی (line input) چپ کارت صدای دوم را روی 80% و ورودی خطی راست را روی 40% تنظیم می‌کند، آن را از حالت بی‌صدا خارج کرده و به عنوان منبع ضبط (capture) انتخاب می‌کند.

.TP
\fBamixer \-c 1 \-\- sset Master playback \-20dB\fR
بلندی صدای اصلی (master) کارت دوم را روی \-20dB تنظیم می‌کند. اگر Master دارای چندین کانال باشد، تمام کانال‌ها روی همان مقدار تنظیم می‌شوند.

.TP
\fBamixer \-c 1 set PCM 2dB+\fR
بلندی صدای PCM کارت دوم را به میزان 2dB افزایش می‌دهد. هنگامی که هر دو بلندی صدای پخش و ضبط وجود داشته باشند، این تغییر روی هر دو اعمال می‌شود.

.TP
\fBamixer \-c 2 cset iface=MIXER,name='Line Playback Volume',index=1 40%\fR
بلندی صدای دومین پخش خطی (line playback) کارت صدای سوم را روی 40% تنظیم می‌کند.

.TP
\fBamixer \-c 2 cset numid=34 40%\fR
عنصر ۳۴ام کارت صدا را روی 40% تنظیم می‌کند.

.SH "همچنین ببینید (SEE ALSO)"
\fB
alsamixer(1)
\fP

.SH "باگ‌ها (BUGS)"
موردی شناخته نشده است.

.SH "نویسنده (AUTHOR)"
دستور \fBamixer\fP توسط Jaroslav Kysela <perex@perex.cz> نوشته شده است.
این مستندات توسط Paul Winkler <zarmzarm@erols.com> و Jaroslav Kysela <perex@perex.cz> تهیه شده است.