.TH POLYPHONE "1" "22 دسامبر 2024" "polyphone 2.5" "راهنمای Polyphone"

.SH "نام (NAME)"
\fBpolyphone\fP \- ویرایشگر ساند‌فونت (soundfont)

.SH "خلاصه دستور (SYNOPSIS)"
.B polyphone
.br
.B polyphone
[\fIFILE\fR]
.br
.B polyphone
[\fIFILE_1\fR] [\fIFILE_2\fR] ...
.br
.B polyphone
-1 [\fB\-i\fR \fIINPUT_FILEPATH\fR] [\fB\-d\fR \fIOUTPUT_DIR\fR] [\fB\-o\fR \fIOUTPUT_NAME\fR]
.br
.B polyphone
-2 [\fB\-i\fR \fIINPUT_FILEPATH\fR] [\fB\-d\fR \fIOUTPUT_DIR\fR] [\fB\-o\fR \fIOUTPUT_NAME\fR] [\fB\-c\fR \fICONFIG\fR]
.br
.B polyphone
-3 [\fB\-i\fR \fIINPUT_FILEPATH\fR] [\fB\-d\fR \fIOUTPUT_DIR\fR] [\fB\-o\fR \fIOUTPUT_NAME\fR] [\fB\-c\fR \fICONFIG\fR]
.br
.B polyphone
-4 [\fB\-i\fR \fIINPUT_FILEPATH\fR] [\fB\-d\fR \fIOUTPUT_DIR\fR] [\fB\-o\fR \fIOUTPUT_NAME\fR] [\fB\-c\fR \fICONFIG\fR]
.br
.B polyphone
-s [\fB\-i\fR \fIINPUT_FILEPATH\fR] [\fB\-c\fR \fICONFIG\fR]

.SH "توضیحات (DESCRIPTION)"
برنامه
.B polyphone
رابط کاربری ساده و کارآمدی را برای ساخت و ویرایش فایل‌های .sf2 فراهم می‌کند. این نرم‌افزار شامل ابزارهایی برای تسهیل و خودکارسازی ویرایش پارامترهای گوناگون است که مدیریت حجم بالایی از داده‌ها را امکان‌پذیر می‌سازد.
.br
.PP
فرمت‌های sf2، sf3، sfz (ورود / صدور)، sfArk (فقط ورود) و GrandOrgue (فقط ورود) پشتیبانی می‌شوند. از خطوط فرمان می‌توان برای تبدیل فایل‌ها، باز کردن Polyphone در حالت سینتی‌سایزر یا بازنشانی پیکربندی‌ها در صورت بروز مشکل استفاده کرد.
.br
.PP
اطلاعات بیشتر را می‌توانید در <https://www.polyphone.io> بیابید.

.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \fBFILE\fR
فایلی را که هنگام شروع
.B polyphone
باید باز شود مشخص می‌کند. در صورت جدا شدن با فاصله، چندین فایل را می‌توان بارگذاری کرد.
فرمت‌های sf2 (نسخه 2.01 یا 2.04)، sf3، sfz، sfArk (نسخه 1 یا 2) و GrandOrgue پشتیبانی می‌شوند.
.TP
.BR \fB-1\fR
استفاده از
.B polyphone
برای تبدیل یک فایل به فرمت sf2.
.TP
.BR \fB-2\fR
استفاده از
.B polyphone
برای تبدیل یک فایل به فرمت sf3.
.TP
.BR \fB-3\fR
استفاده از
.B polyphone
برای تبدیل یک فایل به فرمت sfz.
.TP
.BR \fB-4\fR
استفاده از
.B polyphone
برای تبدیل یک فایل به فرمت csv.
.TP
.BR \fB-s\fR
باز کردن
.B polyphone
در حالت سینتی‌سایزر (synthesizer).
.TP
[\fB\-i\fR \fIINPUT_FILEPATH\fR]
مسیر فایل ورودی برای تبدیل یا باز کردن. فرمت فایل ورودی باید sf2، sf3، sfz، sfArk یا organ باشد.
.TP
[\fB\-d\fR \fIOUTPUT_DIR\fR]
دایرکتوری خروجی که فایل ورودی در آن تبدیل خواهد شد. به‌طور پیش‌فرض، این همان دایرکتوری فایل ورودی است.
.TP
[\fB\-o\fR \fIOUTPUT_NAME\fR]
نام خروجی فایل تبدیل‌شده. پسوند فایل به‌طور خودکار بسته به نوع تبدیل اضافه خواهد شد. به‌طور پیش‌فرض، این همان نام فایل ورودی است.
.TP
[\fB\-c\fR \fICONFIG\fR]
پیکربندی تبدیل، که محتوای آن وابسته به نوع تبدیل است.
.BR \fB-r\fR
حذف پیکربندی موجود.
.br
.BR
 * 
.B تبدیل sf2
.br
هیچ پیکربندی‌ای برای این تبدیل وجود ندارد.
.br
.BR
 * 
.B تبدیل sf3
.br
پیکربندی از یک نویسه تشکیل شده که کیفیت فشرده‌سازی را نشان می‌دهد. \(aq0\(aq برای کیفیت پایین، \(aq1\(aq برای متوسط و \(aq2\(aq برای کیفیت بالا. مقدار پیش‌فرض \(aq1\(aq است.
.br
.BR
 * 
.B تبدیل sfz
.br
پیکربندی از ۳ مقدار تشکیل شده که با یک \(aq|\(aq از هم جدا می‌شوند. مقدار اول در صورتی که هر پریست (preset) باید پیشوندی از شماره پریست خود داشته باشد برابر \(aq1\(aq و در غیر این صورت \(aq0\(aq است. مقدار دوم اگر باید یک دایرکتوری برای هر بانک ایجاد شود برابر \(aq1\(aq و در غیر این صورت \(aq0\(aq است. مقدار سوم اگر دسته‌بندی general midi باید برای مرتب‌سازی پریست‌ها استفاده شود برابر \(aq1\(aq و در غیر این صورت \(aq0\(aq است. مقدار پیش‌فرض \(aq0|0|0\(aq است.
.br
.BR
 * 
.B تبدیل csv
.br
گزینه \(aqraw\(aq می‌تواند برای صدور مقادیر خام (همان‌گونه که در فایل soundfont ذخیره شده‌اند) به‌جای مقادیر با واحدهای فیزیکی و قابل اندازه‌گیری استفاده شود. برای نمونه، مقدار زمان رهاسازی (release time) صادرشده برابر 0.491 (میلی‌ثانیه) یا در حالت خام برابر -1229 خواهد بود. به‌طور پیش‌فرض، مقادیر با واحدهای فیزیکی صادر می‌شوند.
.br
.BR
 * 
.B حالت سینتی‌سایزر
.br
پیکربندی از ۳ مقدار تشکیل شده که با یک \(aq|\(aq از هم جدا شده‌اند. مقدار اول کانال MIDI مورد شنود را مشخص می‌کند که می‌تواند مقداری از 1 تا 16 باشد. مقدار 0 یا “all” نشان می‌دهد که تمام کانال‌ها استفاده شده و به‌عنوان یک کانال واحد پردازش خواهند شد. مقدار -1 یا “each” به هر کانال به‌طور جداگانه گوش می‌دهد، که مثلاً پیش‌نیازی برای پخش فایل‌های MIDI است. مقدار دوم \(aqon\(aq یا \(aqoff\(aq است تا پخش هم‌زمان چندین پریست فعال شود. مقدار سوم \(aqon\(aq، \(aqoff\(aq یا \(aqtoggle\(aq است تا امکان فعال یا غیرفعال شدن پریست‌ها توسط بم‌ترین کلیدهای صفحه‌کلید فراهم شود. مقدار پیش‌فرض \(aqall|off|off\(aq است.
.SH "مثال‌ها (EXAMPLES)"
 * تبدیل از sfArk به sf2:
.br
.BR polyphone
-1 -i /path/to/file.sfArk
.br
.BR
 * تبدیل از sf2 به sf3 (کیفیت خوب):
.br
.BR polyphone
-2 -i /path/to/file.sf2 -c 2
.br
.BR
 * تبدیل از sf3 به sfz (زیردایرکتوری‌ها برای بانک و دسته‌بندی gm):
.br
.BR polyphone
-3 -i /path/to/file.sf3 -c '0|1|1'
.br
.BR
 * باز کردن Polyphone در حالت سینتی‌سایزر، با امکان استفاده از کلیدهای بم برای انتخاب گروه سازها جهت نواختن با صفحه‌کلید MIDI:
.br
.BR polyphone
-s -i /path/to/file.sf2 -c 'all|off|toggle'
.SH "نویسندگان (AUTHORS)"
Davy Triponney (contact@polyphone.io)