VDJPedia



 ControllerDefinition_pt

NOTAS DE TRADUÇÃO : Uma vez que o XML é baseado em língua inglesa, somente comandos em inglês irão funcionar. Porém, para que você possa fazer uma correlação com o português, no decorrer do artigo o elemento PRINCIPAL será grafado separado por aspas (") enquanto que a tradução será posta entre parênteses(). Códigos não serão traduzidos, exceto strings de texto que não interferem no resultado final do código.
Do mesmo modo, caso necessite expressar números decimais, utilize "pontos" ao invés de "vírgulas" para separar o número inteiro da primeira casa decimal. Ex.:0.001




Arquivo para Definições de Controladores (Controller Definition)


No VirtualDJ 6 e 7, um controlador é definido por 2 arquivos: um arquivo de definições ("definition") e um arquivo de mapeamento ("mapper").
O arquivo de definições fornece um nome legível para cada código MIDI ou zona HID.
O arquivo de mapeamento associa cada nome à uma ação (action) no VDJscript.

Muitos controladores já possuem o arquivo de definições dentro do núcleo do VirtualDJ.
Se você tem um controlador que não é reconhecido nativamente pelo VirtualDJ, ou se você é um fabricante trabalhando em um novo controlador, é muito fácil criar um novo arquivo de definições para seu controlador.


Os arquivos de definições são arquivos XML padrão, e devem ser instalados na pasta Documentos/VirtualDJ/Devices/ (Windows) ou /Usuários/SEUNOME/Biblioteca/VirtualDJ/Devices (Mac).

A sintaxe do arquivo de definição depende da interface utilizada (HID ou MIDI):

Ver também:

- Diferenças entre protocolos HID e MIDI

- Como implementar um firmware HID



Os arquivos de mapeamento também são arquivos XML padrão, e devem ser instalados na pasta Documentos/VirtualDJ/Mappers (Windows) ou /Usuários/SEUNOME/Biblioteca/VirtualDJ/Mappers (Mac).

Arquivos de mapeamento para controladores com suporte nativo (de fábrica) somente aparecem na pasta "Mappers" se forem modificados, usando os recursos da aba CONFIG -> Mappers no VirtualDJ. Arquivos de definições para controladores com suporte nativo nunca aparecem na pasta "Devices".

O elemento raiz do arquivo XML deve ser <mapper>, com as seguintes propriedades:
- "device" (dispositivo): string único que identifica o controlador, igual ao utilizado no arquivo de definições.
- "author" (autor - campo opcional): nome do autor do arquivo XML
- "description" (descrição - campo opcional): nome alternativo do controlador que será exibido em CONFIG -> Mappers
- "version" (versão): versão minima do VirtualDJ para a qual o mapeamento foi desenhado (ex.: 702 = 7.0.2)
- "date" (data): a data em que o mapeamento foi criado ou atualizado pela última vez
- "priority" (prioridade - campo opcional): dá ao mapeamento uma prioridade maior ou menor sobre outro mapeamento para o mesmo controlador, ex.: -1 é a prioridade mais alta, 1 é a prioridade mais baixa

Cada botão, botão rotativo, deslizante, etc. mapeado é definildo por um item "filho" <map> do elemento <mapper> com as seguintes propriedades:
- "value" (valor): nome do botão, botão rotativo, deslizante, etc. a ser mapeado
- "action" (ação): ação VDJscript a ser executada quando o botão é pressionado, o botão rotativo é movido, etc.

Exemplo:
<?xml version="1.0" encoding="UTF-8"?>
<mapper device="MEUCONTROLADOR" author="Eu" description="MeuControlador" 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>



VOLTAR ao Indice

VOLTAR para VDJScript