SONIVOXRENDER(1)          Sonivox MIDI File Renderer          SONIVOXRENDER(1)

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

خلاصه دستور (SYNOPSIS)
       sonivoxrender [-h|--help] [-v|--version] [-d|--dls soundfont]
       [-r|--reverb 0..4] [-w|--wet 0..32767] [-n|--dry 0..32767] [-c|--chorus
       0..4] [-l|--level 0..32767] [-g|--gain 0..196] [-V|--Verbosity 0..5]
       [-R|--reverb-post-mix] [-C|--chorus-post-mix] [-s|--sndlib 1..3]
       song_file

توضیحات (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

       حق نشر (c) 2022-2026 متعلق به Pedro López-Cabanillas و مشارکت‌کنندگان

نویسندگان (AUTHORS)
       Pedro López-Cabanillas <plcl@users.sf.net>.

sonivox 4.0.1.0                February 14, 2026              SONIVOXRENDER(1)