.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 (DC\-offset)\&.
.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 برای نظارت بر دامنه سیگنال و آمار اوج (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 در حال اجراست، از دستورهای صفحه‌کلید 
زیر می‌توان برای کنترل عملیات استفاده کرد (نیازمند پشتیبانی سیستم 
از کنترل واسط ترمینال یونیکس است):
.PP 
.IP "spacebar"
بازنشانی آمارها (max\-peak، avg\-amplitude و تعداد نمونه‌های بریده‌شده)\&.
.IP 
.IP "q or Q or Esc"
خروج از ecasignalview\&.
.IP 
همچنین می‌توان با ارسال یک سیگنال SIGHUP به فرایند، شمارنده‌های 
max\-peak و clipped\-samples را بازنشانی کرد (مثلاً از کنسولی دیگر: 
\(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>>