NAME

       qmidiroute - MIDI-Signalverarbeiter und -Router

SYNTAX

       qmidiroute [Option] [Datei]
       qmidiroute { --help | --version }

BESCHREIBUNG

       qmidiroute ist ein vielseitiger MIDI-Signalverarbeiter und -Router für den ALSA Sequencer.
       Die  grafische  Oberfläche  basiert  auf  der  Qt4  Bibliothek.  qmidiroute  erlaubt   die
       Konfiguration  einer  beliebigen  Anzahl  von  MIDI-Routen,  in  denen  eingehende Signale
       ausgewählt, modifiziert oder  vom  Typ  her  verändert  werden  können,  bevor  sie  einem
       bestimmten  ALSA-Ausgang zugeleitet werden. Die Routen arbeiten parallel und sind grafisch
       in Reitern organisiert. Mit qmidiroute ist es zum  Beispiel  möglich,  den  Bereich  einer
       Klaviatur   zu  verschieben  oder  zu  invertieren,  sowie  Tastendrücke  in  Befehle  zur
       Programmänderung oder Kontrollbefehle in Notensignale umzuwandeln.

       Eingehende MIDI-Signale  können  in  einer  Liste  protokolliert  und  nach  Typ  farblich
       unterschiedlich   dargestellt   werden.  qmidiroute  bietet  einen  ALSA-Eingang  und  als
       Voreinstellung zwei ALSA-Ausgänge. Die ALSA-Client-Identifikationsnummer wird als Teil des
       Fenstertitels dargestellt.

   Allgemeine Anwendung
       Nach  dem  Start  der Anwendung wird der Reiter Unpassend angezeigt (Näheres siehe unten).
       Zum Erstellen einer MIDI-Route legt man über das Menü eine neue Route an, die  schließlich
       als  neuer  Reiter  mit  allen  verfügbaren  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
       können duch Duplizieren, Umbenennen und Löschen verwaltet werden.

       Das Protokoll wird zu Beginn am unteren  Ende  des  Programmfensters  angezeigt  und  kann
       verborgen  oder  als  separates  Fenster  frei  beweglich  auf der Arbeitsfläche platziert
       werden. Das Aufzeichnen der MIDI-Signale kann generell abgeschaltet oder auch selektiv für
       Signale der MIDI-Echtzeituhr eingeschaltet werden.

   MIDI Eingang
       Der  Eingabebereich  Eingang repräsentiert den Filter für die eingehenden MIDI-Signale der
       betreffenden Route. Hier lassen sich  die  zubehandelnden  Signaltypen  Note,  Controller,
       Pitchbend  und  Program  Change auswählen. Das Signal läßt 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. Kanäle und Werte können, je nach eingehendem
       Signal, auf Versatz oder Umgekehrter Versatz konfiguriert werden. Zum Beispiel  führt  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  Verfüngung  stehenden  ALSA-Ausgänge  kann  über  die
       entsprechende Kommandozeilenoption festgelegt werden.

   Unpassende MIDI-Signale
       In dem mit Unpassend bezeichneten Reiter wird die Behandlung der MIDI-Signale  festgelegt,
       die   keinem   Filterkriterium  genügen.  Die  Signale  können  verworfen  oder  an  einen
       konfigurierten ALSA-Ausgang geleitet werden.

OPTIONEN

       --portCount <Anzahl>
              Setz  die  Anzahl  der  verfügbaren  ALSA-Ausgänge  auf  den  Wert  <Anzahl>.   Der
              voreingestellte Wert beträgt 2.

       --help Gibt die verfügbaren Kommandozeilenoptionen aus und beendet das Programm.

       --version
              Gibt die Programmversion aus und beendet das Programm.

       Datei  Name einer QMidiRoute-Datei (.qmr) zum Öffnen 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.

UNTERSTÜTZUNG

       alsamodular-devel@lists.sourceforge.net

AUTOREN

       Matthias  Nagorni,  Frank  Kober and Guido Scholz. Das Original dieser Handbuchseite wurde
       von Frank Kober <emuse@users.sourceforge.net> geschrieben; die deutsche Übersetzung  wurde
       von Guido Scholz <gscholz@users.sourceforge.net> angefertigt.

                                            2009-09-13                              QMIDIROUTE(1)