.\" Automatically generated by Pandoc 2.14.0.3
.\"
.TH "SONIVOXRENDER" "1" "February 14, 2026" "sonivox 4.0.1.0" "Sonivox MIDI File Renderer"
.hy
.SH "نام (NAME)"
.PP
\f[B]sonivoxrender\f[R] \- تبدیل فایل‌های آهنگ MIDI به صدای خام PCM
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[B]sonivoxrender\f[R] [\f[B]-h|--help\f[R]] [\f[B]-v|--version\f[R]]
[\f[B]-d|--dls\f[R] \f[I]soundfont\f[R]] [\f[B]-r|--reverb\f[R]
\f[I]0..4\f[R]] [\f[B]-w|--wet\f[R] \f[I]0..32767\f[R]]
[\f[B]-n|--dry\f[R] \f[I]0..32767\f[R]] [\f[B]-c|--chorus\f[R]
\f[I]0..4\f[R]] [\f[B]-l|--level\f[R] \f[I]0..32767\f[R]]
[\f[B]-g|--gain\f[R] \f[I]0..196\f[R]] [\f[B]-V|--Verbosity\f[R]
\f[I]0..5\f[R]] [\f[B]-R|--reverb-post-mix\f[R]]
[\f[B]-C|--chorus-post-mix\f[R]] [\f[B]-s|--sndlib\f[R] \f[I]1..3\f[R]]
\f[I]song_file\f[R]
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه یک رندرکننده فایل MIDI بر پایه کتابخانه سینتی‌سایزر sonivox است.
این ابزار قالب‌های فایلی .MID (Standard MIDI Files)، .RMI (RIFF-RMID)، و .XMF
(Extensible Music Files) را می‌خواند و جریان صوتی را به صورت نمونه‌های صوتی خام ۱۶ بیتی استریو PCM در خروجی استاندارد می‌نویسد.
.SS "گزینه‌ها (OPTIONS)"
.TP
-h, --help
نمایش اطلاعات مختصر درباره نحوه استفاده.
.TP
-v, --version
نمایش شماره نسخه برنامه.
.TP
-d, --dls \f[I]soundfont\f[R]
نام اختیاری فایل soundfont از نوع DLS یا SF2.
در صورت مشخص نشدن، از soundfont داخلی تعبیه‌شده استفاده می‌شود.
.TP
-r, --reverb \f[I]reverb_preset\f[R]
پیش‌تنظیم Reverb بین 0 تا 4: 0=بدون اثر، 1=سالن بزرگ (large hall)، 2=سالن (hall)، 3=اتاقک (chamber)،
4=اتاق (room).
.TP
-w, --wet \f[I]reverb_wet\f[R]
سطح بازآوای پردازش‌شده (Reverb wet) بین 0 تا 32767.
.TP
-n, --dry \f[I]reverb_dry\f[R]
سطح صدای مستقیم و دست‌نخورده (Reverb dry) بین 0 تا 32767.
.TP
-c, --chorus \f[I]chorus_preset\f[R]
پیش‌تنظیم Chorus بین 0 تا 4: 0=بدون اثر، 1..4=پیش‌تنظیم‌ها.
.TP
-l, --level \f[I]chorus_level\f[R]
سطح صدای Chorus بین 0 تا 32767.
.TP
-g, --gain \f[I]master_gain\f[R]
بهره صدای کلی (Master gain) بین 0 تا 196، مقدار پیش‌فرض 100 (+0dB) است.
این عدد نسبت به 100، در گام‌های 1dB محاسبه می‌شود؛ مثلاً\ 120 = +20dB و 80
= -20dB.
.TP
-V, --Verbosity \f[I]verbosity\f[R]
سطح پرگویی گزارش‌ها (Verbosity) بین 0 تا 5، که در آن 0=خاموش، و 1..5=سطوح مختلف جزئیات پیام‌ها است.
.TP
-R, --reverb-post-mix
نادیده گرفتن سطح ارسال بازآوای CC91.
افکت بازآوا بر روی خروجی صوتی میکس‌شده اعمال خواهد شد که رفتار قدیمی برنامه است.
.TP
-C, --chorus-post-mix
نادیده گرفتن سطح ارسال کورس CC93.
همچنین گزینه \f[B]--reverb-post-mix\f[R] را ببینید.
.TP
-s, --sndlib \f[I]index\f[R]
کتابخانه صوتی EAS مورد استفاده:
.RS
.IP \[bu] 2
1: wt_200k_G (پیش‌فرض) - بانک صوتی صرفاً مبتنی بر WT، مورد استفاده در دستگاه‌های Android.
همچنین با نام \[lq]Common\[rq] شناخته می‌شود.
پشتیبانی از نرخ‌های نمونه‌برداری 22050 Hz و 44100 Hz، و نمونه‌های 8-bit و 16-bit.
.IP \[bu] 2
2: GMdblib-3 - بانک صوتی صرفاً مبتنی بر FM.
پشتیبانی از تمام نرخ‌های نمونه‌برداری.
عمق بیت نمونه در اینجا اهمیتی ندارد.
.IP \[bu] 2
3: hybrid_22khz_mcu - بانک صوتی ترکیبی (هیبرید).
استفاده از سینتی‌سایزر WT برای سازهای کوبه‌ای (درام) و FM برای سازهای ملودیک.
این بانک ترکیبی از \f[C]GMdblib-3\f[R] و
\f[C]Sonic_20Khz_Drums\f[R] است.
تنها از نرخ نمونه‌برداری 22050 Hz و نمونه‌های 8-bit پشتیبانی می‌کند.
.PP
\f[B]نکته:\f[R] این گزینه تأثیری بر DLS/SF2 ندارد.
آن‌ها همواره از موتور سنتز صوتی DLS استفاده خواهند کرد.
اگر کتابخانه صوتی انتخاب‌شده با پیکربندی ساخت برنامه سازگار نباشد، اجرای برنامه با نمایش پیام خطا ناموفق خواهد بود.
.RE
.SS "آرگومان‌ها"
.TP
\f[I]song_file\f[R]
نام فایل ورودی [\f[B]MID|RMI|XMF\f[R]].
.SH "مثال‌ها (EXAMPLES)"
.PP
مثال‌های زیر فرض می‌کنند که گزینه پیش‌فرض USE_44KHZ=ON برقرار است، به این معنی که نرخ نمونه‌برداری خروجی = 44100 Hz خواهد بود.
.PP
مثال ۱: تبدیل یک فایل MIDI و ذخیره صدای خروجی به عنوان یک فایل صوتی خام:
.IP
.nf
\f[C]
$ sonivoxrender ants.mid > ants.pcm
\f[R]
.fi
.PP
مثال ۲: هدایت (pipe) صدای رندر شده به ابزار \f[B]aplay\f[R] در ALSA لینوکس:
.IP
.nf
\f[C]
$ sonivoxrender ants.mid | aplay -c 2 -f S16_LE -r 44100
\f[R]
.fi
.PP
معادل است با:
.IP
.nf
\f[C]
$ sonivoxrender ants.mid | aplay -f cd
\f[R]
.fi
.PP
مثال ۳: هدایت صدای خروجی به ابزار \f[B]lame\f[R] جهت ایجاد یک فایل MP3:
.IP
.nf
\f[C]
$ sonivoxrender ants.mid | lame -r -s 44100 - ants.mp3
\f[R]
.fi
.PP
مثال ۴: هدایت صدای خروجی به ابزار \f[B]sox\f[R] جهت ایجاد یک فایل WAV:
.IP
.nf
\f[C]
$ sonivoxrender ants.mid | sox -t s16 -c 2 -r 44100 - ants.wav
\f[R]
.fi
.PP
مثال ۵: هدایت صدای رندر شده به ابزار \f[B]pacat\f[R] در PulseAudio:
.IP
.nf
\f[C]
$ sonivoxrender ants.mid | pacat
\f[R]
.fi
.PP
مثال ۶: هدایت صدای خروجی به ابزار \f[B]pw-play\f[R] در PipeWire:
.IP
.nf
\f[C]
$ sonivoxrender ants.mid | pw-play --rate 44100 -
\f[R]
.fi
.PP
مثال ۷: هدایت صدای خروجی به ابزار \f[B]ffplay\f[R] در FFmpeg:
.IP
.nf
\f[C]
$ sonivoxrender ants.mid | ffplay -i - -f s16le -ar 44.1k -ac 2 -nodisp -autoexit -loglevel quiet
\f[R]
.fi
.PP
مثال ۸: هدایت صدای خروجی به پخش‌کننده رسانه \f[B]mpv\f[R]:
.IP
.nf
\f[C]
$ sonivoxrender ants.mid | mpv --demuxer=rawaudio -demuxer-rawaudio-format=s16le --demuxer-rawaudio-rate=44100 --demuxer-rawaudio-channels=2 --no-video -
\f[R]
.fi
.SH "گزارش باگ‌ها (BUGS)"
.PP
مشاهده تیکت‌ها و مشکلات در گیت‌هاب: <https://github.com/EmbeddedSynth/sonivox/issues>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.PP
تحت مجوز Apache License، نسخه 2.0
.PP
حق نشر (c) 2022-2026 متعلق به Pedro L\['o]pez-Cabanillas و مشارکت‌کنندگان
.SH "نویسندگان (AUTHORS)"
Pedro L\['o]pez-Cabanillas <plcl@users.sf.net>.