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

.PP 
.SH "نام (NAME)"
ecaconvert \- ابزار تبدیل قالب و پردازش فایل‌های صوتی مبتنی بر 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 ابزارهای ساده خط فرمان برای پردازش فایل‌های صوتی هستند\&. هر ابزار برای انجام یک عملیات مشخص طراحی شده است\&. بیشتر این ابزارها از پردازش دسته‌ای نیز پشتیبانی می‌کنند\&.
.PP 
\fBECACONVERT\fP
.PP 
ابزاری برای تبدیل مجموعه‌ای از فایل‌ها به یک قالب مقصد مشترک\&. این قالب مقصد به عنوان نخستین آرگومان خط فرمان مشخص می‌شود و نحو دستوری آن به صورت \fI\&.ext\fP است\&.
.PP 
\fBECAFIXDC\fP
.PP 
ابزاری ساده در خط فرمان برای رفع آفست DC\&.
.PP 
\fBECALENGTH\fP
.PP 
صفحه راهنمای مجزای ecalength(1) را ببینید\&.
.PP 
\fBECAMONITOR\fP
.PP 
برنامه کمکی ecamonitor می‌تواند برای نظارت و پایش یک نشست فعال ecasound به کار رود\&. این ابزار قادر است اطلاعات مربوط به چیدمان زنجیره (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 پیاده‌سازی شده است\&.
.PP 
\fBECANORMALIZE\fP
.PP 
ابزار ecanormalize یک ابزار خط فرمان برای نرمال‌سازی فایل‌های صوتی جهت استفاده از حداکثر تفکیک‌پذیری نمونه (sample resolution) موجود است\&. این ابزار ابتدا بررسی می‌کند که فایل ورودی چقدر می‌تواند بدون اعوجاج و برش (clipping) تقویت شود، و در صورت وجود فضا برای افزایش، یک بهره (gain) ایستا به فایل اعمال می‌کند\&.
.PP 
\fBECAPLAY\fP
.PP 
ابزار 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 برای پایش دامنه سیگنال و آمار قله‌ها (peaks) در نظر گرفته شده است\&. این ابزار گزینه‌های زیر را می‌پذیرد:
.PP 
.IP "input"
نخستین گزینه‌ای که با \(cq\&\-\(cq\& آغاز نشود به عنوان رشته ورودی تفسیر می‌شود\&. این ورودی می‌تواند یک دستگاه یا یک نام فایل باشد\&. تمامی قالب‌های پشتیبانی‌شده توسط libecasound پذیرفته می‌شوند\&. مقدار پیش‌فرض \(cq\&/dev/dsp\(cq\& است\&.
.IP 
.IP "output"
مشابه ورودی، دومین گزینه‌ای که با \(cq\&\-\(cq\& آغاز نشود به عنوان خروجی در نظر گرفته می‌شود\&. مقدار پیش‌فرض \(cq\&null\(cq\& است\&.
.IP 
.IP "\-b:buffersize"
اندازه بافر بر حسب فریم‌های نمونه\&. مقدار پیش‌فرض ۱۲۸ است\&.
.IP 
.IP "\-c"
فعال‌سازی حالت تجمعی\&. شمارنده‌ها پس از تازه‌سازی بازنشانی نمی‌شوند\&. \fI*منسوخ‌شده*\fP
.IP 
.IP "\-d"
فعال‌سازی حالت اشکال‌زدایی\&.
.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"
بازنشانی آمارها (بیشینه قله، میانگین دامنه و تعداد نمونه‌های بریده‌شده)\&.
.IP 
.IP "q or Q or Esc"
خروج از ecasignalview\&.
.IP 
همچنین بازنشانی شمارنده‌های بیشینه قله و نمونه‌های بریده‌شده با ارسال سیگنال SIGHUP به فرایند امکان‌پذیر است (یعنی از کنسولی دیگر: \(dq\&killall \-v \-HUP ecasignalview\(dq\&)\&.
.PP 
مستندات کامل‌تر درباره ecasignalview را می‌توان در «راهنمای کاربر Ecasound» یافت (به نشانی http://nosignal.fi/ecasound بخش مستندات مراجعه کنید)\&.
.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), مستندات HTML در زیرپوشه Documentation
.PP 
.SH "نویسندگان (AUTHORS)"

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