TWOLAME(1)   TWOLAME(1)

twolame - یک رمزگذار بهینه‌سازی‌شده MPEG Audio Layer 2 (MP2)

twolame [options] <infile> [outfile]

برنامه TwoLAME یک رمزگذار بهینه‌سازی‌شده MPEG Audio Layer 2 (MP2) بر پایه tooLAME اثر Mike Cheng است که آن نیز به نوبه خود بر اساس کد ISO dist10 و بخش‌هایی از LAME توسعه یافته است. عمل رمزگذاری توسط بک‌اند کتابخانه libtwolame انجام می‌شود.

برنامه twolame برای خواندن فایل صوتی ورودی از libsndfile استفاده می‌کند، بنابراین فایل ورودی می‌تواند در هر قالبی باشد که توسط libsndfile پشتیبانی می‌شود. برای خواندن صدای خام PCM از STDIN، از - به‌عنوان نام فایل ورودی استفاده کنید.

اگر نام فایل خروجی مشخص نشود، پسوند نام فایل ورودی به‌طور خودکار به .mp2 تغییر می‌یابد. برای نوشتن صدای رمزگذاری‌شده در STDOUT، از - به‌عنوان نام فایل خروجی استفاده کنید.

-r, --raw-input

مشخص می‌کند که ورودی، صدای خام علامت‌دار PCM است. اگر صدا استریو باشد، نمونه‌های صوتی بین دو کانال درهم‌آمیخته (interleaved) هستند.

-x, --byte-swap

وارونه‌سازی بایت‌ها (byte-swapping) در ورودی را اجباری می‌کند. تشخیص ترتیب بایت‌ها (Endianness) به‌طور خودکار توسط libsndfile انجام می‌شود، بنابراین این گزینه در حالت عادی نباید مورد نیاز باشد.

-s, --samplerate <int>

در صورت وارد کردن صدای خام PCM، باید نرخ نمونه‌برداری صدا را برحسب Hz مشخص کنید. نرخ‌های نمونه‌برداری معتبر عبارتند از: 16000, 22050, 24000, 32000, 44100, 48000Hz. نرخ نمونه‌برداری پیش‌فرض 44100Hz است.

--samplesize <int>

اندازه هر نمونه (برحسب بیت) صدای خام PCM را مشخص می‌کند. اندازه‌های معتبر نمونه عبارتند از: 8, 16, 24, 32. اندازه نمونه پیش‌فرض 16-bit است.

-N, --channels <int>

در صورت وارد کردن صدای خام PCM، باید تعداد کانال‌ها در صدای ورودی را مشخص کنید. تعداد پیش‌فرض کانال‌ها 2 است.

-g, --swap-channels

کانال‌های چپ و راست یک فایل ورودی استریو را با یکدیگر جابه‌جا می‌کند.

--scale <float>

صدای ورودی را پیش از رمزگذاری مقیاس‌بندی می‌کند. تمام داده‌های صدای ورودی در مقدار مشخص‌شده ضرب می‌شوند. مقداری بین 0 و 1 بهره صوتی (gain) را کاهش می‌دهد و مقداری بیشتر از 1 بهره صدا را افزایش خواهد داد.

--scale-l <float>

مشابه --scale، اما تنها بر کانال چپ تأثیر می‌گذارد.

--scale-r <float>

مشابه --scale، اما تنها بر کانال راست تأثیر می‌گذارد.

-m, --mode <char>

حالت صدای خروجی حاصل را انتخاب می‌کند. پیش‌فرض auto است.
•"a" auto - انتخاب خودکار حالت بر اساس ورودی
•"s" stereo (استریو)
•"d" dual channel (دو کاناله)
•"j" joint stereo (استریوی مشترک)
•"m" mono (تک‌کاناله)

-a, --downmix

اگر فایل ورودی استریو باشد، کانال‌های ورودی چپ و راست را در یک کانال مونو ادغام (downmix) می‌کند.

-b, --bitrate <int>

نرخ بیت کل (بر حسب kbps) را برای فایل خروجی تنظیم می‌کند. نرخ بیت پیش‌فرض به تعداد کانال‌های ورودی و نرخ نمونه‌برداری (samplerate) بستگی دارد. 
------------------------------
Sample Rate   Mono    Stereo
------------------------------
48000         96      192
44100         96      192
32000         80      160
24000         48      96
22050         48      96
16000         32      64
------------------------------

-P, --psyc-mode <int>

مدل روان‌آکوستیک (psycho-acoustic) مورد استفاده را انتخاب می‌کند (-1 تا 4). مدل شمارهٔ -1 مدل‌سازی روان‌آکوستیک را غیرفعال کرده و در عوض از مقادیر پیش‌فرض ثابت استفاده می‌کند. لطفاً برای توضیحات کامل هر یک از مدل‌های موجود، فایل psycho را ببینید. مدل پیش‌فرض 3 است.

-v, --vbr

حالت VBR را فعال می‌کند. برای جزئیات، فایل مستندات vbr را ببینید. سطح پیش‌فرض VBR مقدار 5.0 است.

-V, --vbr-level <float>

حالت VBR را فعال کرده و سطح کیفیت را تنظیم می‌کند. هرچه این عدد بزرگ‌تر باشد کیفیت بهتر است. محدودهٔ بیشینه -50 تا 50 است اما محدودهٔ کاربردی -10 تا 10 می‌باشد. برای جزئیات، فایل مستندات vbr را ببینید.

-l, --ath <float>

سطح ATH را تنظیم می‌کند. سطح پیش‌فرض 0.0 است.

-q, --quick <int>

حالت سریع (quick) را فعال می‌کند. مدل روان‌آکوستیک تنها در هر تعداد فریم مشخص‌شده مجدداً محاسبه می‌شود.

-S, --single-frame

حالت تک‌فریم را فعال می‌کند: تنها یک فریم از صدای MPEG در خروجی تولید شده و سپس برنامه پایان می‌یابد.

-c, --copyright

فعال‌سازی پرچم کپی‌رایت (Copyright) در جریان بیت خروجی.

-o, --non-original

غیرفعال‌سازی پرچم غیراصل بودن (Original) در جریان بیت خروجی.

--original

فعال‌سازی پرچم نسخه اصلی (Original) در جریان بیت خروجی.

-p, --protect

فعال‌سازی حفاظت از خطای CRC در جریان بیت خروجی. یک چکسام ۱۶ بیتی اضافی به فریم‌ها افزوده می‌شود.

-d, --padding

فعال‌سازی پدینگ (padding) در جریان بیت خروجی.

-R, --reserve <int>

رزرو تعداد بیت‌های مشخص‌شده در هر فریم از جریان بیت خروجی.

-e, --deemphasis <char>

تنظیم نوع واکاهش/de-emphasis (n/c/5). مقدار پیش‌فرض none است.

-E, --energy

فعال‌سازی افزونه‌های سطح انرژی (energy level extensions).

-t, --talkativity <int>

تنظیم میزان اطلاعات نمایش‌داده‌شده روی stderr (۰ تا ۱۰). مقدار پیش‌فرض ۲ است.

--quiet

هیچ پیامی به stderr ارسال نشود، مگر اینکه خطایی رخ دهد. (مشابه --talkativity=0)

--brief

تنها نمایش حداقل پیام‌ها در حین رمزگذاری. این تنظیم کم‌حرف‌تر از تنظیمات پیش‌فرض پرگویی است. (مشابه --talkativity=1)

--verbose

نمایش تعداد بیشتری پیام روی stderr. این تنظیم برای عیب‌یابی مشکلات مفید است. (مشابه --talkativity=4)

اگر رمزگذاری با موفقیت پایان یابد، twolame مقدار 0 را برمی‌گرداند. با این حال اگر رمزگذاری ناموفق باشد، یکی از کدهای زیر بازگردانده خواهد شد.

•1 (هیچ رمزگذاری‌ای انجام نشد)
•2 (خطا در باز کردن فایل ورودی)
•4 (خطا در باز کردن فایل خروجی)
•6 (خطا در تخصیص حافظه)
•8 (خطا در پارامترهای رمزگذاری انتخاب‌شده)
•10 (خطا در خواندن صدای ورودی)
•12 (هنگام رمزگذاری خطایی رخ داد)
•14 (خطا در نوشتن صدای خروجی)

این دستور فایل sound.wav را با استفاده از نرخ بیت ثابت پیش‌فرض 192 kbps و مدل روان‌آکوستیک (psycho-acoustic) پیش‌فرض (مدل ۳) به sound.mp2 کدگذاری می‌کند:

twolame sound.wav

نرخ بیت ثابت 160kbps و کدگذاری joint stereo، ذخیره‌شده در فایل sound_160.mp2:

twolame -b 160 -m j sound.aiff sound_160.mp2

کدگذاری sound.wav به newfile.mp2 با استفاده از مدل روان‌آکوستیک ۲ و با نرخ بیت متغیر:

twolame -P 2 -v sound.wav newfile.mp2

مشابه مثال بالا، با این تفاوت که مقدار منفی برای آرگومان «-V» به این معناست که نرخ‌های بیت پایین‌تر بر نرخ‌های بالاتر ترجیح داده خواهند شد:

twolame -P 2 -V -5 sound.wav newfile.mp2

نمونه‌برداری مجدد (resample) فایل صوتی با استفاده از sox و هدایت مستقیم از طریق pipe به twolame:

sox sound_11025.aiff -t raw -r 16000 | twolame -r -s 16000 - - > out.mp2

فرانت‌اند twolame توسط Nicholas J Humfrey (باز)نویسی شده است. کتابخانه libtwolame بر پایه toolame اثر Mike Cheng توسعه یافته است. برای فهرست کامل نویسندگان، لطفاً فایل AUTHORS را ببینید.

وب‌سایت TwoLAME: http://www.twolame.org

lame(1), mpg123(1), madplay(1), sox(1)

حق نشر © 2004-2018 پروژه The TwoLAME Project. استفاده آزاد از این نرم‌افزار تحت شرایط مجوز عمومی جامع‌تر گنو (LGPL) مجاز است.

Nicholas J Humfrey <njh@aelius.com>

نویسنده.
10/11/2019