.\"                              hey, Emacs:   -*- nroff -*-
.\" FluidSynth is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU Lesser General Public License as published by
.\" the Free Software Foundation; either version 2.1 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU Lesser General Public License
.\" along with this program; see the file LICENSE.  If not, write to
.\" the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.TH FluidSynth 1 "Feb 21, 2026"
.\" Please update the above date whenever this man page is modified.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins (default)
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH "نام (NAME)"
fluidsynth \- یک سینتی‌سایزر نرم‌افزاری بر پایه ساندفونت (SoundFont)
.SH "خلاصه دستور (SYNOPSIS)"
.B fluidsynth
.RI [ گزینه‌ها ]
[ SoundFonts ]
[ midifiles ]
.SH "توضیحات (DESCRIPTION)"
برنامه
\fBFluidSynth\fP
یک سینتی‌سایزر بی‌درنگ (real-time) بر پایه مشخصات SoundFont(R) 2 برای فایل‌های صوتی و MIDI است.
از این ابزار می‌توان برای تبدیل ورودی‌های MIDI یا فایل‌های MIDI به صدا استفاده کرد.
رویدادهای MIDI از یک دستگاه MIDI دریافت می‌شوند.
صدا به صورت بی‌درنگ به دستگاه خروجی صوتی رندر و پخش می‌شود.
.PP
ساده‌ترین روش برای اجرای سینتی‌سایزر، مشخص کردن یک فایل SoundFont در خط فرمان است:
\&'fluidsynth soundfont.sf2'.
برنامه fluidsynth فایل SoundFont را بارگذاری کرده
و رویدادهای MIDI را با استفاده از درایور پیش‌فرض MIDI از دستگاه پیش‌فرض MIDI می‌خواند.
پس از اجرای FluidSynth،
دستورات را از ورودی استاندارد (stdin) دریافت می‌کند.
دستوراتی برای ارسال دستی رویدادهای MIDI،
بارگذاری یا تخلیه SoundFontها
و موارد دیگر وجود دارد.
تمام دستورات موجود در ادامه تشریح شده‌اند.
.PP
همچنین از FluidSynth می‌توان برای پخش فهرستی از فایل‌های MIDI استفاده کرد.
تنها کافی است FluidSynth را به همراه فایل SoundFont
و فهرستی از فایل‌های MIDI برای پخش اجرا کنید.
در این حالت شاید تمایلی به باز کردن دستگاه MIDI برای خواندن رویدادهای خارجی نداشته باشید.
از گزینه
.B \-n
برای غیرفعال‌سازی ورودی MIDI استفاده کنید.
اگر می‌خواهید استفاده از شل (shell) تعاملی را نیز غیرفعال کنید،
FluidSynth را با گزینه
.B \-i
اجرا کنید:
\&'fluidsynth \-ni soundfont.sf2 midifile1.mid midifile2.mid'.
.PP
برنامه fluidsynth را با گزینه
.B \-\-help
اجرا کنید تا از تغییرات موجود در فهرست گزینه‌ها مطلع شوید.
.SH "گزینه‌ها (OPTIONS)"
برنامه
\fBfluidsynth\fP
گزینه‌های زیر را می‌پذیرد:

.TP
.B \-a, \-\-audio\-driver=[label]
درایور صوتی مورد استفاده.
برای مشاهده گزینه‌های معتبر از "\-a help" استفاده کنید.
.TP
.B \-b, \-\-bank\-offset=[num]
یک فلگ وابسته به موقعیت که افست بانک (bank-offset) را برای تمام ساندفونت‌های پس از آن مشخص می‌کند. می‌توان آن را چندین بار تعیین کرد.
.TP
.B \-c, \-\-audio\-bufcount=[count]
تعداد بافرهای صوتی
.TP
.B \-C, \-\-chorus
روشن یا خاموش کردن کُروس (chorus)
[0|1|yes|no، پیش‌فرض = on]
.TP
.B \-d, \-\-dump
تخلیه و چاپ رویدادهای ورودی و خروجی MIDI در خروجی استاندارد (stdout)
.TP
.B \-E, \-\-audio\-file\-endian
ترتیب بایت‌ها (endianness) فایل صوتی برای رندر سریع یا درایور aufile
(برای مشاهده فهرست از "\-E help" استفاده کنید)
.TP
.B \-f, \-\-load\-config
بارگذاری فایل پیکربندی دستورات
(دستورات شل)
.TP
.B \-F, \-\-fast\-render=[file]
رندر کردن فایل MIDI به داده‌های صوتی خام و ذخیره در [file]
.TP
.B \-g, \-\-gain
تنظیم بهره (gain) اصلی خروجی
[0 < gain < 10، پیش‌فرض = 0.2]
.TP
.B \-G, \-\-audio\-groups
تعیین تعداد گره‌های صوتی LADSPA
.TP
.B \-h, \-\-help
چاپ این خلاصه راهنما
.TP
.B \-i, \-\-no\-shell
عدم خواندن دستورات از شل [پیش‌فرض = yes]
.TP
.B \-j, \-\-connect\-jack\-outputs
تلاش برای اتصال خروجی‌های جک (JACK) به درگاه‌های فیزیکی
.TP
.B \-K, \-\-midi\-channels=[num]
تعداد کانال‌های MIDI [پیش‌فرض = 16]
.TP
.B \-L, \-\-audio\-channels=[num]
تعداد کانال‌های صوتی استریو [پیش‌فرض = 1]
.TP
.B \-m, \-\-midi\-driver=[label]
نام درایور MIDI مورد استفاده.
برای مشاهده گزینه‌های معتبر از "\-m help" استفاده کنید.
.TP
.B \-n, \-\-no\-midi\-in
عدم ایجاد درایور MIDI برای خواندن رویدادهای ورودی MIDI [پیش‌فرض = yes]
.TP
.B \-o
تعریف یک تنظیم به صورت \-o name=value
(برای تخلیه و نمایش مقادیر فعلی از "\-o help" استفاده کنید)
.TP
.B \-O, \-\-audio\-file\-format
قالب فایل صوتی برای رندر سریع یا درایور aufile
(برای مشاهده فهرست از "\-O help" استفاده کنید)
.TP
.B \-p, \-\-portname=[label]
تنظیم نام درگاه MIDI
(درایورهای alsa_seq و coremidi)
.TP
.B \-q, \-\-quiet
عدم چاپ پیام خوش‌آمدگویی یا سایر خروجی‌های اطلاعاتی
.TP
.B \-r, \-\-sample\-rate
تنظیم نرخ نمونه‌برداری (sample rate)
.TP
.B \-R, \-\-reverb
روشن یا خاموش کردن ریورب (reverb)
[0|1|yes|no، پیش‌فرض = on]
.TP
.B \-s, \-\-server
اجرای FluidSynth به صورت یک فرآیند سرور
.TP
.B \-T, \-\-audio\-file\-type
نوع فایل صوتی برای رندر سریع یا درایور aufile
(برای مشاهده فهرست از "\-T help" استفاده کنید)
.TP
.B \-v, \-\-verbose
چاپ پیام‌های پرجزئیات درباره رویدادهای MIDI
(synth.verbose=1)
و همچنین سایر پیام‌های اشکال‌زدایی
.TP
.B \-V, \-\-version
نمایش نسخه برنامه
.TP
.B \-z, \-\-audio\-bufsize=[size]
اندازه هر بافر صوتی

.SH "تنظیمات (SETTINGS)"
تنظیماتی که باید با گزینه
.B \-o
مشخص شوند در پرونده
.B fluidsettings.xml
که همراه این توزیع ارائه شده است
یا به صورت برخط در نشانی
https://www.fluidsynth.org/wiki/settings
مستندسازی شده‌اند.
توصیه می‌کنیم این پرونده را در یک مرورگر وب، ترجیحاً فایرفاکس (Firefox)، مشاهده نمایید.

.SH "دستورات شل (SHELL COMMANDS)"
.TP
.B GENERAL
.TP
.B help
چاپ فهرست موضوعات راهنما
(برای مشاهده جزئیات دستورات موجود عبارت "help <topic>" را تایپ کنید)
.TP
.B quit
خروج از سینتی‌سایزر
.TP
.B SOUNDFONTS
.TP
.B load filename [reset] [bankofs]
بارگذاری یک ساند‌فونت (SoundFont) در پشته ساند‌فونت. اگر reset برابر 1 باشد (که پیش‌فرض ضمنی است)، تمام پریست‌های در حال استفاده ساندفونت با در نظر گرفتن ساندفونت تازه بارگذاری‌شده مجدداً ارزیابی می‌شوند.
به صورت اختیاری، می‌توانید یک افست بانک غیرصفر برای ساندفونت جدید تعیین کنید. برای نمونه دستور
.B load soundfont.sf2 0 10
فایل soundfont.sf2 را با افست بانک 10 بدون ارزیابی مجدد پریست‌ها بارگذاری خواهد کرد.
.TP
.B unload number
تخلیه یک ساندفونت.
عدد مشخص‌شده نشان‌دهنده اندیس ساندفونت در پشته است.
.TP
.B fonts
فهرست کردن ساندفونت‌های فعلی موجود در پشته
.TP
.B inst number
چاپ سازهای صوتی موجود برای ساندفونت.
.TP
.B MIDI MESSAGES
.TP
.B noteon channel key velocity
ارسال یک رویداد فشردن کلید نت (note-on)
.TP
.B noteoff channel key
ارسال یک رویداد رها کردن کلید نت (note-off)
.TP
.B cc channel ctrl value
ارسال یک رویداد تغییر کنترل (control change)
.TP
.B prog chan num
ارسال پیام تغییر برنامه (program-change)
.TP
.B select chan sfont bank prog
ترکیبی از انتخاب بانک (bank-select) و تغییر برنامه (program-change)
.TP
.B channels
چاپ پریست‌های تمام کانال‌ها.
.TP
.B AUDIO SYNTHESIS
.TP
.B gain value
تنظیم بهره (gain) اصلی خروجی
(0 < gain < 5)
.TP
.B interp num
انتخاب روش درونیابی (interpolation) برای تمام کانال‌ها
.TP
.B interpc chan num
انتخاب روش درونیابی برای یک کانال مشخص
.TP
.B REVERB
.TP
.B set synth.reverb.active [0|1]
روشن یا خاموش کردن ریورب (reverb)
.TP
.B set synth.reverb.engine
انتخاب موتور ریورب. انتخاب موتور در زمان ایجاد سینتی‌سایزر اعمال می‌شود.
.TP
.B set synth.reverb.room-size num
تغییر اندازه اتاق ریورب (room size)
.TP
.B set synth.reverb.damp num
تغییر میرایی ریورب (damping)
.TP
.B set synth.reverb.width num
تغییر پهنای ریورب (width)
.TP
.B set synth.reverb.level num
تغییر سطح صدای ریورب (level)
.TP
.B CHORUS
.TP
.B set synth.chorus.active [0|1]
روشن یا خاموش کردن کُروس (chorus)
.TP
.B set synth.chorus.nr n
استفاده از n خط تاخیر (delay lines)
(پیش‌فرض 3)
.TP
.B set synth.chorus.level num
تنظیم سطح خروجی هر خط کُروس به مقدار num
.TP
.B set synth.chorus.speed num
تنظیم سرعت مدولاسیون کُروس به مقدار num (بر حسب هرتز)
.TP
.B set synth.chorus.depth num
تنظیم عمق مدولاسیون کُروس به مقدار num (بر حسب میلی‌ثانیه)
.TP
.B MIDI ROUTER
.TP
.B router_default
بارگذاری مجدد قوانین پیش‌فرض مسیریابی MIDI
(کانال‌های ورودی به صورت ۱:۱ به سینتی‌سایزر نگاشت می‌شوند)
.TP
.B router_clear
پاک کردن و حذف تمام قوانین مسیریابی MIDI.
.TP
.B router_begin [note|cc|prog|pbend|cpress|kpress]
شروع یک قانون جدید مسیریابی برای رویدادهایی از نوع داده‌شده
.TP
.B router_chan min max mul add
محدود کردن قانون به رویدادهای در بازه min <= chan <= max.
اگر کانال در این پنجره قرار گیرد،
در 'mul' ضرب شده
و سپس مقدار 'add' به آن اضافه می‌شود.
.TP
.B router_par1 min max mul add
محدود کردن پارامتر ۱
(برای نمونه شماره نت در رویدادهای note).
مشابه با router_chan.
.TP
.B router_par2 min max mul add
محدود کردن پارامتر ۲
(برای نمونه شدت ضربه یا velocity در یک رویداد note).
مشابه با router_chan.
.TP
.B router_end
پایان دادن به قانون فعلی و افزودن آن به مسیریاب.
.TP
.B Router examples
.TP
router_clear
.TP
router_begin note
.TP
router_chan 0 7 0 15
.TP
router_end
.\".TP
تنها رویدادهای نت از ۸ کانال اول و پایین‌تر MIDI را می‌پذیرد.
بدون توجه به کانال ورودی،
سینتی‌سایزر نت را روی کانال ۱۵ اجرا می‌کند
(synthchannel=midichannel*0+15)
.TP
router_begin cc
.TP
router_chan 0 7 0 15
.TP
router_par1 1 1 0 64
.TP
router_add
چرخ مدولاسیون (modulation wheel) را پیکربندی می‌کند تا به عنوان پدال نگهدارنده (sustain pedal) عمل کند
(تبدیل CC 1 به CC 64 روی ۸ کانال اول MIDI،
و مسیریابی به کانال ۱۵)

.SH "نویسندگان (AUTHORS)"
Peter Hanappe <hanappe@fluid-synth.org>
.br
Markus Nentwig <nentwig@users.sourceforge.net>
.br
Antoine Schmitt <as@gratin.org>
.br
Josh Green <jgreen@users.sourceforge.net>
.br
Stephane Letz <letz@grame.fr>
.br
Tom Moebert <tom[d0t]mbrt[ÄT]gmail[d0t]com>
.PP
برای مشاهده تمامی سازندگان و اعتبارنامه‌ها پرونده‌های AUTHORS و THANKS را بررسی کنید.
.SH "سلب مسئولیت (DISCLAIMER)"
علامت تجاری SoundFont(R) یک علامت تجاری ثبت‌شده متعلق به E-mu Systems, Inc. است.