.TH "ecatools" "1" "12\&.11\&.2005" "" "Multimedia software"

.PP 
.SH "نام (NAME)"
ecatools \- ابزارهای پردازش صوتی مبتنی بر ecasound
.PP 
.SH "خلاصه دستور (SYNOPSIS)"
\fBecaconvert\fP \&.extension file1 [ file2 \&.\&.\&. fileN ]
.PP 
\fBecafixdc\fP file1 [ file2 \&.\&.\&. fileN ]
.PP 
\fBecalength\fP file1 [ file2 \&.\&.\&. fileN ]
.PP 
\fBecamonitor\fP [host][:port]
.PP 
\fBecanormalize\fP file1 [ file2 \&.\&.\&. fileN ]
.PP 
\fBecaplay\fP [\-dfhklopq] [ file1 file2 \&.\&.\&. fileN ]
.PP 
\fBecasignalview\fP [ options ] [ input ] [ output ]
.PP 
.SH "توضیحات (DESCRIPTION)"

.PP 
ابزارهای Ecatools ابزارهای خط فرمانی ساده‌ای برای پردازش فایل‌های صوتی هستند\&.
هر ابزار برای انجام یک عملیات مشخص طراحی شده است\&. بیشتر این 
ابزارها از پردازش دسته‌ای (batch) نیز پشتیبانی می‌کنند\&.
.PP 
\fBECACONVERT\fP
.PP 
ابزاری برای تبدیل مجموعه‌ای از فایل‌ها به یک قالب مقصد مشترک\&.
این قالب مقصد به عنوان نخستین آرگومان خط فرمان داده می‌شود، 
و نحو آن به صورت \fI\&.ext\fP است\&.
.PP 
\fBECAFIXDC\fP
.PP 
یک ابزار خط فرمانی ساده برای تصحیح DC\-offset\&.
.PP 
\fBECALENGTH\fP
.PP 
صفحه راهنمای مجزای ecalength(1) را ببینید\&.
.PP 
\fBECAMONITOR\fP
.PP 
برنامه Ecamonitor ابزاری کاربردی است که می‌تواند برای 
پایش یک نشست فعال ecasound به کار رود\&. Ecamonitor 
قادر است اطلاعاتی درباره chainsetup جاری مانند 
فهرست ورودی‌ها، خروجی‌ها، موقعیت جاری، جلوه‌ها، وضعیت موتور 
و موارد متعدد دیگر را نمایش دهد\&.
.PP 
به‌طور پیش‌فرض ecamonitor تلاش می‌کند تا به نشانی IPv4 
با مقدار \(dq\&localhost\(dq\& و درگاه \(dq\&2868\(dq\& متصل شود\&. 
هنگام راه‌اندازی ecamonitor می‌توان نشانی متفاوتی را 
مشخص کرد، برای نمونه 
\(dq\&ecamonitor foo\&.mynetwork\&.com\(dq\& یا
\(dq\&ecamonitor foo\&.mynetwork\&.com:4500\(dq\&\&.
.PP 
جهت فعال‌سازی اتصالات ورودی، ecasound باید با گزینه 
\fI\-\-daemon\fP راه‌اندازی شود\&. Ecamonitor در پایتون و با 
استفاده از NetECI API پیاده‌سازی شده است\&.
.PP 
\fBECANORMALIZE\fP
.PP 
برنامه Ecanormalize ابزاری خط فرمانی برای نرمال‌سازی فایل‌های صوتی 
جهت بهره‌گیری از تمام تفکیک‌پذیری نمونه‌های در دسترس است\&. Ecanormalize 
ابتدا بررسی می‌کند که فایل ورودی تا چه اندازه می‌تواند بدون برش سیگنال (clipping) 
تقویت شود و چنانچه فضایی برای افزایش وجود داشته باشد، یک بهره تقویت (gain) ایستا به 
فایل اعمال خواهد شد\&.
.PP 
\fBECAPLAY\fP
.PP 
برنامه Ecaplay ابزاری خط فرمانی برای پخش فایل‌های صوتی است\&. Ecaplay 
از موتور libecasound بهره می‌برد و بنابراین قادر است تمام قالب‌های صوتی 
پشتیبانی‌شده توسط کتابخانه را مدیریت کند\&.
.PP 
فایل‌ها را می‌توان با مشخص کردن نام آن‌ها در خط فرمان یا با 
استفاده از سازوکار فهرست پخش برای پخش انتخاب کرد\&. در حالت فهرست پخش، 
می‌توان با استفاده از گزینه \fI\-q\fP فایل‌ها را به فهرست پخش افزود\&. سپس می‌توان 
از گزینه \fI\-p\fP برای پخش تمام قطعات موجود در فهرست پخش استفاده کرد\&. Ecaplay 
قطعات فهرست پخش را تکرار می‌کند تا زمانی که صریحاً متوقف شود (با فشردن دو بار Ctrl\-C)\&. 
فهرست پخش را می‌توان با \fI\-f\fP پاک‌سازی کرد و محتویات آن را با 
گزینه \fI\-l\fP فهرست نمود\&.
.PP 
در صورتی که به گونه دیگری مشخص نشده باشد، ecaplay از دستگاه خروجی صوتی 
تعیین‌شده در \fI~/\&.ecasound/ecasoundrc\fP برای پخش استفاده خواهد کرد\&. یک دستگاه 
خروجی متفاوت را می‌توان با متغیر محیطی شل \fIECAPLAY_OUTPUT_DEVICE\fP یا با گزینه 
خط فرمانی \fI\-o:output_device\fP مشخص کرد\&.
.PP 
پخش را می‌توان در هر زمان با Ctrl\-C متوقف کرد\&. در صورت پخش چندین 
فایل، نخستین Ctrl\-C فایل جاری را متوقف کرده و به پخش فایل بعدی 
می‌پردازد\&. فشردن دو بار Ctrl\-C (در مدت یک ثانیه)، موجب خروج ecaplay 
خواهد شد\&.
.PP 
.IP "\-d:debuglevel"
تنظیم سطح اشکال‌زدایی libecasound\&. به ecasound(1) مراجعه کنید\&.
.IP 
.IP "\-f"
پاک‌سازی محتویات فهرست پخش\&. همچنین به گزینه‌های 
\fI\-l\fP، \fI\-p\fP و \fI\-q\fP مراجعه کنید\&.
.IP 
.IP "\-h"
نمایش اطلاعات نحوه استفاده و خروج\&.
.IP 
.IP "\-k:number"
رد کردن به تعداد \(cq\&number\(cq\& از فایل‌ها\&.
.IP 
.IP "\-l"
فهرست کردن محتویات فهرست پخش جاری در stdout\&. همچنین به 
گزینه‌های \fI\-f\fP، \fI\-p\fP و \fI\-q\fP مراجعه کنید\&.
.IP 
.IP "\-o:output_device"
استفاده از \(cq\&output_device\(cq\& به جای دستگاه خروجی پیش‌فرض 
(همان‌طور که در \fI~/\&.ecasound/ecasoundrc\fP مشخص شده است)\&. نحو آن همانند 
گزینه \(dq\&\-o\(dq\& در ecasound است (صفحه راهنمای ecasound(1) را ببینید)\&. 
این گزینه اولویت بالاتری نسبت به متغیر محیطی \fIECAPLAY_OUTPUT_DEVICE\fP 
دارد (اطلاعات بیشتر در زیر آمده است)\&.
.IP 
.IP "\-p"
پخش قطعات موجود در فهرست پخش (در حالت حلقه تکرار)\&. همچنین به 
گزینه‌های \fI\-f\fP، \fI\-l\fP و \fI\-q\fP مراجعه کنید\&.
.IP 
.IP "\-q"
به صف کردن قطعات جدید در فهرست پخش\&. تمام نام‌های فایل داده‌شده در 
خط فرمان به فهرست پخش افزوده خواهند شد\&. صف‌بندی قطعات جدید در حالی که 
نمونه دیگری از ecaplay در حال استفاده از فهرست پخش است، امکان‌پذیر است\&. 
همچنین به گزینه‌های \fI\-f\fP، \fI\-l\fP و \fI\-p\fP مراجعه کنید\&.
.IP 
\fBECASIGNALVIEW\fP
.PP 
ابزار Ecasignalview برای پایش دامنه سیگنال و آمار اوج (peak) در 
نظر گرفته شده است\&. این ابزار گزینه‌های زیر را می‌پذیرد:
.PP 
.IP "input"
نخستین گزینه‌ای که با \(cq\&\-\(cq\& آغاز نشود به عنوان یک رشته ورودی 
تفسیر می‌شود\&. این می‌تواند یک دستگاه یا یک نام فایل باشد\&. تمام قالب‌های 
پشتیبانی‌شده توسط libecasound پذیرفته می‌شوند\&. مقدار پیش‌فرض \(cq\&/dev/dsp\(cq\& است\&.
.IP 
.IP "output"
مشابه ورودی، دومین گزینه‌ای که با \(cq\&\-\(cq\& آغاز نشود 
به عنوان خروجی تفسیر می‌شود\&. مقدار پیش‌فرض \(cq\&null\(cq\& است\&.
.IP 
.IP "\-b:buffersize"
اندازه بافر بر حسب فریم‌های نمونه (sample frames)\&. مقدار پیش‌فرض 128 است\&.
.IP 
.IP "\-c"
فعال‌سازی حالت انباشته (cumulative)\&. شمارنده‌ها پس از بازخوانی بازنشانی نمی‌شوند\&. 
\fI*منسوخ‌شده*\fP
.IP 
.IP "\-d"
فعال‌سازی حالت اشکال‌زدایی (debug)\&.
.IP 
.IP "\-f:format_string"
تعیین قالب صوتی پیش‌فرض\&. برای جزئیات به ecasound(1) مراجعه کنید\&.
.IP 
.IP "\-r:rate_msec"
تعیین نرخ بازخوانی صفحه بر حسب میلی‌ثانیه\&.
.IP 
.IP "\-I"
استفاده از مقیاس خطی برای نمایش دامنه نمونه‌های صوتی\&.
.IP 
.IP "\-L"
استفاده از مقیاس لگاریتمی برای نمایش دامنه نمونه‌های صوتی\&.
.IP 
.IP "\-G, \-B, \-M*, \-r, \-z"
گزینه‌های ecasound که برای تغییر رفتار موتور استفاده می‌شوند؛ برای 
جزئیات به صفحه راهنمای ecasound(1) مراجعه کنید\&.
.IP 
هنگامی که ecasignalview در حال اجرا است، فرمان‌های صفحه‌کلید 
زیر می‌توانند برای واپایش عملیات استفاده شوند (نیازمند پشتیبانی 
سیستم از کنترل واسط پایانه UNIX است):
.PP 
.IP "spacebar"
بازنشانی آمارها (max\-peak، avg\-amplitude و تعداد نمونه‌های 
بریده‌شده یا clipped samples)\&.
.IP 
.IP "q or Q or Esc"
خروج از ecasignalview\&.
.IP 
همچنین می‌توان شمارنده‌های max\-peak و clipped\-samples را با 
ارسال سیگنال SIGHUP به فرایند بازنشانی کرد (یعنی از کنسولی دیگر: 
\(dq\&killall \-v \-HUP ecasignalview\(dq\&)\&.
.PP 
مستندات کامل‌تر درباره ecasignalview را می‌توان در \(dq\&راهنمای کاربر Ecasound\(dq\& 
یافت (به \(cq\&\(cq\&http://nosignal\&.fi/ecasound \-> Documentation\(cq\&\(cq\& مراجعه کنید)\&.
.PP 
.SH "محیط (ENVIRONMENT)"

.PP 
\fIECASOUND\fP
مسیر فایل اجرایی ecasound\&. توسط بسیاری از ecatools استفاده می‌شود\&.
.PP 
\fIECAPLAY_OUTPUT_DEVICE\fP
دستگاهی که ecaplay باید برای خروجی صوتی استفاده کند\&. دارای همان نحو مورد 
استفاده در گزینه \(dq\&\-o\(dq\& برنامه ecaplay/ecasound است\&.
.PP 
.SH "فایل‌ها (FILES)"

.PP 
\fI~/\&.ecasound/ecasoundrc\fP
فایل منبع (تنظیمات) پیش‌فرض ecasound\&. برای جزئیات به ecasoundrc(5) 
مراجعه کنید\&.
.PP 
\fI~/\&.ecasound/ecaplay_queue\fP
فایل مورد استفاده برای ذخیره فهرست پخش ecaplay (یک قطعه در 
هر خط همراه با مسیر کامل)\&.
.PP 
.SH "همچنین ببینید (SEE ALSO)"

.PP 
ecasound (1), ecalength(1), \(dq\&HTML docs in the Documentation subdirectory\(dq\&
.PP 
.SH "نویسندگان (AUTHORS)"

.PP 
Kai Vehmanen, <kvehmanen \-at\- eca \-dot\- cx <kvehmanen \-at\- eca \-dot\- cx>>