Matériel - Capteurs
Réception des données en Midi

Introduction - Définitions

Logiciels / Langages / Applications
Pure-Data
Max MSP
EyesWeb 4
Isadora
Processing
vvvv

< Page 1 - Page 2 - Page 3 >

Isadora

Port

Configurer le Midi revient à configurer le port Midi.

Lors de l'ouverture d'Isadora, les ports Midi disponibles sont répertoriés et numérotés dans une liste de périphériques Input pour les entrées et Output pour les sorties.

Lorsqu'on utilise une interface Midi-USB, il faut toujours la brancher avant de lancer le logiciel, sinon elle risque de ne pas être reconnue.

Il est parfois nécessaire d'assigner un appareil à un port ou de choisir leur ordre. Pour cela, il faut utiliser le menu Windows / Midi Setup. Cette fenêtre permet d'activer ou de désactiver des entrées Midi et de choisir un numéro de port à associer à une entrée spécifique.

Lorsque des ports différents sont utilisés, Isadora les distingue directement par leur numéro (comme on va le voir ci-dessous), sans décaler les canaux Midi.

Les actors Control Watcher, Note On Watcher et Note Off Watcher

Patch objets.izz

L'objet Control Watcher permet de recevoir les messages Control Change.
Il dispose de quatre entrées et cinq sorties, de haut en bas : port, canal, numéro, valeur (et Trigger en plus en sortie). Il s'agit de l'ordre de réception dans le temps de ces informations.

Par défaut, l'actor reçoit tous les Control Change (de numéro 0 à 127) à partir de tous les canaux midi (de 1 à 16) de tous les appareils branchés sur tous les ports (de 1 à 16). Les sorties affichent les composantes des messages reçus. La sortie Trigger envoie un signe à chaque fois qu'un message est reçu.

Les entrées sont paramétrables afin de filtrer les messages Midi entrants.
- Donner un numéro de port permet de ne recevoir que les messages qui arrivent du périphérique branché sur la prise correspondante. Cette configuration est intéressante dans le cas où plusieurs entrées Midi fonctionnent en même temps.
- De même le canal (channel) peut être restreint à un seul possible ou bien à un intervalle plus étroit que 1-16. Par exemple paramétrer le canal sur 2-4 permet de recevoir sur ce même actor les Control Change émis par des cartes sur les canaux 2, 3 et 4.
- L'entrée controller permet de sélectionner un numéro de Control Change précis (32 par exemple), ou bien un intervalle (32-39). Dans notre cas, cela permet de sélectionner les différents capteurs branchés sur une carte.
- L'entrée value est généralement laissée sur l'intervalle 0-127, ce qui permet de recevoir toutes les données envoyées par chaque capteur. Un filtrage par seuil, s'il a lieu, se fait plutôt ensuite, après observation du comportement de l'ensemble des valeurs.

Dans le patch exemple ci-dessus, un capteur a envoyé un Control Change de numéro 32 avec une valeur de 104 à partir d'une carte en canal 1, qui est branchée sur le port 1. Le premier Control Watcher à gauche est l'objet par défaut, le deuxième a été paramétré pour recevoir exclusivement les données issue du capteur branché sur cette entrée de l'interface à capteur.

Les Note On en Isadora sont reçus sur deux actors. En effet les Note On de vélocité supérieure à 1 sont reçus sur un Note On Watcher qui fonctionne de la même manière que le Control Watcher, le pitch correspondant au numéro de Note et la velocity à la valeur.

Isadora cependant interprète un Note On de vélocité 0 comme un Note Off de vélocité 64. Il est d'ailleurs visible sur les paramètres d'entrée des deux Note Watcher qu'ils n'acceptent que des vélocités supérieures à 1. Nos cartes pour interrupteurs envoyant des Note On 0 lorsque les interrupteurs sont relâchés, ceux-ci à l'arrivée arrivent dans un Note Off Watcher.

Dans l'exemple ci-dessus un interrupteur connecté sur une entrée numérique numérotée 5 a envoyé un Note On vélocité 64 puis un Note On vélocité 0 devenu Note Off 64.

Ces deux actors sont au coeur des sous-patchs et des user actors disponibles sur ce site pour les différentes cartes. Pour les traitements et les tris spécifiques de chaque carte, consulter les pages correspondantes.

Liste des patches Isadora disponibles sur le site

Processing

proMIDI

Le protocole Midi peut être utilisé en Processing grâce à la librairie proMIDI, qui se télécharge ici http://www.texone.org/promidi/index.htm.
Librairie pour utiliser le Midi : promidi.zip (PC)

Il faut donc commencer par installer proMIDI, en dézippant l'archive promidi.zip dans le répertoire libraries de processing.

Port

Dans le code :
- il faut importer la librairie pour y avoir accès ;
- on utilise la classe MidiIO pour gérer les ports Midi.

Dans la fonction setup, il faut détecter les périphériques Midi, en choisir un et ouvrir le port correspondant.

Les méthodes utilisées ici sont :
- getInstance() pour ouvrir la possibilité de gérer les entrées/sorties Midi ;
- printDevices() pour imprimer dans la console la liste des périphériques Midi disponibles. Cette étape n'est pas absolument nécessaire mais permet 1) de vérifier rapidement que l'appareil branché est bien reconnu en Processing et 2) de connaître son numéro d'identification dans la liste des ports Midi ;
- openInput(int,int) permet d'ouvrir un des ports de la liste en choisissant aussi un canal particulier. La structure est midiIO.openInput(numero du peripherique,canal).

Ce n'est pas la seule façon de choisir et d'ouvrir un port Midi mais c'est celle qui a été utilisée dans les sketches téléchargeables sur ce site.

Fonctions controllerIn et noteOn

Il est maintenant possible de récupérer les Control Change et les Note On dans notre sketch.

Définissons une variable globale, commodément appelée valeur. Selon les cartes de captation, cette variable peut être un int ou un array. Dans cette page, nous resterons dans le cas le plus simple.

Cette variable est utilisée dans une fonction controllerIn, où la variable valeur prend la valeur courante du capteur pour un numéro de Control Change donné. Le numéro de CC est récupéré grâce à controller.getNumber() et, s'il correspond aux critères de tri de la fonction, la valeur est récupérée grâce à controller.getValue().

Les Note On sont récupérés de façon équivalente, à l'aide d'une fonction noteOn. Là aussi le mieux est de définir auparavant une variable globale, par exemple un array d'integers nommé velocite_8 à 8 cases qui contiendra les informations venues de 8 interrupteurs branchés sur des entrées numériques.

Le numéro de Note On est obtenu grâce à note.getPitch(). Si les conditions de tri sont remplies (ici si le pitch est compris entre 0 et 7), la variable prend la valeur du Note On reçu à l'aide de note.getVelocity() et l'engrange à la bonne place de l'array, place correspondant au numéro de Note On.

Les variables valeur et velocite_8[] sont ensuite utilisables à volonté dans le sketch.

Ces fonctions sont communes aux sketches disponibles sur ce site pour les différentes cartes, avec les variantes spécifiques à chacune. Pour les traitements et les tris spécifiques de chaque carte, consulter les pages correspondantes.

Stabilité

Attention, il y a quelques précautions à prendre pour que tout se passe bien. Lorsqu'on teste un code, on relance régulièrement son exécution. Il faut éviter en Processing avec le Midi de faire simplement Stop / Run de nombreuses fois de suite. En effet, au bout d'un moment, l'accès au Midi se bloque complètement et plus rien ne semble fonctionner... Il devient impossible de relancer proprement Processing, il faut redémarrer la machine, avec le bouton Reset, d'ailleurs...

Pour éviter cet inconvénient relativement désagréable, il faut penser à fermer régulièrement Processing avant de tester une modification (peutêtre pas à tous les coups, mais souvent). Cela permet à Processing de fermer proprement les prots Midi, ce qu'il ne fait pas quand on se contente d'enchaîner les Run/Stop.

Il faudrait aussi explorer la méthode closeInput, cependant elle ne permet pas de fermer le port lui-même.

Liste des sketches Processing disponibles sur le site

VVVV

Paragraphe en cours de rédaction.

Paramètres du node MidiController :
- Channel : 0. Dans vvvv les canaux Midi sont comptés de 0 à 15 et non de 1 à 16.
- Controller : numéro de control change.
- Buffer length : 10 par défaut.
- Enabled : 1
- Midi input Port : choisir l'entrée Midi sur laquelle est connectée le matériel.

En sortie : les données des capteurs sortent transformées entre 0 et 1 et non entre 0 et 127.

Liste des patches vvvv disponibles sur le site

< Page 1 - Page 2 - Page 3 >