.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 processing) نیز پشتیبانی می‌کنند\&.
.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) 
تقویت شود و در صورتی که فضا برای افزایش وجود داشته باشد، یک بهره ثابت (static gain) 
بر روی فایل اعمال خواهد شد\&.
.PP 
\fBECAPLAY\fP
.PP 
ابزار Ecaplay برنامه‌ای خط فرمانی برای پخش فایل‌های صوتی است\&. Ecaplay 
از موتور libecasound بهره می‌برد و بنابراین قادر به مدیریت تمامی قالب‌های 
صوتی پشتیبانی‌شده توسط این کتابخانه است\&.
.PP 
فایل‌ها را می‌توان برای پخش یا با تعیین نام فایل‌ها در خط فرمان، 
یا با استفاده از سازوکار فهرست پخش (playlist) انتخاب کرد\&. در حالت فهرست پخش، 
فایل‌ها را می‌توان با گزینه \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، \-p و \-q\fP را ببینید\&.
.IP 
.IP "\-h"
نمایش اطلاعات نحوه استفاده و خروج\&.
.IP 
.IP "\-k:number"
رد کردن تعداد \(cq\&number\(cq\& از فایل‌ها\&.
.IP 
.IP "\-l"
فهرست کردن محتویات فعلی فهرست پخش در stdout\&. همچنین گزینه‌های 
\fI\-f، \-p و \-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، \-l و \-q\fP را ببینید\&.
.IP 
.IP "\-q"
افزودن قطعه‌های جدید به صف فهرست پخش\&. تمام نام‌فایل‌های ارائه‌شده 
در خط فرمان به فهرست پخش اضافه خواهند شد\&. امکان افزودن قطعه‌های جدید به صف 
در حالی که نمونه دیگری از ecaplay در حال استفاده از فهرست پخش است نیز وجود دارد\&. 
همچنین گزینه‌های \fI\-f، \-l و \-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)\&. پیش‌فرض ۱۲۸ است\&.
.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])\&.
.IP 
.IP "q or Q or Esc"
خروج از ecasignalview\&.
.IP 
همچنین امکان بازنشانی شمارنده‌های max\-peak و clipped\-samples با 
ارسال سیگنال SIGHUP به فرایند وجود دارد (برای نمونه 
از یک کنسول دیگر: \(dq\&killall \-v \-HUP ecasignalview\(dq\&)\&.
.PP 
مستندات کامل‌تر برای ecasignalview را می‌توان در 
\(dq\&Ecasound User\(cq\&s Guide\(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
فایل منبع (resource file) پیش‌فرض 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>>