.TH "ecatools" "1" "12\&.11\&.2005" "" "نرم‌افزار چندرسانه‌ای"

.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 جاری مانند فهرست ورودی‌ها، خروجی‌ها،
موقعیت کنونی، جلوه‌ها (افکت‌ها)، وضعیت موتور صوتی
و موارد بسیار دیگری را نمایش دهد\&.
.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 یک ابزار خط فرمانی برای نرمال‌سازی فایل‌های صوتی
جهت استفاده از حداکثر وضوح نمونه موجود است\&. 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 برای پایش دامنه سیگنال و آمار قله (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"
فعال‌سازی حالت انباشته (تجمعی)\&. شمارنده‌ها پس از بازآوری بازنشانی نمی‌شوند\&.
\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 count)\&.
.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
فایل پیکربندی و منبع پیش‌فرض 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>>