Provided by: qmidiroute_0.3.0-0ubuntu1_i386 bug

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.  Kanle 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)