| ecatools(1) | Multimedia software | ecatools(1) |
نام (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-offset.
ECALENGTH
صفحه راهنمای مجزای ecalength(1) را ببینید.
ECAMONITOR
برنامه Ecamonitor ابزاری کاربردی است که می‌تواند برای پایش یک نشست فعال ecasound به کار رود. Ecamonitor قادر است اطلاعاتی درباره chainsetup فعلی مانند فهرست ورودی‌ها، خروجی‌ها، موقعیت کنونی، جلوه‌ها، وضعیت موتور و موارد متعدد دیگری را نمایش دهد.
به‌طور پیش‌فرض ecamonitor تلاش می‌کند به آدرس IPv4 با مقدار "localhost" و درگاه "2868" متصل شود. هنگام اجرای ecamonitor می‌توان آدرس دیگری را مشخص کرد، برای نمونه: "ecamonitor foo.mynetwork.com" یا "ecamonitor foo.mynetwork.com:4500".
برای فعال‌سازی اتصال‌های ورودی، ecasound باید با گزینه --daemon اجرا شود. Ecamonitor با پایتون و با استفاده از NetECI API پیاده‌سازی شده است.
ECANORMALIZE
ابزار Ecanormalize برنامه‌ای خط فرمانی برای نرمال‌سازی فایل‌های صوتی جهت استفاده از حداکثر تفکیک‌پذیری نمونه‌های در دسترس است. Ecanormalize ابتدا بررسی می‌کند که فایل ورودی چقدر می‌تواند بدون برش و اعوجاج (clipping) تقویت شود و در صورتی که فضا برای افزایش وجود داشته باشد، یک بهره ثابت (static 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 در حال اجراست، کلیدهای فرمان زیر را می‌توان برای کنترل عملکرد آن به کار برد (نیازمند پشتیبانی سیستم از واسط کنترل ترمینال UNIX است):
- spacebar
- بازنشانی آمارها (max-peak، avg-amplitude و تعداد نمونه‌های بریده‌شده [clipped]).
- q or Q or Esc
- خروج از ecasignalview.
- همچنین امکان بازنشانی شمارنده‌های max-peak و clipped-samples با ارسال سیگنال 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>>;
| 12.11.2005 |