Device.xml

Le fichier device.xml est un fichier qui permet de baptiser des boutons, des potards et des leds et ainsi de les utiliser dans Virtual DJ.

En effet les contrôleurs midi envoient des codes (nommés souvent des "notes"). VDJ reconnaît ces codes, mais si on veut pousser un peu, octroyer des commandes multiples avec des conditions, ou encore changer la couleur d'une led, il faudra obligatoirement passer par un fichier device.xml

Le fichier Device est à mettre dans le dossier "Device" dans /MesDocument/Virtual DJ.

-----------------------

Indentification d'un contrôleur midi

Virtual DJ doit pouvoir identifier le contrôleur midi que vous voulez mapper. Cette identification doit apparaître dans le fichier device concerné.

Pour cela il existe à ma connaissance 3 possibilités :

- le drivername

- le sysexid

- le pid et le vid

Le drivername se retrouve avec Miditrace 

Le sysexid se retrouve également avec Miditrace mais c'est déjà plus délicat : Pour plus d'infos sur le sysexid, Voir :  http://www.virtualdj.com/wiki/ControllerDefinitionMIDI.html

Le Pid et Vid se retrouvent dans le gestionnaire des périphériques (Panneau de configuration - système - gestionnaire de périphériques).

Rechercher votre contrôleur (il devrait se trouver dans la section "Contrôleurs audio, vidéo et jeu). Faire un clic droit et cliquer sur "Propriétés".

Dans l'onglet "Détails" fouiller dans le volet Propriété, vous y trouverez les 2 valeurs.

Elles devrons se présenter sous cette forme dans le fichier device :

pid="0x0163" vid="0x08e4"   (ajouter 0x devant vos valeurs)

Voici un exemple de script Device

Sur un contrôleur X nous avons un bouton éclairé qui peut prendre 3 couleurs différentes.

Grâce à Miditrace je découvre que la note midi de ce bouton est 0X70, donc je dois écrire :

<button note="0x70" channel="3" name="BOUT0X70" />

Ici je précise que le bouton ayant la note 0X70 du canal midi n°3 est baptisé "BOUT0X70" (on peut mettre ce qu'on veut comme nom, pourvu qu'on s'y retrouve)

Ensuite je baptise les couleurs de led possibles :

 <led note="0x70" channel="3" value="0x03" name="LED112vert" />

 <led note="0x70" channel="3" value="0x07" name="LED112rouge" />

 <led note="0x70" channel="3" value="0x43" name="LED112orange" />

Par la première ligne, je dis que la led ayant la note 0X70 du canal midi n°3 avec la valeur 0x03 s'appelle "LED112vert" La seconde ligne baptise la même led 0X70, mais cette fois pour la couleur rouge. La troisième pour la couleur orange.

Pour trouver les notes de ces couleurs, c'est encore une fois avec Miditrace !

 

Là j'ai donc baptisé 4 choses pour un même bouton : le bouton en lui-même + les 3 couleurs qu'il est capable de prendre.

Correspondance dans le fichier Mapper

Ensuite dans le fichier xml de mapping, je vais appeler ces noms.

Par exemple :

 <map value="BOUT0X70" action=" sampler 1 play_stop" />

 <map value="LED112rouge" action=" sampler 1 play_stop ? off : on" />

 <map value="LED112vert" action=" sampler 1 play_stop ? on : off" />

Au lieu de mapper une note midi ou une touche quelconque, je mappe les éléments que j'ai baptisé dans le fichier Device.

Les autres paramètres du fichier Device

Le fichier Device doit commencer par ces éléments :

<?xml version="1.0" encoding="UTF-8"?>

<device name="myDevice" author="DJ Chris Dodge" type="MIDI" drivername="Launchpad" decks="2">

La première ligne détermine le type d'encodage xml, c'est toujours la même.

device name : c'est le nom qu'on va donner à ce Device et qui sera appelé dans le fichier de mapping (par la phrase <mapper device=" myDevice" …)

author : c'est vous ;)

type="MIDI" pour les contrôleurs midi

drivername : c'est le nom sous lequel votre PC reconnaît votre contrôleur midi. Ce nom, vous pouvez le retrouver avec miditrace.

Ce nom est très important car c'est de cette manière que VDJ va savoir de quel contrôleur vous parlez, à travers le fichier Device.

NB :

Si VDJ ne reconnaît pas le nom de votre contrôleur midi avec le Drivername, il existe une autre possibilité : le sysexid. C'est le code mère de votre contrôleur midi.
Vous le trouverez une fois de plus avec miditrace. Il s'affiche immédiatement au lancement de miditrace, dans la section "CODE A ENVOYER".

Pour plus d'infos sur le sysexid, Voir :  http://www.virtualdj.com/wiki/ControllerDefinitionMIDI.html

--------------------------