Ubuntu Manpage: qmidiarp - Arpégiateur et LFO MIDI pour le séquenceur ALSA

NOM

       qmidiarp - Arpégiateur et LFO MIDI pour le séquenceur ALSA

SYNOPSIS

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

DESCRIPTION

QMidiArp est un arpégiateur, séquenceur linéaire programmable et oscillateur à basse fréquence (LFO) MIDI
avancé. Selon l'option choisi il utilise JACK MIDI ou ALSA MIDI. Un nombre illimité d'arpégiateurs,
séquenceurs et LFOs peuvent être définis comme modules pour fonctionner en parallèle. Les modules
arpégiateurs produisent des séquences de notes dépendant des notes reçues sur leur port d'entrée, qui est
typiquement connecté à un clavier MIDI ou un séquenceur. Les modules séquenceurs sont similaires aux
premiers séquenceurs analogiques, linéaires, monophoniques et ajustables en étant en marche. Les LFOs
MIDI, de manière indépendante, produisent des données de contrôleur MIDI avec forme d'onde, résolution
temporelle, amplitude et durée ajustables. Pour chaque module, un filtre d'entrée est disponible. Le port
de sortie et le canal MIDI peuvent être attribués pour chaque module indépendamment. Puisque les modules
utilisent un séquenceur commun, ils sont automatiquement synchronisés entre eux. QMidiArp fonctionne avec
une résolution interne de 192 ticks par quart de mesure (beat). La queue peut être synchronisée à une
horologe MIDI entrant ou en tant que client JACK Transport. La plupart des contrôles de QMidiArp est
accessible par contrôle MIDI via un mécanisme d'apprentissage par menu contextuel. QMidiArp possède
également un outil de journalisation d'évênements MIDI entrants. QMidiArp utilise les bibliothèques du
kit Qt4.

Fonctionnement Général
Si aucune option est spécifiée au démarrage, QMidiArp utilise devient un client JACK MIDI et cré un port
d'entrée ainsi que deux ports de sortie. Si l'on démarre QMidiArp avec l'option -a, le système MIDI est
ALSA. En cliquant sur les boutons Nouvel Arpège..., Nouveau LFO... ou Nouveau Séquenceur... le module
choisi apparaît en tant qu'onglet dans la zone principale. Les modules peuvent être renommés ou supprimés
avec les boutons et fonctions de menu correspondants. Le montage entier contenant tous les arpèges et
LFOs de la barre d'onglets ainsi que les définitions de la fenêtre Paramètres peuvent être sauvegardées
dans un fichier XML QMidiArp (.qmax). Les modules peuvent être détachées en tant que fenêtres
indépendantes pour les contrôler et visualiser en parallèle. Le tempo du séquenceur est défini de manière
commune pour tous les modules en unités de beats par minute (bpm). La queue du séquenceur est démarrée en
cliquant sur le bouton indiquant une flêche bleue.

Fonctionnement en mode MIDI Clock (disponible uniquement pour ALSA)
QMidiArp peut utiliser les évênements MIDI clock entrant en tant que source d'horologe et de contrôle
start/stop. Si le bouton MIDI clock à droite de la boîte de réglage du tempo est enfoncé, la queue du
séquenceur est arrêtée et QMidiArp attendra la réception d'un évênement "MIDI Clock Start" d'une source
externe connectée à son entrée MIDI. Une fois cet évênement reçu, la queue est démarrée en utilisant les
évênements d'horologe MIDI comme source. La synchronisation fonctionne au mieux si le tempo de la source
externe correspond à peu près à celui de QMidiArp. La queue s'arrêtera sur réception d'un évênement MIDI
Clock Stop. Pendant le fonctionnement en mode MIDI Clock, les fonctions internes de start/stop ainsi que
l'ajout ou le chargement de fichiers sont desactivées. Elles sont réactivées en cliquant sur le bouton
MIDI Clock à nouveau.

Fonctionnement en tant que client JACK Transport
Lorsqu'on appuye sur le bouton Connecter à Jack Transport, QMidiArp essaiera de se connecter à un serveur
JACK en marche. Il fonctionnera ensuite en tant que client Jack Transport, c'est à dire, le tempo sera
déduit d'un maître Jack Transport et la synchronisation sera maintenue. Le séquenceur de QMidiArp
redémarrera à zéro à chaque fois que le maître Jack transport est mis en marche, indépendamment de la
position initiale de Jack Transport. Ceci s'applique également quand Jack Transport fonctionne en boucle.
Le bouton Jack Transport se relâche automatiquement lors d'une déconnextion de Jack, par exemple si Jack
n'est plus actif.

Note: Les états des boutons MIDI Clock et Jack Transport sont sauvegardés dans le fichier de session
QMidiArp à chaque enregistrement et deviennent actifs ou inactifs à chaque ouverture d'une session.

Les Modules Arpégiateur
Les arpégiateurs de QMidiArp produisent des séquences de notes qui dépendent des notes jouées au clavier
d'entrée. La façon dont les notes sont traduites en séquence est déterminé par le motif et les réglages
de chaque module.

Les champs Entrée et Sortie

Chaque arpégiateur possède un champ Entrée et un champ Sortie. Le champ d'entrée définit la gamme de
notes et le canal MIDI auxquels l'arpeggiator est assigné. Les notes qui passent par ce filtre sont
triées par leur hauteur et ajoutées au tampon interne de notes de l'arpégiateur. Les notes ne passant par
aucun filtre peuvent être acheminées à un port MIDI défini dans la fenêtre Paramètres ou ignorées. Le
champ Sortie contient les réglages du canal MIDI et du port de sortie auxquels les notes de l'arpège
seront envoyées.

Motifs d'arpège

Le motif de l'arpège peut être sélectionné et édité dans le champ Motif. Les motifs prédéfinis (presets)
sont accessibles d'un menu déroulant. Le motif actif est affiché dans un écran dédié montrant les notes
de base comme traits. L'échelle verticale de cet écran correspond à l'index des notes dans le motif. Les
changements d'octave (voir Editer les motifs d'arpège) sont affichés comme des séparateurs horizontaux
supplémentaires. Les notes sortant de l'arpéggiateur dépendent des notes reçues à l'entrée, qui sont
attribuées par ordre ascendant aux notes de base définies dans le motif. Par exemple, un trait unique en
bas de l'écran d'affichage (presets "simple") signifie qu'au premier passage, la note la plus basse jouée
sur le clavier est produite. Si plusieurs notes sont appuyées sur le clavier et si seulement une note est
présente dans le motif, c'est le mode de répétition qui détermine la séquence de notes jouées à la
sortie. Si le motif contient des traits de note empîlés (mode accord), les accords joués sur le clavier
deviennent aussi des accords à la sortie avec une polyphonie dans la limite du nombre de notes définies
dans cette pîle.

Mode de répétition

Le mode de répétition définit le comportement de l'arpège sur plusieurs répétitions du motif quand le
nombre de notes jouées sur le clavier dépasse le nombre de notes présentes dans le motif, par exemple
avec une seule note dans le motif mais un accord de trois notes joué sur le clavier. Avec le mode de
répétition "Monte", la note produite est incrémentée à chaque répétition vers la prochaine note jouée sur
le clavier. Avec le mode "Descend", la prochaine note plus basse est jouée. Avec une seule note présente
dans le motif, ceci produit un arpège classique linéaire. Ainsi, même avec des motifs simples comme "01"
ou "0", on génère des arpèges complets. En revanche, avec le mode de répétition "Statique", les notes à
la sortie seront constantes.

Mode de Déclenchement

Les arpégiateurs de QMidiArp possèdent trois modes de déclenchement par le clavier d'entrée. En mode
"Continu", le motif est répété en permanence en synchronisation avec le séquenceur interne sans tenir
compte du moment où les notes sont jouées. Le mode "Redémarre" permet de garder cette quantisation mais
en renvoyant la séquence au point de départ à chaque nouvelle note jouée en stakato. Enfin, le mode
"Déclenche" produit le démarrage de l'arpégiateur au moment où une note stakato est jouée.

Editer les motifs d'arpège

Les motifs d'arpège de QMidiArp sont définis par une séquence de caractères contenant les notes même
ainsi que des caractères de contrôle pour des changements de tempo, de vélocité, de durée, d'octave, et
de mode accord. En appuyant sur le bouton Editer le motif, le preset de motif apparaît sous forme d'un
champ de texte modifiable. Le motif modifié peut être sauvegardé dans la liste des motifs prédéfinis en
cliquant le bouton Mémoriser le motif. Le motif actif peut être supprimé de la liste en cliquant sur le
bouton Supprimer le motif. Les modifications de la liste des motifs s'appliquent simultanément à tous les
arpéggiateurs dans la barre des onglets. La syntaxe du texte d'un motif est la suivante:

0..9 : Indice de note jouée sur le clavier en ordre ascendant
+ : Augmente d'une octave
- : Diminue d'une octave
= : Retour à l'octave de base
> : Double tempo
< : Demi tempo
. : Retour au tempo standard: un quart de mesure
( ) : Mode accord début / fin
e.g. (012) produit un accord des trois
notes les plus basses dans le tampon
/ : Augmente la vélocité de 20%
\ : Diminue la vélocité de 20%
d : Double durée de note
h : Demi durée de note
p : Pause

Tous les contrôles sont valides jusqu'à la fin du motif. Par exemple, le contrôle > doublera la vitesse
de l'arpège pour toutes les notes suivantes dans le motif jusqu'à la prochaine répétition à laquelle la
vitesse reprendra à un quart de mesure.

Randomisation

Le rythme, la vélocité et la durée des notes produites peuvent être randomisés par les réglettes du champ
Randomisation. Ces réglages peuvent être utilisés pour produire des motifs moins mécaniques, mais à des
valeurs plus élevées, ils ajoutent des accents intéressants au motif joué.

Enveloppe

QMidiArp peut superposer une fonction d'enveloppe aux vélocités des arpèges. La dynamique de cette
enveloppe est définie par les réglettes Attack et Release. En ajustant un temps d'"attack" non-nul, les
vélocités de notes à la sortie sont incrémentées pendant le temps d'attack défini en secondes. Si un
temps "release" est spécifié, les notes relâchées sont gardées dans le tampon, et leur vélocité est
linéairement diminuée jusqu'à la fin du temps "release". Cette fonction n'a un effet sur le son que si le
synthétiseur connecté à la sortie produit des sons sensibles à la vélocité. Elle fonctionne aux mieux
avec des motifs à haute polyphonie comme par exemple le motif "Chord Oct 16 A".

Groove

Les réglettes de la fenêtre Groove permettent de contrôler un décalage linéaire du rythme, de la durée
des notes et de leur vélocité à l'intérieur de chaque quart de mesure du motif. Ceci permet de créer un
rythme du type swing ou d'accentuer le motif. Les ajustements Groove sont valables pour tous les
arpégiateurs simultanément.

Les modules arpégiateurs de QMidiArp ont été inspiré par l'arpégiateur matériel MAP1 par Rudi Linhard.

Les modules LFO
En parallèle aux arpégiateurs, QMidiArp peut envoyer des données de contrôle MIDI sous forme d'un
oscillateur à basse fréquence (LFO) à une sortie spécifiée. Les données LFO sont des évênements MIDI
envoyés en synchronie avec la queue de l'arpégiateur. La queue doit être en état démarré pour activer les
LFOs. Chaque module LFO possède un champ forme d'onde pour définir la forme des données produites et un
champ Sortie pour définir leur canal MIDI, port ALSA ainsi que le numéro de contrôleur à produire.
Actuellement, la forme d'onde peut être choisie entre Sinus, Scie montant, Scie descendant, Triangle,
Créneau et Libre. La fréquence du LFO est définie en multiples et diviseurs du tempo de l'arpégiateur,
une fréquence de 1 produit une onde entière à chaque quart de mesure. Si l'on spécifie des fréquences
plus basses, la longueur de la table d'onde doit être ajustée en conséquence si l'on souhaite produire un
cycle d'onde complet. La résolution temporelle du LFO détermine le nombre d'évênements produits à chaque
quart de temps. Elle peut aller de 1 à 192 évênements par quart de temps. L'amplitude et l'offset de
l'onde peuvent être spécifiés entre 0 et 127. A basse résolution temporelle, le LFO produira des
changements rythmiques du contrôle, tandis que des résolutions élevées mènent à des ondes de plus en plus
continues.

Rendre muet l'onde point par point

On peut retenir l'emission d'un point individuel sur la forme d'onde en cliquant avec le bouton droit de
la souris à l'endroit correspondant dans l'écran d'affichage de l'onde. Les points muets de l'onde sont
affichés en couleur sombre.

Formes Libres

En sélectionnant la forme Libre, l'onde peut être dessinée ou modifiée avec le bouton gauche de la
souris. Lorqu'on tente à modifier une forme calculée, elle est automatiquement copiée vers la forme
libre, et la forme libre précédente est écrasée. Toutes les opérations du LFO incluant le dessin peuvent
être faites pendant que le transport est en marche.

Direction de lecture et répétition

The play mode can be switched between:

->_> : En avant et répéter
<_<- : En arrière et répéter
->_< : Aller-retour et répéter
>_<- : Retour-aller et répéter
->_| : Un seul aller
|_<- : Un seul retour

Les changements faits dans ces contrôles s'appliquent immédiatement.

Enregistrement

Les données de contrôle MIDI reçues à l'entrée peuvent être enregistrées en continue en appuyant sur le
bouton Enregistrer. Ce bouton est lui-même contrôlable par MIDI (c.f. Apprentissage MIDI) et QMidiArp est
ainsi utilisable comme Looper et séquenceur de contrôles.

Le champ Entrée du LFO Le champ d'entrée permet de spécifier le contrôleur MIDI CC à enregistrer. On
spécifie ici également comment le module réagit en cas de réception de notes à l'entrée. Comme les
arpégiateurs, le LFO peut être redémarré ou déclenché (triggé), et la production de données peut être
arrêtée en cas de touches relachées, donc à la réception d'un signal Note Off à l'entrée avec le Canal
correspondant.

Le champ Sortie du LFO

Ce champ contient les réglages du port, canal et contrôleur des données produites. Il permet également de
rendre muet le module entièrement.

Les modules séquenceurs
En cliquant sur le bouton Nouveau Séquenceur... dans la barre de contrôle, un nouveau module Seq peut
être ajouté à la barre d'onglets. Chacun de ces modules produit une séquence simple, linéaire et
monophonique, similaire aux premiers séquenceurs matériels analogiques. Les modules Seq sont contrôlables
en étant en marche, également similaire aux séquenceurs analogiques.

Programmer une séquence

Comme les modules LFO de QMidiArp, le séquenceur peut être programmé en ajustant les notes avec le bouton
gauche de la souris sur l'écran d'affichage. La gamme d'octaves est fixée à 4, la note la plus basse
étant C2, si la transposition globale est zéro. Les notes peuvent être rendues muettes avec le bouton
droit de la souris. La durée de la séquence peut être ajustée entre 1 et 8 beats (quarts de mesure), la
résolution temporelle entre 1 et 16 par beat. Une résolution de 4 produit 4 notes par beat, donc des
notes double croche. On peut aussi programmer des séquences en utilisant la fonction Enregistrer. Si le
bouton Enregistrer est enfoncé, les notes reçues sur le port d'entrée sont enregistrées pas à pas
commençant par la dernière note modifiée. La séquence peut être programmée avec la queue de séquenceur en
marche.

Contrôler la séquence globalement

Le module Seq possède des réglettes pour ajuster la vélocité (volume), la durée des notes et la
transposition de la séquence par demi-notes. Tous les changements de ces contrôles s'appliquent à chaque
nouveau tour de la boucle.

Les champs Entrée et Sortie du séquenceur

Le champ Entrée définit comment gérer les notes reçues sur le Canal MIDI ajusté. Si la case Note est
cochée, la séquence est globalement transposée avec la note reçue comme valeur de transposition. Si la
case Vélocité est cochée également, la séquence produira des notes avec la même vélocité que celle de la
note reçue. Le champ Entrée définit également le comportement de déclenchement de la séquence en cas de
réception de notes à l'entrée. Redémarre renvoie la séquence à son début, mais sans interrompre le
rythme. La séquence est re-déclenchée avec le timing des notes jouées seulement si Trigger est est coché.
Note Off arretera la séquence avec une note relachée, et Boucle doit être cochée pour une répétition
permanente au lieu d'un seul passage. Le champ Sortie est équivalent à celui des arpégiateurs et LFOs.

On peut produire des accents dans une séquence en ajoutant des modules LFO en parallèle aux modules Seq.
Pour ceci, il suffit que le LFO envoie ses données vers le même port et canal MIDI que les modules Seq.

Paramètres
La fenêtre "Paramètres" permet de configurer vers quel port ALSA les évênements passant par le filtre
d'entrée d'aucun arpégiateur sont acheminés. Si ces évênements devront être ignorés, la case
correspondante doit être décochée. Dans cette fenêtre on spécifie également si QMidiArp est contrôlable
par des contrôleurs MIDI. En cochant la case Style compact d'affichage des modules tous les nouveaux
modules créés auront une apparence économique en place pour la distribution sur le bureau de
l'ordinateur.

Tous les ajustements faits dans le dialogue Paramètres sont sauvegardés avec les données des modules dans
le fichier .qmax.

Contrôle MIDI
QMidiArp accepte les évênements de contrôle MIDI, si l'option Modules contrôlables par MIDI est cochée
dans le dialogue Settings. Le contrôle par MIDI est dispobible pour les modules Seq (boutons muets,
vélocité, durée des notes), les modules LFO (boutons muets, amplitude, décalage) et les modules d'arpège
(boutons muets).

Apprentissage MIDI

Les contrôleurs peuvent être attribués par un clic de droite sur l'élément de contrôle correspondant, et
en sélectionnant Apprendre du MIDI. QMidiArp attendra ensuite la réception d'un évênement de contrôle
MIDI (envoyé par exemple à partir d'une réglette d'une surface de contrôle). Lors de la première
réception d'un tel évênement, ce contrôleur est acheminé vers l'élément de contrôle sélectionné. Il est
possible d'attribuer plusieurs contrôleurs MIDI à un seul élément. Lorsqu'on sélectionne Oublier les
contrôleurs, toutes les attributions de cet élément seront supprimées. Si l'on choisit Annuler
l'apprentissage, QMidiArp n'attendra plus d'évênements de contrôle MIDI.

Note: par défaut, les contrôleurs attribués aux boutons "muet" fonctionnent en tant que "toggle", c'est à
dire le bouton change entre actif/inactif sur chaque réception d'une valeur de contrôle de 127.

Editeur de contrôles

Pour modifier les contrôles attribués, on choisit Contrôles MIDI dans le menu Affichage. Les propriétés
de chaque contrôle MIDI peuvent être modifiées dans le tableau de cette fenêtre. Les contrôleurs de
boutons ont un fonctionnement spécifique. Si les valeurs min et max sont identiques, le contrôleur
fonctionnera en tant que "toggle". Si min et max sont différents, le module devient muet lors de la
réception de min (case muet cochée) et devient actif lors de la réception d'une valeur de max.

Lorsqu'on appuye sur Supprimer, la ligne sélectionnée est effacée, et le bouton Rétablir recharge les
attributions actuelles. Toutes les modifications faites dans ce tableau sont appliquées sur appui du
bouton OK alors que Cancel annule les changements.

Stockage Global
Une autre fenêtre à disposition permet le stockage et le rappel de la plupart des paramêtres de tous les
modules en commun. Dans cette fenêtre, chaque module et ses emplacements de stockage apparaissent dans
une colonne, la première colonne étant attribuée à la gestion commune de tous les modules. En cliquant
sur le petit bouton Sauver on enregistre les paramètres de tous les modules dans l'emplacement représenté
par les boutons dans la ligne, et un nouvel emplacement vide apparaît. Les paramètres dans ces
emplacements peuvent être rappellés pour chaque module individuellement par les boutons dans les colonnes
des modules, ou globalement pour tous les modules en cliquant sur le bouton numéroté à gauche. Un
emplacement peut être supprimé en cliquant sur le bouton "flêche" en bas du tableau. Au cas où l'on
ajoute un nouveau module quand les autres modules possèdent déjà leurs emplacements de stockage, les
stockages du nouveau module sont d'abord vides. Ils peuvent être remplis en appuyant à nouveau sur
Sauver.

Quand le séquenceur de QMidiArp est en marche, la commutation des paramètres dépend des sélections faites
dans la première ligne de la fenêtre.

Fin de produit des commutations de paramètres à chaque fois que le module sélectionné dans le deuxième
menu combo atteint la fin de son motif. Si dans cette configuration, on clique sur l'un des boutons
individuels, le module concerné commandera la commutation à la fin de son motif.

Après produit des commutations après le nombre fixe de quart de temps (beats) sélectionnés dans le
deuxième menu combo.

La commutation peut être commandée par contrôleur MIDI attribué par le menu de contexte du bouton de
chaque module dans la première ligne. Notez que c'est la valeur du contrôleur MIDI qui sélectionne
l'emplacement à rappeller, et qu'on doit éventuellement ajuster son échelle dans l' Editeur de contrôles
pour adapter la plage de valeurs. Avec le panneau de Stockage Global QMidiArp devient un séquenceur Live
simple mais pratique. Mais on peut cacher la fenêtre avec l'entrée du menu Affichage ou avec le bouton
correspondant dans la barre d'outils principale.

Journal
La fenêtre du Journal d'évênements liste les évênements MIDI entrants. Les évênements sont affichés en
couleur dépendant de leur type. Le journal est affiché dans la partie inférieure du logiciel par défaut,
mais il peut être caché ou détaché en tant que fenêtre indépendante. La journalisation peut être
desactivée entièrement ou uniquement pour les évênements d'horologe MIDI.

Fichiers d'exemple
Il y a actuellement trois fichiers de démonstration de l'arpégiateur. Le fichier demo.qma a été conçu
pour être utilisé avec des sons de type suivant: Canal 1: Marimba, Canal 2: Celesta, Canal 3: Basse
acoustique, mais on peut obtenir des résultats intéressants en employant d'autres types de son.

Le montage semo_seqlfo.qmax démontre l'utilisation des nouveaux modules Seq et LFO fonctionnant en
parallèle. Les sorties des séquenceurs devraient être connectées à des synthétiseurs et des sons
percussifs. Les LFO produisent des données destinées aux fréquences de filtres (cutoffs) qui ont le
contrôleur MIDI standard CC#74. Le synthétiseur ZynAddSubFX par Paul Nasca réagit à ces contrôleurs, et
ses presets "Bass 1" ou "Plucked 3" fonctionnenet bien avec cette démonstration.

OPTIONS

       --portCount <num>
              Définir le nombre de ports ALSA disponibles égal à <num>. La valeur par défaut est 2.

       --help Affiche les options de ligne de commande disponibles et quitte le programme.

       --version
              Affiche l'information de version du programme et quitte celui-ci.

       --alsa Utiliser le pilote ALSA MIDI

       --jack Utiliser le pilote JACK MIDI (par défaut)

       fichier
              Nom d'un fichier QMidiArp (.qmax) valide à charger au démarrage du programme.

FICHIERS

       *.qmax
              Fichiers XML QMidiArp contenant les données au format texte XML.

EXEMPLES

       Les fichiers d'exemple de QMidiArp se situent dans /usr/share/qmidiarp ou dans /usr/local/share/qmidiarp

NOTES

       Les erreurs et avertissements sont écrits dans stderr(3).

SUPPORT

       qmidiarp-devel@lists.sourceforge.net

AUTEURS

       Frank  Kober,  Nedko  Arnaudov,  Guido  Scholz et Matthias Nagorni. Cette page de manuel a été écrite par
       Frank Kober <emuse@users.sourceforge.net>.

                                                   2011-11-10                                        QMIDIARP(1)