.\" .\" Manual page for qmidiroute .\" Process with: .\" groff -man -Tascii qmidiroute.1 | less .\" .\" Get a printable version with: .\" groff -t -e -mandoc -Tps qmidiroute.1 > qmidiroute.ps .\" .TH QMIDIROUTE 1 2009-09-13 .SH "نام (NAME)" qmidiroute \- پردازشگر و مسیریاب رویدادهای MIDI .SH "خلاصه دستور (SYNOPSIS)" .br .B qmidiroute [\fIOPTION\fR] [\fIfile\fR] .br .B qmidiroute { .B \-\-help | .B \-\-version } .SH "توضیحات (DESCRIPTION)" .B qmidiroute یک پردازشگر و مسیریاب چندکاره رویدادهای MIDI برای ترتیب‌سنج ALSA است. رابط کاربری گرافیکی بر پایه جعبه‌ابزار Qt4 ساخته شده است. .B qmidiroute اجازه می‌دهد تعداد نامحدودی نگاشت MIDI ایجاد شود که در آن‌ها رویدادهای ورودی پیش از هدایت شدن به یک درگاه خروجی اختصاصی ALSA، انتخاب، اصلاح یا حتی نوع آن‌ها تغییر داده می‌شود. این نگاشت‌ها به طور موازی کار می‌کنند و در زبانه‌های مختلف سازمان‌دهی شده‌اند. با .B qmidiroute به عنوان مثال می‌توان گام یک صفحه‌کلید را تغییر داد یا معکوس نمود، فشردن کلیدهای صفحه‌کلید را به تغییر برنامه (program change) تبدیل کرد، یا داده‌های کنترلر را به نت بدل نمود. رویدادهای ورودی MIDI را می‌توان در یک فهرست ثبت کرد که بر اساس نوع MIDI با رنگ‌های متفاوتی نمایش داده می‌شوند. .B qmidiroute یک درگاه ورودی ALSA و به طور پیش‌فرض دو درگاه خروجی ALSA ارائه می‌دهد. شناسه عددی کلاینت ALSA به عنوان بخشی از عنوان پنجره نمایش داده می‌شود. .SS "کاربرد عمومی" پس از راه‌اندازی برنامه، زبانه .I Unmatched نمایش داده می‌شود (پایین را ببینید). برای شروع پیکربندی مسیریابی MIDI، می‌توان روی دکمه .I New map... کلیک کرد که یک نگاشت MIDI جدید ایجاد می‌کند و به عنوان یک زبانه در ناحیه نگاشت ظاهر می‌شود. کل پیکربندی را می‌توان در یک فایل QMidiRoute با پسوند (.qmr) ذخیره یا از آن بارگذاری نمود. چندین نگاشت را می‌توان ایجاد کرد تا به صورت موازی کار کنند. نگاشت‌ها را می‌توان با دکمه‌های .I Map Rename, Remove و .I Clone سازمان‌دهی نمود. .I Event Log به طور پیش‌فرض در ناحیه پایینی نمایش داده می‌شود، اما در صورت عدم نیاز می‌توان آن را پنهان کرد یا به شکل یک پنجره مستقل روی میزکار شناور نمود. ثبت رویدادها را می‌توان به طور کلی یا تنها برای رویدادهای MIDI Clock غیرفعال کرد. .SS "ورودی MIDI" فیلد .I Input نشان‌دهنده فیلتر رویداد ورودی برای هر نگاشت است. انواع رویدادهای پشتیبانی‌شده عبارتند از .I Note, Controller, Pitchbend و .I Program Change. رویدادها می‌توانند بر اساس مقادیر متناظرشان یا بر اساس کانال MIDI فیلتر شوند. رویدادهایی که با شرایط تعیین‌شده در فیلد .I Input مطابقت داشته باشند، به فیلد .I Output هدایت می‌شوند. .SS "خروجی MIDI" فیلد .I Output شرایطی را تعیین می‌کند که رویدادهای منطبق به کدام نوع رویداد تبدیل شوند، کانال و مقادیر آن‌ها چگونه دستخوش تغییر شود، و به کدام درگاه ALSA هدایت گردند. .I Channels و .I Values می‌توانند نسبت به رویداد ورودی روی .I Fixed, Offset یا .I Reverse Offset تنظیم شوند. به عنوان مثال، .I Reverse Offset مقدار مشخص‌شده را گرفته و مقدار رویداد ورودی را از آن کم می‌کند تا مقدار رویداد خروجی حاصل شود. اگر محدوده خروجی برای یک مقدار متفاوت از همتای ورودی‌اش باشد، محدوده ورودی به آرامی و پیوسته به محدوده خروجی مقیاس‌بندی می‌شود. رویدادها به درگاه ALSA تعیین‌شده فرستاده می‌شوند. تعداد درگاه‌های ALSA در دسترس را می‌توان با استفاده از .B گزینه خط فرمان مربوطه تنظیم کرد. .SS "رویدادهای تطبیق‌نیافته MIDI" در زبانه .I Unmatched مدیریت رویدادهایی تعیین می‌شود که با هیچ‌کدام از فیلترهای ورودی نگاشت‌های تعریف‌شده مطابقت ندارند. این رویدادها را می‌توان نادیده گرفت یا به یک درگاه ALSA مشخص ارسال نمود. .SH "گزینه‌ها (OPTIONS)" .TP .BI \-\-portCount\ تنظیم تعداد درگاه‌های خروجی ALSA در دسترس به . مقدار پیش‌فرض ۲ است. .TP .BI \-\-help چاپ گزینه‌های خط فرمان ممکن و خروج. .TP .BI \-\-version چاپ اطلاعات نسخه و خروج. .TP .B file نام یک فایل معتبر QMidiRoute (.qmr) جهت بارگذاری در هنگام شروع. .SH "فایل‌ها (FILES)" .I *.qmr .RS فایل‌های QMidiRoute حاوی داده‌های مسیریابی MIDI در قالب متن خام (plain text). .SH "مثال‌ها (EXAMPLES)" یک فایل نمونه نگاشت MIDI را می‌توان در .I /usr/share/qmidiroute یا در .I /usr/local/share/qmidiroute یافت. .SH "نکات (NOTES)" خطاها و هشدارها در .BR stderr (3) نوشته می‌شوند. .SH "پشتیبانی (SUPPORT)" alsamodular-devel@lists.sourceforge.net .SH "نویسندگان (AUTHORS)" Matthias Nagorni, Frank Kober و Guido Scholz. این صفحه راهنما توسط Frank Kober نوشته شده است.