SETBFREE(1) User Commands SETBFREE(1)

setBfree - ارگ tonewheel مبتنی بر DSP

setBfree [ OPTIONS ] [ property=value ... ]

setBfree - ارگ tonewheel مبتنی بر DSP

دستور setBfree یک سینتی‌سایزر نرم‌افزاری تحت کنترل MIDI است که برای شبیه‌سازی صدا و ویژگی‌های ارگ‌های الکترومکانیکی و دستگاه‌های تغییر صدای مرتبط طراحی شده است؛ همان ابزارهایی که شهرتی جهانی را برای نام و محصولات Laurens Hammond و Don Leslie به ارمغان آوردند.

بارگذاری فایل پیکربندی جایگزین به جای فایل پیش‌فرض
عدم خواندن فایل پیکربندی پیش‌فرض؛ مقادیر پیش‌فرض توکار معادل همچنان اعمال می‌شوند
چاپ فهرستی از نگاشت‌های MIDI-CC در هنگام راه‌اندازی
عدم بارگذاری نگاشت پیش‌فرض CC در هنگام راه‌اندازی
چاپ متن راهنمای کوتاه
چاپ متن راهنمای کامل به همراه فهرست پارامترها
بارگذاری یک پریست برنامه (program-preset) MIDI در هنگام راه‌اندازی (ممکن است تنظیمات قبلی تعیین‌شده با -r، -U و... را لغو کند)
برون‌بری نگاشت فعلی کنترلر به یک فایل ‎.midnam
بارگذاری فایل برنامه جایگزین به جای پیش‌فرض
عدم خواندن فایل برنامه پیش‌فرض؛ برنامه‌های توکار نیز پاک می‌شوند
تصادفی‌سازی پریست اولیه (عجیب اما واقعی)
تعیین تنظیمات اولیه drawbar برای کیبورد بالایی (upper manual) به صورت ۹ رقم؛ به عنوان مثال 808000000
چاپ اطلاعات نسخه

پیکربندی شامل دو بخش است: برنامه (pgm) و پیکربندی (cfg).
پیکربندی ایستا (static) ویژگی‌های ساز در یک فایل ‎.cfg تعریف می‌شود. نیازی به مشخص کردن فایل پیکربندی نیست، زیرا تمام پارامترهای قابل تنظیم دارای مقادیر پیش‌فرض توکار هستند. می‌توان آن‌ها را در هنگام راه‌اندازی با استفاده از جفت‌های 'property=value' یا با بارگذاری یک فایل ‎.cfg خاص بازنویسی کرد. همان‌طور که از نام «ایستا» برمی‌آید، این ویژگی‌ها تنها در زمان شروع برنامه قابل تنظیم هستند. با این حال، بسیاری از این ویژگی‌ها صرفاً مقدار اولیه تنظیماتی را مشخص می‌کنند که بعداً می‌توانند در طول پخش تغییر یابند. مواردی که امکان تغییر پویای آن‌ها وجود دارد با یک ستاره (*) نشانه‌گذاری شده‌اند.
ویژگی‌ها با ارسال دستورات کنترلی MIDI (یا همان CC) به سینتی‌سایزر تغییر می‌یابند. نگاشت CCها به توابع را می‌توان با تنظیم ویژگی "midi.controller.{upper|lower|pedal}.<CC>=<function>" اصلاح کرد. نام‌های توابع معادل نام‌های ویژگی هستند؛ به عنوان مثال: "midi.controller.upper.22=overdrive.outputgain" مقدار overdrive-gain را به MIDI-CC 22 روی کانال ۱ MIDI (کیبورد بالایی یا upper) اختصاص می‌دهد. (نکته: هر تابع تنها می‌تواند یک بار اختصاص داده شود، اما از یک MIDI-CC می‌توان مجدداً استفاده کرد و چندین تابع را به طور هم‌زمان تحریک نمود.)
برنامه اساساً «میان‌برها» را تعریف می‌کند. بارگذاری یک برنامه معمولاً معادل ارسال یک سری دستورات CC است. برنامه‌ها عموماً برای تعریف سازها (مانند تنظیمات drawbar برای شبیه‌سازی فلوت) یا ارائه نقاط مقیاس (مانند reverb=64) استفاده می‌شوند. چند دستور ویژه وجود دارند که فقط با فراخوانی یک برنامه در دسترس قرار می‌گیرند (تصادفی‌سازی تنظیمات، تقسیم دستی کیبوردها یا split-manuals، فعال‌سازی overdrive).
برنامه‌ها در یک فایل ‎.pgm تعریف می‌شوند و پس از شروع برنامه ثابت هستند. آن‌ها با ارسال پیام‌های MIDI-program-change (که با نام «پریست» نیز شناخته می‌شوند) فعال می‌گردند. بانک‌های MIDI نادیده گرفته می‌شوند، بنابراین حداکثر ۱۲۷ برنامه را می‌توان تعیین کرد.
در هنگام راه‌اندازی، فایل‌های 'default.cfg' و 'default.pgm' در مسیر $XDG_CONFIG_HOME/setBfree/ (پیش‌فرض: $HOME/.config/setBfree/) در صورت وجود داشتن ارزیابی می‌شوند، مگر اینکه گزینه‌های '--noconfig' یا با استفاده از گزینه‌های '-c' و '-p' بارگذاری نمود.
پیکربندی نمونه: "/usr/share/setBfree/cfg/default.cfg"
برنامه نمونه: "/usr/share/setBfree/pgm/default.pgm".SS "ویژگی‌های ساز (Instrument Properties):"
در زیر فهرستی از جفت‌های ویژگی-مقدار موجود و مقادیر پیش‌فرض آن‌ها آمده است. مقدار پیش‌فرض برای ویژگی‌هایی که حاوی آرایه‌ای از مقادیر هستند درج نشده است "(-)".
شناسه‌های نوع عبارتند از: 'S': رشته متنی (text-string)، 'I': عدد صحیح (integer)، 'F': ممیز شناور (float)، 'D': ممیز شناور با دقت مضاعف (double-precision float).
ویژگی‌هایی که با ستاره (*) مشخص شده‌اند، به‌عنوان توابع MIDI CC در دسترس هستند. هنگام استفاده به‌صورت CC، مقادیر 0-127 (داده‌های MIDI) به بازه‌ای از مقادیر متناسب با آن تابع نگاشت می‌شوند. در فایل‌های پیکربندی یا در خط فرمان باید نوع را همان‌طور که مشخص شده است استفاده کنید؛ مانند: "osc.temperament=gear60 osc.wiring-crosstalk=0.2"

S ("jack")
راه‌انداز midi مورد استفاده، 'jack' یا 'alsa'
S ("")
درگاه(های) midi برای اتصال خودکار. در alsa یک نام درگاه تکی یا شماره است؛ jack عبارات باقاعده را می‌پذیرد.
S ("system:playback_")
اتصال خودکار هر دو درگاه صوتی به یک عبارت باقاعده داده‌شده. اگر هر یک از jack.out.{left|right} مشخص شده باشد، این تنظیم نادیده گرفته می‌شود.
S ("")
اتصال خروجی چپ به این درگاه jack (نام دقیق)
S ("")
اتصال خروجی راست به این درگاه jack (نام دقیق)

I (1)
کانال MIDI مورد استفاده برای کلاویه بالایی (upper-manual). بازه: [1..16]
I (2)
کانال MIDI مورد استفاده برای کلاویه پایینی (lower manual). بازه: [1..16]
I (3)
کانال MIDI مورد استفاده برای پدال‌ها. بازه: [1..16]
I ("-")
پاک کردن نگاشت CC موجود برای تمام کنترلرها (در صورت ارائه آرگومان غیر صفر). همچنین گزینه -D را ببینید.
S ("-")
مشخص کردن نام یک تابع برای انتساب به دستور کنترلی MIDI داده‌شده. <cc> یک عدد صحیح 0..127 است. مقادیر پیش‌فرض در ()midiPrimeControllerMapping قرار دارند و می‌توان آن‌ها را با استفاده از گزینه خط فرمان '-d' فهرست کرد. بخش اطلاعات عمومی را ببینید.
S ("-")
به midi.controller.upper مراجعه کنید
S ("-")
به midi.controller.upper مراجعه کنید
I (0)
تغییر گام (noteshift) کلی بر حسب نیم‌پرده.
I (0)
انتقال/تغییر گام نت‌های MIDI در کلاویه بالایی
I (0)
انتقال/تغییر گام نت‌های MIDI در کلاویه پایینی
I (0)
انتقال/تغییر گام نت‌های MIDI روی پدال‌ها
I (0)
تغییر نت برای کلاویه بالایی در حالت تقسیم (split mode)
I (0)
تغییر نت برای کلاویه پایینی در حالت تقسیم (split mode)
I (0)
تغییر نت برای کلاویه پایینی در حالت تقسیم (split mode).SS "پارامترهای «MIDI Program Parser»:"
I (1)
جبران‌سازی برای کنترل‌کننده‌های MIDI که برنامه‌ها را از ۱ تا ۱۲۸ شماره‌گذاری می‌کنند. در داخل، همانند MIDI، از 0-127 استفاده می‌شود. محدوده: [0,1]

D (440.0)
کوک پایه‌ی ارگ.
S ("gear60")
اعتدال کوک (temperament)، نسبت دنده‌ها/سرعت موتور (gear-ratios/motor-speed). یکی از مقادیر: "equal", "gear60", "gear50"
D (0.001)
دقت موج. بیشینه خطای مجاز هنگام محاسبه‌ی طول بافر موج برای یک فرکانس مشخص (ideal #of samples - discrete #of samples)
D (1.0)
زمان میرایی (decay) سریع پرکاشن
D (4.0)
زمان میرایی کُند پرکاشن
D (1.0)
بهره‌ی (gain) اولیه‌ی پوش (envelope) پرکاشن برای حجم صدای معمولی (normal).
D (0.5012)
بهره‌ی اولیه‌ی پوش پرکاشن برای حجم صدای ملایم (soft).
D (11.0)
حجم صدای پایه‌ای سیگنال پرکاشن؛ هم برای normal و هم soft اعمال می‌شود
I (3)
محدوده [0..8]
I (4)
محدوده [0..8]
I (8)
محدوده [-1..8]
S ("chspline")
یکی از مقادیر "chspline", "peak24", "peak46"
D (1.0)
پارامتر اسپیلاین (spline) اکولایزر (EQ)
D (0.0)
پارامتر اسپیلاین EQ
D (1.0)
پارامتر اسپیلاین EQ
D (0.0)
پارامتر اسپیلاین EQ
D (1.0)
نرمال‌سازی پارامترهای EQ.
D (-)
oscnum=[0..127]، مقدار: [0..osc.eqv.ceiling]؛ مقادیر پیش‌فرض بسته به osc.eq.macro و tone-generator-model انتخاب‌شده محاسبه می‌شوند.
D (-)
تعیین سطح شماره هارمونیک مشخص‌شده.
D (-)
w: شماره‌ی چرخ‌دنده صوتی (tonewheel) [0..91]، h: شماره هارمونیک
D (-)
t,w: شماره‌ی چرخ‌دنده صوتی (wheel-number) [0..91]
D (-)
سفارشی‌سازی مدل تضعیف (tapering). تعیین سطح [key, drawbar, tonewheel].
S (-)
مقدار جداشده با دونقطه: "<int:bus>:<int:wheel>:<double:level>"
D (0.01)
هم‌شنوی (crosstalk) بین tonewheelها در یک محفظه (compartment) یکسان. این مقدار به میزان سیگنال سرگردان (rogue signal) دریافت‌شده اشاره دارد.
D (0)
هم‌شنوی میان ترانسفورماتورها در بالای tg (مولد تُن).
D (0.01)
هم‌شنوی میان اتصالات روی نوار ترمینال (terminal strip).
D (0.01)
مهارکننده (throttle) روی مدل توزیع هم‌شنوی برای سیم‌کشی
D (0.0000158)
سیگنال‌های ضعیف‌تر از این مقدار در فهرست مشارکت (contribution list) قرار نمی‌گیرند
D (0)
اگر غیر صفر باشد، سیگنال‌های مشارکت‌کننده حداقل دارای این سطح خواهند بود
D (0.5)
میزان تضعیف تصادفی اعمال‌شده بر اتصال بسته‌شونده‌ی bus-oscillator.
D (0.6250)
حداکثر طول فوران نوفه کلیک کلید (key-click noise burst)؛ ۱۰۰٪ معادل ۱۲۸ نمونه صوتی (audio-samples) است
D (0.1250)
حداقل طول فوران نوفه کلیک کلید؛ ۱۰۰٪ معادل ۱۲۸ نمونه صوتی (audio-samples) است
D (0.25)
میزان تضعیف تصادفی اعمال‌شده بر اتصال بازشونده‌ی bus-oscillator
S ("linear")
مدل اعمال‌شده هنگام رهاسازی کلید (key-release)؛ یکی از مقادیر: "click", "cosine", "linear", "shelf"
S ("click").IP مدلی که هنگام key-attack اعمال می‌شود؛ یکی از موارد "click" ،"cosine" ،"linear" یا "shelf"

D (7.25)
فرکانس اسکنر ویبراتو
D (3.0)
میزان مدولاسیون برای تنظیم vibrato/chorus 1
D (6.0)
میزان مدولاسیون برای تنظیم vibrato/chorus 2
D (9.0)
میزان مدولاسیون برای تنظیم vibrato/chorus 3

F* (0.3567)
این پارامتر مشخص می‌کند که سیگنال ورودی هنگام ورود به جلوه اوردرایو چقدر مقیاس‌بندی (تغییر سطح) شود. مقدار پیش‌فرض نسبتاً بالا (hot) است، اما می‌توانید آن را به هر شکل که مایلید تغییر دهید؛ بازه [0..1]
F* (0.07873)
این پارامتر مشخص می‌کند که سیگنال هنگام خروج از جلوه اوردرایو چقدر مقیاس‌بندی شود. این مقدار اساساً باید بدون ایجاد برش سیگنال (clipping) تا حد ممکن بالا باشد (و در صورت برش سیگنال، قطعاً متوجه آن خواهید شد - با یک آکورد باس روی 88 8888 000 با percussion فعال و full swell آزمایش کنید، اما ابتدا حتماً صدای آمپلی‌فایر/هدفون را کم کنید!)؛ بازه [0..1]
F* (0.5347)
پایه بایاس (bias base)؛ بازه [0..1]
F* (0.6214)
کنترل بازخورد [منفی] سراسری (Global [negative] feedback control)؛ بازه [0..1]
F* (-)
انتزاعی برای تنظیم xov.ctl_biased_fb و xov.ctl_biased_fb2
F* (0.5821)
این پارامتر تا حدودی شبیه به یک کنترل‌کننده آنالوگ تن صدا برای باس عمل می‌کند که پیش از مرحله اوردرایو قرار گرفته است. سطح واحد (Unity) حدود مقدار 0.6 است؛ مقادیر کمتر، صدای باس را کاهش داده و سطح صدا را پایین می‌آورند، در حالی که مقادیر بالاتر باس بیشتر و سیگنال قوی‌تری را به اوردرایو هدایت می‌کنند. باید کمتر از 1.0 باشد.
F* (0.999)
پارامتر fb2 عملکردی مشابه fb1 دارد اما سیگنال را پس از مرحله اوردرایو کنترل می‌کند. ترکیب این دو پارامتر از این جهت مفید است که می‌توانند مقدار باس ورودی به اوردرایو را کاهش داده و سپس در سمت دیگر آن را بازیابی کنند. باید کمتر از 1.0 باشد.
F* (0.1880)
این پارامتر بخشی از تلاش برای بازآفرینی پدیده‌ای موسوم به «افت توان» (power sag) است. هنگامی که یک تقویت‌کننده قدرت تحت بار سنگین قرار می‌گیرد، ولتاژ افت کرده و پارامترهای عملیاتی دستگاه را معمولاً به سمت اعوجاج (distortion) بیشتر و انواع متفاوتی از آن تغییر می‌دهد. پارامتر sagfb نرخ بازیابی از اثر افت ولتاژ را پس از برداشته شدن بار کنترل می‌کند. باید کمتر از 1.0 باشد.

I (0)
اگر روی 1 تنظیم شود، شبیه‌سازی leslie را به‌طور کامل دور می‌زند (bypass).
I (0)
سرعت اولیه شیپور (horn) و درام (drum). 0: متوقف‌شده، 1: آهسته، 2: سریع
D (40.32)
دور بر دقیقه (RPM) هدف برای سرعت آهسته (موسوم به choral) شیپور
D (423.36)
دور بر دقیقه (RPM) هدف برای سرعت سریع (موسوم به tremolo) شیپور
D* (0.161)
زمان مورد نیاز برای شتاب‌گیری شیپور (ثابت زمانی نمایی)
D* (0.321)
زمان مورد نیاز برای کاهش سرعت شیپور (ثابت زمانی نمایی)
D* (0)
موقعیت توقف شیپور. موقعیت جهت عقربه‌های ساعت برای محل توقف. (0: توقف آزاد (free-stop)، 1.0: جلو-مرکز (front-center))
D (36.0)
دور بر دقیقه (RPM) هدف برای سرعت آهسته (موسوم به choral) درام.
D (357.3)
دور بر دقیقه (RPM) هدف برای سرعت سریع (موسوم به tremolo) درام.
D* (4.127)
زمان مورد نیاز برای شتاب‌گیری درام (ثابت زمانی نمایی)
D* (1.371)
زمان مورد نیاز برای کاهش سرعت درام (ثابت زمانی نمایی)
D* (0)
موقعیت توقف درام. موقعیت جهت عقربه‌های ساعت برای محل توقف. (0: توقف آزاد (free-stop)، 1.0: جلو-مرکز (front-center))
D (0)
عرض استریوی درام (فقط LV2) (-1: میکروفون چپ، 0: استریو، 1: میکروفون راست)
D (0)
عرض استریوی شیپور (فقط LV2) (-1: میکروفون چپ، 0: استریو، 1: میکروفون راست)
D (19.2)
شعاع شیپور بر حسب سانتی‌متر
D (22.0)
شعاع درام بر حسب سانتی‌متر
D (42.0)
فاصله میکروفون از مبدأ مختصات بر حسب سانتی‌متر
D (180.0)
زاویه میکروفون استریوی شیپور
D (0.0)
انحراف (offset) شیپور عمود بر میکروفون به سمت جلو، بر حسب سانتی‌متر
D (0.0)
انحراف شیپور به سمت میکروفون چپ، بر حسب سانتی‌متر
D (0.7)
حجم صدای سیگنال پردازش‌شده (wet-signal) شیپور
D (0.15)
میزان نشت سیگنال پردازش‌نشده (dry-signal) شیپور
I* (8)
این فیلتر سیگنالی را که باید به بلندگوی درام (drum-speaker) ارسال شود تفکیک می‌کند. این فیلتر باید یک فیلتر high-shelf با بهره (gain) منفی باشد. نوع فیلتر: 0-8. بخش «Filter types» در زیر را ببینید..TP whirl.drum.filter.q D* (1.6016)
کیفیت فیلتر، پهنای باند
D* (811.9695)
فرکانس فیلتر.
D* (-38.9291)
بهره فیلتر
I* (0)
این فیلتر اول از دو فیلتر برای شکل‌دهی به سیگنال ارسالی به بلندگوی شیپوری (horn-speaker) است؛ به‌طور پیش‌فرض یک فیلتر پایین‌گذر (low-pass) با بهره منفی برای قطع فرکانس‌های بالا. نوع فیلتر: 0-8. بخش «Filter types» در زیر را ببینید.
D* (4500)
فرکانس فیلتر
D* (2.7456)
کیفیت فیلتر، پهنای باند
D* (-30.0)
بهره فیلتر
I* (7)
این فیلتر دوم از دو فیلتر برای شکل‌دهی به سیگنال ارسالی به بلندگوی شیپوری (horn-speaker) است؛ به‌طور پیش‌فرض یک فیلتر low-shelf با بهره منفی برای حذف فرکانس‌هایی که به drum فرستاده می‌شوند. نوع فیلتر: 0-8. بخش «Filter types» در زیر را ببینید.
D* (300.0)
فرکانس فیلتر
D* (1.0)
کیفیت فیلتر، پهنای باند
D* (-30.0)
بهره فیلتر

D (0.1)
سطح سیگنال اثر طنین (Wet)؛ محدوده [0..1]
D (0.9)
سطح سیگنال اصلی طنین (Dry)؛ محدوده [0..1]
D (0.1)
بهره ورودی طنین (Input Gain)
D (1.0)
بهره خروجی طنین (Output Gain) (dry/wet را تغییر می‌دهد)
D* (0.1)
میکس طنین (dry/wet را تغییر می‌دهد)..SS "انواع فیلتر (برای Leslie):"
0
LPF پایین‌گذر (low-pass)
1
HPF بالاگذر (high-pass)
2
BF0 میان‌گذر ۰ (band-pass 0)
3
BF1 میان‌گذر ۱ (band-pass 1)
4
NOT شکافی (notch)
5
APF تمام‌گذر (all-pass)
6
PEQ اکولایزر قله‌ای (peaking eq)
7
LSH شلف پایین (low shelf)
8
HSH شلف بالا (high shelf)

توجه داشته باشید که پارامتر بهره (gain) برای فیلترهای پایین‌گذر نوع ۰ اعمال نمی‌شود.

این ویژگی‌ها را نمی‌توان مستقیماً ویرایش کرد، بلکه باید به کنترلرهای MIDI نگاشت شوند (بخش «اطلاعات عمومی» در بالا را ببینید)؛ مانند "midi.controller.upper.70=upper.drawbar16".
{upper|lower|pedal}.drawbar<NUM>
I* (-)
که در آن <NUM> یکی از مقادیر [16, 513, 8, 4, 223, 2, 135 , 113, 1] است. شناسه‌های MIDI-Controller را برای تنظیم drawbar مشخص‌شده تعیین کنید. -- محدوده به‌طور معکوس به موقعیت drawbar نگاشت می‌شود، به طوری که کنترلرهای شبیه فیدر، مانند drawbarهای واقعی به صورت معکوس کار می‌کنند. توجه داشته باشید که مقادیر کنترلر MIDI به بازهٔ ۰ ... ۸ کوانتایز می‌شوند تا با ۹ موقعیت گسسته در سیستم اصلی drawbar مطابقت داشته باشند: 0:8 (بلندترین)، 1-15:7، 16-31:6، 32-47:5، 48-63:4، 64-79:3، 80-92:2، 96-110:1، 111-127:0(خاموش)
I* (-)
تنظیم سرعت شیپور (horn) و طبل (drum)؛ 0-توقف، 1:آهسته، 2:سریع
I* (-)
تغییر وضعیت rotary.speed-preset بین ۱ و ۲
I* (-)
تابع دسترسی سطح پایین 0..8 (ترکیب‌های ۳^۲) [stop/slow/fast]^[horn|drum]
D* (0.7)
تنظیم بهرهٔ (gain) پدال swell
D* (0.7)
مشابه swellpedal1
I* (0)
<22:vibrato1, <44:chorus1, <66:vibrato2, <88:chorus2, <110vibrato3, >=110:chorus3
I* (0)
<32:off, <64:lower, <96:upper, >=96:both
I* (0)
<64:off, >=64 on
I* (0)
<64:off, >=64 on
I* (0)
<16:off, <63:normal, <112:soft, >=112:off
I* (0)
<64: fast-decay (افت سریع)، >=64 slow decay (افت کُند)
I* (0)
<64: third harmonic (هارمونیک سوم)، >=64 second harmonic (هارمونیک دوم)
I* (0)
<64: غیرفعال‌سازی overdrive، >=64 فعال‌سازی overdrive.SH "مثال‌ها (EXAMPLES)" setBfree setBfree -p pgm/default.pgm midi.port="a2j:[AV]" midi.driver=jack setBfree midi.port=129 midi.driver=alsa jack.connect=jack_rack:in_ setBfree jack.out.left=system:playback_7 jack.out.right=system:playback_8 setBfree -U 868000000

باگ‌ها را در http://github.com/pantherb/setBfree/issues گزارش دهید.
وب‌سایت و راهنما: http://setbfree.org

حق نشر © 2008-2018 Robin Gareus <robin@gareus.org>
حق نشر © 2012 Will Panther <pantherb@setbfree.org>
حق نشر © 2010 Ken Restivo <ken@restivo.org>
حق نشر © 2003-2004 Fredrik Kilander <fk@dsv.su.se>

این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر، کد منبع را ببینید. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.

June 2024 setBfree 0.8.13