QMIDIROUTE(1) General Commands Manual QMIDIROUTE(1) NAME qmidiroute - MIDI-Signalverarbeiter und -Router SYNTAX qmidiroute [Option] [Datei] qmidiroute { --help | --version } BESCHREIBUNG qmidiroute ist ein vielseitiger MIDI-Signalverarbeiter und -Router fur den ALSA Sequencer. Die grafische Oberflache basiert auf der Qt4 Bibliothek. qmidiroute erlaubt die Konfiguration einer beliebigen Anzahl von MIDI-Routen, in denen eingehende Signale ausgewahlt, modifiziert oder vom Typ her verandert werden konnen, bevor sie einem bestimmten ALSA-Ausgang zugeleitet werden. Die Routen arbeiten parallel und sind grafisch in Reitern organisiert. Mit qmidiroute ist es zum Beispiel moglich, den Bereich einer Klaviatur zu verschieben oder zu invertieren, sowie Tastendrucke in Befehle zur Programmanderung oder Kontrollbefehle in Notensignale umzuwandeln. Eingehende MIDI-Signale konnen in einer Liste protokolliert und nach Typ farblich unterschiedlich dargestellt werden. qmidiroute bietet einen ALSA-Eingang und als Voreinstellung zwei ALSA-Ausgange. Die ALSA- Client-Identifikationsnummer wird als Teil des Fenstertitels dargestellt. Allgemeine Anwendung Nach dem Start der Anwendung wird der Reiter Unpassend angezeigt (Naheres siehe unten). Zum Erstellen einer MIDI-Route legt man uber das Menu eine neue Route an, die schliesslich als neuer Reiter mit allen verfugbaren Einstellungen angezeigt wird. Die komplette Konfiguration kann in einer QMidiRoute-Datei (.qmr) gespeichert und von dieser auch wieder geladen werden. Es lassen sich mehrere Routen erzeugen, die parallel arbeiten. Die Routen konnen duch Duplizieren, Umbenennen und Loschen verwaltet werden. Das Protokoll wird zu Beginn am unteren Ende des Programmfensters angezeigt und kann verborgen oder als separates Fenster frei beweglich auf der Arbeitsflache platziert werden. Das Aufzeichnen der MIDI- Signale kann generell abgeschaltet oder auch selektiv fur Signale der MIDI-Echtzeituhr eingeschaltet werden. MIDI Eingang Der Eingabebereich Eingang reprasentiert den Filter fur die eingehenden MIDI-Signale der betreffenden Route. Hier lassen sich die zubehandelnden Signaltypen Note, Controller, Pitchbend und Program Change auswahlen. Das Signal lasst sich nach den enthaltenen Daten bzw. nach dem MIDI-Kanal filtern. Die zu den hier im Eingang festgelegten Kriterien passenden Signale werden zum Bereich Ausgang weitergeleitet. MIDI Ausgang Der Eingabebereich Ausgang legt die Parameter fest, mit denen die vom Eingang kommenden Signale transformiert werden; z.B. wie der Kanal und andere Werte modifiziert und zu welchem ALSA-Ausgang diese geleitet werden. Kanale und Werte konnen, je nach eingehendem Signal, auf Versatz oder Umgekehrter Versatz konfiguriert werden. Zum Beispiel fuhrt die Auswahl von Umgekehrter Versatz dazu, dass der eingehende Wert von dem hier festgelegte Wert abgezogen wird. Wenn der Wertebereich eines ausgehenden Parameters unterschiedlich vom Bereich des entsprechenden Eingangsparameters ist, wird der Wert entsprechend skaliert. Die modifizierten MIDI-Signale werden an den hier festgelegten ALSA-Ausgang geleitet. Die Anzahl der zur Verfungung stehenden ALSA-Ausgange kann uber die entsprechende Kommandozeilenoption festgelegt werden. Unpassende MIDI-Signale In dem mit Unpassend bezeichneten Reiter wird die Behandlung der MIDI- Signale festgelegt, die keinem Filterkriterium genugen. Die Signale konnen verworfen oder an einen konfigurierten ALSA-Ausgang geleitet werden. OPTIONEN --portCount Setz die Anzahl der verfugbaren ALSA-Ausgange auf den Wert . Der voreingestellte Wert betragt 2. --help Gibt die verfugbaren Kommandozeilenoptionen aus und beendet das Programm. --version Gibt die Programmversion aus und beendet das Programm. Datei Name einer QMidiRoute-Datei (.qmr) zum Offnen beim Start des Programms. DATEIEN *.qmr QMidiRoute-Dateien, enthalten Daten der konfigurieten MIDI- Routen in einem reinen Textformat. BEISPIELE Eine Beispieldatei kann in einem der folgenden Verzeichnisse gefunden werden: /usr/share/qmidiroute oder /usr/local/share/qmidiroute BEMERKUNGEN Fehler und Warnungen werden nach stderr(3) geschrieben. UNTERSTUTZUNG alsamodular-devel@lists.sourceforge.net AUTOREN Matthias Nagorni, Frank Kober and Guido Scholz. Das Original dieser Handbuchseite wurde von Frank Kober geschrieben; die deutsche Ubersetzung wurde von Guido Scholz angefertigt. 2009-09-13 QMIDIROUTE(1)