نام (NAME)

ecatools - ابزارهای پردازش صوت مبتنی بر ecasound

خلاصه دستور (SYNOPSIS)

ecaconvert .extension file1 [ file2 ... fileN ]

ecafixdc file1 [ file2 ... fileN ]

ecalength file1 [ file2 ... fileN ]

ecamonitor [host][:port]

ecanormalize file1 [ file2 ... fileN ]

ecaplay [-dfhklopq] [ file1 file2 ... fileN ]

ecasignalview [ options ] [ input ] [ output ]

توضیحات (DESCRIPTION)

ابزارهای ecatools ابزارهای خط فرمانی ساده‌ای برای پردازش فایل‌های صوتی هستند. هر ابزار برای انجام یک عملیات خاص طراحی شده است. بیشتر این ابزارها از پردازش دسته‌ای (batch processing) نیز پشتیبانی می‌کنند.

ECACONVERT

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

ECAFIXDC

ابزار خط فرمانی ساده برای اصلاح آفست DC (جریان مستقیم).

ECALENGTH

صفحه راهنمای مجزای ecalength(1) را ببینید.

ECAMONITOR

برنامه ecamonitor ابزاری کاربردی است که می‌تواند برای نظارت بر یک نشست فعال ecasound به کار رود. برنامه ecamonitor قادر است اطلاعات مربوط به chainsetup فعلی مانند فهرست ورودی‌ها، خروجی‌ها، موقعیت جاری، جلوه‌ها (effects)، وضعیت موتور و موارد متعدد دیگری را نمایش دهد.

به طور پیش‌فرض ecamonitor تلاش می‌کند به نشانی IP4 با مقدار "localhost" و پورت "2868" متصل شود. نشانی متفاوتی را می‌توان هنگام راه‌اندازی ecamonitor مشخص کرد، برای مثال "ecamonitor foo.mynetwork.com" یا "ecamonitor foo.mynetwork.com:4500".

برای فعال‌سازی اتصالات ورودی، ecasound باید با گزینه --daemon راه‌اندازی شود. برنامه ecamonitor با استفاده از NetECI API در پایتون پیاده‌سازی شده است.

ECANORMALIZE

برنامه ecanormalize یک ابزار خط فرمانی برای نرمال‌سازی فایل‌های صوتی جهت بهره‌گیری از حداکثر تفکیک‌پذیری نمونه (sample resolution) موجود است. برنامه ecanormalize ابتدا بررسی می‌کند که فایل ورودی بدون اعوجاج و برش (clipping) تا چه اندازه قابل تقویت است و در صورت وجود فضا برای افزایش، یک بهره (gain) ایستا به فایل اعمال خواهد شد.

ECAPLAY

برنامه ecaplay ابزاری خط فرمانی برای پخش فایل‌های صوتی است. برنامه ecaplay از موتور libecasound استفاده می‌کند و در نتیجه قادر به مدیریت تمام قالب‌های صوتی پشتیبانی‌شده توسط این کتابخانه است.

فایل‌ها را می‌توان هم با تعیین نام آن‌ها در خط فرمان و هم با استفاده از سازوکار لیست پخش (playlist) برای پخش انتخاب کرد. در حالت لیست پخش، می‌توان فایل‌ها را با استفاده از گزینه -q به لیست پخش اضافه کرد. سپس می‌توان از گزینه -p برای پخش تمام ترک‌های موجود در لیست پخش استفاده نمود. برنامه ecaplay ترک‌های لیست پخش را تا زمانی که صریحاً متوقف شود (با فشردن دو بار Ctrl-C) تکرار خواهد کرد. لیست پخش را می‌توان با -f پاکسازی کرد و محتویات آن را با گزینه -l فهرست نمود.

در صورتی که به شکل دیگری تعیین نشده باشد، ecaplay برای پخش از دستگاه خروجی صوتی مشخص‌شده در ~/.ecasound/ecasoundrc استفاده خواهد کرد. دستگاه خروجی متفاوتی را می‌توان با متغیر محیطی شل ECAPLAY_OUTPUT_DEVICE یا با گزینه خط فرمان -o:output_device انتخاب کرد.

پخش را می‌توان در هر زمانی با Ctrl-C متوقف کرد. در صورت پخش چندین فایل، اولین Ctrl-C فایل جاری را متوقف کرده و به پخش فایل بعدی می‌رود. زدن دوبار Ctrl-C (در مدت یک ثانیه) موجب خروج ecaplay خواهد شد.

-d:debuglevel

تنظیم سطح دیباگ libecasound. به ecasound(1) مراجعه کنید.

-f

پاکسازی محتویات لیست پخش. همچنین گزینه‌های -l، -p و -q را ببینید.

-h

چاپ اطلاعات نحوه استفاده و خروج.

-k:number

پرش از روی ’number’ فایل.

-l

فهرست کردن محتویات فعلی لیست پخش در stdout. همچنین گزینه‌های -f، -p و -q را ببینید.

-o:output_device

استفاده از ’output_device’ به جای دستگاه خروجی پیش‌فرض (همان‌طور که در ~/.ecasound/ecasoundrc تعیین شده است). نحو مشابه گزینه "-o" در ecasound است (صفحه راهنمای ecasound(1) را ببینید). این گزینه متغیر محیطی ECAPLAY_OUTPUT_DEVICE را بازنویسی می‌کند (توضیحات بیشتر در زیر).

-p

پخش ترک‌های لیست پخش (در حالت تکرار حلقه). همچنین گزینه‌های -f، -l و -q را ببینید.

-q

صف‌بندی ترک‌های جدید در لیست پخش. تمام نام‌فایل‌های ارائه‌شده در خط فرمان به لیست پخش اضافه خواهند شد. این امکان وجود دارد که در حالی که نمونه دیگری از ecaplay در حال استفاده از لیست پخش است، ترک‌های جدیدی را در صف قرار داد. همچنین گزینه‌های -f، -l و -p را ببینید.

ECASIGNALVIEW

ابزار ecasignalview برای نظارت بر دامنه سیگنال و آمار پیک در نظر گرفته شده است. این ابزار گزینه‌های زیر را می‌پذیرد:

input

نخستین گزینه‌ای که با ’-’ شروع نشود به عنوان یک رشته ورودی تفسیر می‌شود. این می‌تواند یک دستگاه یا یک نام‌فایل باشد. تمام قالب‌های پشتیبانی‌شده توسط libecasound پذیرفته می‌شوند. پیش‌فرض ’/dev/dsp’ است.

output

مشابه ورودی، دومین گزینه‌ای که با ’-’ شروع نشود به عنوان خروجی تفسیر می‌شود. پیش‌فرض ’null’ است.

-b:buffersize

اندازه بافر بر حسب فریم‌های نمونه (sample frames). پیش‌فرض 128 است.

-c

فعال‌سازی حالت تجمعی (cumulative). شمارنده‌ها پس از تازه‌سازی بازنشانی نمی‌شوند. *منسوخ‌شده*

-d

فعال‌سازی حالت دیباگ.

-f:format_string

تعیین قالب صوتی پیش‌فرض. برای جزئیات به ecasound(1) مراجعه کنید.

-r:rate_msec

تعیین نرخ نوسازی (refresh rate) صفحه بر حسب میلی‌ثانیه.

-I

استفاده از مقیاس خطی برای نمایش دامنه نمونه صوت.

-L

استفاده از مقیاس لگاریتمی برای نمایش دامنه نمونه صوت.

-G, -B, -M*, -r, -z

گزینه‌های ecasound که برای تغییر رفتار موتور به کار می‌روند؛ برای جزئیات به صفحه راهنمای ecasound(1) مراجعه کنید.

هنگامی که ecasignalview در حال اجرا است، می‌توان از دستورهای صفحه‌کلید زیر برای کنترل عملیات استفاده کرد (نیازمند پشتیبانی سیستم از کنترل رابط ترمینال UNIX است):

spacebar

بازنشانی آمارها (حداکثر پیک، میانگین دامنه و تعداد نمونه‌های بریده‌شده/clipped).

q or Q or Esc

خروج از ecasignalview.

همچنین می‌توان با ارسال سیگنال SIGHUP به فرایند، شمارنده‌های حداکثر پیک و نمونه‌های بریده‌شده را بازنشانی کرد (یعنی از کنسول دیگری: "killall -v -HUP ecasignalview";).

مستندات کامل‌تر برای ecasignalview را می‌توان در "Ecasound User’s Guide" یافت (به ’’http://nosignal.fi/ecasound -> Documentation’’ مراجعه کنید).

محیط (ENVIRONMENT)

ECASOUND مسیر فایل اجرایی ecasound. توسط بسیاری از ابزارهای ecatools استفاده می‌شود.

ECAPLAY_OUTPUT_DEVICE دستگاهی که ecaplay باید برای خروجی صوتی استفاده کند. نحوی مشابه گزینه "-o" در ecaplay/ecasound دارد.

فایل‌ها (FILES)

~/.ecasound/ecasoundrc فایل منبع (resource file) پیش‌فرض ecasound. برای جزئیات به ecasoundrc(5) مراجعه کنید.

~/.ecasound/ecaplay_queue فایل مورد استفاده برای ذخیره لیست پخش ecaplay (یک ترک در هر خط به همراه مسیر کامل).

همچنین ببینید (SEE ALSO)

ecasound (1), ecalength(1), "HTML docs in the Documentation subdirectory"

نویسندگان (AUTHORS)

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