ecasoundrc(5) Multimedia software ecasoundrc(5)

ecasoundrc - فایل پیکربندی ecasound

{prefix}/share/ecasound/ecasoundrc (برای نمونه ’/usr/local/share/ecasound/ecasoundrc’) $HOME/.ecasound/ecasoundrc

پرونده ecasoundrc فایل پیکربندی اصلی ecasound است. هرگونه تغییر ویژه کاربر باید در $HOME/.ecasound/ecasoundrc انجام شود، نه در فایل منبع سراسری سیستم. همچنین ecasound این امکان را می‌دهد که سیاست معمول نادیده گرفته شده و تنظیمات فقط از یک فایل منبع مشخص خوانده شود (صفحه راهنمای ecasound (1) و مستندات گزینه -R را ببینید).

قالب این فایل بسیار ساده است. هر خط شامل یک متغیر پیکربندی و مقدار آن است. متغیر و مقدار با ’=’ یا ’ ’ از یکدیگر جدا می‌شوند. خطوطی که با "#" آغاز می‌شوند نادیده گرفته خواهند شد (خطوط توضیح).

دستگاه MIDI. اگر نام دستگاه در قالب rawmidi,/dev/midi* داده شود، از راه‌اندازهای OSS/Linux یا OSS/Lite استفاده می‌شود. دستگاه rawmidi,/dev/snd/midiCxDy یک دستگاه خام ALSA MIDI با شماره کارت ’x’ و شماره دستگاه ’y’ را باز می‌کند. برای اطلاعات بیشتر صفحه راهنمای ecasound (1) (گزینه ’-Md’) را ببینید. مقدار پیش‌فرض rawmidi,/dev/midi است.
دستگاه خروجی پیش‌فرض. اگر یک راه‌اندازی زنجیره‌ای (chainsetup) بدون خروجی اما با یک یا چند ورودی متصل شود، یک خروجی پیش‌فرض اضافه شده و همه زنجیره‌ها به آن متصل می‌شوند. اگر مقدار حالت خاص ’autodetect’ مشخص شود، ecasound تلاش می‌کند یک دستگاه مناسب را به‌طور خودکار شناسایی کند (JACK -> ALSA -> OSS -> rtnull). مقدار پیش‌فرض autodetect است.
مقادیر پیش‌فرض برای قالب نمونه، تعداد کانال‌ها، نرخ نمونه‌برداری و درهم‌تنیدگی کانال‌ها. نحو آن مشابه گزینه -f در ecasound است (صفحه راهنمای ecasound (1) را ببینید). مقدار پیش‌فرض s16_le,2,44100,i است.
تعیین می‌کند که آیا تفاوت‌های نرخ نمونه‌برداری نادیده گرفته شود (و احتمالاً از نمونه‌برداری مجدد جلوگیری شود) یا خیر. در حال حاضر فقط بر دستگاه‌های OSS تأثیر می‌گذارد. مقدار پیش‌فرض false است.
اگر default-mix-mode برابر sum باشد، موتور با جمع زدن همه کانال‌های ورودی، چند کانال را در یک کانال خروجی میکس می‌کند. در حالت avg، میکس با میانگین‌گیری از تمام کانال‌های ورودی انجام می‌شود. حالت avg در برابر برش سیگنال (clipping) ایمن است، در حالی که حالت sum به نحوه کار میکسرهای آنالوگ نزدیک‌تر است. مقدار پیش‌فرض avg است.
پارامترهای پیش‌فرض را برای استفاده در حالت بافرسازی ’nonrt’ انتخاب می‌کند (سایر حالت‌ها ’rt’ و ’rtlowlatency’ هستند). پارامترها به‌صورت چندتایی از مقادیر جداشده با کاما مشخص می‌شوند: ۱) اندازه بافر (عدد، -b)، ۲) اولویت افزایش‌یافته (true/false، -r)، ۳) اولویت زمان‌بندی (عدد، -r:X)، ۴) بافرسازی دوگانه (true/false، -z:db)، ۵) اندازه بافر دوتایی (عدد، -z:db,X)، و ۶) حداکثر بافر داخلی (true/false، -z:intbuf). مقدار پیش‌فرض 1024,false,50,false,100000,true است.
توضیحات ’bmode-defaults-nonrt’ را ببینید. مقدار پیش‌فرض 1024,true,50,true,100000,true است.
توضیحات ’bmode-defaults-nonrt’ را ببینید. مقدار پیش‌فرض 256,true,50,true,100000,false است.
پوشه مربوط به فایل‌های پیکربندی سراسری ecasound. مقدار پیش‌فرض {prefix-dir}/share/ecasound است. توجه! فایل‌های منبع ویژه کاربر می‌توانند در ’$(HOME)/.ecasound/’ ذخیره شوند. برای نمونه می‌توانید تعاریف پیش‌تنظیم خود را به ’$(HOME)/.ecasound/effect_presets’ اضافه کنید.
فایل پیکربندی برای نوسان‌سازهای عمومی (generic oscillators). در پوشه منابع قرار دارد. مقدار پیش‌فرض generic_oscillators است.
فایل پیکربندی برای پیش‌تنظیم‌های جلوه صوتی. در پوشه منابع قرار دارد. مقدار پیش‌فرض effect_presets است.
پوشه حاوی افزونه‌های جلوه LADSPA. مقدار پیش‌فرض {prefix-dir}/lib/ladspa است. اگر متغیر محیطی LADSPA_PATH وجود داشته باشد، پوشه‌های مشخص‌شده در آن به‌طور خودکار برای یافتن افزونه‌ها جستجو می‌شوند. توجه! برای تطابق با نحو متغیر محیطی LADSPA_PATH، گزینه ’ladspa-plugin-directory’ می‌تواند شامل چند پوشه باشد که با نویسه ’:’ از هم جدا شده‌اند.
اگر ext-cmd-text-editor-use-getenv برابر false یا "EDITOR" تهی (null) باشد، مقدار این فیلد استفاده می‌شود.
مشخص می‌کند که آیا ecasound باید متغیر محیطی "EDITOR" را بررسی کند یا خیر. مقدار پیش‌فرض true است.
دستور برای شروع ورودی mp3. برنامه Ecasound انتظار دارد نمونه‌های صوتی استریو با علامت، ۱۶ بیتی و little-endian را از ورودی استاندارد خود بخواند. برنامه Ecasound سایر پارامترهای قالب صوتی را با پردازش سرآیند فایل mp3 به دست می‌آورد. پیش از اجرا، %f با مسیر فایل mp3 ورودی جایگزین می‌شود. در صورت وجود، "%o" با آفست شروع در فریم‌های mp3 جایگزین می‌شود. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد. به‌طور پیش‌فرض، mpg123 اجرا می‌شود.
دستور برای شروع خروجی mp3. برنامه Ecasound نمونه‌های صوتی استریو، با علامت، ۱۶ بیتی و little-endian را در خروجی استاندارد می‌نویسد. نرخ نمونه‌برداری قابل پیکربندی است. پیش از اجرا، %f با مسیر فایل mp3 خروجی، %S با نرخ نمونه‌برداری به کیلوهرتز (kHz) و %B با نرخ بیت کدگذاری به kbps جایگزین می‌شوند. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد. به‌طور پیش‌فرض Ecasound تلاش می‌کند lame را اجرا کند. به عنوان یک استثنای خاص (اضافه‌شده در Ecasound 2.7.0)، اگر برنامه خروجی "lame" باشد و گزینه‌ها شامل "--big-endian" باشند، Ecasound این مورد را تشخیص داده و نمونه‌های big-endian خروجی می‌دهد.
دستور برای شروع ورودی Ogg Vorbis. برنامه Ecasound انتظار دارد که نمونه‌های صوتی در خروجی استاندارد نوشته شوند. باید توجه داشت که Ecasound قادر به دریافت پارامترهای قالب صوتی از فایل‌های ogg نیست، بنابراین این موارد باید به‌صورت دستی توسط کاربر تنظیم شوند. پیش از اجرا، %f با مسیر فایل ogg ورودی جایگزین می‌شود. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد. به‌طور پیش‌فرض Ecasound تلاش می‌کند (ogg123) را اجرا کند.
دستور برای شروع خروجی Ogg Vorbis. برنامه Ecasound نمونه‌ها را با قالب little-endian در خروجی استاندارد می‌نویسد. سایر پارامترهای صوتی قابل پیکربندی هستند. پیش از اجرا، %f با مسیر فایل ogg خروجی، %c، %s و %b با پارامترهای قالب صوتی مطابق، و %B با نرخ بیت کدگذاری به kbps جایگزین می‌شوند. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد. به‌طور پیش‌فرض Ecasound تلاش می‌کند (oggenc) را اجرا کند.
دستور برای شروع ورودی mikmod. برنامه Ecasound انتظار دارد نمونه‌های صوتی استریو، با علامت و ۱۶ بیتی در خروجی استاندارد نوشته شوند. پیش از اجرا، %f با مسیر فایل و %s با نرخ نمونه‌برداری انتخاب‌شده جایگزین می‌شود. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد. به‌طور پیش‌فرض Ecasound تلاش می‌کند mikmod را اجرا کند.
دستور برای شروع ورودی timidity++. برنامه Ecasound انتظار دارد نمونه‌های صوتی استریو، با علامت و ۱۶ بیتی در خروجی استاندارد نوشته شوند. پیش از اجرا، %f با مسیر فایل و %s با نرخ نمونه‌برداری جایگزین می‌شود. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد. به‌طور پیش‌فرض Ecasound تلاش می‌کند timidity را اجرا کند.
دستور برای شروع ورودی FLAC. برنامه Ecasound انتظار دارد که نمونه‌های صوتی در خروجی استاندارد نوشته شوند. باید توجه داشت که Ecasound قادر به دریافت پارامترهای قالب صوتی از فایل‌های FLAC نیست، بنابراین این موارد باید به‌صورت دستی توسط کاربر تنظیم شوند. پیش از اجرا، %f با مسیر فایل FLAC ورودی جایگزین می‌شود. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد. به‌طور پیش‌فرض Ecasound تلاش می‌کند (flac) را اجرا کند.
دستور برای شروع خروجی FLAC. برنامه Ecasound نمونه‌ها را در خروجی استاندارد می‌نویسد. تمام پارامترهای صوتی قابل پیکربندی هستند. پیش از اجرا، %f با مسیر فایل flac خروجی، %c، %b و %s با پارامترهای قالب صوتی مطابق، %I با ’signed’ یا ’unsigned’، و %E با ’little’ یا ’big’ جایگزین می‌شوند. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد. به‌طور پیش‌فرض Ecasound تلاش می‌کند (flac) را اجرا کند.
دستور برای شروع ورودی AAC. برنامه Ecasound انتظار دارد نمونه‌های صوتی استریو، با علامت، ۱۶ بیتی و big-endian در خروجی استاندارد نوشته شوند. باید توجه داشت که Ecasound قادر به دریافت نرخ نمونه‌برداری ورودی نیست، بنابراین این مورد باید به‌صورت دستی توسط کاربر تنظیم شود. پیش از اجرا، %f با مسیر فایل AAC ورودی جایگزین می‌شود. توجه! FAAC باید با پشتیبانی از MP4 کامپایل شده باشد. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد. به‌طور پیش‌فرض Ecasound تلاش می‌کند faad را اجرا کند.
دستور برای شروع خروجی AAC. برنامه Ecasound نمونه‌های صوتی big-endian را در خروجی استاندارد می‌نویسد. سایر پارامترهای صوتی قابل پیکربندی هستند. پیش از اجرا، %f با مسیر فایل AAC خروجی، %c، %b و %s با پارامترهای قالب صوتی مطابق جایگزین می‌شوند. توجه! FAAC باید با پشتیبانی از MP4 کامپایل شده باشد. می‌توان از نقل‌قول دوتایی و گریز با بک‌اسلش برای گنجاندن فاصله‌ها در تک‌تک پارامترها استفاده کرد. به‌طور پیش‌فرض Ecasound تلاش می‌کند faac را اجرا کند.

ecasound (1), ecatools (1), ecasound-iam (1)

Kai Vehmanen, <kvehmanen -at- eca -dot- cx <kvehmanen -at- eca -dot- cx>>;

22.03.2009