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)