.TH APLAYMIDI2 1 "4 July 2024"

.SH "نام (NAME)"
aplaymidi2 \- پخش فایل‌های کلیپ MIDI

.SH "خلاصه دستور (SYNOPSIS)"
.B aplaymidi2
\-p client:port[,...] midi2file ...

.SH "توضیحات (DESCRIPTION)"
دستور
.B aplaymidi2
یک ابزار خط فرمانی است که فایل(های) کلیپ MIDI مشخص‌شده را به یک یا چند درگاه ترتیب‌سنج (sequencer) ALSA ارسال و پخش می‌کند.

.SH "گزینه‌ها (OPTIONS)"

.TP
.I \-h, \-\-help
نمایش فهرستی از گزینه‌ها.

.TP
.I \-V, \-\-version
نمایش نسخه فعلی.

.TP
.I \-p, \-\-port=client:port,...
درگاه(های) ترتیب‌سنج را که رویدادهای موجود در فایل(های) کلیپ MIDI باید به آن‌ها ارسال شوند، تنظیم می‌کند.

یک کلاینت می‌تواند با شماره، نام یا پیشوندی از نام آن مشخص شود. یک درگاه با شماره آن مشخص می‌شود؛ برای درگاه ۰ یک کلاینت، بخش ":0" در مشخصات درگاه می‌تواند حذف شود.

برای امکان پخش فایل(های) کلیپ MIDI که شامل رویدادهایی برای چندین دستگاه (درگاه) متناظر با چندین گروه UMP هستند، می‌توان چندین درگاه مشخص کرد.

برای سازگاری با
.B pmidi(1),
در صورتی که هیچ درگاهی در خط فرمان داده نشود، مشخصات درگاه از متغیر محیطی
.I ALSA_OUTPUT_PORTS
گرفته می‌شود.

دستور
.B aplaymidi2
تنها از رویدادهای پایه UMP پشتیبانی می‌کند: علاوه بر پیام‌های استاندارد صوتی کانال MIDI1 و MIDI2 و پیام‌های ۷ بیتی SysEx، تنها موارد زیر پشتیبانی می‌شوند:
DCTPQ، DC، Set Tempo، Start Clip، End Clip.
متن ترانه و سایر فراداده‌ها در Flex Data نیز چاپ می‌شوند، مگر اینکه گزینه
\fI\-s\fP
داده شده باشد.

درگاه‌های خروجی متعدد زمانی مفید هستند که فایل کلیپ MIDI داده‌شده حاوی بسته‌های UMP برای چندین گروه باشد.
هنگامی که درگاه مقصد یک درگاه UMP MIDI 2.0 باشد، یک اتصال منفرد باید کافی باشد، زیرا درگاه MIDI 2.0 می‌تواند ورودی‌های مربوط به چندین گروه را پردازش کند. برای موارد دیگر (به عنوان مثال اتصال به یک درگاه قدیمی MIDI)، باید درگاه مقصد را برای هر گروه مشخص کنید. در صورت تعریف نشدن، به صورت پیش‌فرض به اولین درگاه مقصد ارسال می‌شود.

.TP
.I \-d, \-\-delay=seconds
مشخص می‌کند پس از پایان هر فایل کلیپ MIDI چه مدت (به ثانیه) صبر شود تا طنین آخرین نت‌ها محو شود.
پیش‌فرض ۲ ثانیه است.

.TP
.I \-s, \-\-silent
متن پیام‌ها را نمایش ندهد.

.TP
.I \-a, \-\-passall
تمام بسته‌های UMP را همان‌گونه که هستند عبور دهد.

به صورت پیش‌فرض،
\fBaplaymidi2\fP
تنها پیام‌های صوتی کانال MIDI1 و MIDI2 را عبور می‌دهد و سایر بسته‌های UMP را به صورت داخلی پردازش می‌کند.
با این گزینه، تمام بسته‌های UMP را به مقصد ارسال می‌کند.

.SH "همچنین ببینید (SEE ALSO)"
pmidi(1)
.br
aplaymidi(1)

.SH "نویسندگان (AUTHORS)"
Takashi Iwai <tiwai@suse.de>