| ecatools(1) | نرم‌افزار چندرسانه‌ای | 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.
ECALENGTH
صفحه راهنمای جداگانه ecalength(1) را ببینید.
ECAMONITOR
برنامه کاربردی ecamonitor ابزاری است که می‌تواند برای پایش یک نشست فعال ecasound به کار رود. ecamonitor قادر است اطلاعات مربوط به chainsetup جاری مانند فهرست ورودی‌ها، خروجی‌ها، موقعیت کنونی، جلوه‌ها (افکت‌ها)، وضعیت موتور صوتی و موارد بسیار دیگری را نمایش دهد.
به طور پیش‌فرض ecamonitor تلاش می‌کند به نشانی IP4 با مقدار "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 بهره می‌برد و بنابراین قادر به مدیریت تمام قالب‌های صوتی پشتیبانی‌شده توسط کتابخانه است.
فایل‌ها را می‌توان یا با مشخص کردن نام آن‌ها در خط فرمان یا با استفاده از سازوکار فهرست پخش (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). پیش‌فرض 128 است.
- -c
- فعال‌سازی حالت انباشته (تجمعی). شمارنده‌ها پس از بازآوری بازنشانی نمی‌شوند. *منسوخ‌شده*
- -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 count).
- 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 فایل پیکربندی و منبع پیش‌فرض 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 |