نام (NAME)

aplaymidi2 - پخش فایل‌های کلیپ MIDI

خلاصه دستور (SYNOPSIS)

aplaymidi2 -p client:port[,...] midi2file ...

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

-h, --help

نمایش فهرستی از گزینه‌ها.

-V, --version

نمایش نسخه فعلی.

-p, --port=client:port,...

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

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

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

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

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

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

-d, --delay=seconds

مشخص می‌کند پس از پایان هر فایل کلیپ MIDI چه مدت (به ثانیه) صبر شود تا طنین آخرین نت‌ها محو شود. پیش‌فرض ۲ ثانیه است.

-s, --silent

متن پیام‌ها را نمایش ندهد.

-a, --passall

تمام بسته‌های UMP را همان‌گونه که هستند عبور دهد.

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

همچنین ببینید (SEE ALSO)

pmidi(1)
aplaymidi(1)

نویسندگان (AUTHORS)

Takashi Iwai <tiwai@suse.de>