VDJPedia



 Definizioni per i controller

Per integrare i controller in VirtualDJ 6 e 7 sono necessari due file: il file di "definizione" e il file "mapper".

Il file di definizione serve per definire un nome ai controlli presenti (cursori ,pulsanti, led, ect) sul controller MIDI/HID.

Il file mapper associano ad uno specifico controllo (cursori ,pulsanti, led, ect) una azione del VDJscript.

Molti controller sono già nativamente integarti per cui il file di definizione e mapper sono scritti nel codice di VirtualDJ.

Se si dispone di un controller che non viene riconosciuto nativamente da VirtualDJ, o se siete un produttore che sta creando un nuovo controller, è molto facile creare un nuovo file di definizione.

I file di definizione sono file XML standard, e devono essere installati in C:/Documenti/VirtualDJ/Devices per chi usa PC
oppure /users/TUONOME/Documenti/VirtualDJ/Devices per chi usa Mac.

La sintassi del file di definizione dipende l'interfaccia utilizzata (HID o MIDI):

Sintassi del file di definizione controller MIDI

Sintassi del file di definizione controller HID

Vedi anche:

Differenze tra protocolli HID e MIDI

Come implementare un firmware HID

I file di mapping sono file XML standard, e devono essere installati in C:/Documenti/VirtualDJ/Mapper/ per chi usa PC
oppure /users/"NOME UTENTE"/Documenti/VirtualDJ/Mapper/ per chi usa Mac.

i file di mapping per il built-in (supporto nativo) dei controller appariranno in questa cartella solo se vengono modificati dall'utente tramite
CONFIG -> Mappers in VirtualDJ

L'elemento iniziale del file XML deve essere <mapper>, contenente queste caratteristiche:

-dispositivo: stringa univoca che identifica il controller, come utilizzato nel file di definizione

-autore: (opzionale) nome dell'autore di questo file xml

-descrizione: (opzionale) nome alternativo del controller da visualizzare in CONFIG -> Mappers

-versione: la versione minima di VirtualDJ per la quale il mapper è stato progettato Es:( 702 = 7.0.2)

-data: la data in cui il mapper è stato creato o aggiornato

-priorità: (opzionale) dà ad un mapper priorità più alta o più bassa rispetto ad un altro mapper creato per lo stesso controller,
ad esempio: -1 assegna una priorità più alta, 1 una priorità più bassa

Ogni pulsante mappato,manopola, slider, ecc. è definito da un elemento <map> figlio dell'elemento <mapper> con
le seguenti caratteristiche:

-valore: nome del pulsante, manopola, slider, ecc. mappato

-azione: azione VDJscript da eseguire quando si preme il pulsante,si sposta la manopola,ecc.

Esempio:

<?xml version="1.0" encoding="UTF-8"?>
<mapper device="MYCONTROLLER" author="Name" description="My Controller" version="702" date="14/03/2011">
<map value="CUE" action="cue_stop" />
<map value="PLAY" action="play_pause" />
<map value="JOG" action="jogwheel" />
<map value="PITCH" action="pitch_slider" />
</mapper>


Torna indietro

Wiki menù principale