Skip to main content

Full Example Walkthrough

This page ties DMX Files and DMXD Files together into one working example: a .dmxd definition file for a fictional controller, a .dmx sequence that uses it, and the command to compile both into MIDI.

1. Define your controller (obey70.dmxd)​

caution

There is currently a bug in 0.1.0 where the Range command types syntax doesn't work. Follow the syntax below and wait till this is fixed.

.alias obey70

.defines
blackout:midi_on = 0
s1x/8:midi_on = 10
  • .alias obey70 — the name this file answers to. It must match the .controller value in the .dmx file below.
  • blackout is an exact command with no argument.
  • s1x/8 is a range command: 8 slots starting at note 10. Typing s18 plays note 17 (10 + 8 - 1).

2. Write your sequence (intro.dmx)​

.controller obey70
.bpm 120
.channel 1
.commands

s11        ; scene 1, slot 1 (note 10)
delta 2       ; wait 2 seconds
loop 3
    s18      ; scene 1, slot 8 (note 17)
    delta 1
end
blackout
  • .controller obey70 matches the .alias obey70 above.
  • .commands is the last section header; everything after it is the actual sequence.
  • loop 3 ... end repeats the enclosed lines 3 times before continuing.

3. Compile it​

dmxc intro.dmx obey70.dmxd intro.mid

intro.mid is a standard MIDI 1.0 file on channel 1 at 120 BPM, ready to open in a DAW or send to your controller.