| 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) نیز پشتیبانی می‌کنند.
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) تقویت شود و چنانچه فضایی برای افزایش وجود داشته باشد، یک بهره تقویت (gain) ایستا به فایل اعمال خواهد شد.
ECAPLAY
برنامه Ecaplay ابزاری خط فرمانی برای پخش فایل‌های صوتی است. Ecaplay از موتور libecasound بهره می‌برد و بنابراین قادر است تمام قالب‌های صوتی پشتیبانی‌شده توسط کتابخانه را مدیریت کند.
فایل‌ها را می‌توان با مشخص کردن نام آن‌ها در خط فرمان یا با استفاده از سازوکار فهرست پخش برای پخش انتخاب کرد. در حالت فهرست پخش، می‌توان با استفاده از گزینه -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). مقدار پیش‌فرض 128 است.
- -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 samples).
- q or Q or Esc
- خروج از ecasignalview.
- همچنین می‌توان شمارنده‌های max-peak و clipped-samples را با ارسال سیگنال SIGHUP به فرایند بازنشانی کرد (یعنی از کنسولی دیگر: "killall -v -HUP ecasignalview";).
مستندات کامل‌تر درباره ecasignalview را می‌توان در "راهنمای کاربر Ecasound" یافت (به ’’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>>;
| 12.11.2005 |