نام (NAME)

sonivoxrender - تبدیل فایل‌های آهنگ MIDI به صدای خام PCM

خلاصه دستور (SYNOPSIS)

توضیحات (DESCRIPTION)

این برنامه یک رندرکننده فایل MIDI بر پایه کتابخانه سینتی‌سایزر sonivox است. این ابزار قالب‌های فایلی .MID (Standard MIDI Files)، .RMI (RIFF-RMID)، و .XMF (Extensible Music Files) را می‌خواند و جریان صوتی را به صورت نمونه‌های صوتی خام ۱۶ بیتی استریو PCM در خروجی استاندارد می‌نویسد.

گزینه‌ها (OPTIONS)

-h, --help: نمایش اطلاعات مختصر درباره نحوه استفاده.
-v, --version: نمایش شماره نسخه برنامه.
-d, --dls soundfont: نام اختیاری فایل soundfont از نوع DLS یا SF2. در صورت مشخص نشدن، از soundfont داخلی تعبیه‌شده استفاده می‌شود.
-r, --reverb reverb_preset: پیش‌تنظیم Reverb بین 0 تا 4: 0=بدون اثر، 1=سالن بزرگ (large hall)، 2=سالن (hall)، 3=اتاقک (chamber)، 4=اتاق (room).
-w, --wet reverb_wet: سطح بازآوای پردازش‌شده (Reverb wet) بین 0 تا 32767.
-n, --dry reverb_dry: سطح صدای مستقیم و دست‌نخورده (Reverb dry) بین 0 تا 32767.
-c, --chorus chorus_preset: پیش‌تنظیم Chorus بین 0 تا 4: 0=بدون اثر، 1..4=پیش‌تنظیم‌ها.
-l, --level chorus_level: سطح صدای Chorus بین 0 تا 32767.
-g, --gain master_gain: بهره صدای کلی (Master gain) بین 0 تا 196، مقدار پیش‌فرض 100 (+0dB) است. این عدد نسبت به 100، در گام‌های 1dB محاسبه می‌شود؛ مثلاً 120 = +20dB و 80 = -20dB.
-V, --Verbosity verbosity: سطح پرگویی گزارش‌ها (Verbosity) بین 0 تا 5، که در آن 0=خاموش، و 1..5=سطوح مختلف جزئیات پیام‌ها است.
-R, --reverb-post-mix: نادیده گرفتن سطح ارسال بازآوای CC91. افکت بازآوا بر روی خروجی صوتی میکس‌شده اعمال خواهد شد که رفتار قدیمی برنامه است.
-C, --chorus-post-mix: نادیده گرفتن سطح ارسال کورس CC93. همچنین گزینه --reverb-post-mix را ببینید.
-s, --sndlib index: کتابخانه صوتی EAS مورد استفاده:

•: 1: wt_200k_G (پیش‌فرض) - بانک صوتی صرفاً مبتنی بر WT، مورد استفاده در دستگاه‌های Android. همچنین با نام “Common” شناخته می‌شود. پشتیبانی از نرخ‌های نمونه‌برداری 22050 Hz و 44100 Hz، و نمونه‌های 8-bit و 16-bit.
•: 2: GMdblib-3 - بانک صوتی صرفاً مبتنی بر FM. پشتیبانی از تمام نرخ‌های نمونه‌برداری. عمق بیت نمونه در اینجا اهمیتی ندارد.
•: 3: hybrid_22khz_mcu - بانک صوتی ترکیبی (هیبرید). استفاده از سینتی‌سایزر WT برای سازهای کوبه‌ای (درام) و FM برای سازهای ملودیک. این بانک ترکیبی از GMdblib-3 و Sonic_20Khz_Drums است. تنها از نرخ نمونه‌برداری 22050 Hz و نمونه‌های 8-bit پشتیبانی می‌کند.

نکته: این گزینه تأثیری بر DLS/SF2 ندارد. آن‌ها همواره از موتور سنتز صوتی DLS استفاده خواهند کرد. اگر کتابخانه صوتی انتخاب‌شده با پیکربندی ساخت برنامه سازگار نباشد، اجرای برنامه با نمایش پیام خطا ناموفق خواهد بود.

آرگومان‌ها

song_file: نام فایل ورودی [MID|RMI|XMF].

مثال‌ها (EXAMPLES)

مثال‌های زیر فرض می‌کنند که گزینه پیش‌فرض USE_44KHZ=ON برقرار است، به این معنی که نرخ نمونه‌برداری خروجی = 44100 Hz خواهد بود.

مثال ۱: تبدیل یک فایل MIDI و ذخیره صدای خروجی به عنوان یک فایل صوتی خام:

$ sonivoxrender ants.mid > ants.pcm

مثال ۲: هدایت (pipe) صدای رندر شده به ابزار aplay در ALSA لینوکس:

$ sonivoxrender ants.mid | aplay -c 2 -f S16_LE -r 44100

معادل است با:

$ sonivoxrender ants.mid | aplay -f cd

مثال ۳: هدایت صدای خروجی به ابزار lame جهت ایجاد یک فایل MP3:

$ sonivoxrender ants.mid | lame -r -s 44100 - ants.mp3

مثال ۴: هدایت صدای خروجی به ابزار sox جهت ایجاد یک فایل WAV:

$ sonivoxrender ants.mid | sox -t s16 -c 2 -r 44100 - ants.wav

مثال ۵: هدایت صدای رندر شده به ابزار pacat در PulseAudio:

$ sonivoxrender ants.mid | pacat

مثال ۶: هدایت صدای خروجی به ابزار pw-play در PipeWire:

$ sonivoxrender ants.mid | pw-play --rate 44100 -

مثال ۷: هدایت صدای خروجی به ابزار ffplay در FFmpeg:

$ sonivoxrender ants.mid | ffplay -i - -f s16le -ar 44.1k -ac 2 -nodisp -autoexit -loglevel quiet

مثال ۸: هدایت صدای خروجی به پخش‌کننده رسانه mpv:

$ sonivoxrender ants.mid | mpv --demuxer=rawaudio -demuxer-rawaudio-format=s16le --demuxer-rawaudio-rate=44100 --demuxer-rawaudio-channels=2 --no-video -

گزارش باگ‌ها (BUGS)

مشاهده تیکت‌ها و مشکلات در گیت‌هاب: https://github.com/EmbeddedSynth/sonivox/issues

کپی‌رایت و تکثیر (COPYRIGHT)

تحت مجوز Apache License، نسخه 2.0

نویسندگان (AUTHORS)

Pedro López-Cabanillas <plcl@users.sf.net>.