.TH "DRUMGIZMO" "1" "21 July 2018" "drumgizmo" ""

.SH "نام (NAME)"
drumgizmo \- نرم‌افزار درام

.SH "خلاصه دستور (SYNOPSIS)"
\fBdrumgizmo\fR [\fIOPTIONS\fR] <\fIFILE\fR>

.SH "توضیحات (DESCRIPTION)"
.PP
\fBDrumGizmo\fR یک افزونه درام و برنامه مستقل (stand-alone) متن‌باز و چندسکویی است. این نرم‌افزار با چندین محصول تجاری در رده افزونه‌های درام قابل مقایسه است.
.PP
DrumGizmo از قالب فایل باز مجموعه‌درام (drumkit) استفاده می‌کند که به جامعه کاربری اجازه می‌دهد مجموعه‌درام‌های اختصاصی خود را بسازند. این برنامه خروجی چندکاناله دارد که میکس صدا را دقیقاً مانند یک مجموعه‌درام واقعی ممکن می‌سازد. بخش انسان‌ساز (humanizer) داخلی و اختیاری آن نت‌های MIDI را تحلیل کرده و شدت ضربات (velocities) را به‌صورت بلادرنگ تنظیم می‌کند. این کلاینت می‌تواند به‌صورت یک پردازشگر مستقل MIDI عمل کرده و فایل‌های .wav (یک فایل برای هر کانال) تولید کند؛ یا این‌که از DrumGizmo به عنوان نمونه‌بردار صوتی (sampler) نرم‌افزاری برای درام الکترونیکی استفاده شود. همچنین نسخه‌های افزونه آن نیز موجود است.

.SH "گزینه‌ها (OPTIONS)"
.PD 0
.RE
\fB-a, --async_load\fR
.RS 7
بارگذاری مجموعه‌درام در پس‌زمینه.

.RE
\fB-b, --bleed\fR
.RS 7
تنظیم و فعال‌سازی هم‌شنوی فراگیر (master bleed).

.RE
\fB-i, --inputengine \fR{dummy|test|jackmidi|midifile}
.RS 7
استفاده از موتور ورودی رویداد مشخص‌شده.

.RE
\fB-I, --inputparms parmlist\fR
.RS 7
تنظیم پارامترهای موتور ورودی.

\fBjackmidi:\fR
.P
midimap=<midimapfile>

\fBmidifile:\fR
.P
file=<midifile>
.P
speed=<tempo> (پیش‌فرض 1.0)
.P
track=<miditrack> (پیش‌فرض -1، تمام تراک‌ها)
.P
midimap=<midimapfile>
.P
loop=<true|false>

\fBossmidi:\fR
.P
midimap=<midimapfile>
.P
dev=<device> (پیش‌فرض '/dev/midi')

\fBtest:\fR
.P
p=<hit_propability> (پیش‌فرض 0.1)
.P
instr=<instrument> (پیش‌فرض -1، ساز تصادفی)
.P
len=<seconds> (پیش‌فرض -1، نامحدود)

\fBdummy:\fR

.RE
\fB-o, --outputengine \fR{dummy|alsa|jackaudio|wavfile|oss}
.RS 7
استفاده از موتور خروجی صوتی مشخص‌شده.

.RE
\fB-O, --outputparms parmlist\fR
.RS 7
تنظیم پارامترهای موتور خروجی.

\fBalsa:\fR
.P
dev=<device> (پیش‌فرض 'default')
.P
frames=<frames> (پیش‌فرض 32)
.P
srate=<samplerate> (پیش‌فرض 44100)

\fBwavfile:\fR
.P
file=<filename> (پیش‌فرض 'output')
.P
srate=<samplerate> (پیش‌فرض 44100)

\fBoss:\fR
.P
dev=<device> (پیش‌فرض /dev/dsp)
.P
srate=<samplerate> (پیش‌فرض 44100)
.P
max_fragments=<fragments> (پیش‌فرض 4)
.P
fragment_size=<size> (پیش‌فرض 8)

.P
اطلاعات بیشتر درباره \fBmax_fragments\fR و \fBfragment_size\fR در
http://manuals.opensound.com/developer/SNDCTL_DSP_SETFRAGMENT.html

\fBjackaudio:\fR

\fBdummy:\fR

.RE
\fB-e, --endpos\fR
.RS 7
تعداد نمونه‌ها برای پردازش، (پیش‌فرض -1: بی‌نهایت)

.RE
\fB-r, --no-resampling\fR
.RS 7
غیرفعال‌سازی نمونه‌برداری مجدد (resampling)

.RE
\fB-s, --streaming\fR
.RS 7
فعال‌سازی جریان مستقیم از دیسک (diskstreaming)

.RE
\fB-S, --strimingparms parmlist\fR
.RS 7
پارامترهای مربوط به کنترل بافرهای جریان‌سازی.

.P
\fBlimit\fR=<size> (محدود کردن میزان داده‌های پیش‌بارگذاری‌شده drumkit به این مقدار)
\" .P
\" \fBchunk_size\fR=<size> (chunk size in k,M,G)

.RE
\fB-t, --timing-humanizer\fR
.RS 7
فعال‌سازی جابه‌جایی زمانی نت‌ها.
.P
\fIنکته: \fIبه \fIخروجی \fIتاخیر \fIاضافه \fIمی‌کند، \fIبنابراین \fIاز \fIآن \fIبا \fIیک \fIdrumkit \fIبلادرنگ \fImidi \fIاستفاده \fIنکنید.

.RE
\fB-T, --timing-humanizerparms parmlist\fR
.RS 7
گزینه‌های انسان‌ساز زمان‌بندی (timing humanizer).

.P
\fBlaidback\fR=<val> (جلو یا عقب بردن نت‌ها در زمان بر حسب میلی‌ثانیه
[+/-100].)
.P
\fBtightness\fR=<val> (کنترل دقت و هماهنگی زمان‌بندی نوازنده درام. [0,1].)
.P
\fBregain\fR=<val> (کنترل سرعت هماهنگ‌شدن مجدد نوازنده با ضرب‌آهنگ. [0,1])

.RE
\fB-t, --velocity-humanizer\fR
.RS 7
فعال‌سازی تنظیم شدت ضربات ورودی برای واقعی‌تر جلوه دادن صدا.

.RE
\fB-T, --velocity-humanizerparms parmlist\fR
.RS 7
گزینه‌های انسان‌ساز شدت ضربه (velocity humanizer).

.P
\fBattack\fR=<val> (سرعت کاهش شدت ضربه هنگام نواختن نت‌های سریع.
مقادیر کمتر منجر به افت سریع‌تر شدت ضربه می‌شوند. [0,1])
.P
\fBrelease\fR=<val> (سرعت بازیابی شدت ضربه توسط نوازنده درام
هنگامی که بین نت‌ها فاصله وجود دارد. مقادیر کمتر منجر به بازیابی سریع‌تر می‌شود. [0,1])
.P
\fBstddev\fR=<val> (انحراف معیار برای انسان‌ساز شدت ضربه.
مقدار بالاتر احتمال پخش نمونه‌ای با فاصله بیشتر
از شدت ضربه ورودی را افزایش می‌دهد. [0,4.5])

.RE
\fB-l, --voice-limit\fR
.RS 7
فعال‌سازی محدودیت تعداد صداها (voice limit).

.RE
\fB-L, --voice-limitparms parmlist\fR
.RS 7
گزینه‌های محدودیت تعداد صداها.

.P
\fBmax\fR=<val> (حداکثر تعداد صداها برای هر ساز پیش از آنکه
صدای نمونه‌های قدیمی به آرامی کاهش یابد. [1,30])
.P
\fBrampdown\fR=<val> (مدت زمانی که طول می‌کشد تا یک نمونه قدیمی کاملاً
بی‌صدا شود. [0.01,2.0])

.RE
\fB-p, --parameters parmlist\fR
.RS 7
پارامترهای مربوط به الگوریتم انتخاب نمونه (sample).
.P
\fBclose\fR=<val> (میزان اهمیت انتخاب نمونه‌ای نزدیک به
مقدار واقعی شدت ضربه (پس از انسانی‌سازی) [0,1])
.P
\fBdiverse\fR=<val> (میزان اهمیت انتخاب نمونه‌هایی که
اخیراً نواخته نشده‌اند [0,1])
.P
\fBrandom\fR=<val> (میزان تصادفی‌بودن اعمال‌شده [0,1])

.RE
\fB-v, --version\fR
.RS 7
نمایش نسخه drumgizmo و خروج.

.RE
\fB-h, --help\fR
.RS 7
نمایش راهنمای خط فرمان و خروج.

.RE
\fBdrumkitfile\fR
.RS 7
بارگذاری drumkitfile.

.RE
.SH "مثال‌ها (EXAMPLES)"
\fBتبدیل فایل midifile به فایل‌های wav:\fR
.RS 7
drumgizmo -i midifile -I file=file.mid,midimap=midimap.xml -o wavfile -O file=prefix drumkit.xml
.RE
\fBدریافت midi از Jack و ارسال خروجی صوتی به بلندگوها:\fR
.RS 7
drumgizmo -i jackmidi -I midimap=midimap.xml -o jackaudio drumkit.xml
.RE
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها به http://www.drumgizmo.org/wiki/doku.php?id=bugs.

.SH "اطلاعات بیشتر (ADDITIONAL INFORMATION)"
برای کسب اطلاعات بیشتر، از وب‌سایت http://www.drumgizmo.org بازدید فرمایید.