نام (NAME)

ecaconvert - ابزار تبدیل قالب و پردازش فایل‌های صوتی مبتنی بر 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 ابزارهای ساده خط فرمان برای پردازش فایل‌های صوتی هستند. هر ابزار برای انجام یک عملیات مشخص طراحی شده است. بیشتر این ابزارها از پردازش دسته‌ای نیز پشتیبانی می‌کنند.

ECACONVERT

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

ECAFIXDC

ابزاری ساده در خط فرمان برای رفع آفست DC.

ECALENGTH

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

ECAMONITOR

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

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

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

ECANORMALIZE

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

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 برای پایش دامنه سیگنال و آمار قله‌ها (peaks) در نظر گرفته شده است. این ابزار گزینه‌های زیر را می‌پذیرد:

input

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

output

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

-b:buffersize

اندازه بافر بر حسب فریم‌های نمونه. مقدار پیش‌فرض ۱۲۸ است.

-c

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

-d

فعال‌سازی حالت اشکال‌زدایی.

-f:format_string

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

-r:rate_msec

تعیین نرخ تازه‌سازی صفحه بر حسب میلی‌ثانیه.

-I

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

-L

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

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

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

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

spacebar

بازنشانی آمارها (بیشینه قله، میانگین دامنه و تعداد نمونه‌های بریده‌شده).

q or Q or Esc

خروج از ecasignalview.

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

مستندات کامل‌تر درباره ecasignalview را می‌توان در «راهنمای کاربر Ecasound» یافت (به نشانی http://nosignal.fi/ecasound بخش مستندات مراجعه کنید).

محیط (ENVIRONMENT)

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

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

فایل‌ها (FILES)

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

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

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

ecasound(1), ecalength(1), مستندات HTML در زیرپوشه Documentation

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

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