.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 (جریان مستقیم)\&.
.PP 
\fBECALENGTH\fP
.PP 
صفحه راهنمای مجزای ecalength(1) را ببینید\&.
.PP 
\fBECAMONITOR\fP
.PP 
برنامه ecamonitor ابزاری کاربردی است که می‌تواند برای 
نظارت بر یک نشست فعال ecasound به کار رود\&. برنامه ecamonitor 
قادر است اطلاعات مربوط به chainsetup فعلی مانند فهرست ورودی‌ها، 
خروجی‌ها، موقعیت جاری، جلوه‌ها (effects)، وضعیت موتور 
و موارد متعدد دیگری را نمایش دهد\&.
.PP 
به طور پیش‌فرض ecamonitor تلاش می‌کند به نشانی IP4 با مقدار 
\(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 یک ابزار خط فرمانی برای نرمال‌سازی فایل‌های صوتی 
جهت بهره‌گیری از حداکثر تفکیک‌پذیری نمونه (sample resolution) موجود است\&. 
برنامه ecanormalize ابتدا بررسی می‌کند که فایل ورودی بدون اعوجاج و برش 
(clipping) تا چه اندازه قابل تقویت است و در صورت وجود فضا برای افزایش، 
یک بهره (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 برای نظارت بر دامنه سیگنال و آمار پیک 
در نظر گرفته شده است\&. این ابزار گزینه‌های زیر را می‌پذیرد:
.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"
فعال‌سازی حالت دیباگ\&.
.IP 
.IP "\-f:format_string"
تعیین قالب صوتی پیش‌فرض\&. برای جزئیات به ecasound(1) مراجعه کنید\&.
.IP 
.IP "\-r:rate_msec"
تعیین نرخ نوسازی (refresh rate) صفحه بر حسب میلی‌ثانیه\&.
.IP 
.IP "\-I"
استفاده از مقیاس خطی برای نمایش دامنه نمونه صوت\&.
.IP 
.IP "\-L"
استفاده از مقیاس لگاریتمی برای نمایش دامنه نمونه صوت\&.
.IP 
.IP "\-G, \-B, \-M*, \-r, \-z"
گزینه‌های ecasound که برای تغییر رفتار موتور به کار می‌روند؛ 
برای جزئیات به صفحه راهنمای ecasound(1) مراجعه کنید\&.
.IP 
هنگامی که ecasignalview در حال اجرا است، می‌توان از دستورهای صفحه‌کلید 
زیر برای کنترل عملیات استفاده کرد (نیازمند پشتیبانی سیستم از کنترل 
رابط ترمینال UNIX است):
.PP 
.IP "spacebar"
بازنشانی آمارها (حداکثر پیک، میانگین دامنه و تعداد 
نمونه‌های بریده‌شده/clipped)\&.
.IP 
.IP "q or Q or Esc"
خروج از ecasignalview\&.
.IP 
همچنین می‌توان با ارسال سیگنال 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>>