How to program different DMX devices from Show Director

Show Director supports DMX devices in two ways.  First by providing a simple way to address a DMX controller, channel and value for that channel.  The second is by providing specific devices where multiple channels are used.  Below we will provide example of how each can be used.

Show Director allows for DMX devices to be added to any show script.  Different actions can be specified using the existing columns in your script.  One requirement for the DMX devices is that the TYPE column in your script must be exactly one of the supported DMX types.  For example, the SimpleDMX type must be specified in the TYPE column as "SimpleDMX".  Case and spelling do count.  Other columns will contain the additional information based on the DMX command.

SimpleDMX

The most basic of the DMX commands is a generic simple command.  This will set  one of the 512 channels to a specified value.  We allow for CUSTOM1 column to be used to over-ride the PIN column.  This is so that you can create Effects Manager entries to control the intensity value set to the PIN column.  If you put a numerical value in CUSTOM1, it will over-ride the value in PIN.  Otherwise, use the PIN column.

Here is an example of what a SD script might look like using SimpleDMX commands:

When the DUR column is zero, then the value place on the channel is permanent until changed again by another cue.  However, if a duration is provided, then the channel is set to the value in the PIN column for the specified time and then the channel is returned to zero.  The limit on duration is 99 seconds.

Galaxis G-Flame Flame Box

One of the specifically supported DMX devices is the G-Flame by Galaxis.  Like most flame boxes, the G-Flame has a safety channel as well as a trigger channel.  In order for the G-Flame to operate, the safety channel must first be turned on and later, for safety, must be turned off.  The G-Flame therefore has three command: GFlameSafetyOn, GFlameTrigger and GFlameSafetyOff.  These can be called multiple times during the show as long as the safety channel is on before any event triggers.  Note that multiple G-Flame devices can share a single safety channel.  Here are the SD columns and an example script:

Assuming two G-Flame boxes are configured with safety channel 33 and trigger channel 2 and 17 respectively:

You should always turn the G-Flame safety on for at least 1 second before any trigger events in order to give the flame box time to get activated.

Le Maitre Salamander Flame Box

The Salamander Flame Box is a specifically supported DMX device.  Like all flame boxes it has a safety channel and a trigger channel.  In order for the flame box to operate, the safety channel must be turned on before any trigger commands will activate.  For safety reasons we must also turn the safety channel back off at the end of the script.  The safety and triggers may be turned on or off any number of times as long as the safety is on before any trigger cues are executed.  The Salamander has three commands for this: SalamanderSafetyOn, SalamanderTrigger and SalamanderSafetyOff.  Note that multiple Salamander devices may use the same safety channel.

Here is an example SD script using two Salamander flame boxes with separate safety channels.  One has the safety channel on 1 and trigger on 2, the other safety is 3 and trigger 4.

You should always allow for 10 seconds after turning the Salamander safety channel on before any trigger events.

Explo X2 Wave Flame Box

The Explo X2 Wave flame box is specifically supported by SD.  This DMX device sports a moving flame head and is a little more complex the some other flame boxes.  SD takes care of this complexity through four commands: X2WaveSafetyOn, X2WaveTrigger, X2WaveSeq and S2WaveSafetyOff.  The X2 Wave device has a safety channel for each device and they cannot be shared.  A unique feature of the X2 Wave is that you only need to set the first channel of the device.  All other features are an offset from that first channel and therefore not required to be specified in the SD script.  There are 6 channels in use, so the base addresses for any other device must be 6 greater than the base address of the X2 Wave.  If the base channel of a X2 Wave flame box is 6, then the next DMX device on the controller must be set to 12 or higher otherwise you will have channel conflicts and errors.

Here is an example SD script using the X2 Wave.  Assume we have two devices set to base channel 10 and 16 respectively.

The build in sequences in the X2 Wave are nice in that cue 10 does the same thing as cues 6,7 and the duration of the flame is regulated by the sequence, not by the script writers estimation.

SafeX Flame Jet Flame Box

The SafeX Flame Jet flame box is another SD supported DMX device.  Like all flame boxes it has a safety channel and a trigger channel.  In order for the flame box to operate, the safety channel must be turned on before any trigger commands will activate.  For safety reasons we must also turn the safety channel back off at the end of the script.  The safety and triggers may be turned on or off any number of times as long as the safety is on before any trigger cues are executed.  The Flame Jet has three commands for this: FlameJetSafetyOn, FlameJetTrigger and FlameJetSafetyOff.  Note that multiple Flame Jet devices may use the same safety channel.

Assuming two Flame Jet boxes are configured with safety channel 33 and trigger channel 2 and 17 respectively:

You should always turn the Flame Jet safety on for at least 1 second before any trigger events in order to give the flame box time to get activated.

CRGBLight

A very common DMX controlled light is one with four channels that does Red, Green and Blue colors.  Show Director Control has provided a TYPE for this light.  The Control for the light is in the PIN (or CUSTOM1) column and is light specific as to how values control the light.  Typically 0 turns the light off and 255 will use the values of Red, Green and Blue to set color and intensity.  Your lamp may have other features that are controlled using the PIN column.  Consult your manual.  To specify a color, you need to have the start of the Effect Description have a '#RRGGBB' hexadecimal value.  These values are two hex characters each for red, green and blue.  So, for example, #FF0000 would be full red.  #00FF00 would be full Blue, etc.  #7F0000 would be half intensity red.  #00FFFF would be bright cyan.  If you provide a duration, the light will turn on for than amount of time and then turn itself off.

Here is an example of what a SD script might look like using CRGBLight commands:

PanTiltWRGBCYMLight

Another common DMX controlled light is one with 10 channels that does Pan, Tilt, colors.  Show Director Control has provided a TYPE for this light.  In this light, the color is determined by an internal color wheel that has 7 colors: White, Red, Green, Blue, Cyan, Yellow and Magenta.  To specify a color, you need to have the start of the Effect Description have a '#RRGGBB' hexadecimal value.  These values are two hex characters each for red, green and blue.  So, for example, #FF0000 would be full red.  #00FF00 would be full Blue, #00FFFF would be bright cyan, etc.  If you provide a duration, the light will turn on for than amount of time and then turn itself off.  In addition the light has a swivel head and can be panned or tilted.  You can pan through 360 degrees and tilt from 0 to 180.  The light can be pan/tilted while the light is off or on.

Here is an example of what a SD script might look like using PanTiltWRGBCYMLight commands:

Created with the Personal Edition of HelpNDoc: Single source CHM, PDF, DOC and HTML Help creation