QMIDIROUTE(1) General Commands Manual QMIDIROUTE(1)

qmidiroute - پردازشگر و مسیریاب رویدادهای MIDI

qmidiroute [OPTION] [file]
qmidiroute { --help | --version }

qmidiroute یک پردازشگر و مسیریاب چندکاره رویدادهای MIDI برای ترتیب‌سنج ALSA است. رابط کاربری گرافیکی بر پایه جعبه‌ابزار Qt4 ساخته شده است. qmidiroute اجازه می‌دهد تعداد نامحدودی نگاشت MIDI ایجاد شود که در آن‌ها رویدادهای ورودی پیش از هدایت شدن به یک درگاه خروجی اختصاصی ALSA، انتخاب، اصلاح یا حتی نوع آن‌ها تغییر داده می‌شود. این نگاشت‌ها به طور موازی کار می‌کنند و در زبانه‌های مختلف سازمان‌دهی شده‌اند. با qmidiroute به عنوان مثال می‌توان گام یک صفحه‌کلید را تغییر داد یا معکوس نمود، فشردن کلیدهای صفحه‌کلید را به تغییر برنامه (program change) تبدیل کرد، یا داده‌های کنترلر را به نت بدل نمود.

رویدادهای ورودی MIDI را می‌توان در یک فهرست ثبت کرد که بر اساس نوع MIDI با رنگ‌های متفاوتی نمایش داده می‌شوند. qmidiroute یک درگاه ورودی ALSA و به طور پیش‌فرض دو درگاه خروجی ALSA ارائه می‌دهد. شناسه عددی کلاینت ALSA به عنوان بخشی از عنوان پنجره نمایش داده می‌شود.

پس از راه‌اندازی برنامه، زبانه Unmatched نمایش داده می‌شود (پایین را ببینید). برای شروع پیکربندی مسیریابی MIDI، می‌توان روی دکمه New map... کلیک کرد که یک نگاشت MIDI جدید ایجاد می‌کند و به عنوان یک زبانه در ناحیه نگاشت ظاهر می‌شود. کل پیکربندی را می‌توان در یک فایل QMidiRoute با پسوند (.qmr) ذخیره یا از آن بارگذاری نمود. چندین نگاشت را می‌توان ایجاد کرد تا به صورت موازی کار کنند. نگاشت‌ها را می‌توان با دکمه‌های Map Rename, Remove و Clone سازمان‌دهی نمود. Event Log به طور پیش‌فرض در ناحیه پایینی نمایش داده می‌شود، اما در صورت عدم نیاز می‌توان آن را پنهان کرد یا به شکل یک پنجره مستقل روی میزکار شناور نمود. ثبت رویدادها را می‌توان به طور کلی یا تنها برای رویدادهای MIDI Clock غیرفعال کرد.

فیلد Input نشان‌دهنده فیلتر رویداد ورودی برای هر نگاشت است. انواع رویدادهای پشتیبانی‌شده عبارتند از Note, Controller, Pitchbend و Program Change. رویدادها می‌توانند بر اساس مقادیر متناظرشان یا بر اساس کانال MIDI فیلتر شوند. رویدادهایی که با شرایط تعیین‌شده در فیلد Input مطابقت داشته باشند، به فیلد Output هدایت می‌شوند.

فیلد Output شرایطی را تعیین می‌کند که رویدادهای منطبق به کدام نوع رویداد تبدیل شوند، کانال و مقادیر آن‌ها چگونه دستخوش تغییر شود، و به کدام درگاه ALSA هدایت گردند. Channels و Values می‌توانند نسبت به رویداد ورودی روی Fixed, Offset یا Reverse Offset تنظیم شوند. به عنوان مثال، Reverse Offset مقدار مشخص‌شده را گرفته و مقدار رویداد ورودی را از آن کم می‌کند تا مقدار رویداد خروجی حاصل شود. اگر محدوده خروجی برای یک مقدار متفاوت از همتای ورودی‌اش باشد، محدوده ورودی به آرامی و پیوسته به محدوده خروجی مقیاس‌بندی می‌شود. رویدادها به درگاه ALSA تعیین‌شده فرستاده می‌شوند. تعداد درگاه‌های ALSA در دسترس را می‌توان با استفاده از گزینه خط فرمان مربوطه تنظیم کرد.

در زبانه Unmatched مدیریت رویدادهایی تعیین می‌شود که با هیچ‌کدام از فیلترهای ورودی نگاشت‌های تعریف‌شده مطابقت ندارند. این رویدادها را می‌توان نادیده گرفت یا به یک درگاه ALSA مشخص ارسال نمود.

تنظیم تعداد درگاه‌های خروجی ALSA در دسترس به <num>. مقدار پیش‌فرض ۲ است.
چاپ گزینه‌های خط فرمان ممکن و خروج.
چاپ اطلاعات نسخه و خروج.
نام یک فایل معتبر QMidiRoute (.qmr) جهت بارگذاری در هنگام شروع.

*.qmr

فایل‌های QMidiRoute حاوی داده‌های مسیریابی MIDI در قالب متن خام (plain text).

یک فایل نمونه نگاشت MIDI را می‌توان در /usr/share/qmidiroute یا در /usr/local/share/qmidiroute یافت.

خطاها و هشدارها در stderr(3) نوشته می‌شوند.

alsamodular-devel@lists.sourceforge.net

Matthias Nagorni, Frank Kober و Guido Scholz. این صفحه راهنما توسط Frank Kober <emuse@users.sourceforge.net> نوشته شده است.

2009-09-13