ecasound(1) Multimedia software ecasound(1)

ecasound - ویرایشگر نمونه صوتی، ضبط‌کننده چندتراکه، پردازشگر افکت‌ها و موارد دیگر.

ecasound [ general_options ] { [ chain_setup ] [ effect_setup ] [ input_setup ] [ output_setup ] }

اکاساند (Ecasound) یک بسته نرم‌افزاری است که برای پردازش چندتراکه‌ای صوت طراحی شده است. این برنامه می‌تواند برای کارهای ساده‌ای نظیر پخش صدا، ضبط و تبدیل قالب، و همچنین برای پردازش افکت‌های چندتراکه، میکس، ضبط و بازچرخانی سیگنال صوتی استفاده شود. اکاساند از طیف گسترده‌ای از ورودی‌ها، خروجی‌ها و الگوریتم‌های افکت صوتی پشتیبانی می‌کند. افکت‌ها و اشیاء صوتی را می‌توان به روش‌های گوناگون ترکیب کرد و پارامترهای آن‌ها را توسط اشیاء کنترل‌کننده مانند نوسان‌سازها و MIDI-CC کنترل نمود. یک رابط کاربری چندمنظوره در حالت خط فرمان نیز درون بسته گنجانده شده است.

توجه! تمامی گزینه‌ها به جز موارد ذکرشده در گزینه‌های ecasound و گزینه‌های سراسری را می‌توان در فایل‌های راه‌اندازی زنجیره ecasound (.ecs) استفاده کرد.

گزینه‌های ECASOUND (ECASOUND OPTIONS)

این گزینه‌ها توسط باینری فرانت‌اند ecasound تجزیه و پردازش می‌شوند و به کتابخانه بک‌اند منتقل نمی‌گردند. این بدان معناست که این گزینه‌ها ممکن است در سایر برنامه‌هایی که از کتابخانه‌های ecasound برای عملکردهای خود استفاده می‌کنند، کار نکنند.
راه‌اندازی ecasound در حالت تعاملی. در حالت تعاملی می‌توانید ecasound را با دستورهای ساده کنترل کنید ("start"، "stop"، "pause" و غیره). به ecasound-iam مراجعه کنید.
غیرفعال کردن حالت تعاملی ecasound (به ’-c’ و ’-K’ مراجعه کنید).
چاپ تمام اطلاعات اشکال‌زدایی در خروجی خطای استاندارد (stderr) (به‌صورت بافرنشده، خروجی ساده بدون ncurses).
ایجاد یک پیکربندی زنجیره (chainsetup) جدید از فایل ’chainsetup-file’ و افزودن آن به نشست جاری. فایل‌های پیکربندی زنجیره معمولاً پسوند ’.ecs’ دارند. یک پیکربندی زنجیره می‌تواند شامل ورودی‌ها، خروجی‌ها، زنجیره‌ها، افکت‌ها و کنترل‌کننده‌ها باشد -- یعنی اشیای یک پیکربندی خاص از عناصر پردازش صوت. از سوی دیگر، یک نشست (session) مجموعه‌ای از یک یا چند پیکربندی زنجیره است. تنها یکی از پیکربندی‌های زنجیره می‌تواند متصل باشد (یعنی قابل اجرا/پردازش باشد). اما امکان انتخاب و پیکربندی زنجیره دیگر وجود دارد در حالی که زنجیره دیگر در حال اجراست.
اجرای مجموعه‌ای از دستورهای حالت تعاملی اکاساند (EIAM) هنگام راه‌اندازی. این دستورها بلافاصله پس از شروع ecasound اجرا می‌شوند. چنانچه خط فرمان حاوی گزینه‌های کافی برای ایجاد یک پیکربندی زنجیره معتبر قابل اجرا باشد، دستورهای راه‌اندازی پس از تجزیه سایر گزینه‌های خط فرمان، اما پیش از آغاز موتور پردازش اجرا می‌گردند. توجه داشته باشید که این دستور قابلیتی مربوط به باینری فرانت‌اند ecasound است و توسط بک‌اند کتابخانه پشتیبانی نمی‌شود. این بدان معناست که سایر کلاینت‌ها ممکن است از گزینه ’-E’ پشتیبانی نکنند، و همچنین دستورهای راه‌اندازی به عنوان بخشی از وضعیت نشست یا پیکربندی زنجیره ذخیره نمی‌شوند.
فعال‌سازی حالت موسوم به NetECI، که در آن ecasound را می‌توان از راه دور از طریق اتصال سوکت کنترل کرد. با فعال شدن این حالت، کلاینت‌ها می‌توانند به نشست در حال اجرای ecasound متصل شوند و از دستورهای حالت تعاملی برای کنترل و نظارت بر پردازش استفاده کنند.
پروتکل NetECI در راهنمای برنامه‌نویس اکاساند (Ecasound Programmer Guide) تعریف شده است.
یک کلاینت نمونه که از این قابلیت استفاده می‌کند ecamonitor(1) است. این ابزار در بسته توزیع اکاساند گنجانده شده است (نیازمند محیط پایتون فعال است).
هشدار! چنانچه رایانه‌ای که ecasound را اجرا می‌کند به یک شبکه عمومی متصل است، حتماً درگاه (port) مربوط به ecasound را در فایروال خود مسدود کنید! از آنجا که هیچ کنترل دسترسی برای اتصالات ورودی تعبیه نشده است، هر کاربری در غیر این صورت می‌تواند متصل شده و نشست‌های شما را کنترل یا مشاهده کند. این گزینه جایگزین ’--daemon’ است (که از نسخه ۲.۶.۰ منسوخ شده است).
--server-tcp-port=NNN
تنظیم درگاه TCP مورد استفاده در حالت سرور (دیمن). به‌طور پیش‌فرض ecasound از درگاه 2868 استفاده می‌کند. این گزینه جایگزین ’--daemon-port’ است (که از نسخه ۲.۶.۰ منسوخ شد).
غیرفعال کردن حالت سرور ecasound. این حالت پیش‌فرض است. این گزینه جایگزین ’--nodaemon’ است (از نسخه ۲.۶.۰ منسوخ شد).
فعال‌سازی پشتیبانی از Open Sound Control (OSC). اکاساند برای پیام‌های ورودی OSC روی درگاه UDP با شماره NNN گوش خواهد داد. رابط OSC اکاساند در نشانی زیر مستند شده است: http://ecasound.git.sourceforge.net/git/gitweb.cgi?p=ecasound/ecasound;a=blob;f=Documentation/ecasound_osc_interface.txt;hb=HEAD
توجه داشته باشید که پشتیبانی از OSC هنوز آزمایشی است و ممکن است رابط آن در نسخه‌های بعدی اکاساند تغییر کند.
این گزینه در نسخه ۲.۷.۰ به ecasound اضافه شد.
عدم خروج پس از پایان/توقف پردازش. این گزینه تنها بر حالت عملکرد غیرتعاملی تأثیر می‌گذارد (به -c/-C مراجعه کنید). این گزینه در نسخه ۲.۴.۲ به ecasound اضافه شد.
نمایش این راهنما.
چاپ اطلاعات نسخه.
گزینه‌های سراسری (GLOBAL OPTIONS)
افزایش میزان پیام‌های اشکال‌زدایی چاپ‌شده. -d مقداری جزئیات اضافه می‌کند، در حالی که -ddd منجر به خروجی بسیار دقیق می‌شود.
تنظیم ماسک سطح اشکال‌زدایی روی ’debug_level’. این مقدار ماسک بیتی است با رده‌های زیر: خطاها (1)، اطلاعات (2)، زیرسیستم‌ها (4)، نام‌های ماژول (8)، اشیای کاربری (16)، اشیای سیستمی (32)، توابع (64)، مداوم (128) و مقادیر بازگشتی eiam با مقدار (256). مقدار پیش‌فرض ۲۷۱ است (1+2+4+8+256). برای اطلاعات دقیق‌تر به مستندات کد منبع کلاس ECA_LOGGER مراجعه فرمایید.
استفاده از فایل منابع ecasound (صفحه راهنمای ecasoundrc را ببینید) ’path-to-file’ به عنوان تنها منبع تنظیم مقادیر منابع. تعیین این گزینه، رویه عادی بررسی هر دو فایل منبع سراسری و کاربری (در صورت وجود) را غیرفعال می‌کند.
حالت بی‌صدا، بدون خروجی. همانند -d:0.
گزینه‌های عمومی پیکربندی زنجیره (GENERAL CHAINSETUP OPTIONS)
انتخاب زنجیره‌های سیگنال فعال. تمامی ورودی‌ها و خروجی‌های پس از این گزینه ’-a’ به زنجیره‌های انتخاب‌شده تخصیص می‌یابند (تا زمانی که گزینه جدید -a مشخص شود). هنگام افزودن افکت‌ها، کنترل‌کننده‌ها و سایر عملگرهای زنجیره، تنها یک زنجیره در هر زمان می‌تواند انتخاب شود. در صورتی که گزینه -a داده نشود، زنجیره ’default’ به صورت پیش‌فرض هنگام افزودن اشیا استفاده خواهد شد. نام زنجیره ’all’ نیز رزرو شده است و باعث انتخاب تمامی زنجیره‌های موجود می‌گردد. با دادن چندین گزینه -a، می‌توانید کنترل کنید که افکت‌ها، ورودی‌ها و خروجی‌ها به کدام زنجیره‌ها تخصیص داده شوند. برای اطلاعات بیشتر در خصوص کاربرد این گزینه به بخش مثال‌ها (EXAMPLES) نگاه کنید.
تنظیم نام پیکربندی زنجیره روی ’name’. در صورت عدم تعیین، مقدار پیش‌فرض یا "command-line-setup" است یا نام فایلی که پیکربندی زنجیره از آن بارگذاری شده است. فاصله خالی مجاز نیست.
کوتاه کردن خروجی‌ها. تمام اشیای خروجی در حالت بازنویسی باز می‌شوند. هرگونه فایل موجود پاک یا کوتاه خواهد شد.
باز کردن خروجی‌ها برای به‌روزرسانی. اکاساند تمامی خروجی‌ها را - در صورتی که قالب مقصد اجازه دهد - در حالت خواندن و نوشتن باز می‌کند.
فعال‌سازی ویژگی ’feature’. اکثر ویژگی‌ها را می‌توان با نماد -z:nofeature غیرفعال کرد. گزینه ’-z:db,dbsize’ بافر دوگانه (double-buffering) را برای اشیای صوتی پشتیبانی‌کننده فعال می‌کند (dbsize=0 برای پیش‌فرض، در غیر این صورت اندازه بافر بر حسب فریم‌های نمونه). گزینه ’-z:nodb’ بافر دوگانه را غیرفعال می‌سازد. گزینه‌های ’-z:intbuf’ و ’-z:nointbuf’ تعیین می‌کنند که آیا بافر داخلی اضافی برای دستگاه‌های بی‌درنگ (realtime) مجاز است یا خیر. غیرفعال کردن این ویژگی می‌تواند تاخیر (latency) را در برخی موقعیت‌ها کاهش دهد. با ’-z:xruns’، در صورت بروز سرریز یا کمبود داده در بافر (under/overrun)، پردازش متوقف می‌شود. گزینه‌های ’-z:multitrack’ و ’-z:nomultitrack’ می‌توانند برای فعال یا غیرفعال کردن اجباری حالت چندتراکه‌ای استفاده شوند. در موارد نادر ممکن است بخواهید میزان آفست ضبط را صراحتاً با ’-z:multitrack,offset-in-samples’ مشخص کنید. آفست تعداد نمونه‌هایی است که هنگام ضبط از ورودی‌های بی‌درنگ نادیده گرفته می‌شوند. گزینه ’-z:psr’ حالت نرخ نمونه دقیق (precise-sample-rates) را برای دستگاه‌های OSS فعال می‌کند. گزینه ’-z:mixmode,sum’ حالت میکسی را فعال می‌کند که در آن کانال‌ها با جمع زدن تمام کانال‌ها میکس می‌شوند. مقدار پیش‌فرض ’-z:mixmode,avg’ است که در آن کانال‌ها میانگین‌گیری می‌شوند. انتخاب mixmode برای نخستین بار در نسخه ۲.۴.۰ به ecasound اضافه شد. به صفحه راهنمای ecasoundrc مراجعه کنید.
گزینه‌های بافرسازی و کارایی پیکربندی زنجیره (CHAINSETUP BUFFERING AND PERFORMANCE OPTIONS)
انتخاب حالت بافر پیش‌فرض. حالت یکی از موارد زیر است: ’auto’ (پیش‌فرض)، ’nonrt’، ’rt’، ’rtlowlatency’.
تنظیم اندازه بافر موتور پردازش بر حسب نمونه‌ها. اندازه باید توانی از ۲ باشد، و مستقل از تعداد کانال‌ها است (برای نمونه -b:1024 در ۴۸ کیلوهرتز منجر به طول بافر ۲۱.۳۳۳ میلی‌ثانیه می‌شود، چه ورودی مونو باشد، چه استریو یا ۵.۱).
این یک گزینه مهم است زیرا طول یک تکرار موتور پردازش را تعیین کرده و از راه‌های گوناگون بر رفتار اکاساند تأثیر می‌گذارد. در صورت عدم تعیین صریح، اکاساند تلاش خواهد کرد مقداری بهینه بر اساس حالت بافر جاری انتخاب کند (گزینه -B را ببینید). برای پردازش بی‌درنگ (realtime)، می‌توانید این مقدار را تا حد امکان کم تنظیم کنید تا تأخیر پردازش کاهش یابد. برخی سیستم‌ها می‌توانند اندازه‌های بافر به پایینی ۶۴ و ۱۲۸ را اداره کنند. در برخی شرایط (مثلاً هنگام استفاده از پوش‌های نوسان‌ساز) اندازه‌های کوچک‌تر بافر باعث حرکت روان‌تر پوش‌ها می‌شوند. هنگام پردازش غیربی‌درنگ (تمام ورودی‌ها و خروجی‌ها فایل‌های عادی باشند)، مقادیر بزرگ‌تر می‌توانند به جلوگیری از سرریز بافر، کاهش مصرف CPU و/یا بهبود کارایی کمک نمایند.
توجه داشته باشید که هنگام استفاده از هر ورودی/خروجی JACK، تنظیم اندازه بافر نادیده گرفته شده و برابر با اندازه دوره/بافر گزارش‌شده توسط سرور JACK قرار می‌گیرد (مثلاً گزینه ’-p’ در jackd). امکان غیرفعال کردن این رفتار وجود ندارد.
در صورت عدم تعیین صریح، اندازه بافر پیش‌فرض بر پایه حالت بافر جاری انتخاب می‌شود (به -B مراجعه کنید).
استفاده از سیاست زمان‌بندی بی‌درنگ (SCHED_FIFO). در صورتی که اکاساند دسترسی مدیر سیستم (کاربر ارشد) نداشته باشد این کار امکان‌پذیر نیست. مراقب باشید! این گزینه کارایی بهتری ارائه می‌دهد، اما در صورت بروز مشکل ممکن است باعث قفل شدن کامل سیستم شود. پارامتر ’sched_priority’ را می‌توان حذف کرد (0=حذف‌شده). در صورت ارائه، این مقدار اولویت ایستا برای ریسه با بالاترین اولویت اکاساند خواهد بود. سایر ریسه‌های اکاساند با اولویت ’sched_priority-1...n’ اجرا می‌شوند. مقدار ’-1’ می‌تواند برای غیرفعال کردن حالت اولویت بالا استفاده شود.
ویژگی‌های مرتبط عبارتند از -z:db,xxx (-z:nodb) و -z:intbuf (-z:nointbuf). برای جزئیات به بخش گزینه‌های عمومی پیکربندی زنجیره (GENERAL CHAINSETUP OPTIONS) مراجعه کنید.
کنترل پردازش (PROCESSING CONTROL)
تنظیم زمان پردازش بر حسب ثانیه (نیازی نیست یک عدد صحیح باشد). اگر زمان پردازش تنظیم نشود، با پایان یافتن تمام ورودی‌ها موتور متوقف می‌شود. این گزینه معادل دستور EIAM موسوم به ’cs-set-length’ است. مقدار خاص ’-1’ طول پیکربندی زنجیره را مطابق با طولانی‌ترین شیء ورودی تنظیم می‌کند.
فعال‌سازی پخش حلقه‌ای (looping). با اتمام پردازش، موتور مجدداً از ابتدا آغاز می‌کند. این گزینه معادل دستور EIAM موسوم به ’cs-loop’ است.
برپاسازی ورودی/خروجی (INPUT/OUTPUT SETUP)

برای مستندات دقیق‌تر به راهنمای کاربر اکاساند مراجعه کنید.

تنظیم گزینه‌ها برای نوع مدیر شیء صوتی ’mgrtype’. برای گزینه‌های در دسترس، به "یادداشت‌های ویژه هر نوع شیء (OBJECT TYPE SPECIFIC NOTES)" در زیر مراجعه کنید.
تنظیم پارامترهای جریان صوتی برای اشیای صوتی بعدی. برای تنظیم پارامترهای مختلف برای اشیای صوتی گوناگون، چندین گزینه ’-f’ باید تعیین شود (به ترتیب دقت فرمایید، گزینه‌های ’-f’ باید پیش از اشیای صوتی قرار گیرند تا اثربخش باشند). به مستندات گزینه‌های ’-i’ و ’-o’ مراجعه کنید.
هنگامی که یک شیء صوتی باز می‌شود (مثلاً فایل یا دستگاه صوتی باز می‌شود، یا اتصالی به یک سرور صوتی برقرار می‌گردد)، پارامترهای جریان صوتی به شیء ارسال می‌شوند. باید توجه داشت که تمام اشیای صوتی اجازه تنظیم برخی یا همه پارامترها را نمی‌دهند. به عنوان مثال هنگام باز کردن فایل‌های صوتی موجود، قالب‌های فایل فراوانی دارای یک سرآیند (header) هستند که پارامترهای صوتی فایل را توصیف می‌کند. در این موارد سرآیند فایل صوتی بر پارامترهای ارائه‌شده با گزینه ’-f’ اولویت دارد. به همین ترتیب هنگام ایجاد ورودی‌ها و خروجی‌های JACK، سرور JACK نرخ نمونه‌برداری و قالب نمونه را تحمیل می‌کند.
چنانچه هیچ گزینه ’-f’ مشخص نشود، یا برخی از فیلدهای آرگومان خالی رها شوند (مثلاً ’-f:,2,44100’)، اکاساند از مقادیر پیش‌فرض استفاده خواهد کرد. این مقادیر پیش‌فرض در فایل پیکربندی ecasoundrc تعریف شده‌اند. به صفحه راهنمای ecasoundrc(5) مراجعه کنید.
توجه داشته باشید که اکاساند به‌طور پیش‌فرض فایل‌های خروجی را در حالت به‌روزرسانی باز می‌کند. مگر اینکه گزینه ’-x’ (بازنویسی خروجی‌ها) مشخص شده باشد، پارامترهای صوتی یک فایل صوتی موجود بر پارامترهای تنظیم‌شده با ’-f’ اولویت دارند.
قالب نمونه به صورت یک رشته قالب‌بندی‌شده ارائه می‌شود. حرف نخست یکی از حروف "u"، "s" و "f" است (بدون علامت unsigned، علامت‌دار signed، ممیز شناور floating point). عدد بعدی اندازه نمونه بر حسب بیت را مشخص می‌کند. اگر نمونه اندیان کوچک باشد، "_le" به پایان اضافه می‌شود. به همین صورت اگر اندیان بزرگ باشد، "_be" اضافه می‌گردد. در صورت عدم تعیین اندیان، ترتیب بایت میزبان به کار می‌رود. قالب‌های پشتیبانی‌شده فعلی عبارتند از "u8" (همان "8")، "s16_le" (همان "16")، "s16_be"، "s24_le"، "s24_be"، "s32_le"، "s32_be"، "f32_le" و "f32_be". یک رشته تهی "" قالب نمونه پیش‌فرض سیستم را برمی‌گزیند.
پارامتر چهارم چیدمان کانال را تعیین می‌کند. گزینه‌های در دسترس عبارتند از ’i’ (درهم‌تنیده یا interleaved) و ’n’ (غیردرهم‌تنیده یا noninterleaved). با تنظیم غیردرهم‌تنیده، اکاساند نمونه‌ها را در هر نوبت برای یک کانال پردازش می‌کند و اندازه بلوک با ’-b’ تنظیم می‌گردد. تنظیم پیش‌فرض ’i’ است.
تنظیم موقعیت آغازین برای آخرین ورودی/خروجی مشخص‌شده. اگر به کنترل منعطف‌تری بر اشیای صوتی نیاز دارید، باید از قالب .ewf استفاده کنید.
مشخص کردن یک منبع ورودی جدید که به تمامی زنجیره‌های انتخاب‌شده متصل است (زنجیره‌ها با ’-a:...’ انتخاب می‌شوند). اتصال چند ورودی به یک زنجیره امکان‌پذیر نیست، اما یک ورودی می‌تواند به چندین زنجیره متصل شود. ورودی می‌تواند یک فایل، دستگاه یا هر شیء صوتی دیگر باشد (به زیر مراجعه کنید). اگر ورودی یک فایل باشد، نوع آن از روی پسوند نام فایل تشخیص داده می‌شود. در صورتی که نام شیء حاوی کاما (ویرگول) باشد، باید نام را در گیومه معکوس (backquotes) قرار داد تا تداخلی با تجزیه‌کننده ایجاد نشود. قالب‌های پشتیبانی‌شده فعلی عبارتند از فایل‌های RIFF WAVE با پسوند (.wav)، شیارهای لوح فشرده صوتی (.cdr)، فایل‌های EWF اکاساند (.ewf)، داده‌های خام صوتی RAW با پسوند (.raw) و فایل‌های صوتی MPEG با پسوند (.mp2، .mp3). قالب‌های صوتی بیشتری از طریق کتابخانه‌های libaudiofile و libsndfile پشتیبانی می‌شوند (مستندات زیر را ببینید). فرمت MikMod نیز پشتیبانی می‌شود (.xm، .mod، .s3m، .it و غیره). فایل‌های MIDI با پسوند (.mid) با استفاده از Timidity++ پشتیبانی می‌شوند. همچنین Ogg Vorbis با پسوند (.ogg) قابل خواندن است، و اگر ابزارهای ogg123 و vorbize نصب باشند قابل نوشتن است؛ فایل‌های FLAC با پسوند (.flac) با ابزارهای خط فرمان flac یا با استفاده از libsndfile پشتیبانی می‌شوند؛ و فایل‌های AAC با پسوند (.aac/.m4a/.mp4) با ابزارهای faad2/faac کار می‌کنند. دستگاه‌های بی‌درنگ پشتیبانی‌شده عبارتند از دستگاه‌های صوتی OSS با مسیر (/dev/dsp*)، دستگاه‌های صوتی و loopback مربوط به ALSA و زیرسیستم صوتی JACK. اگر هیچ ورودی مشخص نشود، نخستین آرگومان خط فرمان که گزینه نباشد (با ’-’ شروع نشود) به عنوان ورودی در نظر گرفته می‌شود.
مشابه با گزینه -i عمل می‌کند. اگر خروجی مشخص نشود، دستگاه خروجی پیش‌فرض استفاده می‌شود (به ~/.ecasoundrc مراجعه کنید). اگر نام شیء حاوی ویرگول باشد، نام باید در گیومه معکوس قرار گیرد تا از سردرگمی تجزیه‌کننده جلوگیری شود. توجه داشته باشید بسیاری از انواع اشیا از خروجی پشتیبانی نمی‌کنند (مانند MikMod، MIDI و بسیاری دیگر).
یادداشت‌های ویژه هر نوع شیء (OBJECT TYPE SPECIFIC NOTES)
دستگاه‌های ALSA - ’alsa’
هنگام استفاده از درایورهای ALSA، به جای نام فایل دستگاه، باید از نحو گزینه زیر استفاده کنید: -i[:]alsa,pcm_device_name.
دسترسی مستقیم به سخت‌افزار و افزونه ALSA - ’alsahw’, ’alsaplugin’
همچنین امکان استفاده از ترکیب خاصی از کارت و دستگاه با استفاده از قالب زیر وجود دارد: -i[:]alsahw,card_number,device_number,subdevice_number. گزینه دیگر لایه افزونه ALSA PCM است. این لایه دقیقاً مانند دستگاه‌های معمول ALSA pcm کار می‌کند، اما همراه با تبدیل خودکار تعداد کانال‌ها و قالب نمونه. نحو گزینه به این صورت است: -i[:]alsaplugin,card_number,device_number,subdevice_number.
ورودی/خروجی aRts - ’arts’
در صورت فعال بودن در زمان کامپایل، اکاساند از ورودی و خروجی صوتی با سرور صوتی aRts پشتیبانی می‌کند. نحو گزینه به شکل -i:arts و -o:arts است.
توالی‌بندی فایل‌های صوتی - ’audioloop’, ’select’, ’playat’
اکاساند مجموعه‌ای از انواع اشیای صوتی ویژه فراهم می‌آورد که می‌توان از آن‌ها برای توالی زمانی فایل‌های صوتی استفاده کرد - مانند تکرار حلقه‌ای، پخش تنها بخشی از یک فایل، پخش فایل در زمان مشخص و سایر عملیات مشابه.
تکرار حلقه‌ای با گزینه -i:audioloop,file.ext,params امکان‌پذیر است. نام فایل (یا هر نوع شیء قابل درک برای Ecasound) که به عنوان پارامتر دوم داده می‌شود، به‌طور مداوم پخش شده و با رسیدن به پایان فایل مجدداً به آغاز بازمی‌گردد. هرگونه پارامتر اضافی ارائه‌شده بدون تغییر به شیء فایل ارسال می‌گردد. پارامترهای ۳ تا N به همان صورت به شیء فرزند ارسال می‌شوند (یعنی "-i audioloop,foo.wav,bar1,bar2" پارامترهای "bar1,bar2" را به شیء "foo.wav" ارسال می‌کند)..IP برای انتخاب و استفاده از تنها یک بخش مشخص از یک شیء صوتی، می‌توان از گزینه -i:select,start-time,duration,file.ext,params استفاده کرد. این گزینه مدت‌زمان "duration" از فایل "file.ext" را با شروع از زمان "start-time" پخش می‌کند. مقادیر زمان باید بر حسب ثانیه (مثلاً "2.25") یا بر حسب نمونه (مثلاً "25000sa") مشخص شوند. پارامترهای ۴ تا N همان‌گونه که هستند به شیء فرزند ارسال می‌شوند.
برای پخش یک شیء صوتی در یک نقطه مشخص از زمان، می‌توان از گزینه -i:playat,play-at-time,file.ext,params استفاده کرد. این گزینه پس از گذشت زمان "play-at-time"، فایل "file.ext" را پخش می‌کند. مقادیر زمان باید بر حسب ثانیه (مثلاً "2.25") یا نمونه (مثلاً "25000sa") داده شوند. پارامترهای ۲ تا N همان‌گونه که هستند به شیء فرزند ارسال می‌شوند.
فایل‌های موج Ecasound (EWF) - ’*.ewf’
یک قالب فایل ویژه که به کاربر اجازه می‌دهد فایل‌های صوتی را به‌طور کامل (یا بخش‌هایی از آن‌ها) برش داده و تکرار حلقه‌ای (loop) کند. این قالب مختص Ecasound است. برای اطلاعات بیشتر به راهنمای کاربر Ecasound مراجعه کنید.
همچنین انواع اشیای صوتی ’audioloop’، ’select’ و ’playat’ را ببینید.
ورودی/خروجی‌های JACK - بررسی اجمالی
سرور JACK یک سرور صوتی با تأخیر بسیار کم است که می‌تواند برای اتصال چندین برنامه صوتی مستقل به یکدیگر به کار رود. این سیستم با سایر سرورهای صوتی تفاوت دارد، زیرا از ابتدا برای کارهای حرفه‌ای صوتی با تأخیر پایین طراحی شده است.
ورودی/خروجی‌های JACK - ’jack’
برنامه Ecasound چندین روش برای ارتباط با سرورهای JACK فراهم می‌کند. برای ایجاد یک شیء ورودی یا خروجی JACK، باید از -i jack و -o jack استفاده شود. این گزینه‌ها درگاه‌های کلاینت JACK را به ترتیب با نام‌های "ecasound:in_N" و "ecasound:out_n" ایجاد می‌کنند (’N’ با شماره کانال جایگزین می‌شود). برنامه Ecasound به‌طور خودکار برای هر کانال یک درگاه JACK ایجاد می‌کند (کانال‌ها با گزینه -f:bits,channels,rate پیکربندی می‌شوند).
بسیار مهم است توجه داشته باشید که به‌طور پیش‌فرض درگاه‌های JACK به جایی متصل نیستند (مثلاً به ورودی/خروجی کارت صدا یا به برنامه‌های دیگر). بنابراین کاربر باید با یک برنامه خارجی (مانند "QJackCtl" یا "jack_connect") این درگاه‌ها را متصل کند.
ورودی/خروجی‌های JACK - ’jack,clientname,portprefix’
"jack,clientname" برای سناریوهای استفاده ساده، Ecasound روشی را برای اتصال خودکار درگاه‌های Ecasound فراهم می‌سازد. این کار با ارسال نام کلاینت همتا به عنوان پارامتر دوم به شیء "jack" انجام می‌شود، مانند -o jack,clientname. برای مثال، -o jack,system خروجی‌ای ایجاد می‌کند که به‌طور خودکار به خروجی‌های کارت صدای پیش‌فرض سیستم متصل می‌شود. پارامتر کلاینت را می‌توان حذف کرد که در این صورت هیچ اتصال خودکاری برقرار نمی‌گردد.
اگر نیاز به تغییر پیشوند درگاه دارید (مثلاً "in" در نام کلاینت "ecasound:in_N")، می‌توانید آن را به عنوان پارامتر سوم شیء "jack" مشخص کنید، مانند -o jack,,fxout. پارامتر سوم نیز می‌تواند حذف شود که در این صورت از پیشوندهای پیش‌فرض "in" و "out" استفاده می‌شود.
ورودی/خروجی‌های JACK - ’jack_multi’
گونه دیگر شیء ’jack’ نوع ’jack_multi’ است. نحو کامل آن jack_multi,destport1,...,destportN است. هنگامی که یک شیء ’jack_multi’ به یک سرور JACK متصل می‌شود، نخستین کانال شیء به درگاه JACK موسوم به ’destport1’، دومین کانال به ’destport2’ و به همین ترتیب متصل می‌گردد. به عنوان مثال "-f:32,2,44100 -o jack_multi,foo:in,bar:in" یک شیء خروجی استریوی Ecasound می‌سازد که کانال‌های چپ و راست آن به دو کلاینت مختلف JACK هدایت می‌شوند. درگاه‌های مقصد باید هنگام شروع موتور Ecasound فعال باشند، در غیر این صورت اتصال‌ها با شکست مواجه می‌شوند. اگر درگاه‌های مقصد برای تمام کانال‌ها مشخص نشده باشند، یا رشته‌هایی با طول صفر داده شوند، آن درگاه‌ها در هنگام راه‌اندازی توسط Ecasound متصل نخواهند شد.
ورودی/خروجی‌های JACK - ’jack_alsa’، ’jack_auto’، ’jack_generic’ (**از نسخه ۲.۶.۰ منسوخ شده**)
نسخه ۲.۵ و قدیمی‌تر Ecasound از انواع شیء "jack_alsa"، "jack_auto" و "jack_generic" پشتیبانی می‌کردند، اما این‌ها اکنون با رابط عمومی‌تر "jack" جایگزین شده‌اند و در نتیجه اکنون منسوخ هستند (هنوز کار می‌کنند اما دیگر مستند نمی‌شوند).
ورودی/خروجی‌های JACK - گزینه‌های کلاینت
علاوه بر این، گزینه‌های سراسری JACK را می‌توان با استفاده از گزینه -G:jack,client_name,operation_mode پیکربندی کرد. مقدار ’client_name’ نامی است که هنگام ثبت Ecasound در سیستم JACK استفاده می‌شود. اگر ’operation_mode’ برابر با "notransport" باشد، Ecasound هرگونه تغییر وضعیت انتقال (transport) در سیستم JACK را نادیده می‌گیرد؛ در حالت "send" تمام رویدادهای شروع، توقف و تغییر موقعیت را به سایر کلاینت‌های JACK ارسال می‌کند؛ در حالت "recv" برنامه Ecasound رویدادهای شروع، توقف و تغییر موقعیت JACK را دنبال می‌کند؛ و حالت "sendrecv" که ترکیبی از دو حالت پیشین است.
در صورتی که صراحتاً تنظیم نشود، در حالت تعاملی (گزینه ’-c’)، حالت پیش‌فرض "sendrecv" است، در حالی که در حالت دسته‌ای (batchmode) پیش‌فرض "notransport" است. در هر دو حالت می‌توان این حالت را با گزینه -G همان‌گونه که در بالا شرح داده شد تغییر داد.
جزئیات بیشتر درباره پشتیبانی Ecasound از JACK را می‌توان در راهنمای کاربر Ecasound یافت.
اگر پشتیبانی از libaudiofile در زمان کامپایل فعال شده باشد، این گزینه به شما امکان می‌دهد Ecasound را مجبور به استفاده از libaudiofile برای خواندن/نوشتن یک فایل صوتی خاص کنید. نحو آن -i:audiofile,foobar.ext است (برای -o نیز یکسان است).
اگر پشتیبانی از libsndfile در زمان کامپایل فعال شده باشد، این گزینه به شما امکان می‌دهد Ecasound را مجبور به استفاده از libsndfile برای خواندن/نوشتن یک فایل صوتی خاص کنید. نحو آن -i:sndfile,foobar.ext[,.format-ext] است (برای -o نیز یکسان است). پارامتر اختیاری سوم "format" می‌تواند برای بازنویسی قالب صوتی استفاده شود (برای مثال می‌توانید یک فایل AIFF با نام فایل "foo.wav" بسازید).
دستگاه حلقه - ’loop’
دستگاه‌های حلقه (loop) امکان هدایت (بازگردانی) داده‌ها میان زنجیره‌ها را فراهم می‌کنند. نحو آن -[io][:]loop,tag است. اگر یک خروجی loop با برچسب ’1’ اضافه کنید، تمام داده‌های نوشته‌شده در این خروجی به هر ورودی loop با برچسب ’1’ هدایت می‌شوند. این برچسب می‌تواند عددی باشد (مثلاً ’-i:loop,1’) یا یک رشته باشد (مثلاً "-i:loop,vocals"). مانند سایر اشیای ورودی/خروجی، می‌توانید همان دستگاه loop را به چندین زنجیره متصل کنید و از این طریق سیگنال را تفکیک/میکس نمایید.
نکته: این دستگاه ’loop’ با ’audioloop’ متفاوت است (مورد دوم در نسخه ۲.۵.۰ به ecasound اضافه شد).
اگر پشتیبانی از mikmod در زمان کامپایل فعال شده باشد، این گزینه به شما امکان می‌دهد Ecasound را مجبور به استفاده از Mikmod برای خواندن/نوشتن یک فایل ماژول خاص نمایید. نحو آن -i:mikmod,foobar.ext است.
ورودی/خروجی‌های تهی - ’null’
چنانچه "null" یا "/dev/null" را به عنوان ورودی یا خروجی مشخص کنید، یک دستگاه صوتی تهی ایجاد می‌شود. این گزینه زمانی مفید است که صرفاً بخواهید داده‌های نمونه را بدون نوشتن آن‌ها در یک فایل تحلیل کنید. همچنین یک گونه بی‌درنگ به نام "rtnull" وجود دارد که رفتاری دقیقاً مشابه با اشیای "null" دارد، با این تفاوت که تمام ورودی/خروجی با سرعت بی‌درنگ (realtime) انجام می‌شود.
بازنمونه‌برداری - ’resample’
نوع شیء ’resample’ می‌تواند برای بازنمونه‌برداری داده‌های صوتی یک شیء صوتی به کار رود تا با نرخ نمونه‌برداری استفاده‌شده در پیکربندی زنجیره فعال (chainsetup) مطابقت پیدا کند. به عنوان مثال: ecasound -f:16,2,44100 -i resample,22050,foo.wav -o /dev/dsp فایل را از ۲۲.۰۵ کیلوهرتز به ۴۴.۱ کیلوهرتز بازنمونه‌برداری کرده و نتیجه را روی دستگاه کارت صدا می‌نویسد. نرخ نمونه‌برداری فرزند می‌تواند با کلمه کلیدی ’auto’ جایگزین شود. در این حالت Ecasound تلاش خواهد کرد نرخ نمونه‌برداری را از شیء فرزند استعلام کند. این قابلیت برای قالب‌هایی مانند wav که فراداده قالب صوتی را ذخیره می‌کنند کار می‌کند. برای استفاده از ’auto’ در مثال پیشین: ecasound -f:16,2,44100 -i resample,auto,foo.wav -o /dev/dsp.
پارامترهای ۴ تا N همان‌گونه که هستند به شیء فرزند ارسال می‌شوند (یعنی "-i resample,22050,foo.wav,bar1,bar2" پارامترهای "bar1,bar2" را به شیء "foo.wav" ارسال می‌کند).
اگر Ecasound با پشتیبانی از libsamplerate کامپایل شده باشد، می‌توانید با استفاده از ’resample-hq’ از بالاترین کیفیت الگوریتم بازنمونه‌برداری در دسترس استفاده کنید. برای اجبار Ecasound به استفاده از بازنمونه‌بردار داخلی، گزینه ’resampler-lq’ (کیفیت پایین) می‌تواند به کار رود.
معکوس‌سازی - ’reverse’
نوع شیء ’reverse’ می‌تواند برای معکوس کردن داده‌های صوتی آمده از یک شیء صوتی استفاده شود. به عنوان مثال: ecasound -i reverse,foo.wav -o /dev/dsp فایل ’foo.wav’ را به صورت وارونه (رو به عقب) پخش می‌کند. معکوس کردن اشیای خروجی پشتیبانی نمی‌شود. نکته! تلاش برای معکوس کردن انواع اشیای صوتی با عملیات پرش (seek) بسیار کُند (مانند mp3)، عملکرد بسیار ضعیفی دارد. ابتدا تبدیل به یک قالب فشرده‌نشده (wav یا raw) را امتحان کنید و سپس معکوس‌سازی را انجام دهید.
پارامترهای ۳ تا N همان‌گونه که هستند به شیء فرزند ارسال می‌شوند (یعنی "-i reverse,foo.wav,bar1,bar2" پارامترهای "bar1,bar2" را به شیء "foo.wav" ارسال می‌کند).
جریان‌های استاندارد سیستم و لوله‌های نام‌گذاری‌شده - ’stdin’، ’stdout’
می‌توانید با تعیین stdin یا stdout به عنوان نام فایل، از جریان‌های استاندارد ورودی و خروجی استفاده کنید. فرض می‌شود داده‌های صوتی در قالب خام بدون سرآیند (.raw) هستند. اگر قصد استفاده از لوله‌های نام‌گذاری‌شده (named pipes) را دارید، پیش از استفاده آن‌ها را با پسوند فایل مناسب ایجاد نمایید.
تولیدکننده تن - ’tone’
برای تولید یک تن آزمایشی، می‌توان از ورودی -i:tone,type,freq,duration-secs استفاده کرد. پارامتر ’type’ نوع تن را مشخص می‌کند: در حال حاضر تنها ’sine’ (سینوسی) پشتیبانی می‌شود. پارامتر ’freq’ فرکانس تن تولیدی و ’duration-secs’ طول جریان تولیدشده را مشخص می‌سازد. تعیین مقدار صفر یا یک مقدار منفی برای مدت‌زمان، جریانی بی‌پایان تولید خواهد کرد. این ویژگی نخستین بار در Ecasound ۲.۴.۷ اضافه شد.
انتخاب نوع - ’typeselect’
نوع شیء ویژه ’typeselect’ می‌تواند برای بازنویسی نحوه نگاشت پسوندهای نام فایل به انواع اشیای صوتی در Ecasound استفاده شود. به عنوان نمونه: ecasound -i typeselect,.mp3,an_mp3_file.wav -o /dev/dsp فایل ’an_mp3_file.wav’ را به عنوان یک فایل mp3 پخش خواهد کرد و نه به عنوان یک فایل wav که در حالت عادی بدون typeselect رخ می‌داد.
پارامترهای ۴ تا N همان‌گونه که هستند به شیء فرزند ارسال می‌شوند (یعنی "-i typeselect,.au,foo.wav,bar1,bar2" پارامترهای "bar1,bar2" را به شیء "foo.wav" ارسال می‌کند).
پیکربندی MIDI (MIDI SETUP)
دستگاه‌های ورودی/خروجی MIDI - عمومی
در صورت عدم تعیین دستگاه MIDI، دستگاه MIDI پیش‌فرض استفاده می‌شود (به ecasoundrc(5) مراجعه کنید).
افزودن یک دستگاه ورودی/خروجی rawmidi MIDI به پیکربندی. مقدار ’device_name’ می‌تواند هر چیزی باشد که با استفاده از عملیات معمول فایل‌های یونیکس قابل دسترسی بوده و بایت‌های خام MIDI تولید کند. دستگاه‌های معتبر به عنوان مثال دستگاه‌های OSS rawmidi به نشانی (/dev/midi00)، دستگاه‌های ALSA rawmidi به نشانی (/dev/snd/midiC2D0)، لوله‌های نام‌گذاری‌شده (به صفحه راهنمای mkfifo رجوع کنید) و فایل‌های عادی هستند.
افزودن یک درگاه توالی‌ساز ALSA MIDI به پیکربندی. مقدار ’sequencer-port’ درگاه مورد اتصال را مشخص می‌کند. این مقدار می‌تواند عددی باشد (مثلاً 128:1) یا در قالب نام یک کلاینت باشد (مانند "KMidimon").
ارسال دستور شروع ("Deferred Play") و توقف ("Stop") پروتکل MMC با شناسه دستگاه ’device_id’.
اگرچه Ecasound مستقیماً از همگام‌سازی وضعیت انتقال با پیام‌های ورودی MMC پشتیبانی نمی‌کند، اما این هدف را می‌توان با اتصال Ecasound به ورودی/خروجی‌های JACK و استفاده از ابزارهایی مانند JackMMC و JackCtlMMC (به http://jackctlmmc.sourceforge.net مراجعه فرمایید) برای تبدیل پیام‌های MMC به رویدادهای تغییر موقعیت انتقال JACK محقق ساخت.
ارسال پیام‌های همگام‌سازی MIDI (یعنی پیام‌های بی‌درنگ سیستم "MIDI Start" و "MIDI Stop") به دستگاه MIDI انتخاب‌شده. توجه داشته باشید که Ecasound پیام MIDI-clock ارسال نمی‌کند، بلکه تنها پیام‌های start و stop را می‌فرستد.
پیکربندی جلوه‌ها (EFFECT SETUP)

پیش‌تنظیم‌ها (PRESETS)

برنامه Ecasound دارای سامانه قدرتمندی برای پیش‌تنظیم جلوه‌ها است که به شما امکان می‌دهد با ترکیب جلوه‌ها و کنترل‌کننده‌های پایه، جلوه‌های جدیدی بسازید. برای اطلاعات بیشتر به راهنمای کاربر Ecasound مراجعه کنید.

استفاده از نخستین پیش‌تنظیم یافت‌شده در فایل ’preset_file.eep’ به عنوان یک عملگر زنجیره.
یافتن پیش‌تنظیم ’preset_name’ از پایگاه داده سراسری پیش‌تنظیم‌ها و استفاده از آن به عنوان یک عملگر زنجیره. برای اطلاعات در خصوص پایگاه داده پیش‌تنظیم‌ها به صفحه راهنمای ecasoundrc مراجعه فرمایید.
تحلیل سیگنال (SIGNAL ANALYSIS)
تجزیه و تحلیل داده‌های نمونه برای تعیین میزان امکان تقویت سیگنال بدون وقوع اعوجاج برش (clipping). مقدار درصد حاصل را می‌توان به عنوان یک پارامتر برای گزینه ’-ea’ (تقویت) استفاده کرد. یک خلاصه آماری حاوی اطلاعات مربوط به تصویر استریو و توزیع مقادیر نمونه در پایان پردازش چاپ می‌شود.
دیده‌بان دامنه اوج (peak amplitude watcher). اطلاعات اوج را برای هر کانال پردازش‌شده نگهداری می‌کند. اطلاعات اوج در هر بار خواندن بازنشانی می‌شود.
یافتن مقدار بهینه برای تنظیم DC. می‌توانید از نتیجه به عنوان پارامتری برای جلوه -ezx استفاده کنید.
الگوریتم‌های عمومی پردازش سیگنال (GENERAL SIGNAL PROCESSING ALGORITHMS)
مُهر صوتی (Audio stamp). یک تصویر لحظه‌ای (snapshot) از داده‌های صوتی عبوری می‌گیرد و آن را با شناسه ’stamp-id’ (عدد صحیح) ذخیره می‌کند. این داده‌ها بعداً می‌توانند توسط کنترل‌کننده‌ها و دیگر عملگرها استفاده شوند.
تنظیم دامنه سیگنال روی ’amplify%’ درصد (مقیاس خطی، یعنی نمونه‌های منفرد در ’amplify%/100’ ضرب می‌شوند). همچنین ’-eadb’ را ببینید.
تقویت سیگنال کانال ’channel’ به میزان درصد amplify-% (مقیاس خطی، یعنی نمونه‌های منفرد در ’amplify%/100’ ضرب می‌شوند). دامنه ’channel’ از 1 تا n است که n تعداد کل کانال‌ها می‌باشد. همچنین ’-eadb’ را ببینید.
تنظیم سطح سیگنال بر حسب ’gain-dB’، که در آن بهره 0dB تاثیری بر سیگنال ندارد، مقادیر منفی بهره سیگنال را تضعیف کرده و مقادیر مثبت آن را تقویت می‌کنند. پارامتر ’channel’ (از 1 تا n) اختیاری است. اگر پارامتر ’channel’ مشخص شود و مقدار آن غیرصفر باشد، بهره تنها روی کانال داده‌شده اعمال می‌شود.
تقویت سیگنال به میزان درصد amplify-%. چنانچه تعداد نمونه‌های بریده‌شده (clipped) متوالی بیش از ’max-clipped-samples’ باشد (مقدار نمونه حاصل از محدوده اسمی [-1,1] خارج شود)، یک هشدار صادر خواهد شد.
جلوه محدودکننده (Limiter). سطح صدا را به میزان ’limit-%’ (مقیاس خطی) محدود می‌کند، که در آن مقادیر مساوی یا بیشتر از 100% تغییری در سیگنال ایجاد نمی‌کنند.
کمپرسور یا فشرده‌ساز (یک نسخه ساده). مقدار ’rate’ نرخ فشرده‌سازی بر حسب دسی‌بل است (’rate’ دسی‌بل تغییر در سیگنال ورودی موجب 1dB تغییر در خروجی می‌شود). مقدار ’threshold’ بین 0.0 (سکوت) و 1.0 (بیشینه دامنه) تغییر می‌کند.
یک کمپرسور پیشرفته‌تر (الگوریتم اصلی از John S. Dyson). اگر برای هر پارامتر مقدار 0 بدهید، مقدار پیش‌فرض استفاده می‌شود. پارامتر ’peak-level-%’ اساساً تعیین می‌کند که محدودکننده اوج تا چه اندازه تحت فشار قرار گیرد؛ مقدار پیش‌فرض 69% مناسب است. مقدار ’release_time’ بر حسب ثانیه داده می‌شود. این کمپرسور بسیار پیشرفته است و زمان رهایش (release) آن پیچیده می‌باشد؛ این یکی از کنترل‌های اصلی زمان رهایش است اما زمان واقعی به عوامل زیادی در پویایی موسیقی وابسته است. پارامتر ’fastrate’ نسبت فشرده‌سازی برای کمپرسور سریع است؛ مقدار 1.0 بی‌نهایت به یک است، در حالی که پیش‌فرض 0.50 معادل 2:1 است؛ یک مقدار عالی دیگر 0.25 است که کمی کمتر از 2:1 است و صدایی بسیار یکدست ایجاد می‌کند. پارامتر ’rate’ نسبت فشرده‌سازی برای کل زنجیره کمپرسور است؛ پیش‌فرض 1.0 است و حجم صدا را بدون اثرات جانبی ناخوشایند بسیار ثابت نگه می‌دارد، با این حال پویایی موسیقی به شدت محدود می‌شود و مقدار 0.5 ممکن است ماهیت موسیقی را دست‌نخورده‌تر نگه دارد.
گیت نویز (Noise gate). از پردازش چندکاناله پشتیبانی می‌کند (هر کانال جداگانه پردازش می‌شود). هنگامی که دامنه سیگنال به زیر درصد ’threshold_level_%’ سقوط کند (100% به معنی بیشینه دامنه است)، گیت فعال می‌شود. اگر سیگنال برای مدت ’th_time’ میلی‌ثانیه زیر آستانه بماند، در طول فاز حمله به مدت ’attack’ میلی‌ثانیه محو (fade out) می‌شود. اگر سیگنال بالاتر از ’threshold_level’ برود و بیش از ’hold’ میلی‌ثانیه در آنجا بماند، گیت در طول زمان ’release’ میلی‌ثانیه رها می‌گردد.
تغییردهنده زیروبمی صدا (Pitch shifter). زیروبمی صدا را با تغییر طول آن دگرگون می‌کند.
ترازکننده استریو (Stereo panner). تعادل نسبی میان دو کانال اول را تغییر می‌دهد. هنگامی که ’right-%’ برابر با 0 باشد، تنها سیگنال کانال چپ (اول) عبور داده می‌شود؛ به همین ترتیب اگر ’100’ باشد، تنها کانال راست (دوم) عبور داده می‌شود.
تنظیم آفست DC سیگنال به میزان ’delta-chX’، که در آن X شماره کانال است. از گزینه -ezf برای یافتن مقادیر دلتای بهینه استفاده کنید.
مدولاسیون پوش (ENVELOPE MODULATION)
گیت پالس (سرعت پالس بر حسب ضربه در دقیقه یا bpm داده می‌شود).
گیت پالس.
جلوه ترمولو (Tremolo) (سرعت ترمولو بر حسب ضربه در دقیقه یا bpm مشخص می‌شود).
جلوه‌های فیلتر (FILTER EFFECTS)
فیلتر میان‌گذر تشدیدکننده (Resonant bandpass filter). مقدار ’center_freq’ فرکانس مرکزی است. پهنای باند بر حسب هرتز مشخص می‌شود.
فیلتر پایین‌گذر تشدیدکننده (Resonant lowpass filter). مقدار ’cutoffr_freq’ فرکانس قطع فیلتر است. مقدار ’reso’ نشان‌دهنده تشدید (رزونانس) است؛ معمولاً بهترین مقادیر برای رزونانس میان 1.0 و 2.0 هستند، اما می‌توانید از مقادیر بزرگ‌تر نیز استفاده کنید. مقدار ’gain’ ضریب بهره کلی است؛ این یک ضریب ساده است (1.0 سطح نرمال است)؛ با مقادیر رزونانس بالا اغلب مفید است که مقدار بهره را کاهش دهید..IP
فیلتر پایین‌گذر تشدیدکننده (مرتبه ۳، ۳۶ دسی‌بل، الگوریتم اصلی از Stefan M. Fendt). یک مدار آنالوگ فعال RC-lowpass را شبیه‌سازی می‌کند. فرکانس قطع مقداری در بازه [0,1] و رزونانس مقداری در بازه [0,infinity) است.
فیلتر تمام‌گذر (Allpass filter). تمامی فرکانس‌ها را بدون تغییر در دامنه عبور می‌دهد. با این حال، به‌طور همزمان یک شیفت فاز وابسته به فرکانس اعمال می‌کند.
فیلتر شانه‌ای (Comb filter). اجازه عبور به شاخک‌های شانه را می‌دهد. مقدار ’radius’ باید در بازه [0, 1.0) باشد.
فیلتر میان‌گذر (Bandpass filter). مقدار ’center_freq’ فرکانس مرکزی است. پهنا بر حسب هرتز تعیین می‌شود.
فیلتر بالاگذر (Highpass filter). تنها فرکانس‌های بالاتر از ’cutoff_freq’ عبور داده می‌شوند.
فیلتر شانه‌ای معکوس (Inverse comb filter). شاخک‌های شانه را فیلتر می‌کند. تعداد شاخک‌ها برابر با ’delay_in_samples-2’ است. مقدار ’radius’ باید در بازه [0, 1.0) باشد؛ هر چه به مقدار بیشینه نزدیک‌تر باشد، فرورفتگی‌های شانه عمیق‌تر خواهند بود.
فیلتر پایین‌گذر (Lowpass filter). تنها فرکانس‌های پایین‌تر از ’cutoff_freq’ عبور داده می‌شوند.
فیلتر میان‌ناگذر (Bandreject filter). مقدار ’center_freq’ فرکانس مرکزی است. پهنا بر حسب هرتز تعیین می‌شود.
رزوناتور (Resonator). مقدار ’center_freq’ فرکانس مرکزی است. پهنا بر حسب هرتز تعیین می‌شود. در اصل یک فیلتر میان‌گذر تشدیدکننده دیگر است.
CHANNEL MIXING / ROUTING
کپی کردن کانال ’from_channel’ به ’to_channel’. اگر کانال ’to_channel’ وجود نداشته باشد، ایجاد می‌شود. شماره‌گذاری کانال‌ها از 1 آغاز می‌گردد. این گزینه در نسخه ۲.۴.۵ به ecasound افزوده شد.
کپی کردن کانال ’from_channel’ به ’to_channel’ و بی‌صدا (mute) کردن کانال مبدا ’from_channel’. شماره‌گذاری کانال‌ها از 1 آغاز می‌گردد. این گزینه در نسخه ۲.۴.۵ به ecasound افزوده شد.
تغییر ترتیب، حذف و/یا تکرار کانال‌های زنجیره. جریان صوتی حاصل در مجموع دارای ’N’ کانال خواهد بود. هر پارامتر کانال مبدا را برای کانال خروجی داده‌شده تعیین می‌کند. به عنوان مثال، ’-chorder:2,1’ کانال‌های یک جریان استریو را معکوس می‌کند (’out1,out2’ = ’in2,in1’). تعیین چندباره یک کانال مبدا مجاز است؛ مثلاً ’-chorder:2,2’ کانال دوم را به هر دو کانال خروجی هدایت می‌کند (’out1,out2’ = ’in2,in2’). اگر ’chX’ صفر باشد، کانال مربوطه ’X’ در جریان خروجی بی‌صدا خواهد شد. این گزینه در نسخه ۲.۷.۰ به ecasound افزوده شد.
میکس تمامی کانال‌های مبدا در کانال ’to_channel’. اگر ’to_channel’ وجود نداشته باشد، ایجاد می‌شود. شماره‌گذاری کانال‌ها از 1 آغاز می‌شود. این گزینه در نسخه ۲.۴.۵ به ecasound اضافه شد.
بی‌صدا کردن کانال ’channel’. شماره‌گذاری کانال‌ها از 1 آغاز می‌شود. این گزینه در نسخه ۲.۴.۵ به ecasound اضافه شد.
منسوخ شده، به -chcopy مراجعه کنید.
منسوخ شده، به -chmix مراجعه کنید.
TIME-BASED EFFECTS
جلوه کروس (Chorus).
جلوه تاخیر (Delay). مقدار ’delay time’ زمان تاخیر بر حسب میلی‌ثانیه است. مقدار ’surround-mode’ یک عدد صحیح با معانی زیر است: 0 = نرمال، 1 = فراگیر (surround)، 2 = گسترش استریو (stereo-spread). مقدار ’number_of_delays’ تعداد تکرارها است؛ توجه داشته باشید که تعداد بالای تاخیرها و زمان‌های تاخیر طولانی نیاز به توان پردازشی بالای CPU دارد. مقدار ’mix-%’ تعادل میکس میان سیگنال اصلی و تاخیریافته را بیان می‌کند، به طوری که 0 به معنی عدم وجود سیگنال تاخیریافته، 100 به معنای حذف سیگنال اصلی، و 50 (پیش‌فرض) برای تعادل مساوی است. مقدار ’feedback-%’ نشان می‌دهد چه مقدار از سیگنال در هر تاخیر بازچرخانی می‌شود یا به بیانی دیگر، قطعه صوتی تکرارشده با چه سرعتی محو می‌گردد؛ توجه داشته باشید که مقادیر بازخورد به اندازه کافی پایین ممکن است منجر به تعداد تکرارهای شنیداری کمتری نسبت به مقدار تعیین‌شده در ’number_of_delays’ شود، به ویژه اگر مقدار پایینی برای ’mix-%’ تنظیم کرده باشید؛ مقدار پیش‌فرض این پارامتر 100% است (بدون افت سیگنال).
یک جلوه طنین (ریورب / Reverb) پیشرفته‌تر (الگوریتم اصلی توسط Stefan M. Fendt). مقدار ’room_size’ بر حسب متر داده می‌شود، ’feedback-%’ سطح بازخورد بر حسب درصد است و ’wet-%’ میزان سیگنال طنین‌دارشده اضافه به سیگنال اصلی است.
جلوه استریوی ساختگی (Fake-stereo). سیگنال ورودی به مونو تبدیل می‌شود؛ سیگنال اصلی به کانال چپ می‌رود در حالی که یک نسخه تاخیریافته (با تاخیر ’delay time’ میلی‌ثانیه) به کانال راست فرستاده می‌شود؛ با زمان تاخیر ۱ تا ۴۰ میلی‌ثانیه، این جلوه حس استریو را به سیگنال‌های مونو می‌افزاید.
جلوه فلنجر (Flanger).
تاخیر چندشاخه (Multitap delay). مقدار ’delay time’ زمان تاخیر بر حسب میلی‌ثانیه است؛ پارامتر ’number_of_delays’ تعداد تکرارها را مشخص می‌کند؛ و ’mix-%’ تعیین می‌کند چه میزان از سیگنال افکت‌خورده (wet) با سیگنال اصلی میکس شود.
جلوه فیزر (Phaser).
جلوه طنین (Reverb). مقدار ’delay time’ زمان تاخیر بر حسب میلی‌ثانیه است؛ اگر ’surround-mode’ برابر با ’surround’ باشد، سیگنال طنین‌دار درون تصویر استریو جابه‌جا می‌شود؛ مقدار ’feedback-%’ تعیین می‌کند چه مقدار از سیگنال افکت‌خورده به ریورب بازخورد داده شود.
LADSPA-PLUGINS
اکاساند از افزونه‌های افکت LADSPA (واسط برنامه‌نویسی ساده افزونه‌های توسعه‌دهنده صوت لینوکس) پشتیبانی می‌کند. پارامترهای ۱ تا N به عنوان مقادیر درگاه‌های کنترلی افزونه تنظیم می‌شوند.
اگر افزونه بیش از یک درگاه ورودی و/یا خروجی صوتی داشته باشد، تنها یک نمونه از افزونه ایجاد می‌شود و کانال‌های زنجیره به همان یک نمونه داده می‌شوند. اگر افزونه حداکثر دارای یک درگاه ورودی و حداکثر یک درگاه خروجی صوتی باشد، برای هر کانال زنجیره اکاساند یک نمونه افزونه جداگانه ایجاد می‌شود (مثلاً برای یک کانال صوتی استریو، دو افزونه LADSPA از همان نوع ساخته می‌شود که برای هر کانال یکی خواهد بود).
افزونه‌ها در پرونده‌های کتابخانه اشتراکی (.so) قرار دارند. اکاساند افزونه‌ها را در @prefix@/lib/ladspa (مثلاً "/usr/local/lib/ladspa") و دایرکتوری‌های فهرست‌شده در متغیر محیطی LADSPA_PATH جستجو می‌کند. مسیر جستجوی افزونه را می‌توان از طریق ecasoundrc نیز پیکربندی کرد؛ به صفحه راهنمای ecasoundrc(5) مراجعه کنید. یک پرونده کتابخانه اشتراکی می‌تواند حاوی چندین شیء افزونه باشد، اما هر افزونه نام یکتای خود را دارد که برای انتخاب افزونه استفاده می‌شود.
برای اطلاعات بیشتر در مورد LADSPA به وب‌سایت لیست پستی LAD مراجعه کنید. سایر سایت‌های مفید صفحه اصلی LADSPA و مستندات LADSPA هستند.
مشابه با مورد بالا (-el)، با این تفاوت که از شماره شناسه یکتای افزونه استفاده می‌شود. تضمین شده است که این شماره‌های شناسه در میان تمام افزونه‌های LADSPA یکتا هستند.
LV2 PLUGINS
اکاساند همچنین از افزونه‌های صوتی LV2 پشتیبانی می‌کند. افزونه‌های LV2 با یک شناسه حساس به حروف بزرگ و کوچک و یکتا در سطح جهانی شناخته می‌شوند.
اگر افزونه بیش از یک درگاه ورودی و/یا خروجی صوتی داشته باشد، تنها یک نمونه ایجاد شده و کانال‌های زنجیره به آن ارسال می‌شوند. اگر افزونه حداکثر دارای یک درگاه ورودی و خروجی صوتی باشد، برای هر کانال زنجیره یک نمونه جداگانه ایجاد می‌شود (برای کانال استریو، دو افزونه LV2 از همان نوع ایجاد می‌شود).
افزونه LV2 یک استاندارد برای افزونه‌های سامانه‌های صوتی است.

GATE SETUP

گیت برش زمانی (Time crop gate). در ابتدا گیت بسته است. پس از گذشت ’start-time’ ثانیه، گیت باز شده و به مدت ’len’ ثانیه باز می‌ماند. در زمان بسته بودن، بافرهای صوتی عبوری به طول صفر کوتاه می‌شوند.
گیت آستانه (Threshold gate). در ابتدا گیت بسته است. هنگامی که حجم صدا از درصد ’othreshold’ بالاتر رود باز می‌شود. پس از آن، اگر حجم صدا به زیر درصد ’cthold’ افت کند، گیت بسته شده و دوباره باز نخواهد شد، مگر اینکه ’reopen-count’ روی مقداری غیر از صفر تنظیم شده باشد. اگر ’value_mode’ برابر با ’rms’ باشد، میانگین حجم RMS استفاده می‌شود؛ در غیر این صورت میانگین اوج به کار می‌رود. در حالت بسته، بافرهای صوتی عبوری به طول صفر کوتاه می‌شوند. اگر ’reopen-count’ به یک عدد مثبت تنظیم شود، گیت عملکرد خود را همان تعداد بار مجدداً آغاز خواهد کرد؛ بنابراین برای مثال مقدار reopen count برابر با 1 موجب حداکثر ۲ بار باز شدن گیت می‌شود. یک مقدار منفی برای ’reopen-count’ منجر به بازگشایی نامحدود گیت می‌گردد. پارامتر ’reopen-count’ در ضبط صفحات گرامافون و نوارهای کاست بسیار ارزشمند است، جایی که می‌توانید همه‌چیز را تنظیم کنید و سپس ضبط هر زمان که سوزن روی صفحه قرار گیرد آغاز شده و با برداشتن سوزن متوقف گردد. هر تعداد طرف صفحه که بخواهید را می‌توان در یک نشست ضبط کرد. شما باید با طول‌های بافر و سطوح شروع/توقف آزمایش کنید تا تنظیمات مطمئنی برای تجهیزات خود به دست آورید.
گیت دستی (Manual gate). اگر ’state’ برابر با 1 باشد، گیت باز است و تمام نمونه‌ها عبور داده می‌شوند. اگر ’state’ صفر باشد، گیت بسته است و هیچ نمونه‌ای اجازه عبور ندارد. این عملگر زنجیره زمانی مفید است که نوشتن روی یک خروجی باید به صورت پویا (بدون متوقف کردن کل موتور) متوقف شود.
CONTROL ENVELOPE SETUP
از کنترل‌کننده‌ها می‌توان برای تغییر پویای پارامترهای جلوه در حین پردازش استفاده کرد. تمام کنترل‌کننده‌ها به جلوهٔ انتخاب‌شده (=معمولاً آخرین جلوه/کنترل‌کنندهٔ مشخص‌شده) متصل می‌شوند. سه پارامتر نخست میان تمام کنترل‌کننده‌ها مشترک هستند. پارامتر ’fx_param’ پارامتری را که باید کنترل شود تعیین می‌کند. مقدار ’1’ به معنای اولین پارامتر، ’2’ به معنای دومین پارامتر و الی آخر است. مقادیر ’start_value’ و ’end_value’ دامنهٔ مقادیر را تنظیم می‌کنند. برای مشاهده مثال‌ها به بخش مثال‌ها (EXAMPLES) مراجعه کنید.
نوسان‌ساز سینوسی با فرکانس ’freq’ هرتز و فاز اولیهٔ ’i_phase’ برابر با عدد پی (pi).
نوسان‌ساز عمومی (Generic oscillator). فرکانس ’freq’ هرتز، حالت برابر با ’0’ برای مقادیر ایستا یا ’1’ برای درون‌یابی خطی است. پارامتر ’point-pairs’ تعداد جفت‌های ’posN’ - ’valueN’ موجود را تعیین می‌کند. مقادیر ’first-value’ و ’last-value’ به عنوان مقادیر مرزی (مقادیر مربوط به موقعیت 0.0/اول و موقعیت 1.0/آخر) استفاده می‌شوند. تمام مقادیر ’posN’ و ’valueN’ باید بین 0.0 و 1.0 باشند. همچنین، برای تمام مقادیر ’posN’ باید رابطهٔ ’pos1 < pos2 < ... < posN’ برقرار باشد.
نوسان‌ساز عمومی (Generic oscillator). مقدار ’genosc_number’ شمارهٔ پیش‌تنظیم نوسان‌ساز برای بارگذاری است. حالت برابر با ’0’ برای مقادیر ایستا یا ’1’ برای درون‌یابی خطی است. مسیر فایل پیش‌تنظیم از ./ecasoundrc گرفته می‌شود (به صفحه راهنمای ecasoundrc مراجعه کنید).
پوش خطی که از ’start_value’ آغاز شده و در طول ’time_in_seconds’ ثانیه به صورت خطی به ’end_value’ تغییر می‌کند. می‌تواند برای محو تدریجی به داخل (fade-in) و محو تدریجی به خارج (fade-out) به کار رود.
پوش خطی دو مرحله‌ای، ابزاری چندمنظوره‌تر برای انجام محو تدریجی به داخل و خارج (fade-in و fade-out). به مدت ’1st_stage_length’ ثانیه در ’start_value’ باقی می‌ماند و سپس در طول ’2nd_stage_length’ ثانیه به صورت خطی به سمت ’end_value’ تغییر می‌کند.
پوش خطی عمومی (Generic linear envelope). این منبع کنترل‌کننده می‌تواند برای نگاشت پوش‌های سفارشی به پارامترهای عملگر زنجیره استفاده شود. تعداد نقاط پوش در ’point_count’ تعیین می‌شود. هر نقطهٔ پوش از یک موقعیت و یک مقدار متناظر تشکیل شده است. تعداد جفت‌ها باید با ’point_count’ مطابقت داشته باشد (یعنی ’N==point_count’). پارامترهای ’posX’ بر حسب ثانیه (از ابتدای جریان صوتی) داده می‌شوند. نقاط پوش به صورت مقادیر ممیز شناور (float) در بازهٔ ’[0,1]’ تعیین می‌شوند. پیش از اینکه مقادیر پوش به پارامترهای عملگر نگاشت شوند، به بازهٔ هدف ’[low-value,high-value]’ نگاشت می‌شوند؛ به عنوان مثال مقدار ’0’ پارامتر عملگر را روی ’low-value’ و مقدار ’1’ آن را روی ’high-value’ تنظیم خواهد کرد. برای قطعهٔ آغازین ’[0,pos1]’، پوش مقدار ’value1’ (مثلاً ’low-value’) را تولید خواهد کرد.
کنترل‌کنندهٔ پیوستهٔ MIDI (پیام‌های تغییر کنترل یا Control Change). پیام‌های موجود روی کانال MIDI با شمارهٔ ’channel’ که از شمارهٔ کنترل‌کنندهٔ ’controller’ دریافت می‌شوند، به عنوان منبع کنترل‌کننده به کار می‌روند. همان‌گونه که در مشخصات فنی MIDI توصیه شده است، شماره‌گذاری کانال‌ها از 1 تا 16 انجام می‌گیرد. شماره‌های کنترل‌کنندهٔ معتبر، مقادیری از 0 تا 127 هستند. دستگاه MIDI که بایت‌ها از آن خوانده می‌شوند را می‌توان با استفاده از گزینهٔ -Md تعیین کرد. در غیر این صورت، از دستگاه MIDI پیش‌فرضی که در ~ecasound/ecasoundrc مشخص شده است استفاده می‌شود (به صفحه راهنمای ecasoundrc مراجعه کنید). مقدار پیش‌فرض /dev/midi است. کنترل‌کننده تحلیل بلندی صدا. داده‌های صوتی ذخیره‌شده در نشانگر ’stamp-id’ (مستندات ’-eS:id’ را ببینید) را تحلیل کرده و بر اساس نتایج، داده‌های کنترلی ایجاد می‌کند. اگر ’rms-toggle’ غیرصفر باشد، از RMS-volume برای محاسبه مقدار کنترل استفاده می‌شود. در غیر این صورت از میانگین دامنه اوج (peak-amplitude) استفاده می‌شود.
این یک سوئیچ ویژه است که می‌توان هنگام نیاز به کنترل پارامترهای یک کنترل‌کننده با کنترل‌کننده‌ای دیگر، از آن استفاده کرد. هنگامی که -kx را مشخص می‌کنید، آخرین کنترل‌کننده تعیین‌شده به عنوان هدف کنترل تنظیم خواهد شد. سپس تنها کافی است کنترل‌کننده دیگری را طبق روال معمول اضافه کنید.

حالت تعاملی (INTERACTIVE MODE)

صفحه راهنمای ecasound-iam(1) را ببینید.

در صورت تعریف شدن، برخی از برنامه‌های کمکی و اسکریپت‌ها از متغیر محیطی ECASOUND به عنوان مسیر پیش‌فرض برای فایل اجرایی ecasound استفاده خواهند کرد.
ارسال همه پیام‌های اشکال‌زدایی به یک فایل لاگ جداگانه. در صورت تعریف شدن، ECASOUND_LOGFILE مسیر فایل لاگ را تعیین می‌کند. این ابزار مناسبی برای اشکال‌زدایی اسکریپت‌ها و برنامه‌های ECI/EIAM است.
انتخاب پیام‌هایی که در فایل لاگ تعیین‌شده توسط ECASOUND_LOGFILE نوشته می‌شوند. از نحو دستوری -d:level استفاده می‌شود. اگر تعریف نشود، همه پیام‌ها نوشته می‌شوند. مقدار پیش‌فرض -d:319 است (همه چیز به جز پیام‌های رده ’functions (64)’ و ’continuous (128)’).
برنامه Ecasound هنگام قالب‌بندی پیام‌های ردگیری (trace) چاپ‌شده، متغیر محیطی COLUMNS را رعایت می‌کند. اگر COLUMNS تنظیم نشده باشد، مقدار پیش‌فرض 74 به کار می‌رود.
برخی از عملکردهای Ecasound (مانند دستور تعاملی "cs-edit") نیازمند ایجاد فایل‌های موقت هستند. به طور پیش‌فرض، این فایل‌ها در "/tmp" ایجاد می‌شوند، اما این مقدار را می‌توان با تنظیم متغیر محیطی TMPDIR لغو و جایگزین کرد.

در حالت تعاملی، ecasound همیشه مقدار صفر را برمی‌گرداند.
در حالت غیرتعاملی (دسته‌ای)، برای خطاهای زیر یک مقدار غیرصفر برگردانده می‌شود:
1
ناتوان در ایجاد یک پیکربندی زنجیره (chainsetup) معتبر با پارامترهای داده‌شده. این خطا می‌تواند ناشی از نحو نامعتبر گزینه‌ها و غیره باشد.
2
ناتوان در شروع پردازش. این خطا می‌تواند ناشی از ناکافی بودن مجوزهای فایل، عدم امکان دسترسی به برخی منابع سیستم و غیره باشد.
3
خطا در حین پردازش. علل احتمالی: تمام شدن فضای خالی دیسک برای شیء خروجی و غیره.
4
خطا در حین خاتمه فرایند و/یا پاک‌سازی. برای جزئیات بیشتر بخش ’SIGNALS’ را ببینید.

هنگامی که ecasound هر یک از سیگنال‌های POSIX شامل SIGINT (ctrl-c)، SIGHUP، SIGTERM یا SIGQUIT را دریافت کند، روال عادی پاک‌سازی و خروج آغاز می‌شود. در اینجا خروج عادی بدین معناست که به عنوان مثال، هدرهای فایل پیش از بسته شدن به‌روزرسانی می‌شوند، فرایندهای کمکی به شیوه عادی خاتمه می‌یابند، و مواردی از این دست.

اگر در حین انجام پاک‌سازی شرح‌داده‌شده در بالا، ecasound سیگنال دیگری (از همان مجموعه سیگنال‌های POSIX) دریافت کند، ecasound از روال پاک‌سازی عادی صرف‌نظر کرده و فوراً خاتمه می‌یابد. تمامی وظایف باقی‌مانده پاک‌سازی نادیده گرفته خواهند شد. بسته به وضعیت زمان اجرا و پیکربندی، این خروج اجباری ممکن است عوارض جانبی داشته باشد. در صورتی که از پاک‌سازی عادی صرف‌نظر شود، Ecasound کد خروج ’4’ را بازخواهد گرداند.

رسیدگی به حالت خاص برای سیگنال SIGINT (ctrl-c) اعمال می‌شود. اگر در طول روال پاک‌سازی یک سیگنال SIGINT دریافت شود، برنامه ecasound یک بار این سیگنال را نادیده گرفته و پیامی را به ’stderr’ ارسال می‌کند مبنی بر اینکه پاک‌سازی از قبل در حال انجام است. هر سیگنال SIGINT بعدی دیگر تحت این رسیدگی خاص قرار نخواهد گرفت و در عوض، فرایند فوراً (و احتمالاً بدون پاک‌سازی مناسب) خاتمه خواهد یافت.

~/.ecasound دایرکتوری پیش‌فرض برای فایل‌های منبع کاربری ecasound. صفحه راهنمای ecasoundrc (5) را ببینید.

*.ecs فایل‌های Chainsetup مربوط به ecasound. نحو کم‌وبیش همانند آرگومان‌های خط فرمان است.

*.ecp فایل‌های Chain Preset مربوط به ecasound. برای ذخیره پیش‌تنظیم‌های جلوه (effect) و عملگر زنجیره استفاده می‌شود. برای مستندات بهتر، راهنمای کاربر ecasound را ببینید.

*.ews فایل‌های Ecasound Wave Stats. این فایل‌ها برای کش کردن داده‌های شکل‌موج استفاده می‌شوند.

مثال‌هایی از نحوه انجام کارهای متداول با ecasound را می‌توانید در نشانی زیر بیابید: http://nosignal.fi/ecasound/Documentation/examples.html

صفحه راهنمای ecatools (1)، صفحه راهنمای ecasound-iam (1)، صفحه راهنمای ecasoundrc (5)، "مستندات HTML در زیردایرکتوری Documentation"

فایل BUGS را ببینید. اگر ecasound رفتار عجیبی دارد، سعی کنید سطح اشکال‌زدایی (debug level) را افزایش دهید تا متوجه شوید چه رخ می‌دهد.

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

05.05.2011