نام (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 (DC-offset).

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

input

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

output

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

-b:buffersize

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

-c

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

-d

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

-f:format_string

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

-r:rate_msec

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

-I

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

-L

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

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

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

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

spacebar

بازنشانی آمارها (max-peak، avg-amplitude و تعداد نمونه‌های بریده‌شده).

q or Q or Esc

خروج از ecasignalview.

همچنین می‌توان با ارسال یک سیگنال SIGHUP به فرایند، شمارنده‌های max-peak و clipped-samples را بازنشانی کرد (مثلاً از کنسولی دیگر: "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 فایل پیکربندی و منابع پیش‌فرض 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>>;