'\" t .\" Title: twolame .\" Author: Nicholas J Humfrey .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: 10/11/2019 .\" Manual: \ \& .\" Source: \ \& .\" Language: Persian .\" .TH "TWOLAME" "1" "10/11/2019" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" twolame \- یک رمزگذار بهینه‌سازی‌شده MPEG Audio Layer 2 (MP2) .SH "خلاصه دستور (SYNOPSIS)" .sp \fItwolame\fR [options] [outfile] .SH "توضیحات (DESCRIPTION)" .sp برنامه TwoLAME یک رمزگذار بهینه‌سازی‌شده MPEG Audio Layer 2 (MP2) بر پایه tooLAME اثر Mike Cheng است که آن نیز به نوبه خود بر اساس کد ISO dist10 و بخش‌هایی از LAME توسعه یافته است\&. عمل رمزگذاری توسط بک‌اند کتابخانه libtwolame انجام می‌شود\&. .SH "گزینه‌ها (OPTIONS)" .SS "فایل ورودی (Input File)" .sp برنامه twolame برای خواندن فایل صوتی ورودی از libsndfile استفاده می‌کند، بنابراین فایل ورودی می‌تواند در هر قالبی باشد که توسط libsndfile پشتیبانی می‌شود\&. برای خواندن صدای خام PCM از STDIN، از \- به‌عنوان نام فایل ورودی استفاده کنید\&. .SS "فایل خروجی (Output File)" .sp اگر نام فایل خروجی مشخص نشود، پسوند نام فایل ورودی به‌طور خودکار به \&.mp2 تغییر می‌یابد\&. برای نوشتن صدای رمزگذاری‌شده در STDOUT، از \- به‌عنوان نام فایل خروجی استفاده کنید\&. .SS "گزینه‌های ورودی (Input Options)" .PP \-r, \-\-raw\-input .RS 4 مشخص می‌کند که ورودی، صدای خام علامت‌دار PCM است\&. اگر صدا استریو باشد، نمونه‌های صوتی بین دو کانال درهم‌آمیخته (interleaved) هستند\&. .RE .PP \-x, \-\-byte\-swap .RS 4 وارونه‌سازی بایت‌ها (byte\-swapping) در ورودی را اجباری می‌کند\&. تشخیص ترتیب بایت‌ها (Endianness) به‌طور خودکار توسط libsndfile انجام می‌شود، بنابراین این گزینه در حالت عادی نباید مورد نیاز باشد\&. .RE .PP \-s, \-\-samplerate .RS 4 در صورت وارد کردن صدای خام PCM، باید نرخ نمونه‌برداری صدا را برحسب Hz مشخص کنید\&. نرخ‌های نمونه‌برداری معتبر عبارتند از: 16000, 22050, 24000, 32000, 44100, 48000Hz\&. نرخ نمونه‌برداری پیش‌فرض 44100Hz است\&. .RE .PP \-\-samplesize .RS 4 اندازه هر نمونه (برحسب بیت) صدای خام PCM را مشخص می‌کند\&. اندازه‌های معتبر نمونه عبارتند از: 8, 16, 24, 32\&. اندازه نمونه پیش‌فرض 16\-bit است\&. .RE .PP \-N, \-\-channels .RS 4 در صورت وارد کردن صدای خام PCM، باید تعداد کانال‌ها در صدای ورودی را مشخص کنید\&. تعداد پیش‌فرض کانال‌ها 2 است\&. .RE .PP \-g, \-\-swap\-channels .RS 4 کانال‌های چپ و راست یک فایل ورودی استریو را با یکدیگر جابه‌جا می‌کند\&. .RE .PP \-\-scale .RS 4 صدای ورودی را پیش از رمزگذاری مقیاس‌بندی می‌کند\&. تمام داده‌های صدای ورودی در مقدار مشخص‌شده ضرب می‌شوند\&. مقداری بین 0 و 1 بهره صوتی (gain) را کاهش می‌دهد و مقداری بیشتر از 1 بهره صدا را افزایش خواهد داد\&. .RE .PP \-\-scale\-l .RS 4 مشابه \-\-scale، اما تنها بر کانال چپ تأثیر می‌گذارد\&. .RE .PP \-\-scale\-r .RS 4 مشابه \-\-scale، اما تنها بر کانال راست تأثیر می‌گذارد\&. .RE.SS "گزینه‌های خروجی (Output Options)" .PP \-m, \-\-mode .RS 4 حالت صدای خروجی حاصل را انتخاب می‌کند\&. پیش‌فرض auto است\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} "a" auto \- انتخاب خودکار حالت بر اساس ورودی .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} "s" stereo (استریو) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} "d" dual channel (دو کاناله) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} "j" joint stereo (استریوی مشترک) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} "m" mono (تک‌کاناله) .RE .RE .PP \-a, \-\-downmix .RS 4 اگر فایل ورودی استریو باشد، کانال‌های ورودی چپ و راست را در یک کانال مونو ادغام (downmix) می‌کند\&. .RE .PP \-b, \-\-bitrate .RS 4 نرخ بیت کل (بر حسب kbps) را برای فایل خروجی تنظیم می‌کند\&. نرخ بیت پیش‌فرض به تعداد کانال‌های ورودی و نرخ نمونه‌برداری (samplerate) بستگی دارد\&. .sp .if n \{\ .RS 4 .\} .nf \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- Sample Rate Mono Stereo \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- 48000 96 192 44100 96 192 32000 80 160 24000 48 96 22050 48 96 16000 32 64 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- .fi .if n \{\ .RE .\} .RE .PP \-P, \-\-psyc\-mode .RS 4 مدل روان‌آکوستیک (psycho\-acoustic) مورد استفاده را انتخاب می‌کند (\-1 تا 4)\&. مدل شمارهٔ \-1 مدل‌سازی روان‌آکوستیک را غیرفعال کرده و در عوض از مقادیر پیش‌فرض ثابت استفاده می‌کند\&. لطفاً برای توضیحات کامل هر یک از مدل‌های موجود، فایل \fIpsycho\fR را ببینید\&. مدل پیش‌فرض 3 است\&. .RE .PP \-v, \-\-vbr .RS 4 حالت VBR را فعال می‌کند\&. برای جزئیات، فایل مستندات \fIvbr\fR را ببینید\&. سطح پیش‌فرض VBR مقدار 5\&.0 است\&. .RE .PP \-V, \-\-vbr\-level .RS 4 حالت VBR را فعال کرده و سطح کیفیت را تنظیم می‌کند\&. هرچه این عدد بزرگ‌تر باشد کیفیت بهتر است\&. محدودهٔ بیشینه \-50 تا 50 است اما محدودهٔ کاربردی \-10 تا 10 می‌باشد\&. برای جزئیات، فایل مستندات \fIvbr\fR را ببینید\&. .RE .PP \-l, \-\-ath .RS 4 سطح ATH را تنظیم می‌کند\&. سطح پیش‌فرض 0\&.0 است\&. .RE .PP \-q, \-\-quick .RS 4 حالت سریع (quick) را فعال می‌کند\&. مدل روان‌آکوستیک تنها در هر تعداد فریم مشخص‌شده مجدداً محاسبه می‌شود\&. .RE .PP \-S, \-\-single\-frame .RS 4 حالت تک‌فریم را فعال می‌کند: تنها یک فریم از صدای MPEG در خروجی تولید شده و سپس برنامه پایان می‌یابد\&. .RE.SS "گزینه‌های متفرقه (Miscellaneous Options)" .PP \-c, \-\-copyright .RS 4 فعال‌سازی پرچم کپی‌رایت (Copyright) در جریان بیت خروجی\&. .RE .PP \-o, \-\-non\-original .RS 4 غیرفعال‌سازی پرچم غیراصل بودن (Original) در جریان بیت خروجی\&. .RE .PP \-\-original .RS 4 فعال‌سازی پرچم نسخه اصلی (Original) در جریان بیت خروجی\&. .RE .PP \-p, \-\-protect .RS 4 فعال‌سازی حفاظت از خطای CRC در جریان بیت خروجی\&. یک چکسام ۱۶ بیتی اضافی به فریم‌ها افزوده می‌شود\&. .RE .PP \-d, \-\-padding .RS 4 فعال‌سازی پدینگ (padding) در جریان بیت خروجی\&. .RE .PP \-R, \-\-reserve .RS 4 رزرو تعداد بیت‌های مشخص‌شده در هر فریم از جریان بیت خروجی\&. .RE .PP \-e, \-\-deemphasis .RS 4 تنظیم نوع واکاهش/de\-emphasis (n/c/5)\&. مقدار پیش‌فرض none است\&. .RE .PP \-E, \-\-energy .RS 4 فعال‌سازی افزونه‌های سطح انرژی (energy level extensions)\&. .RE .SS "گزینه‌های پرگویی (Verbosity Options)" .PP \-t, \-\-talkativity .RS 4 تنظیم میزان اطلاعات نمایش‌داده‌شده روی stderr (۰ تا ۱۰)\&. مقدار پیش‌فرض ۲ است\&. .RE .PP \-\-quiet .RS 4 هیچ پیامی به stderr ارسال نشود، مگر اینکه خطایی رخ دهد\&. (مشابه \-\-talkativity=0) .RE .PP \-\-brief .RS 4 تنها نمایش حداقل پیام‌ها در حین رمزگذاری\&. این تنظیم کم‌حرف‌تر از تنظیمات پیش‌فرض پرگویی است\&. (مشابه \-\-talkativity=1) .RE .PP \-\-verbose .RS 4 نمایش تعداد بیشتری پیام روی stderr\&. این تنظیم برای عیب‌یابی مشکلات مفید است\&. (مشابه \-\-talkativity=4) .RE .SH "کدهای بازگشتی (RETURN CODES)" .sp اگر رمزگذاری با موفقیت پایان یابد، twolame مقدار 0 را برمی‌گرداند\&. با این حال اگر رمزگذاری ناموفق باشد، یکی از کدهای زیر بازگردانده خواهد شد\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} 1 (هیچ رمزگذاری‌ای انجام نشد) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} 2 (خطا در باز کردن فایل ورودی) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} 4 (خطا در باز کردن فایل خروجی) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} 6 (خطا در تخصیص حافظه) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} 8 (خطا در پارامترهای رمزگذاری انتخاب‌شده) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} 10 (خطا در خواندن صدای ورودی) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} 12 (هنگام رمزگذاری خطایی رخ داد) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} 14 (خطا در نوشتن صدای خروجی) .RE.SH "مثال‌ها (EXAMPLES)" .sp این دستور فایل sound\&.wav را با استفاده از نرخ بیت ثابت پیش‌فرض 192 kbps و مدل روان‌آکوستیک (psycho\-acoustic) پیش‌فرض (مدل ۳) به sound\&.mp2 کدگذاری می‌کند: .sp .if n \{\ .RS 4 .\} .nf twolame sound\&.wav .fi .if n \{\ .RE .\} .sp نرخ بیت ثابت 160kbps و کدگذاری joint stereo، ذخیره‌شده در فایل sound_160\&.mp2: .sp .if n \{\ .RS 4 .\} .nf twolame \-b 160 \-m j sound\&.aiff sound_160\&.mp2 .fi .if n \{\ .RE .\} .sp کدگذاری sound\&.wav به newfile\&.mp2 با استفاده از مدل روان‌آکوستیک ۲ و با نرخ بیت متغیر: .sp .if n \{\ .RS 4 .\} .nf twolame \-P 2 \-v sound\&.wav newfile\&.mp2 .fi .if n \{\ .RE .\} .sp مشابه مثال بالا، با این تفاوت که مقدار منفی برای آرگومان «\-V» به این معناست که نرخ‌های بیت پایین‌تر بر نرخ‌های بالاتر ترجیح داده خواهند شد: .sp .if n \{\ .RS 4 .\} .nf twolame \-P 2 \-V \-5 sound\&.wav newfile\&.mp2 .fi .if n \{\ .RE .\} .sp نمونه‌برداری مجدد (resample) فایل صوتی با استفاده از sox و هدایت مستقیم از طریق pipe به twolame: .sp .if n \{\ .RS 4 .\} .nf sox sound_11025\&.aiff \-t raw \-r 16000 | twolame \-r \-s 16000 \- \- > out\&.mp2 .fi .if n \{\ .RE .\} .SH "نویسندگان (AUTHORS)" .sp فرانت‌اند twolame توسط Nicholas J Humfrey (باز)نویسی شده است\&. کتابخانه libtwolame بر پایه toolame اثر Mike Cheng توسعه یافته است\&. برای فهرست کامل نویسندگان، لطفاً فایل AUTHORS را ببینید\&. .SH "منابع (RESOURCES)" .sp وب‌سایت TwoLAME: \m[blue]\fBhttp://www\&.twolame\&.org\fR\m[] .SH "همچنین ببینید (SEE ALSO)" .sp lame(1), mpg123(1), madplay(1), sox(1) .SH "کپی‌رایت و تکثیر (COPYING)" .sp حق نشر \(co 2004\-2018 پروژه The TwoLAME Project\&. استفاده آزاد از این نرم‌افزار تحت شرایط مجوز عمومی جامع‌تر گنو (LGPL) مجاز است\&. .SH "نویسنده (AUTHOR)" .PP \fBNicholas J Humfrey\fR <\&njh@aelius\&.com\&> .RS 4 نویسنده. .RE