.TH yoshimi 1 " 2026" "yoshimi 2.3.6"
.SH "نام (NAME)"
yoshimi \- یک سینتی‌سایزر نرم‌افزاری موسیقی
.SH "خلاصه دستور (SYNOPSIS)"
\fByoshimi\fP [\fI\-option\fP] [\fIcmd\fP]
.SH "توضیحات (DESCRIPTION)"
\fBYoshimi\fP یک سینتی‌سایزر صوتی چندصدایی (polyphonic) و چندبخشی (multi-part) است که از سه «موتور» متمایز بهره می‌برد که می‌توانند به صورت جداگانه یا هم‌زمان به کار گرفته شوند. همچنین می‌توان این موتورها را در قالب «کیت‌ها»، معمولاً برای سازهای کوبه‌ای، روی هم چید. این برنامه به طور کامل از JACK و ALSA برای ورودی MIDI و خروجی صوتی پشتیبانی می‌کند.
.PP
\fBYoshimi\fP می‌تواند در یک رابط گرافیکی، یک رابط خط فرمان، یا با کنترل از هر دو اجرا شود. همچنین به تعدادی از کنترل‌ها می‌توان از طریق MIDI دسترسی داشت. رابط خط فرمان (CLI) دارای تجزیه‌کننده Readline اختصاصی و سیستم راهنمای داخلی است که با وارد کردن دستورات «?» یا «help» قابل دسترسی است.
.PP
سیستم راهنمای CLI حساس به زمینه (context-sensitive) است و به جز یادآوری دستورات اساسی و متداول، تنها دستورات مرتبط را نشان می‌دهد. با این حال، می‌توان راهنما را به طور مشخص از زمینه‌های دیگر نیز فراخوانی کرد.
.PP
برای مثال، در زمینه «part»، دستور «? config» دستورات مربوط به تنظیمات پیکربندی را نمایش می‌دهد.
.PP
\fBYoshimi\fP دارای قابلیت بسیار گسترده فراگیری MIDI (MIDI learn) است که اکثر کنترل‌ها را در دسترس قرار می‌دهد. یک جفت یکسان از MIDI CC و کانال می‌تواند به چندین کنترل مستقل پیوند داده شود. همچنین قابلیت‌های قابل‌توجهی برای ویرایش پس از یادگیری وجود دارد.
.PP
از دیگر قابلیت‌ها، توانایی درون‌ریزی و برون‌ریزی کل بانک‌های ساز به روشی امن و سرراست است. اکنون همچنین می‌توان هر ساز یا بانکی را با هر ساز یا بانک دیگری در هر ریشه بانک (bank root)، بدون ایجاد اختلال در باقی ساختار جابه‌جا کرد.
.PP
قابلیت افزوده دیگر، امکان بارگذاری فهرستی از تنظیمات MIDI فراگرفته‌شده از طریق خط فرمان در زمان راه‌اندازی است.
.PP
بهبودهای اخیر شامل Aftertouch کلید و کانال، پنجره‌های کاملاً با قابلیت تغییر اندازه، همگام‌سازی MIDI برای LFOها و گسترش قابلیت‌های Panning است. همچنین، همگام‌سازی MIDI برای تمامی LFOها و تمام جلوه‌های صوتی (Effects) مرتبط اضافه شده است.
.PP
یکی دیگر از پیشرفت‌های اخیر، بازنگری جامع در موتور PadSynth همراه با تغییر شکل (morphing) افزوده برای wavetableها بود. همچنین پشتیبانی از واگرد/ازنو (Undo/Redo) اضافه شده است.
.PP
توسعه‌های بیشتر شامل کنترل‌های با تفکیک‌پذیری بالا و سازگار با نسخه‌های پیشین برای بخش‌های مهم، و یک سیستم جامع مدیریت پوسته است که امکان انتخاب رنگ‌های رابط گرافیکی توسط کاربر را فراهم می‌سازد.
ما همچنین مدیریت گام‌های ریزپرده‌ای (microtonal scales) را بهبود بخشیده‌ایم و امکان برون‌ریزی فایل‌های ‎.scl‎ و ‎.kbd‎ را اضافه کرده‌ایم.
اکنون تعیین نرخ تکرار اکو (Echo) متفاوت برای کانال‌های چپ و راست امکان‌پذیر است.
.PP
قابلیت MIDI «Omni» در سطح پارت اکنون در دسترس است. همچنین در صورتی که اقدامی صورت گیرد که ممکن است سبب بازنویسی روی سازی با تغییرات ذخیره‌نشده شود، پیام هشدار نمایش داده می‌شود. موتور SubSynth اکنون دارای مجموعه‌ای از LFOها است.
.PP
LFOهایی متناسب با موارد موجود در سایر انواع موتورها، به موتور SUBsynth اضافه شده‌اند.
.PP
حالت کیت پارت (Part kit) اکنون علاوه بر Crossfade Velocity، دارای Crossfade Volume نیز می‌باشد.
.SH "دستورها (COMMANDS)"
.TP
.BR \-? ", " \-\-help " نمایش نحو دستور."
.TP
.BR \-a ", " \-\-alsa-midi[=<device>] " استفاده از ورودی ALSA MIDI."
.TP
.BR \-A ", " \-\-alsa-audio[=<device>] " استفاده از خروجی صوتی ALSA."
.TP
.BR \-b ", " \-\-buffersize=<size> " تنظیم اندازه بافر داخلی."
.TP
.BR \-c ", " \-\-no-cmdline " غیرفعال کردن رابط خط فرمان."
.TP
.BR \-C ", " \-\-cmdline " فعال کردن رابط خط فرمان."
.TP
.BR \-D ", " \-\-define-root " تعیین مسیر به شاخه ریشه جدید بانک."
.TP
.BR \-i ", " \-\-no-gui " غیرفعال کردن رابط گرافیکی."
.TP
.BR \-I ", " \-\-gui " فعال کردن رابط گرافیکی."
.TP
تلاش برای استفاده از «c» و «i» هشداری تولید خواهد کرد، و اگرچه امکان اجرا در حالت غیرفعال بودن هر دو (تنها با پذیرش MIDI) وجود دارد، اما توصیه نمی‌شود.
.TP
.BR \-j ", " \-\-jack-midi[=<device>] " استفاده از ورودی JACK MIDI."
.TP
.BR \-J ", " \-\-jack-audio[=<device>] " اتصال به کارساز JACK."
.TP
.BR \-k ", " \-\-autostart-jack " راه‌اندازی خودکار کارساز JACK."
.TP
.BR \-K ", " \-\-auto-connect " اتصال خودکار به کارساز JACK."
.TP
.BR \-l ", " \-\-load=<file> " بارگذاری مجموعه پچ .xmz."
.TP
.BR \-L ", " \-\-load-instrument=<file>[@part] " بارگذاری فایل ساز .xiz به پارت مشخص‌شده با فرمت (بدون فاصله)n@."
.TP
.BR \-M ", " \-\-load-midilearn=<file> " بارگذاری فایل فهرست یادگیری .xly."
.TP
.BR \-N ", " \-\-name-tag=<tag> " افزودن یک برچسب به نام کلاینت."
.TP
.BR \-o ", " \-\-oscilsize=<size> " تنظیم اندازه نوسان‌ساز AddSynth."
.TP
.BR \-R ", " \-\-samplerate=<rate> " تنظیم نرخ نمونه‌برداری صوتی ALSA."
.TP
.BR \-S ", " \-\-state[=<file>] "  بارگذاری وضعیت از قبل ذخیره‌شده."
مقدار پیش‌فرض "HOME/.config/yoshimi/yoshimi.state" است.
.TP
.BR \-u ", " \-\-jack-session-file=<file> " بارگذاری فایل نشست JACK مشخص‌شده."
.TP
.BR \-U ", " \-\-jack-session-uuid=<uuid> " استفاده از uuid نشست JACK."
.TP
صرف‌نظر از موقعیت آن‌ها در خط فرمان، بارگذاری فایل‌ها همیشه به این ترتیب خواهد بود: نشست (یا وضعیت)، مجموعه پچ، ساز، یادگیری میدی (midi-learn)
.TP
.BR \-V ", " \-\-version " نمایش نسخه Yoshimi."
.TP
«آرگومان‌های اجباری یا اختیاری برای گزینه‌های طولانی، برای گزینه‌های کوتاه متناظر نیز اجباری یا اختیاری هستند.»
.\"nroff -man yoshimi.1 | less