.TH "ecasoundrc" "5" "22\&.03\&.2009" "" "Multimedia software"

.PP
.SH "نام (NAME)"
ecasoundrc \- فایل پیکربندی ecasound
.PP
.SH "خلاصه دستور (SYNOPSIS)"
{prefix}/share/ecasound/ecasoundrc (برای نمونه \(cq\&/usr/local/share/ecasound/ecasoundrc\(cq\&)
$HOME/\&.ecasound/ecasoundrc
.PP
.SH "توضیحات (DESCRIPTION)"

.PP
پرونده
\fBecasoundrc\fP
فایل پیکربندی اصلی ecasound است\&.
هرگونه تغییر ویژه کاربر باید در
$HOME/\&.ecasound/ecasoundrc
انجام شود، نه در فایل منبع سراسری سیستم\&. همچنین ecasound این امکان را می‌دهد که سیاست معمول نادیده گرفته شده و تنظیمات فقط از یک فایل منبع مشخص خوانده شود (صفحه راهنمای ecasound (1) و مستندات گزینه
\fB\-R\fP
را ببینید)\&.
.PP
قالب این فایل بسیار ساده است\&. هر خط شامل یک متغیر پیکربندی و مقدار آن است\&. متغیر و مقدار با
\(cq\&=\(cq\&
یا
\(cq\& \(cq\&
از یکدیگر جدا می‌شوند\&. خطوطی که با
\(dq\&#\(dq\&
آغاز می‌شوند نادیده گرفته خواهند شد (خطوط توضیح)\&.
.PP
.SH "متغیرها (VARIABLES)"

.PP
.IP "midi\-device"
دستگاه MIDI\&. اگر نام دستگاه در قالب
\fIrawmidi,/dev/midi*\fP
داده شود، از راه‌اندازهای OSS/Linux یا OSS/Lite استفاده می‌شود\&.
دستگاه
\fIrawmidi,/dev/snd/midiCxDy\fP
یک دستگاه خام ALSA MIDI با شماره کارت \(cq\&x\(cq\& و شماره دستگاه \(cq\&y\(cq\& را باز می‌کند\&.
برای اطلاعات بیشتر صفحه راهنمای ecasound (1) (گزینه \(cq\&\-Md\(cq\&) را ببینید\&.
مقدار پیش‌فرض
\fIrawmidi,/dev/midi\fP
است\&.
.IP
.IP "default\-output"
دستگاه خروجی پیش‌فرض\&. اگر یک راه‌اندازی زنجیره‌ای (chainsetup) بدون خروجی اما با یک یا چند ورودی متصل شود، یک خروجی پیش‌فرض اضافه شده و همه زنجیره‌ها به آن متصل می‌شوند\&. اگر مقدار حالت خاص
\(cq\&autodetect\(cq\&
مشخص شود، ecasound تلاش می‌کند یک دستگاه مناسب را به‌طور خودکار شناسایی کند (JACK \-> ALSA \-> OSS \-> rtnull)\&.
مقدار پیش‌فرض
\fIautodetect\fP
است\&.
.IP
.IP "default\-audio\-format"
مقادیر پیش‌فرض برای قالب نمونه، تعداد کانال‌ها، نرخ نمونه‌برداری و درهم‌تنیدگی کانال‌ها\&. نحو آن مشابه گزینه
\fI\-f\fP
در ecasound است (صفحه راهنمای ecasound (1) را ببینید)\&.
مقدار پیش‌فرض
\fIs16_le,2,44100,i\fP
است\&.
.IP
.IP "default\-to\-precise\-sample\-rates"
تعیین می‌کند که آیا تفاوت‌های نرخ نمونه‌برداری نادیده گرفته شود (و احتمالاً از نمونه‌برداری مجدد جلوگیری شود) یا خیر\&. در حال حاضر فقط بر دستگاه‌های OSS تأثیر می‌گذارد\&. مقدار پیش‌فرض
\fIfalse\fP
است\&.
.IP
.IP "default\-mix\-mode"
اگر
\fIdefault\-mix\-mode\fP
برابر
\fIsum\fP
باشد، موتور با جمع زدن همه کانال‌های ورودی، چند کانال را در یک کانال خروجی میکس می‌کند\&. در حالت
\fIavg\fP،
میکس با میانگین‌گیری از تمام کانال‌های ورودی انجام می‌شود\&. حالت
\fIavg\fP
در برابر برش سیگنال (clipping) ایمن است، در حالی که حالت
\fIsum\fP
به نحوه کار میکسرهای آنالوگ نزدیک‌تر است\&. مقدار پیش‌فرض
\fIavg\fP
است\&.
.IP
.IP "bmode\-defaults\-nonrt"
پارامترهای پیش‌فرض را برای استفاده در حالت بافرسازی
\(cq\&nonrt\(cq\&
انتخاب می‌کند (سایر حالت‌ها
\(cq\&rt\(cq\&
و
\(cq\&rtlowlatency\(cq\&
هستند)\&. پارامترها به‌صورت چندتایی از مقادیر جداشده با کاما مشخص می‌شوند:
۱) اندازه بافر (عدد، \-b)، ۲) اولویت افزایش‌یافته (true/false، \-r)، ۳) اولویت زمان‌بندی (عدد، \-r:X)، ۴) بافرسازی دوگانه (true/false، \-z:db)، ۵) اندازه بافر دوتایی (عدد، \-z:db,X)، و ۶) حداکثر بافر داخلی (true/false، \-z:intbuf)\&.
مقدار پیش‌فرض
\fI1024,false,50,false,100000,true\fP
است\&.
.IP
.IP "bmode\-defaults\-rt"
توضیحات
\(cq\&bmode\-defaults\-nonrt\(cq\&
را ببینید\&. مقدار پیش‌فرض
\fI1024,true,50,true,100000,true\fP
است\&.
.IP
.IP "bmode\-defaults\-rtlowlatency"
توضیحات
\(cq\&bmode\-defaults\-nonrt\(cq\&
را ببینید\&. مقدار پیش‌فرض
\fI256,true,50,true,100000,false\fP
است\&.
.IP
.IP "resource\-directory"
پوشه مربوط به فایل‌های پیکربندی سراسری ecasound\&.
مقدار پیش‌فرض
\fI{prefix\-dir}/share/ecasound\fP
است\&.
توجه! فایل‌های منبع ویژه کاربر می‌توانند در
\(cq\&$(HOME)/\&.ecasound/\(cq\&
ذخیره شوند\&. برای نمونه می‌توانید تعاریف پیش‌تنظیم خود را به
\(cq\&$(HOME)/\&.ecasound/effect_presets\(cq\&
اضافه کنید\&.
.IP
.IP "resource\-file\-genosc\-envelopes"
فایل پیکربندی برای نوسان‌سازهای عمومی (generic oscillators)\&. در پوشه منابع قرار دارد\&. مقدار پیش‌فرض
\fIgeneric_oscillators\fP
است\&.
.IP
.IP "resource\-file\-effect\-presets"
فایل پیکربندی برای پیش‌تنظیم‌های جلوه صوتی\&. در پوشه منابع قرار دارد\&. مقدار پیش‌فرض
\fIeffect_presets\fP
است\&.
.IP
.IP "ladspa\-plugin\-directory"
پوشه حاوی افزونه‌های جلوه LADSPA\&. مقدار پیش‌فرض
\fI{prefix\-dir}/lib/ladspa\fP
است\&.
اگر متغیر محیطی
\fILADSPA_PATH\fP
وجود داشته باشد، پوشه‌های مشخص‌شده در آن به‌طور خودکار برای یافتن افزونه‌ها جستجو می‌شوند\&.
توجه! برای تطابق با نحو متغیر محیطی
\fILADSPA_PATH\fP،
گزینه
\(cq\&ladspa\-plugin\-directory\(cq\&
می‌تواند شامل چند پوشه باشد که با نویسه
\(cq\&:\(cq\&
از هم جدا شده‌اند\&.
.IP
.IP "ext\-cmd\-text\-editor"
اگر
\fIext\-cmd\-text\-editor\-use\-getenv\fP
برابر
\fIfalse\fP
یا
\(dq\&EDITOR\(dq\&
تهی (null) باشد، مقدار این فیلد استفاده می‌شود\&.
.IP
.IP "ext\-cmd\-text\-editor\-use\-getenv"
مشخص می‌کند که آیا ecasound باید متغیر محیطی
\(dq\&EDITOR\(dq\&
را بررسی کند یا خیر\&. مقدار پیش‌فرض
\fItrue\fP
است\&.
.IP
.IP "ext\-cmd\-mp3\-input"
دستور برای شروع ورودی mp3\&. برنامه Ecasound انتظار دارد نمونه‌های صوتی استریو با علامت، ۱۶ بیتی و little\-endian را از ورودی استاندارد خود بخواند\&. برنامه Ecasound سایر پارامترهای قالب صوتی را با پردازش سرآیند فایل mp3 به دست می‌آورد\&. پیش از اجرا، %f با مسیر فایل mp3 ورودی جایگزین می‌شود\&. در صورت وجود،
\(dq\&%o\(dq\&
با آفست شروع در فریم‌های mp3 جایگزین می‌شود\&. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد\&. به‌طور پیش‌فرض،
\fImpg123\fP
اجرا می‌شود\&.
.IP
.IP "ext\-cmd\-mp3\-output"
دستور برای شروع خروجی mp3\&. برنامه Ecasound نمونه‌های صوتی استریو، با علامت، ۱۶ بیتی و little\-endian را در خروجی استاندارد می‌نویسد\&. نرخ نمونه‌برداری قابل پیکربندی است\&. پیش از اجرا، %f با مسیر فایل mp3 خروجی، %S با نرخ نمونه‌برداری به کیلوهرتز (kHz) و %B با نرخ بیت کدگذاری به kbps جایگزین می‌شوند\&. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد\&. به‌طور پیش‌فرض Ecasound تلاش می‌کند
\fIlame\fP
را اجرا کند\&. به عنوان یک استثنای خاص (اضافه‌شده در Ecasound 2\&.7\&.0)، اگر برنامه خروجی
\(dq\&lame\(dq\&
باشد و گزینه‌ها شامل
\(dq\&\-\-big\-endian\(dq\&
باشند، Ecasound این مورد را تشخیص داده و نمونه‌های big\-endian خروجی می‌دهد\&.
.IP
.IP "ext\-cmd\-ogg\-input"
دستور برای شروع ورودی Ogg Vorbis\&. برنامه Ecasound انتظار دارد که نمونه‌های صوتی در خروجی استاندارد نوشته شوند\&. باید توجه داشت که Ecasound قادر به دریافت پارامترهای قالب صوتی از فایل‌های ogg نیست، بنابراین این موارد باید به‌صورت دستی توسط کاربر تنظیم شوند\&. پیش از اجرا، %f با مسیر فایل ogg ورودی جایگزین می‌شود\&. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد\&. به‌طور پیش‌فرض Ecasound تلاش می‌کند
(ogg123)
را اجرا کند\&.
.IP
.IP "ext\-cmd\-ogg\-output"
دستور برای شروع خروجی Ogg Vorbis\&. برنامه Ecasound نمونه‌ها را با قالب little\-endian در خروجی استاندارد می‌نویسد\&. سایر پارامترهای صوتی قابل پیکربندی هستند\&. پیش از اجرا، %f با مسیر فایل ogg خروجی، %c، %s و %b با پارامترهای قالب صوتی مطابق، و %B با نرخ بیت کدگذاری به kbps جایگزین می‌شوند\&. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد\&. به‌طور پیش‌فرض Ecasound تلاش می‌کند
(oggenc)
را اجرا کند\&.
.IP
.IP "ext\-cmd\-mikmod"
دستور برای شروع ورودی mikmod\&. برنامه Ecasound انتظار دارد نمونه‌های صوتی استریو، با علامت و ۱۶ بیتی در خروجی استاندارد نوشته شوند\&. پیش از اجرا، %f با مسیر فایل و %s با نرخ نمونه‌برداری انتخاب‌شده جایگزین می‌شود\&. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد\&. به‌طور پیش‌فرض Ecasound تلاش می‌کند
\fImikmod\fP
را اجرا کند\&.
.IP
.IP "ext\-cmd\-timidity"
دستور برای شروع ورودی timidity++\&. برنامه Ecasound انتظار دارد نمونه‌های صوتی استریو، با علامت و ۱۶ بیتی در خروجی استاندارد نوشته شوند\&. پیش از اجرا، %f با مسیر فایل و %s با نرخ نمونه‌برداری جایگزین می‌شود\&. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد\&. به‌طور پیش‌فرض Ecasound تلاش می‌کند
\fItimidity\fP
را اجرا کند\&.
.IP
.IP "ext\-cmd\-flac\-input"
دستور برای شروع ورودی FLAC\&. برنامه Ecasound انتظار دارد که نمونه‌های صوتی در خروجی استاندارد نوشته شوند\&. باید توجه داشت که Ecasound قادر به دریافت پارامترهای قالب صوتی از فایل‌های FLAC نیست، بنابراین این موارد باید به‌صورت دستی توسط کاربر تنظیم شوند\&. پیش از اجرا، %f با مسیر فایل FLAC ورودی جایگزین می‌شود\&. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد\&. به‌طور پیش‌فرض Ecasound تلاش می‌کند
(flac)
را اجرا کند\&.
.IP
.IP "ext\-cmd\-flac\-output"
دستور برای شروع خروجی FLAC\&. برنامه Ecasound نمونه‌ها را در خروجی استاندارد می‌نویسد\&. تمام پارامترهای صوتی قابل پیکربندی هستند\&. پیش از اجرا، %f با مسیر فایل flac خروجی، %c، %b و %s با پارامترهای قالب صوتی مطابق، %I با
\(cq\&signed\(cq\&
یا
\(cq\&unsigned\(cq\&،
و %E با
\(cq\&little\(cq\&
یا
\(cq\&big\(cq\&
جایگزین می‌شوند\&. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد\&. به‌طور پیش‌فرض Ecasound تلاش می‌کند
(flac)
را اجرا کند\&.
.IP
.IP "ext\-cmd\-aac\-input"
دستور برای شروع ورودی AAC\&. برنامه Ecasound انتظار دارد نمونه‌های صوتی استریو، با علامت، ۱۶ بیتی و big\-endian در خروجی استاندارد نوشته شوند\&. باید توجه داشت که Ecasound قادر به دریافت نرخ نمونه‌برداری ورودی نیست، بنابراین این مورد باید به‌صورت دستی توسط کاربر تنظیم شود\&. پیش از اجرا، %f با مسیر فایل AAC ورودی جایگزین می‌شود\&. توجه! FAAC باید با پشتیبانی از MP4 کامپایل شده باشد\&. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد\&. به‌طور پیش‌فرض Ecasound تلاش می‌کند
\fIfaad\fP
را اجرا کند\&.
.IP
.IP "ext\-cmd\-aac\-output"
دستور برای شروع خروجی AAC\&. برنامه Ecasound نمونه‌های صوتی big\-endian را در خروجی استاندارد می‌نویسد\&. سایر پارامترهای صوتی قابل پیکربندی هستند\&. پیش از اجرا، %f با مسیر فایل AAC خروجی، %c، %b و %s با پارامترهای قالب صوتی مطابق جایگزین می‌شوند\&. توجه! FAAC باید با پشتیبانی از MP4 کامپایل شده باشد\&. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد\&. به‌طور پیش‌فرض Ecasound تلاش می‌کند
\fIfaac\fP
را اجرا کند\&.
.IP
.SH "منسوخ‌شده (DEPRECATED)"

.PP
.IP "ext\-cmd\-wave\-editor"

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

.PP
ecasound (1), ecatools (1), ecasound\-iam (1)
.PP
.SH "نویسندگان (AUTHORS)"

.PP
Kai Vehmanen, <kvehmanen \-at\- eca \-dot\- cx <kvehmanen \-at\- eca \-dot\- cx>>