Page 1
LightJockey II
LightJockey Help file - (C) Martin Professional 2010
Page 2
Table of Contents
Overview
................................................................................................................................... 1Contents of help file
................................................................................................................................... 2Using this help file
Quick start and concepts
................................................................................................................................... 4Quickstart
................................................................................................................................... 11Basic programming terms and elements
................................................................................................................................... 14DMX addresses and links
................................................................................................................................... 15Cross fixture-type compatible effects
................................................................................................................................... 15Scene and fade times
Hardware configuration and setup
................................................................................................................................... 16Hardware setup
................................................................................................................................... 17Lightjockey Software License
................................................................................................................................... 17USB DMX Interfaces
................................................................................................................................... 18XLR cable connnections
................................................................................................................................... 19Updating the driver for the USB DMX interface
................................................................................................................................... 19Audio
................................................................................................................................... 22MIDI
................................................................................................................................... 22External control devices
......................................................................................1
......................................................................................4
......................................................................................16
.......................................................................................................................................................... 18Configuration
.......................................................................................................................................................... 19Audio setup
.......................................................................................................................................................... 20Audio CD control
.......................................................................................................................................................... 21Audio CD-ROM trouble shooing
The LightJockey desktop
LightJockey Help
......................................................................................24
................................................................................................................................... 24Main desktop window
................................................................................................................................... 25Configuring the desktop
................................................................................................................................... 27Desktop main menu
.......................................................................................................................................................... 27Main system menu
......................................................................................................................................................... 27Deleting multiple data files
......................................................................................................................................................... 28Using the data restore option
.......................................................................................................................................................... 29Main setup menu
......................................................................................................................................................... 30System preferences
......................................................................................................................................................... 32Startup options
......................................................................................................................................................... 33Default DMX output
.......................................................................................................................................................... 33Main view menu
......................................................................................................................................................... 34The unassigned fixtures list
................................................................................................................................... 34Tool- and status-bars
.......................................................................................................................................................... 34Sequence/cue tool bar
.......................................................................................................................................................... 35Cue list tool bar
.......................................................................................................................................................... 36LightJockey Offline Visualizer tool bar
.......................................................................................................................................................... 36Fixture tool bar
.......................................................................................................................................................... 37Status bar
................................................................................................................................... 38Fixture icon popup
I LightJockey Help file - (C) Martin Professional 2010
Page 3
................................................................................................................................... 39DMX output monitor
User libraries
......................................................................................42
................................................................................................................................... 42User libraries
................................................................................................................................... 44Backup & restore
Fixture configuration
......................................................................................46
................................................................................................................................... 46Fixture configuration
................................................................................................................................... 50Configuration warnings
................................................................................................................................... 51Copy from fixture
................................................................................................................................... 52Clear fixture data
................................................................................................................................... 53Applying default DMX to new fixtures
................................................................................................................................... 53Customizing built-in fixture profiles
.......................................................................................................................................................... 56The select bitmap dialog
Controlling and programming fixtures
......................................................................................58
................................................................................................................................... 58Selecting fixtures for control and programming
.......................................................................................................................................................... 58Selecting fixtures on the desktop
.......................................................................................................................................................... 59Next/previous fixture selection
.......................................................................................................................................................... 60Fixture groups
................................................................................................................................... 62Using generic DMX profiles
.......................................................................................................................................................... 62Generic DMX profiles
.......................................................................................................................................................... 64The generic DMX control
.......................................................................................................................................................... 67The RGB pack color control
................................................................................................................................... 69Fixture controls
.......................................................................................................................................................... 70Fade state buttons
.......................................................................................................................................................... 71Fixture control elements
.......................................................................................................................................................... 73User palettes
.......................................................................................................................................................... 74Intensity control
......................................................................................................................................................... 74Intensity controls for built in profiles
......................................................................................................................................................... 74Intensity controls for user defined profiles
.......................................................................................................................................................... 75Movement and position control
......................................................................................................................................................... 75Position control
......................................................................................................................................................... 78Position fan out
......................................................................................................................................................... 79Movement macros
......................................................................................................................................... 79Movement macro engine
......................................................................................................................................... 80Bézier shapes
......................................................................................................................................... 81Auto delay control
......................................................................................................................................................... 83Position presets
......................................................................................................................................................... 84Non pan/tilt movement controls
.......................................................................................................................................................... 85Color control
......................................................................................................................................................... 85Color controls for built in profiles
......................................................................................................................................................... 87Color controls for user defined profiles
.......................................................................................................................................................... 88Gobo control
......................................................................................................................................................... 88Gobo controls for built in profiles
......................................................................................................................................................... 90Gobo controls for user defined profiles
.......................................................................................................................................................... 90Beam control
......................................................................................................................................................... 90Beam controls for built in fixtures
......................................................................................................................................................... 91Beam controls for user defined profiles
.......................................................................................................................................................... 91Effect control
......................................................................................................................................................... 91Effect controls for built in profiles
......................................................................................................................................................... 93Effect controls for user defined profiles
.......................................................................................................................................................... 94Extended controls
LightJockey Help
II LightJockey Help file - (C) Martin Professional 2010
Page 4
......................................................................................................................................................... 94Extended controls for built in profiles
......................................................................................................................................................... 95Extended controls for user defined profiles
.......................................................................................................................................................... 95Lamp controls
......................................................................................................................................................... 95Lamp controls for built in fixtures
......................................................................................................................................................... 96Lamp controls for user defined profiles
.......................................................................................................................................................... 97Reset control
......................................................................................................................................................... 97Resetting fixtures, built in profiles
......................................................................................................................................................... 97Resetting fixtures, user defined profiles
Smoke machines and hazers
................................................................................................................................... 99Controlling DMX smoke machines and hazers
................................................................................................................................... 100The smoke control
The sequence control
................................................................................................................................... 102The sequence control
................................................................................................................................... 103Save sequence dialog
................................................................................................................................... 105List of sequences
................................................................................................................................... 106Inserting scenes
................................................................................................................................... 106Deleting scenes
................................................................................................................................... 107Sequence blind mode
................................................................................................................................... 107Snapshot and recording from DMX output
................................................................................................................................... 109Sequence fades
The cue control
................................................................................................................................... 111The cue control
................................................................................................................................... 114Save cue dialog
................................................................................................................................... 115List of cues
................................................................................................................................... 120Cue control columns and slot colors
................................................................................................................................... 121Modifying sequence slot labels
................................................................................................................................... 122Trigging sequences in the cue
................................................................................................................................... 123Sequence slot loop options
................................................................................................................................... 124Cue time control
................................................................................................................................... 125Cue macro control
................................................................................................................................... 127Transparent cues
................................................................................................................................... 127Sequence intensities
................................................................................................................................... 128The cue builder
......................................................................................99
......................................................................................102
......................................................................................111
.......................................................................................................................................................... 118Cue pages
The generic DMX macro
LightJockey Help
......................................................................................131
................................................................................................................................... 131Generic DMX macros
................................................................................................................................... 134The Generic DMX macro editor
................................................................................................................................... 136The macro shapes lists
................................................................................................................................... 137Macro visualization and tracking panel
................................................................................................................................... 138The fixture channel list
................................................................................................................................... 139Generic macro parameters
................................................................................................................................... 140Generic macro delays
III LightJockey Help file - (C) Martin Professional 2010
Page 5
................................................................................................................................... 142Save macro dialog
................................................................................................................................... 143Select macro list
The background cue
................................................................................................................................... 145Using the background cue
................................................................................................................................... 147List of background cues
The cue list control
................................................................................................................................... 148The cue list control
................................................................................................................................... 154Save cue list dialog
................................................................................................................................... 154List of cue lists
................................................................................................................................... 155Cue list commands
................................................................................................................................... 157Using time code in cue lists
................................................................................................................................... 159MIDI/SMPTE time code
................................................................................................................................... 161Launching external programs from the cue list
................................................................................................................................... 161Using the LightJockey MediaPlayer
................................................................................................................................... 163Playing multiple, simultaneous media files from the cue list
................................................................................................................................... 164Using Winamp for digital audio playback
................................................................................................................................... 165Winamp time code issues
The statics control
................................................................................................................................... 168Static merge and replace modes
......................................................................................145
......................................................................................148
......................................................................................167
Using audio input
Global functions
................................................................................................................................... 173Global intensity control
Host i.n..t..e..n...s..i.t.y.. .c..o...n..t.r..o..l. ............................................................................................................................ 173
................................................................................................................................... 176Freeze output
................................................................................................................................... 176Offline / Online switch
................................................................................................................................... 176Follow spot function
................................................................................................................................... 178Fixture solo function
................................................................................................................................... 178Global patching
Hotkeys
................................................................................................................................... 182Using hotkeys
................................................................................................................................... 183Hotkey functions
External control
................................................................................................................................... 189Fingers for LightJockey
......................................................................................170
......................................................................................173
.......................................................................................................................................................... 173Blackout/restore
.......................................................................................................................................................... 178Global patch dialog
......................................................................................................................................................... 181HTP groups
......................................................................................182
......................................................................................189
.......................................................................................................................................................... 189Introduction to Fingers
.......................................................................................................................................................... 189Fingers setup
.......................................................................................................................................................... 191Fingers controls overview
.......................................................................................................................................................... 194Fingers status panel
LightJockey Help
IV LightJockey Help file - (C) Martin Professional 2010
Page 6
.......................................................................................................................................................... 194Configuring and using the function buttons
.......................................................................................................................................................... 196Configuring and using the scroll buttons
.......................................................................................................................................................... 197Configuring and using the cue slot button functions
.......................................................................................................................................................... 198Configuring and using fader and bump functions
.......................................................................................................................................................... 201Configuring and using jog-wheel functions
.......................................................................................................................................................... 201Fingers multi select mode
.......................................................................................................................................................... 202Virtual Fingers
................................................................................................................................... 203Using the 2532 direct access controller
.......................................................................................................................................................... 2032532 direct access
.......................................................................................................................................................... 203The 2532 layout
.......................................................................................................................................................... 204Configuring the 2532 controller
.......................................................................................................................................................... 208Printing the 2532 configuration
.......................................................................................................................................................... 208Emulating the 2532
................................................................................................................................... 209Using DMX in
.......................................................................................................................................................... 214DMX in translation
......................................................................................................................................................... 216Editing translation tables
................................................................................................................................... 217Using MIDI in
................................................................................................................................... 219Using the 2518 controller via RS-232
.......................................................................................................................................................... 2192518 controller via RS-232
.......................................................................................................................................................... 2202518 controller via RS-232, mode 2
.......................................................................................................................................................... 2212518 controller via RS-232, mode 1
................................................................................................................................... 222MC-X remote control
................................................................................................................................... 223RS-232 remote control
User definable fixture profiles
......................................................................................225
................................................................................................................................... 225The user definable fixtures profiles
................................................................................................................................... 225Scanner 1 profile
.......................................................................................................................................................... 225Configuring the Scanner 1 profile
.......................................................................................................................................................... 226Defining the Scanner 1 profile
.......................................................................................................................................................... 226Defining Scanner 1 intensity control
.......................................................................................................................................................... 228Defining Scanner 1 pan & tilt control
.......................................................................................................................................................... 229Defining Scanner 1 color control
.......................................................................................................................................................... 230Defining Scanner 1 gobo control
.......................................................................................................................................................... 231Defining Scanner 1 level control
................................................................................................................................... 232Color Scroller 1
.......................................................................................................................................................... 232User Definable Fixtures - Color Scroller 1
.......................................................................................................................................................... 232Defining the Color Scroller Profile
................................................................................................................................... 233Generic fixture type 2 profile
.......................................................................................................................................................... 233Defining the generic fixture 2 profile
.......................................................................................................................................................... 235Applying profile data to multiple fixtures
.......................................................................................................................................................... 235User definable dynamic functions
.......................................................................................................................................................... 236User definable static functions
.......................................................................................................................................................... 237User definable palettes
.......................................................................................................................................................... 240The fixture info tab
.......................................................................................................................................................... 242The intensity & lamp tab
.......................................................................................................................................................... 244The pan & tilt tab
.......................................................................................................................................................... 247The fixed color tab
.......................................................................................................................................................... 247The CMY & RGB tab
.......................................................................................................................................................... 249The gobo tab
.......................................................................................................................................................... 250The beam tab
.......................................................................................................................................................... 251The effects tab
.......................................................................................................................................................... 251The special tab
.......................................................................................................................................................... 253The levels tab
.......................................................................................................................................................... 254The Offline Visualizer tab
LightJockey Help
V LightJockey Help file - (C) Martin Professional 2010
Page 7
.......................................................................................................................................................... 255Creating custom bitmaps for palette controls
.......................................................................................................................................................... 256Creating custom bitmaps for fixture icons
................................................................................................................................... 256Importing and exporting profiles
.......................................................................................................................................................... 256Importing user defined fixture profiles
.......................................................................................................................................................... 257Exporting user defined fixture profiles
................................................................................................................................... 258External application/device profile plug in
Real time visualizing
................................................................................................................................... 260Martin Showdesigner MC Edition
................................................................................................................................... 260Interfacing with Capture
LJ Manager
................................................................................................................................... 263LJ Manager plugin
The 2510 playback controller
................................................................................................................................... 265Using the 2510 playback controller with LightJockey
................................................................................................................................... 266Creating a sequence list for the 2510 controller
................................................................................................................................... 269Generating the 2510 download file
................................................................................................................................... 270Downloading the 2510 download file
................................................................................................................................... 270Using the 2510 for playback
................................................................................................................................... 2712510 memory test
................................................................................................................................... 272Binary 2510 files
......................................................................................260
......................................................................................263
......................................................................................265
Creating download files for the 2518
controller
......................................................................................273
Release notes
................................................................................................................................... 275Version 2.100
................................................................................................................................... 275Version 2.95
................................................................................................................................... 275Version 2.9
................................................................................................................................... 276Version 2.8
................................................................................................................................... 276Version 2.7
................................................................................................................................... 278Version 2.6
................................................................................................................................... 283Version 2.5
................................................................................................................................... 286Version 2.3
................................................................................................................................... 287Version 2.2
................................................................................................................................... 289Version 2.1
................................................................................................................................... 291Version 2.0
......................................................................................275
LightJockey Help
VI LightJockey Help file - (C) Martin Professional 2010
Page 8
Overview
Contents of help file
See Release notes
See Using this help file
Contents - overview
Basic programming terms and elements
Programming quick start
Hardware setup
Fixture configuration
User definable fixtures and creating new profiles
DMX smoke machines and hazers
DMX addresses and links
Main desktop window
Configuring the desktop
Desktop main menu
Selecting fixtures
Tool and status bars
Fixture controls
The generic DMX control
The sequence control
The cue control
The cue list control
The background cue
The statics control
Generic DMX macros
Follow spot functions
Global patch
Default DMX output
HTP groups
Startup options
Using audio-in
Using time code in cue lists
Using the LightJockey MediaPlayer
LightJockey Help
1 LightJockey Help file - (C) Martin Professional 2010
Page 9
Backup and restore
Using the data restore option
Hotkeys
Fingers for LightJockey
2532 direct access
DMX In remote control
MIDI In remote control
Martin MC-X remote control
Martin 2518 Controller via RS-232
Using the 2510 playback controller.
RS232 remote control
External devices and applications
Controlling RGB fixtures
Martin Showdesigner MC Edition
LJ manager (plug-in)
Interfacing with Capture
Using this help file
Changing the help file
the LightJockey help file may be available in different languages. To select between different help files
use Select Help file from the main help menu.
Please note that any non-English help-files may not document the latest changes and updates (see
LightJockey Help
2 LightJockey Help file - (C) Martin Professional 2010
Page 10
Release Notes for the helpfile in question).
While an updated version of the English help file is always shipped with LightJockey it may be
necessary to update the non-English help files when they become available.
The latest releases are available from the Martin Website at http://www.martin.com/service/default.
asp?product=lightjockey and the latest beta release usually via the LightJockey forum at www.martin.
com/forum/
Topic help from within LightJockey
Most windows and controls in LightJockey has a Help entry in the local menu. If present, clicking
Help opens the help file on a help topic that relates to the function(s) of the window/control itself.
The help file as PDF
The help file is also supplied in PDF format on the CD. The latest PDF version may be downloaded via
the LightJockey end-user forum at www.martin.com/forum/.
Adobe Acrobat reader or another PDF reader application is required to read PDF documents - at the
time of writing this a free version of the Acrobat reader can be downloaded from www.Adobe.com.
A print out of the entire help file should be made via the PDF file.
LightJockey Help
3 LightJockey Help file - (C) Martin Professional 2010
Page 11
Quick start and concepts
Quickstart
Programming LightJockey
Introduction to programming
This short introduction will help you get started using the Martin LightJockey quickly. It assumes that
you have some basic experience programming moving lights and are familiar with Windows. Additional
information is available in this on-line "Help" documentation.
If you are a Martin 3032 programmer
Programming with the LightJockey is similar in many ways to programming with the 3032 Controller.
Fade times and the Off/Snap/Fade control, however, will be new features to 3032 programmers.
The best way to learn your way around the LightJockey is to experiment. As you try the controls, be
aware that clicking with the left and right mouse buttons often do different things. Note: depending on
software version, screens and button names may differ from those shown here.
LightJockey Desktop
Configuring fixtures
The first step after configuring the hardware is to select and address your lighting fixtures in the
Fixture Configuration window. In the following example, the LightJockey is set up to control 2 MAC
600s.
1. Choose Setup > Fixture Configuration from the main menu.
2. Select "MAC 600 (mode 2/4)" from the list of Available Fixture Types (found under the Martin
3. If the addresses are already set on the fixtures, click the fixture, select the DMX link it's on, and
4. If you want the controller to automatically assign addresses, click Auto Address. Click Find
LightJockey Help
Manufacturer heading). Drag and drop it on line 1. Add another MAC 600 to line 2. (Multiple
fixtures can also be added using the Add (fixture name) button.)
enter its address in the DMX Address field.
4 LightJockey Help file - (C) Martin Professional 2010
Page 12
Addresses and then click Ok. Remember to set the addresses on the fixtures to match the
LightJockey's fixture configuration.
5. Click the first MAC 600. Type "Left" in the Fixture Username field.
6. Click the second MAC 600 and name it "Right."
7. Save the configuration and close the window.
Configuring the desktop
Lighting fixtures are represented by icons on the desktop. To create and place icons you drag fixtures
from the Unassigned Fixtures list to the desktop. Icons can be organized any way you like on multiple
pages or "tabs."
1. The list of unassigned fixtures is displayed on the desktop automatically. It can also be opened
by selecting View > Unassigned Fixtures from the main menu.
2. Drag the MAC 600s to the desktop.
3. Right-click on the desktop. Select Icons > Auto Arrange. Click OK. Additional menus pop up
when you right-click on the icons but we are not concerned with these now.
Key LightJockey concepts
Understanding these concepts is critical for successful programming with the Light-Jockey. Don't
LightJockey Help
5 LightJockey Help file - (C) Martin Professional 2010
Page 13
worry if they are new to you, the programming example that follows is designed to illustrate them and
they will make more sense once you have been through it.
Cues, sequences, and scenes
A light show is typically divided into cues that you program and then play back from the list of
available cues. The LightJockey also supports cue playback several external units such as the Martin
2532 Direct Access Controller.
A cue 'points' to up to 12 sequences that run together in parallel. In addition to these pointers, cues
have some additional sequence timing and loop options.
A sequence is a set of scenes that run one after the other. A sequence can have from 1 to
999 scenes.
A scene is a set of instructions for selected fixtures. These instructions are made up of a static
command, a fade time, and a scene time. A static command is one or more instructions such as
"insert the red filter" or "rotate the triangle gobo counterclockwise." Fade time is the time it takes, for
example, for the color to change from blue to red. Scene time is simply how long the scene lasts
before the next scene in the sequence is executed. If scene time is greater than fade time, the fixture
fades to the position and stops.
Current cues and current sequences
To program cues and sequences you either create new ones or load existing ones using standard
Windows techniques such as dragging and dropping. Once loaded or created from new they become
the current cue or current sequence.
The current cue is displayed differently from the current sequence. The action of the current cue is
shown by changes in the relevant control windows. The pan/tilt cursor in the movement window, for
instance, slides back and forth to show a pan movement. This feature lets you see the program
without actual fixtures.
The controls for effects programmed in the current sequence, however, stand still so you don't have to
catch a moving target as you work. The pan/tilt cursor, to take the previous example, stops moving
when you load the movement sequence onto the desktop. To see the sequence run again you have to
clear it from the desktop by loading another sequence or clicking New/Clear Sequence on the
Sequence toolbar.
Bottom to top execution
Understanding the order of execution in the cue is vital for successful programming. The Light-Jockey
executes the current sequence first and then executes the current cue from bottom (sequence 12) to
top (sequence 1). When two sequences contain instructions for the same effect, the sequence
closest to the bottom has priority; instructions in the sequence closest to the top are not executed.
Off/Snap/Fade control
Most effect controls have an Off/Snap/Fade (O/S/F) button. In the default setting, the button is red and
displays "Off." Clicking the red Off button once turns it into a yellow "Snap" button. Clicking again
turns it into a green "Fade" button. Some controls, such as
the Lamp Control, have Off and Snap only.
When an effect's O/S/F button is Off, the control sends no instructions. This allows a lower-priority
sequence to control that effect. It does not turn off the effect itself. The dimmer O/S/F button must be
Off in sequence 10, for example, if you want to program a
dimmer command in sequence 9 or below.
When you set an effect's O/S/F button to Snap, the effect moves at maximum speed.
When you set an effect's O/S/F button to Fade, the effect's speed is determined by the fade time. To
program a scene with a 10-second pan movement, you would first define the movement with the
cursor, then set the Pan O/S/F button to Fade, and finally set the scene and fade times to 10
seconds.
Setting an effect's O/S/F button to Snap or Fade overrides all programming for that effect in higher
sequences in the cue. Leave the button on Off (the default) unless you are programming a command.
Striking lamps
Most Martin fixtures with discharge lamps, also known as arc lamps, must be struck (turned on) from
LightJockey Help
6 LightJockey Help file - (C) Martin Professional 2010
Page 14
the controller. There are three ways to do this:
Use the LightJockey's automatic lamp-strike feature. This is recommended and is described in the
following example.
Program a "lamp on" cue. This is not recommended because Martin fixtures use the same DMX
channel for lamp and shutter control. Therefore, the lamp-on command will be overridden by any
higher-priority sequence with a shutter command. If you choose to program a "lamp on" cue, turn
on the lamps one at a time with 3 - 5 second intervals to avoid excessive voltage drop and current
draw.
Strike a lamp manually by selecting it, clicking the Lamp button on the fixture tool-bar, and clicking
Power On in the Lamp Control dialog. Depending on the fixture, the Lamp Control may also allow
you to turn off the lamp.
Example: Programming a cue
The following example, in which you program a simple cue for 2 MAC 600s, demonstrates the basic
steps and concepts involved in programming. To keep you focus on the screen, it is suggested that
you program the first cue without fixtures attached.
The screens shots show how your screen will look if you follow the steps correctly.
Step I: Strike lamps
This step only applies if you have actual fixtures connected to the controller.
1. Configure 2 MAC 600s and place them on the desktop.
2. Turn on the MAC 600s, set them to mode 4, and set their addresses to match the LightJockey
fixture configuration.
3. Choose System > Auto Strike Lamps from the main menu. Click Stop when the lamps have
struck.
Step II: Program shutter/dimmer sequence
In this step you program a sequence to open the shutters and set the dimmers to 20%.
1. Configure 2 MAC 600s and place them on the desktop if you have not done so.
2. Click New/Clear Sequence on the Sequence toolbar. The new (blank) sequence is indicated by a
gray Sequence name field.
3. Click both MAC 600s to select them. The fixture icon caption is blue when the fixture is not
selected and red when it is selected.
4. Click Show Fixture Controls on the Fixture toolbar (see page 1). Arrange the control windows any
way like by dragging them on the desktop. Since you will not be using the Beam control in this
example, you can close it to make more room on the desktop. Individual controls can be opened
and closed as needed by clicking buttons on the Fixture toolbar.
5. Find the Intensity dialog (see below). Click the shutter control. Three things happen: "Shutter
Closed" changes to "Shutter Open," the shutter O/S/F button automatically changes to Snap,
and the Sequence Name field in the Sequence toolbar changes from gray to yellow, indicating
that the new (blank) sequence has been changed.
6. Drag the dimmer level to 20%. Click the dimmer O/S/F button twice to Snap.
7. Verify that your Intensity control looks like the one above and that the O/S/F buttons
in all other controls are off.
8. Click Save Sequence in the Sequence toolbar. Type "20% dimmer" in the dialog's
Sequence Name field. Click Save as New Sequence or press Enter.
LightJockey Help
7 LightJockey Help file - (C) Martin Professional 2010
Page 15
Step III: Add sequence to Cue
Checking "Add Sequence to Current Cue" in the Save Sequence dialog would have automatically
added the sequence to the current cue when saving. Windows techniques such as drag and drop can
also be used to add, delete, and rearrange items in lists.
1. Click List of Sequences on the Sequence toolbar.
2. Click View Cue Control on the Cue toolbar.
3. Drag the "20% dimmer" sequence to position 1 in the cue. (If drag mode is not enabled, choose
Preferences > Drag mode from the Select Sequence dialog menu.)
Step IV: Program CMY sequence
The next sequence is a CMY (cyan, magenta, yellow) color chase with 3 scenes. In the first scene,
cyan fades in and yellow, which comes in scene 3, fades out. In the second scene, cyan fades out
and magenta fades in. Finally, magenta fades out and yellow fades in. The scene and fade times for
each scene is set to three seconds for a smooth continuous effect.
1. Close the cue editing and sequence list windows.
2. Click New/Clear Sequence on the Sequence toolbar.
3. Make sure both MAC 600s are selected: a fixture is selected when the icon caption is red. Drag
and drop sequences to cues.
4. Place the cursor over the cyan fader and drag it to 100%. The O/S/F button automatically
changes to Fade.
5. Click View Sequence Control in the Sequence toolbar.
6. Click the "Synchronize Scene and Fade Times" box. Set the scene (and fade) time to 3
7. Click Add Scene in the Sequence dialog.
LightJockey Help
seconds.
8 LightJockey Help file - (C) Martin Professional 2010
Page 16
8. Drag the Cyan fader to 0%. Drag the Magenta fader to 100%.
9. Click Add Scene in the Sequence dialog.
10. Drag the Magenta fader to 0% and the Yellow fader to 100%.
11. Now you need to change scene 1 to fade out yellow. Scroll to scene 1 of 3 by clicking Next
Scene (not Add Scene) in the dialog.
12. Yellow is already at 0% so you only need to click its O/S/F button to Fade.
13. Click Save Sequence in the Sequence dialog or toolbar.
14. Click the "Clear after Save" and "Add Sequence to Current Cue" boxes in the Save Sequence
15. Type "CMY chase" in the name field.
16. Click Save as New Sequence or press Enter. Notice how the CMY faders move once the
Step V: Program movement sequence
The LightJockey features a sophisticated engine for generating pan/tilt movements. The effects engine
is not described here but detailed information is available in the on-line help. In the first two
sequences, both fixtures were programmed together to do the same thing. In this sequence you
program each fixture individually to move in opposite directions.
1. To program "Left" MAC 600, select it and deselect the "Right" MAC 600.
2. If the pan/tilt control window, shown below, is not open, click Movement on the Fixture toolbar.
3. Drag the movement cursor to the middle of the top-right quadrant. Click the Pan and the Tilt O/S/
LightJockey Help
dialog.
sequence has been saved, cleared, and added to the current cue.
9 LightJockey Help file - (C) Martin Professional 2010
Page 17
F buttons twice to Snap.
4. Click the "Left" MAC 600 to deselect it; select the "Right" MAC 600.
5. Drag the movement cursor to the middle of the top-right quadrant.
6. Click the Pan O/S/F button and the Tilt O/S/F button to Snap.
7. Open the Sequence Control if it is closed by clicking View Sequence Control. Set the scene time
to 2 seconds.
8. Click Add Scene in the Sequence dialog. Click Synchronize Scene and Fade Times. Set the
scene (and fade) time to 15 seconds.
9. Drag the movement cursor to the middle of the top-right quadrant. Click the Pan O/S/F button to
Fade.
10. Click the "Right" MAC 600 to deselect. Select the "Left" one.
11. Drag the movement cursor to the top-left quadrant and click the Pan O/S/F button to Fade.
12. Click Save Sequence on the Sequence toolbar. Type "Pan" in the Sequence Name field. Click the
"Clear after Save" and "Add Sequence to Current Cue" boxes. Click Save as New Sequence or
press Enter.
If you programmed the sequence as described, the movement cursor will move slowly from left to right
if when you select the "Left" MAC 600 and from right to left when you select the "Right" one.
Step VI: Edit movement sequence
This step demonstrates how to edit a programmed sequence. Here you edit the pan sequence to
black out both fixtures in the first scene.
1. Click List of Sequences on the Sequence toolbar.
2. Drag the "Pan" sequence to the desktop. Close the sequence list. Notice that the cursor in the
Movement control stopped moving.
3. Open the Sequence Control if it is closed. Click Next Scene to advance to scene 1 of 2.
4. Select both MAC 600s.
5. Click the shutter control in the Intensity dialog. It changes from "Shutter Open" to "Shutter
Closed." Click, if necessary, to set the shutter O/S/F button to Snap.
6. Click Save Sequence on the Sequence toolbar or in the Sequence dialog. To save the changes to
the sequence, click Save Sequence or press Enter. Click OK to confirm.
Step VI: Save the cue
Cues are handed much like sequences.
1. Click Save Cue on the Cue toolbar.
2. Type "M600 CMY pan" in the Cue Name field.
3. Click Save New or press Enter.
Step VII: Edit the cue
This step demonstrates how sequence order effects cue playback. Look at the Intensity control: the
shutter closes for 2 seconds because of the command in the pan sequence. This sequence has the
highest priority because it is closest to the bottom. When you put the 20% dimmer sequence
underneath the pan sequence, the 20% dimmer sequence takes priority and keeps the shutter open
all the time. With a little planning, you can create different looks using the same sequences just by
changing their order.
1. Click New/Clear Cue on the Cue toolbar to clear the cue from the desktop. (This is not required; it
just helps demonstrate how to load cues.)
2. Click List of Cues on the Cue toolbar.
3. Drag the "M600 CMY pan" cue to the desktop. Its name appears in the Cue name field and the
cue begins to run. Close the list of cues to make room on the desktop.
4. Click View Cue Control on the Cue toolbar.
5. Drag the "20% dimmer" sequence from position 1 to position 4. Select Move Sequence from the
popup dialog.
6. Click Save Cue in the Edit Cue window or on the Cue toolbar.
7. Click Save. Click OK in the confirmation dialog.
8. Look at the Intensity control: the shutter now stays open all the time.
LightJockey Help
10 LightJockey Help file - (C) Martin Professional 2010
Page 18
Additional cue operations
When editing cues, remember that the current sequence has highest priority. Normal cue execution
resumes when the current sequence is cleared. Note too that to synchronize the sequences in the
current cue, you must clear the cue and reload it onto the desktop.
To create a new cue and/or clear the current one, click New/Clear Cue.
To load a cue, click List of Cues and drag it from the List of Cues to the desktop. Click View Cue
Control to open the Edit Cue window. Here, sequences can be added, removed, rearranged,
loaded, etc.
To adjust cue timing, open the Cue Edit window and click Cue Times at the bottom. The cue
Host fader adjusts times (as a percent) for all sequences set to "CUE" time. Setting a sequence
fader to another value overrides the Host cue fader.
Basic programming terms and elements
Fixtures
This term is used throughout the LightJockey to describe the 'equipment' that the LightJockey can
control. The term may not only be confined to lighting fixtures, but everything that might be controlled
from LightJockey via DMX protocol, such as smoke machines or motor control.
Fixture profiles and protocols
Controlling fixtures via DMX is actually not a very 'intelligent' method of control. There are (for various
reasons, some of them good reasons) no industry standards for commands like "go to red" or "move
to home position". This means that each type of fixture has it's own set of command values - the
fixture DMX protocol. On generics DMX consoles, usually equipped with faders to set values, it is
necessary for the programmer to know the correct command values to send and also which channel
or address to send these value to. Most modern control systems implement more or less
sophisticated fixture 'personalities' to hide the protocols from the end-user. LightJockey implements
graphical 'personalities' or profiles for most DMX capable fixtures, this means that the user does not
need to know anything about DMX values or addresses to program fixtures. While not essential, a
good understanding of how the DMX protocol works is definitely an advantage when trying to get the
most out of LightJockey programming.
See also DMX addresses and links, Generic DMX fixtures, User definable fixture profiles
Scene
A scene is the most basic programming element in LightJockey. In other types of consoles and
controllers this is also known as a memory. Unlike most other consoles, LightJockey does not refer
to individual memories, scenes only exists as part of sequences (see later).
Each scene in LightJockey contains information for all fixtures and all their effects.
Usually, only a small number of the fixtures/effects will be programmed in a scene as LightJockey
offers methods to combine and layer several 'scenes' to create a final output (e.g. in a cue). So most
of the time an effect will probably be "unused" or "off" in a given scene (see off/snap/fade).
A good analogy to a scene in LightJockey is a single picture frame on a roll of film. As the picture
frame, a scene only contains static information, so a scene cannot contain both red and blue color
commands for the same color wheel on the same fixture. Like the film, the 'animation' or changes
happen when the film progresses through the individual picture frames to form a movie. This is what
happens when one scene is replaced by another scene, as in a sequence or when replacing one cue
with another cue.
As mentioned, the scene only contains static commands, note however that not all static commands
to fixtures result in a static 'expression'.
For example a command to a fixture to strobe or rotate it's color wheel will result in a 'dynamic'
expression - in this case the static command specifies a strobe-frequency or rotation speed but the
fixture performs the actual dynamic.
LightJockey Help
11 LightJockey Help file - (C) Martin Professional 2010
Page 19
Another notable exception which is dynamic in expression are the movement macros that moves the
light around in geometric patterns. Although the information to move the light in a circle has a
dynamic expression (the movement in a circle) - the parameters that determine the 'dynamics' are still
static within the scene.
Sequence
A sequence is the cornerstone of programming in LightJockey. A sequence consists of one or more
scenes chained together in a sequential order. If the sequence contains more than one scene, the
sequence can 'animate' the fixtures by executing scenes with different contents, like the film strip with
different picture frames. The default behavior for a sequence when it reaches the last scene, is to loop
back to the first scene to get a continuous execution of the sequence.
A very simplified example is a sequence containing 3 scenes:
Scene 1 instructs a fixture equipped with a color wheel to go to red, scene 2 instructs the fixture to go
to yellow and in scene 3 the fixture is instructed to go to green. When this sequence is played back
in the default loop mode, the sequence will 'animate' the color of the fixture through the 3 colors, and
after scene 3 it will loop back and start with scene 1 and the red color again.
Scene and Fade times
The sequence also contains parameters that dictate how the animation is supposed to take place.
First of all there is the scene time. In the previous example, a scene time of 1 second for all scenes
would have LightJockey advancing through the sequence, with each scene being replaced by the next
scene after 1 second of 'on time'. Scene times can be set individually for each scene in the sequence
with the sequence control, e.g. scene 1 may have a scene time of 1 second, while scenes 2 and 3
may have a scene time of 0.5 and 2 seconds respectively.
The sequence also contains a fade time for each scene. The fade time dictates how long time the
physical transition will take from the position (e.g. color wheel position) programmed in the previous
scene, to the position programmed in the current scene.
Here the film analogy might be used again. A film shot showing a person walking from one side of the
scene to the other side requires 'a lot' of individual pictures in between the two positions to get
'smooth' movement. The way to make making slow, smooth movements like this with LightJockey is
to program the two end points (colors in the example) in two scenes, and then let LightJockey
calculate all the positions (pictures in the analogy) in between the two end points. This is exactly
what using fade time and fading an effects does.
With the previous color example, setting a fade time of 3 second for each scene, would mean that
each color change takes 3 seconds. The way this works is that LightJockey calculates all the
possible positions between the two colors, and outputs these values at a calculated rate so that the
fixture moves the color wheel from one position to the next in one smooth movement taking exactly 3
seconds (note, some fixtures will not allow slow transitions between colors or other types of effects this is a restriction of the fixture's DMX protocol, not LightJockey).
Note that in order for an effect to fade from one position to the next, the fade state of that effect must
be set to fade. See off/snap/fade
A sequence does not have to contain more than one scene - in this case, the sequence is called
static sequence. While the scene time no longer is relevant since there will be no progression in the
sequence, the fade time still controls the transition time from the previous effect position (whatever
that was) to the one programmed into the scene.
See also Scene and fade times, Sequence control
Cues
A cue is a construction that contains up to 12 sequences to be executed run in parallel. Although
LightJockey allows playback of single sequences, the cue offers much more flexibility in terms of
dynamic and combination options.
LightJockey Help
12 LightJockey Help file - (C) Martin Professional 2010
Page 20
It is important to understand that the cue only contains references to the sequence, not the actual
sequences themselves. This means that if a sequence is edited to a new contents, this change will
take effect in ALL cues that contains a reference to this sequence. It also means that it is not
necessary to re-save cues just because the sequence has been changed, the changes will implement
automatically.
It is normally not desirable to program every fixture and effect into the same scene, even to obtain the
'complete look'. The reason for this, is that by combining a number of sequences each with elements
that together forms the complete look, it is much easier to re-use some of these elements to obtain
other looks. It is also the only way of obtaining simultaneous different fade times on different effects in
the same fixture, as the sequence only allows one fade time pr scene, e.g when combining a slow
color change with a fast speed intensity chase.
An example is a very simple cue consisting of 3 sequences:
- Sequence 1 contains instructions to all fixtures output light with full intensity (static sequence)
- Sequence 2 contains information to all fixtures to fade between red, green and blue colors (non-
static sequence)
- Sequence 3 contains information that moves the fixtures beams around in a pattern (non-static
sequence)
The combined result has the fixtures moving around in the complex pattern, all changing between the
colors and all with full intensity.
By replacing sequence 1 with another static sequence that orders the fixtures to strobe on full
intensity, a different expression has been created. Still the same colors changes, still the same
movements, but now the fixtures are strobing rather than having full intensity. To obtain the same
result in a single sequence, all scenes would have to be edited so that they contain a strobe
command and not full intensity for all fixtures.
Another example would be to have the original cue running, but two of the fixtures should point to a
specific location in open white at 50% intensity, while all the other fixtures still moves the beam
around in the pattern and changing colors.
Without the cue construction, the only way to do this would be to edit the two fixtures in every scene
of the sequence, creating a new sequence with this look particular look.
However, by using the cue and its rules of priority (see below), it is possible to write just a single
static sequence instructing just these two fixtures to go to the position in open white with the right
amount of intensity. This static sequence is then added at a priority position within the cue and takes
control over only the programmed fixtures - the rest still runs the original cue since they are not at all
affected by the new sequence.
The way the priority works within the cue is not related to fixtures, rater to individual fixtures/effects
(DMX control channels to be precise). How to program the sequences and use the cue is very much
up to individual tastes, and most likely also fixture types and fixture count.
Some programmers programs complete fixtures, or groups of fixtures into sequences including all
desired effects for these fixtures. They then use the cue to combine different groups of fixtures, each
group of fixtures contained in it's 'own' sequence. Other programmers swear to modularity and only
programs single effects into sequences. E.g. color information in one sequence, gobo information in
another, movement information in a third sequence and so on. By combining these sequences in the
cue they create complete looks.
Most programmers however, tends to use some from both methods. There are no rules governing how
to use the cue - in the end it is up to personal preferences.
See cue control for more details.
LightJockey Help
13 LightJockey Help file - (C) Martin Professional 2010
Page 21
Cue list
The cue list offers a way to playback cues in a pre-determined order. The cue list may be
synchronized to internal PC clock for elapsed time between cues or to time code from a CD-ROM
drive or Windows Media files. It can also be executed manually using a 'go-button', if for example used
in a theatrical type of show where everything is planned and pre-programmed.
See cue list control for more details
The current sequence
It is important to understand that the LightJockey always contains a 'current sequence'. Think of the
current sequence as a 'holder' for sequences when editing a sequence. When saving a sequence, it is
always the current sequence that is being saved, and when loading an already saved sequence, the
sequence is being loaded 'into' the current sequence for editing.
In principle the current sequence always contributes to the final DMX output of the LightJockey however if the current sequence does not contain any 'instructions' (for example after a New Sequence
command has been executed) there will be no visible effect of the current sequences contribution to
the overall output.
The current cue
In the same way as the current sequence the LightJockey always have a current cue. The current cue
acts as a 'holder' for cues when editing, and when playing back cues, it is always done by loading
cues into the current cue. As with the current sequence, the current cue always contributes to the
final DMX output, but if the current cue contains no 'instructions' (no sequences or other elements) there will be no visible effect.
DMX addresses and links
DMX Addresses
To enable communication between the LightJockey and the fixtures, an address must be assigned to
each fixture. This address must also be set on the fixture itself - Martin fixtures has DIP-switches or
LED display panels for address settings.
When assigning DMX addresses keep in mind that fixtures usually uses several continuous
addresses, for example the Roboscan 918 uses 16 addresses. The first address is usually referred to
as the start-address. This is important to remember since it is not possible to 'share' addresses
between individual fixtures, so if the Roboscan 918 was given the start-address of 1, the next available
address would be 17 (1+16).
The DMX protocol defines a maximum of 512 addresses (or channels) so all fixtures must fit within
this address space.
There are two ways to assign an address to a fixture in LightJockey.
Set the address manually.
Use the address field in the upper right hand corner of the fixture configuration dialog. Use this method
to match addresses on fixtures that has already been given an address (on the fixture).
Use the "Auto Address" function.
This will prompt LightJockey to calculate addresses based on the fixtures selected and fixtures that
has already been assigned an address. Use this approach when fixtures have not yet been addressed
(on the fixture). There are a few exceptions where the auto address will not work - see details in the
Fixture Configuration help topic.
Link
Link is a term that describes the physical connection from the controller to the fixtures (and between
the fixtures). Since the DMX protocol allows only 512 channels on one link, the only way to add more
channels to a system is to increase the number of links (physical connections). Depending on what
DMX transmitter hardware is in use in the installation, one or more links may be available for
connecting fixtures. Links are numbered 1-4 and when addressing the fixtures, make sure to specify
LightJockey Help
14 LightJockey Help file - (C) Martin Professional 2010
Page 22
which link the fixture is connected to.
Cross fixture-type compatible effects
Some fixture effects are cross-fixture type compatible. This means that changes to a cross type
compatible effect on the Host fixture will also change the effects on the selected client fixtures, even if
they are not of the same type as the Host fixture but still support the same type of effect. For
example, applying 50% intensity to the Host fixture will also set 50% intensity on the client fixtures.
The following effects are usully cross-fixture type compatible although exceptions may exist:
Intensity, strobe, shutter (intensity), pan and tilt positions and movement macros, CMY and RGB, iris,
focus, (variable) zoom, lamp on/off commands, fixture reset, levels (for generic DMX fixture profiles)
Other effects such as gobo or fixed colors are not cross fixture-type compatible.
Scene and fade times
Each scene in a sequence has its own scene time and fade time, both can be set in the Sequence
control. The scene time defines how long each scene is active before the sequence advances to the
next scene within the sequence. If the sequence contains only one scene, the scene time doesn't
have any real effect since the sequence never advances to a new scene. The scene time defaults to a
value of 1.00 seconds.
Fade time dictates the way a scene changes effects from its previous position (DMX value) to the
position(DMX value) stored within the scene.
In order for an effect transition to be controlled by the fade time, the effect must be programmed with
the fade state set to fade. If the effect is programmed with the fade state to snap, the effect will simply
snap to the new position regardless of the fade time set in the scene. The fade time defaults to a
value of 0.05 seconds.
It is possible to set a fade time that is higher than the scene time. In this case the transition to the
new value in the scene is never finished.
LightJockey Help
15 LightJockey Help file - (C) Martin Professional 2010
Page 23
Hardware configuration and setup
Hardware setup
In order for LightJockey to recognize PC or external hardware such as transmitter interfaces or direct
access controllers, they must first be configured using the hardware setup dialog. The dialog is
accessed through the main Setup menu (Setup/Hardware Setup).
The hardware setup dialog
The dialog locates different types of hardware and associated settings on different tabs:
DMX Hardware - configure and setup DMX transmitter and receiver hardware - see Configuring USB
DMX Interface
XLR Cable connections - connecting the serial links to the interfaces. Converting 3 pin XLR to 5 pin
XLR and phase reversing XLR cables - see XLR cable connnections
Audio - configure and setup Audio related hardware and software - see Audio setup
MIDI - configure and setup MIDI related hardware and software - see MIDI
External control devices - configure and setup peripheral hardware that connects via RS-232 or DMX-in
- see External control devices
LightJockey Help
16 LightJockey Help file - (C) Martin Professional 2010
Page 24
Lightjockey Software License
The bottom of the DMX Hardware Setup indicates the current license level of LightJockey.
Protection device:
Indicates if the Martin OneKey with the LightJockey license is connected to the PC.
The key always needs to be plugged in before starting LightJockey. Inserting the key when
LightJockey is running requires to close and restart the application.
LightJockey license:
Full license allows 4 DMX Universes Out, 1x DMX In, 2048Ch., maximum of 3 USB devices can
be used by LightJockey
Limited license (Martin OneKey found but no license present): Interfaces can be configured, but
only Universe 1, Channels 1-128 and DMX IN are active.
No License (no Martin OneKey found): Unable to configure devices and no DMX Output
USB DMX Interfaces
DMX transmitter hardware is configured using the DMX hardware tab in the hardware setup dialog.
LightJockey supports the following types of DMX transmitter/receiver hardware:
Martin Universal USB DMX interface
Martin USB Duo DMX Interface
Both devices support 1024 DMX channels out or 512 DMX channels out + 512 DMX channels in.
Up to 3 interfaces may be connected (4x Out, 1x In)
LightJockey Help
17 LightJockey Help file - (C) Martin Professional 2010
Page 25
Configuration
Once installation of Windows USB driver(s) is completed and the interface(s) is plugged in, start up
LightJockey and go to the hardware setup Main Menu ->Setup
Configured DMX hardware list
Identifying and naming the Universal USB/DMX interfaces
If you click on an ID button in the list, the interface will respond by blinking green/orange on the right
LED.
Assigning Universe to Ports
Each USB Interface needs to have its ports assigned to the desired DMX Universe or to DMX In.
Port A is the left port when looking at the front of the interface, Port B the right port.
The configuration is stored inside the USB interface.
See also XLR cable connections
XLR cable connnections
Connecting the DMX link(s)
All LightJockey DMX transmitter hardware is configured as pin 1 to shield, pin 2 to cold and pin 3 to
hot. See below for notes on 3 to 5 pin XLR converters and phase-reversing cables (used with older
Martin fixtures and possibly fixtures from other manufacturers).
Always remember to terminate the end of the DMX links with a 120-ohm terminating plug.
3 Pin to 5 pin XLR converters and phase reversing cables.
LightJockey Help
18 LightJockey Help file - (C) Martin Professional 2010
Page 26
Updating the driver for the USB DMX interface
When updating the driver for the USB DMX interface as prompted by an in-program notification or
release notes please follow the following procedure:
1. Shut down LightJockey.
2. Unplug all USB DMX interfaces.
3. To update the driver run the driver installation program located in the <LightJockey Installation
Path>\HardwareDrivers\ and follow any onscreen prompts. If updating from a downloaded driver
update, please follow the instructions given for the download.
4. Once the driver setup application has finished, attach each individual USB DMX interface one at a
time wait for 10 seconds and allow Windows Found New Hardware Wizard to complete for each
interface if required (the wizard may not appear in all circumstances).
5. Restart LightJockey and check that the interfaces are recognized by selecting Setup/Hardware
Setup from the main menu.
Please note that updating drivers will most likely require a user account with administrator access
(depending on Windows version)
Audio
Audio setup
Use the Audio tab to configure and select audio options for LightJockey.
Audio options
The Audio Analyzer
The Audio analyzer program enables LightJockey to use audio input via a sound card to trig
sequences in the cue. See using audio in and trigging sequences in the cue for more information.
LightJockey Help
19 LightJockey Help file - (C) Martin Professional 2010
Page 27
CD-Audio
Enabling CD-Audio allows LightJockey to control a CD-ROM drive for audio CD play back. It also
allows LightJockey to take time code from the audio CD to synchronize the cue list to audio CD time
code. See Audio CD Control and Using time code in cue lists for more information. Note that in newer
Windows versions application control of CD-ROM drives has become... errhhh.. troublesome. If
possible, copy the CD tracks to hard disk (use any 'CD ripping' application - for example Windows
Media Player to copy the track to hard disk) and use the LightJockey MediaPlayer to playback the
digital audio file rather than using the CD directly.
Digital Audio Playback
While not strictly a piece of hardware, LightJockey is able to connect to Winamp for playback of
digital audio (MP3, Wav, etc..). The time code from the digital audio may be used to synchronize
sound and light in the cue list. Note that LightJockey connects with Winamp 2 (version 2.74) only.
See uising Winamp for digital audio and using time code in cue lists for more information. In order for
LightJockey to automatically start Winamp when required (through in the cue list), the complete path
to the Winamp executable must be entered in the 'Path to Winamp' field. Click and navigate to
the Winamp.exe file.
LightJockey MediaPlayer
The LightJockey MediaPlayer is a separate module distributed with LightJockey that encapsulates
core functions of Windows Media Player. LJ MediaPlayer may be used to playback different media file
formats, including digital audio and video files. The MediaPlayer requires Windows Media Player
version 6.0+ installed on the PC. The LJ MediaPlayer is exclusively used in cue list context and
requires no initial configuration. For more details see LightJockey MediaPlayer
Audio CD control
In order to get access to the audio functions from the CD-ROM drive, the drive must be configured in
the hardware setup dialog.
After configuration and a restart of LightJockey, the CD audio control is available via on the cue
list tool bar
Audio CD control
The CD control functions like any domestic CD player, play, forward, next track etc. The drag bars
may also be used to set the playing position. When the CD time-code is used to drive a cue list
elapsed disc time is always used.
Analogue vs. digital playback in Windows 2000 and XP
Windows 2000 and XP offer the option to playback CD audio mode - which may be a great option if
there is no analogue connection from the CD/DVD drive to the sound card. The response time from
the digital mode driver seems to be much faster than the analogue driver.
However, experience shows that in digital mode the 'true' time code update rate may actually be much
slower than in analogue mode - the digital audio driver simply just returns the same time code for
sequential time code requests.
The best way to check for the 'real' time code update rate is to open an empty cue list. Then open the
LightJockey Help
20 LightJockey Help file - (C) Martin Professional 2010
Page 28
time code log panel in CD time code mode, and hold down the [Ctrl] key for about 2-3 seconds to
continuously log time codes from the CD drive (*). Then add the time codes to the cue list and check
the time between individual time codes.
(*) It may be necessary to set keyboard repetition rate to max to log as many time codes as possible.
Preferences menu
View Track Info - Expand the control to show individual track time information.
CD Device Settings, Status Timer Interval - Set a rate between 50ms to 1000 ms or select minimum
(fastest) - default value is 100 ms.
Minimum depends on system, but is usually around 5 to 7 ms. The lower the value the more often the
time code is read from the CD-ROM, allowing for a more precise time code triggering of the cue list.
However some Windows versions/CD-ROM drive combinations take a very long time (25-100+ ms) to
return time code for the CD-ROM. Setting a low value on a 'slow' system may slow down the PC a
low, even to the point of choking the PC. The caption of the CD control continuously displays the time
taken for the last status polling - setting a time polling time at about or lower than the average polling
time will cause the system to slow down a lot.
Tests have shown that the way Windows 2000 and XP drives the CD-ROM drive seems much more
effective than Windows 9X (although this may not apply to all systems) - if CD audio is a crucial
element of a Windows 9X system and response time from the drive is high (50ms+), it may be a good
idea to upgrade the PC to Windows 2000 or XP.
Commands
Even though Microsoft has published a command interface for use of CD-ROM, not all Windows
versions/drive combinations seem to work according to the command set - if the drive doesn't work as
expected try set or clear the following options (by default all options are on).
Use Stop as Pause Command - The control issues a stop rather than a pause command (some drives
does not seem to recognize the pause command).
Pause before cuing position - Some drives ignores a position command if they are already playing.
Check this option to issue a pause command before re-positioning.
Invalidate Timecode when stopped - some drives return invalid or wrong time code when stopped
(which may cause the cue list to behave strangely). Check this option to automatically invalidate time
(set to 0) code when the drive is stopped or paused.
See also audio CD-ROM trouble-shooting
Audio CD-ROM trouble shooing
No Disc or Drive Not Ready
No disc is inserted into the CD-ROM Drive or system is still initializing
Cannot open drive tray
Some CD-ROM drives will return a tray-open status even when the tray is closed if there is no CD
present in the drive. On "Eject" LightJockey will try to "Close the tray that is already closed. Shift
click on the eject button to force the tray open if necessary.
Message: CDROM drive already in use. The drive cannot be shared between applications
Another application is already using the CD-ROM drive. Most likely it is used by the Windows CD Player (check in the Windows taskbar). Often this will happen when "CD insert notification" is enabled
on the CD-ROM drive, auto-starting the Windows CD Player application whenever a new Audio CD is
inserted.
There are two ways of fixing this problem. The first fix is to disable the auto insert notification. This
may be done by right-clicking on the "my computer" icon on the desktop. Select "properties" and
"device manager". Select "properties" for the particular CD-ROM Drive, and disable "auto insert
notification" on the "settings" tab. Please note that this will disable the auto-start feature for any CDROM.
LightJockey Help
21 LightJockey Help file - (C) Martin Professional 2010
Page 29
The second is to remove the file-type association of the audio CD. The exact method may depend
somewhat on what version of windows is installed, and what type of desktop manager is used. In
general, open any folder and select the "File type" tab. Find the "AudioCD" entries in the "registered
file types" and remove the entry.
Message CD-ROM drive not found
LightJockey cannot detect the presence of a CD-ROM drive - please check Windows installation.
See also audio CD control
MIDI
Select MIDI options from the MIDI tab.
MIDI tab
MIDI Note Commands
A number of functions including latching cues or flashing sequences may be remotely controlled via a
MIDI interface. To enable MIDI remote control of LightJockey via MIDI, enable the MIDI In function on
the MIDI In tab. For more details on the MIDI note implementation see MIDI In.
MIDI Timecode
MIDI time code (MTC) may be used as a time source for cue lists. To enable a MIDI time code
interface, select it from the MIDI device list via the lower right-hand corner (Select from list then click
Select Device). Note that in order for LightJockey to recognize the MIDI device it must be installed
with working Windows drivers.
The MTC Timeout Value determines the time it takes before an MTC driven cuelist times out after
MTC transmission has stopped. Normally, the default value of 0.5 sec is fine, but special
circumstances may make it necessary to increase the timeout value.
External control devices
2532 Direct Access keyboard
Before the 2532 Direct Access keyboard may be used with LightJockey it needs to be configured.
Enable the 2532 Direct Access and then select the appropriate serial port (COM1-COM4). It is not
necessary (or recommended) to enable to enable the 2532 and select a serial port in order to use the
2532 control in virtual mode (using the control without a 2532 physically connected).
NOTE: The 2532 must have at least version 3.0 software in order to work with LightJockey.
Martin 2518 (via RS-232)
Connects the Martin 2518 controller via RS-232. Since the connection is via RS-232 it is possible to
connect the 2518 without additional hardware (except an available RS-232 port and suitable cable).
MC-X Controller
As the MC-X controller uses DMX to communicate with LightJockey, it is only useable with an
LightJockey Help
22 LightJockey Help file - (C) Martin Professional 2010
Page 30
appropriate hardware interface that supports DMX in.
Note that if the MC-X interface is enabled, normal DMX in functionality is suspended.
See MC-X Remote Controller for details on setup and use.
Fingers for LightJockey
Fingers connection is enabled and configured from the main menu (Fingers)
See also RS-232 remote interface for controlling LightJockey through a RS-232 connection.
LightJockey Help
23 LightJockey Help file - (C) Martin Professional 2010
Page 31
The LightJockey desktop
Main desktop window
The LightJockey desktop
The LightJockey Desktop is devided into 3 separate areas. At the top (below the main desktop menu)
is a tool bar area, in the middle is the fixture area where configured fixtures are illustrated by Icons,
and at the bottom is the status bar.
The desktop window it self is an ordinary Windows-style window that may be minimized, maximized
or resized at will. On multiple monitor systems the Desktop window can reside on any monitor.
Besides the desktop window LightJockey has a number of different dialogs, lists and other types of
controls. All these are launched in separate, independent windows (as the fixture controls in the
screenshot above) - these windows may be moved freely on the whole Windows desktop, even
outside the regular LightJockey desktop, and LightJockey remembers the position where the window
was placed the last time and uses this position when the window is opened again (it is possible to set
a restriction on where the windows are located when re-opened).
On multi-monitor systems, use the extra desktop space to keep the LightJockey desktop on one
monitor, or even a par of one monitor, while using some or the rest of the Windows desktop area for
the individual control windows.
Desktop tabs
Fixtures are represented on the desktop by icons that may be placed anywhere on multiple pages or
"tabs" This allows fixtures to be organized according to personal preferences. To create or edit tabs,
select tabs from the popup menu. Create a new tab by clicking add. Edit or delete the tab by
selecting the tab from the list, and then click the appropriate button.
Placing fixture icons on the desktop
When a new fixture has been configured it's icon is not yet assigned to any tab on the desktop. A
fixture is not programmable until it has been placed on the desktop - to place the fixture, drag it from
the unassigned fixtures list that opens automatically when new fixtures are configured, and drop it on
a suitable place on the desktop. Alternatively click place all in the menu to place all unassigned
fixtures on the current tab.
Moving fixture icons
Select Icons -> Move all from the desktop popup menu. This will switch all icons into move mode. It
LightJockey Help
24 LightJockey Help file - (C) Martin Professional 2010
Page 32
is now possible to move the icons around on the current tab by dragging the icon to the new position.
Icons in move mode cannot be selected for programming, so once the icons are placed deselect
move all again on the desktop menu.
To place a fixture icon on a specific tab
If the fixture is still in the unassigned fixures list, activate the tab, and drag the fixture onto the
desktop. To move a fixture from one tab to the other, right-click the fixture icon to unassign the icon.
The unassigned window will automatically open up. Activate the relevant tab and drag the fixture to the
desktop.
See also configuring the desktop, desktop main menu, selecting fixtures, tool and status bars, fixture
icon popup
Configuring the desktop
Right-click on an empty spot the desktop to access the desktop popup menu.
Desktop popup menu
Desktop popup menu
Select All Programmed - selects all fixtures programmed in the current sequence/scene. Requires
Show programmed fixtures option enabled (see below).
Deselect Odd Fixtures - deselects all fixtures with odd fixture number
Deselect Even Fixtures - deselects all fixtures with even fixture number
Fixture Groups - opens the fixture groups dialog.
See also selecting fixtures
Icons Menu
Icons menu
Style - this option selects between two different styles of fixture icons:
Fixed Size : All Icons have the same base size.
Image Size : Icons are sized according to the size of the image assigned to the fixture icon and icon
caption (fixture user name).
Move all - toggles all fixture icons between move mode (gray caption) and normal mode. For arranging
the icons on the desktop, see below. When in move mode the icons cannot be used for fixture
selection.
Auto-arrange Icons- this will auto arrange all the fixture icons on the current tab, according to fixture
type or fixture number.
Show Programmed Fixtures - with this option enabled each fixture icon will show a colored rectangle
when the fixture is programmed (scene/sequence contains data) in the current sequence. Green if the
fixture is programmed in the current scene, and cyan if the fixture as been programmed in any other
scene in the current sequence. The function is off by default. Note that checking the sequence for
programmed status runs in a separate low priority process, so especially for larger sequences or very
busy systems, the status may take a few seconds to update.
LightJockey Help
25 LightJockey Help file - (C) Martin Professional 2010
Page 33
Fixture programmed in current scene
Fixture programmed in current sequence
Unassign Icons - unassign all icons on the current tab, or just the selected icons.
Desktop
Desktop menu
Tabs - use this dialog to create, rename or delete desktop tabs.
Grid - use a grid to assist in positioning fixture icons on the desktop.
Desktop grid dialog
Image - It is possible to use bitmaps (pictures) as wallpaper on the desktop. Click Image, locate the
required bitmap then click Ok. Note that only standard Windows bitmap files (.bmp files) may be
used. Also note that large images may requires a lot of CPU time when re-drawing and may slow
down the GUI of LightJockey considerably. Use the image dialog to clear an earlier assigned image
and to set the following image options:
Stretch Image - sizes the image so that it fills up the desktop.
Center Image - centers the image on the desktop. Does not resize image.
Note: It is not possible to show wallpaper image and the grid at the same time.
LightJockey Help
26 LightJockey Help file - (C) Martin Professional 2010
Page 34
Custom wallpaper image
See also fixture icon popup
Desktop main menu
System menu - see system menu
Setup menu - see setup menu
View menu - see view menu
Offline-Visualizer menu - see Offline Visualizer
Capture - settings for Capture link - only visible when a Capture link is configured.
Fingers - configuration and settings for Fingers
Generics - provides access to the generic DMX control - only visible if at least one Generic fixture has
been configured
LJ-Manager - access configuration for the LJ Manager plug in.
Download - create program data for 2510 and 2518 controllers
Audio - use to launch Audio Analyzer or Digital Audio playback program. Only visible if either function
have been configured in the hardware setup dialog.
Main system menu
The System menu is located on the desktop main menu.
Main system menu
User Libraries - used to create and select userlibraries. See user libraries
Delete Files- used to delete multiple data files. See deleting multiple data files
Restore Program Data - see using the data restore option. Note that this option is only available if a
restore data set has previously been created.
Auto Strike Lamps - start auto-strike lamp cycle - see startup options
Restart LightJockey - closes down LightJockey and restarts a new session.
Deleting multiple data files
From the main desktop menu select System -> delete files. The following file types may be deleted
(select from menu):
Sequence Files
LightJockey Help
27 LightJockey Help file - (C) Martin Professional 2010
Page 35
Cue Files
cue list Files
Background cue files
Generic DMX Macros
Selecting and deleting files
Delete sequence files dialog
Select one or more files to delete by highlighting the files in the list. Use Select All or Clear All to
select all files or clear all selections.
Once the files are marked, delete the files by clicking Delete.
Checking Sequences
The Delete Sequences dialog contains an option to check if the sequence files are used in any cues.
To check through sequences, click Check Used Sequences. Used sequences are marked with a
'Yes' in the rightmost column and unused sequences are marked with a 'No'. When the sequences
have been checked (may take a little time), click Mark Unused Sequences to highlight unused
sequences only.
Using the data restore option
LightJockey has the capability of backing up the contents of a single users library and on demand
restore the backed up users library to the exact same contents as when the backup was created. The
backup data may be password protected so that the backup data can only be created by authorized
personnel. The backup data is stored locally on the PC hard disk.
This backup function is not intended as a general method to backup and restore data from
LightJockey, but rather targeted towards installation types such as fixed installations in clubs where
inexperienced users have access to various settings and programming. The option offers a quick
method for the inexperienced user to restore LightJockey to the exact point at where the backup was
created without having to locate individual backup files.
Creating the backup data
Create restore data dialog
To create the backup data set, open the system preferences dialog, setup -> preferences -> system
and select the Data Restore tab. Then click Create Restore Data. A complete snapshot of the
LightJockey Help
28 LightJockey Help file - (C) Martin Professional 2010
Page 36
current settings and user library contents is now created and stored for later retrieval.
Once a restore data set has been created, access to the dialog may be password protected, see
below.
Password Protecting the Backup Data
Password dialog
When a backup data set has been created, the create data dialog may be password protected so that
only authorized personnel has access to modify the backup data. To set or change a password click
New Password. Make sure to enter the exact same password twice, and then click Ok. Back in the
Create Restore Data dialog check the Password Protect Restore File option. The access to the
Create Restore Data dialog is now password protected. A new restore data set cannot be created
without entering the password.
Restoring the backup data
In order restore a previously created data set, select System -> Restore Program Data. Note that
the option is only available in the menu if a data set has been created. Accept the LightJockey restart
prompt. Upon restarting LightJockey restores the user library data from the restore data set.
WARNING
Any data existing in the user library to be restored is deleted before the
restore is performed.
File Error during data restore
After restart LightJockey will attempt to restore the data found in the restore data file. If the data
restore file is found to be corrupt this error dialog will appear, offering an option to abort the restore
operation. Note that aborting the operation will delete the restore data file.
See also backup & restore
Main setup menu
The main setup menu has a number of sub-menus that facilitates settings of various options and
settings. The menu is located in the LightJockey desktop main menu.
Main setup menu
Fixture Configuration - dialog for setting up the fixtures to be controlled by LightJockey. See fixture
LightJockey Help
29 LightJockey Help file - (C) Martin Professional 2010
Page 37
configuration
Hardware Setup - dialog for selecting and configuring hardware options. See hardware setup
Global Patch - dialog for modifying the default source of DMX output data. See global patch
Preferences - dialog for setting system preferences. See preferences -> system, preferences -> start
up and preferences -> default DMX output
Hotkeys - dialog for modifying hotkey setup and global enable/disable of hotkeys. See hotkeys
System preferences
The system preferences dialog allow settings of various user library or system wide options. The
access is through the main menu, select Setup -> Preferences -> System.
System Preferences dialog
System Settings tab
Enable bitmap cache - enabling this function will give an increased performance when drawing
controls, but it also uses Windows system resources which may be limited on some systems;
especially Windows 9X or ME. If only one instance of the LightJockey application is running, this will
not be a problem, but if Windows throws up a warning that system resources are getting low, make
sure to deselect this option.
Allow freeze output - enables or disables the users access to the freeze output function.
Allow sequence blind mode - enables or disables the sequence blind mode
Allow offline switch - enables or disables the On/Offline switch
Allow fixture solo selection - enables or disables the fixture solo selection function
Open controls on Windows desktop - normally most controls retain their last position when re-opened.
When this option is enabled, all controls are forced to open within the boundaries of the Windows
desktop. Checking this option ensures that if controls have been placed outside the visible area of the
Windows desktop (e.g. when lowering the video resolution) they will become visible when re-opening.
Note for multi-monitor systems: Windows desktop is defined as the upper left corner of the primary
display to the lower right corner of the last display. However, if monitors are driven in different screen
resolutions, the desktop height (or width if displays are vertically configured) is defined as the height
(or width) of the primary display. This may cause problems if secondary displays are driven at a
resolution different from the primary displays - in this case it is probably the best to disable the option.
Open controls on LightJockey desktop - when this option is enabled, all controls open within the
boundaries of the LightJockey desktop. Use this option if controls have been placed outside the visible
area of the Windows desktop (e.g. when lowering the video resolution).
Start LightJockey on Secondary Monitor - check this option to force LightJockey to start up on the
secondary monitor in a multi monitor system. Setting is ignored if only one monitor is detected.
Restore LightJockey desktop on startup (Size/Position) - when checked, the LightJockey desktop will
default to the same size and position and size it had when LightJockey was previously closed down. If
not enabled LJ will maximize on the designated monitor.
LightJockey Help
30 LightJockey Help file - (C) Martin Professional 2010
Page 38
Warnings tab
Sequence/Cue Modified - enable to prompt a confirmation box every time before a modified sequence
or cue is overwritten by a clear or load command. Note that the cue modified warning will not be
shown if the cue was loaded as a transparent cue.
Overwrite Sequence/Cue - enable to prompt a confirmation box each time before a saving on top of an
already saved sequence or cue.
Show Blackout Warning - enable this to show a warning when blackout or fade-in or fade-out is active.
Click Cancel on the warning dialog to restore from blackout or fade modes.
Show Freeze Warning - when enabled, a warning is shown when DMX output is frozen.
Show Offline Warning - when enabled, a warning is shown when DMX output is offline.
Confirm Close Program - enable this to show a confirmation dialog when LightJockey is closed.
Quick Save/Load tab - enable sequence/cue/cue list quick save/load.
When quick save/load is enabled, right-clicking will re-save the current sequence, cue or cuelist
without using the save dialog (it requires that the sequence, cue or cuelist has previously been saved if not, the case the save dialog will appear as usual).
Likewise right-clicking on any will re-load the current sequence, cue or cuelist (only if a
previously saved sequence or cue or cuelist is currently loaded)
External Links tab
External links - external links allows LightJockey to talk to other Martin Windows applications.
Normally, if not instructed otherwise, leave these options off.
The external links will only be enabled if transmitter hardware is detected.
Enable Offline Visualizer - enables communication to Offline Visualizer - there is normally no reason
to disable this setting other than for trouble shooting purposes. If the option is grayed out it means
that LightJockey cannot locate the Offline Visualizer installation.
Enable link to Sandnet - enables routing of DMX data through Sandnet (tm). Note that this option
requires that LightJockey DMX hardware is installed and configured as well as appropriate Sandnet
hardware and/or software. More information about Sandnet can (at the time of writing this) be found at
http://www.sandsys.com
LightJockey Help
31 LightJockey Help file - (C) Martin Professional 2010
Page 39
Enable link to Capture - enables communication with the Capture Visualization application running on
the same or another networked PC - see interfacing with Capture for more information
Data Restore tab - see using the data restore option
Startup options
To access the startup dialog, select Setup/Preferences/Startup from the desktop main menu.
Startup options dialog
Auto Lamp-On - enabling this option will configure LightJockey to startup with a lamp-on cycle,
sending lamp-on commands to all fixtures that support a lamp-on command. Lamp-on commands are
sent to one fixture at a time with a delay of approx. 1 second to avoid a surge on the power line. Set
the duration of the power-on cycle to 1 to 5 minutes. If none of the configured fixtures support lampon, the cycle will be aborted. The power-on cycle will run before any auto-start programs are
executed. During the lamp on cycle a window will appear on the desktop, displaying the lamp-on
cycle progress. The cycle may be aborted at any point by clicking Stop. The auto-lamp on command
is also available under the desktop main system menu. When started from here cycle will continue
until canceled.
Auto lamp-on cycle
Load On Startup (programs auto-start) - these options enables LightJockey to automatically launch a
specific sequence, cue, cue list or background cue (BG cue) on startup. Click the relevant Select
button to select the sequence, cue, cue list or background cue to auto-start. Sequences and cue lists
requires a check mark in the Run check box to execute after load, else they will remain static.
Run Minimized - check to automatically to minimize LightJockey after start up as soon as all
initializations are done. This setting is useful if LightJockey has to run silently in the background with
LightJockey Help
32 LightJockey Help file - (C) Martin Professional 2010
Page 40
other applications.
Show notes on startup - when enabled the built-in note pad will (Main Menu -> View -> Notes)
automatically be displayed when LightJockey starts up.
Auto Launch Programs - use this option to automatically launch external support programs as
LightJockey starts up. Click Browse to specify which programs to be launched. An example of a
support program that must be launched this way is the RS-232 remote program.
To clear a program from the list, highlight it, right click and select delete entry from the popup menu.
During startup LightJockey will make no attempt to check if the program is already running, neither
will the program automatically be shut down when LightJockey shuts down. If the file launched is not
an executable, eg. *.exe - it is up to the user to make sure that the data file is properly associated
with an executable. For example to launch an MP3 file, the .MP3 extension must be properly
associated with a program to playback MP3 files. If, for some reason, an automatically launched
program causes LightJockey to crash or lockup before the entry can be removed from the list, the
program entries may be manually removed from the startup.ini file located in the LightJockey
installation folder.
Default DMX output
By default LightJockey defaults to a value of 0 for all DMX output channels when they are not
programmed - some fixture profiles may cause other default values to be used. By customizing the
default values, it is often easier to create a good basis for programming. The new defaults may contain
values causes a fixtures to home (center) on pan and tilt, or opens the shutter on fixtures equipped
with separate shutter and dimmer, so it won't be necessary both to open shutters and set intensity
values when programming. It may also be used to set a pre-heat value for fixtures running via dimmer
packs.
Use Current Scene - this option will record the output from the current scene. If values have already
been recorded for default output they will be included in the new default output, unless overwritten by
the contents of scene. This makes it possible to modify the default output just by programming the
modifications into the scene and then select 'use current scene'. Note : The default output cannot
contain presets or pan/tilt macros, if presets are present an error message will be displayed and the
new values will not be recorded.
Clear Default Output - this will reset the default output to all 0 values.
Main view menu
The menu is located under the desktop main menu.
Main view menu
Toolbars - use this submenu to toggle visibility of the various tool bars and the status bar.
Controls - use this submenu to display specific controls if the corresponding tool bar is not visible.
Unassigned Fixtures - use this to show the list of unassigned fixtures if the list was previously closed
(unassigned fixtures are fixtures which icons have not yet been placed on the desktop)
Notes - this will show a handy little notepad - the notes are saved in the current user library and can
be recalled at any time by selecting this menu item or by hotkey.
DMX Output - See DMX output monitor
Windows System Memory - displays information regarding Windows system memory. Used for
trouble shooting.
LightJockey Help
33 LightJockey Help file - (C) Martin Professional 2010
Page 41
The unassigned fixtures list
When new fixtures have been configured using the fixture configuration dialog, a fixture icon
representing the individual fixture must be placed on the LightJockey desktop. Until the icon has been
placed, the fixture cannot be accessed from the desktop. When closing the fixture configuration
dialog, new fixtures are placed in a unassigned fixtures list. A dialog containing the list is
automatically displayed after configuration. The dialog may also be opened via View -> Unassigned
Fixtures.
Unassigned fixtures list
To place individual fixture icons on the desktop, drag the fixture from the list and drop it on the
desktop. Move Icons will automatically switch fixture icons in and out of icon move mode. Click
Unassign All to move remove all fixture icons from the desktop to unassigned list. Click Autoplace
All to place all icons on the current desktop tab ordered either by fixture type or fixture number.
Tool- and status-bars
The LightJockey desktop contains up to 4 tool bars with buttons for quick access to various functions.
There is also a statusbar with status information.
The sequence/cue tool bar has functions relating to the current sequence and the current cue.
The cue list tool bar has functions relating to the cue list, background cue and external control options
such as DMX in, MIDI, Audio CD and the 2532 Direct Access controller.
The fixture tool bar contains functions related to individual fixtures or groups of fixtures.
Finally the status bar contains various status information.
Any of the tool bars and status bar may be hidden to save desktop space, see main view menu
Sequence/cue tool bar
The left part of the tool bar contains buttons and information related to the current sequence, while the
right half contains buttons and information relating to the current cue.
Sequence tool bar
LightJockey Help
34 LightJockey Help file - (C) Martin Professional 2010
Page 42
Current sequence displays the name of the current sequence (if any). The background turns yellow if
the sequence is 'active' (contains data). If the current sequence is empty, the background color is
gray.
Click to view the sequence control.
Click to clear the current sequence (see sequence control).
Click to bring up the save sequence dialog.
Click to open the list of sequences (to access previously saved sequences)
The tool bar also displays the current scene number in the current sequence, in the form of X:Y,
where X is the current scene number and Y the last scene number. If the sequence is empty, the
display shows '1:1'.
Cue tool bar
Current cue displays the name of the current cue (if any). The background turns yellow if the cue is
'active' or modified (contains data). If the current cue is empty, a gray background is used.
Click to view the cue control.
Click to clear the current cue.
Click to bring up the save cue dialog.
Click to get the list of cues (to browse existing cues or load a previously saved cue)
See also tool- and status-bars
Cue list tool bar
The left part of the tool bar contains buttons and information related to the current cue list while the
right part contains a button for the background cue, the statics control, audio CD control as well as
buttons for other, external control options.
The cue list tool bar
Current Cue List displays the name of the current cue list (if any). The background turns yellow if the
cue list is 'active' (executing) - if a gray background color is used.
Click to view the cue list ontrol.
Click to clear the current cue list (see cue list control).
Click to bring up the save cue list dialog.
Click to get the list of cue lists.
The bcue button
Click to open the background cue control. If a background cue is active, the 'LED'
is green, if not the 'LED' is red
LightJockey Help
35 LightJockey Help file - (C) Martin Professional 2010
Page 43
The statics control button
Click to open the statics control. If one or more static entries are active, the 'LED' is
green, if not the LED is red.
Audio CD control
Click to access the audio CD control. The button is not enabled (grayed out) unless the
LightJockey has been configured to use a CD-ROM Drive.
The external control buttons
Click to access the MC-X setup dialog
Click to access the 2518/RS232 control (note, the 2518 must have been configured first)
Click to access the DMX in setup
Click to view the MIDI in control (must be configured first)
Click to view the 2532 direct access control
See also tool- and status-bars
LightJockey Offline Visualizer tool bar
The Offline Visualizer tool bar contains a button to launch/enable/disable the Offline Visualizer as well
as buttons to control various Offline Visualizer camera functions directly from LightJockey.
LightJockey Offline Visualizer tool bar
The first button changes between Launch (start Offline Visualizer), Disable (hide) and Enable (show
if hidden).
default camera front view
default camera back view
default camera left view
default camera right view
default camera top view
default camera bottom view
camera full view
undo camera view
redo camera view
The last box contains the Offline Visualizer user camera list with cameras previously saved in the
Offline Visualizer scene. Views may be selected via this list or via hotkeys.
Fixture tool bar
The fixture tool bar contains buttons to access fixture controls, buttons for fixture selection and
selection modes as well as buttons for special controls such as smoke control or the global Host
LightJockey Help
36 LightJockey Help file - (C) Martin Professional 2010
Page 44
intensity control.
Fixture control selection
Click icons to access the individual fixture controls. Note that none of these buttons will be enabled
until at least one fixture is selected.
Right-click a button to open the corresponding control and close the other fixture controls
automatically (useful on a smaller desktop setup).
Click as a shortcut to show or hide all fixture controls (except extended controls) with one
click.
Fixture selection buttons
Displays the fixture group selection window.
These buttons effects the desktop fixture selection.
Selects previous or next fixture respectively - see next/previous fixture
Selects fixture solo Mode
Follow spot button
toggles follow spot settings
Special controls buttons
/ see OffLine/OnLine switch
see freeze output
see smoke control
see blackout
ser intensity
See also tool- and status-bars
Status bar
The status bar is located below the main desktop. It displays the current time, system and system
memory status and the current level of the intensity control. The bar also shows if the current
sequence, cue or cue list have been modified. Finally the trig information from the Audio Analyzer is
duplicated on the status bar.
Status bar
Memory status
Windows utilizes both physical memory (RAM) and virtual memory (hard disk). Accessing information
in the physical memory is magnitudes faster than accessing information
The indicator shows the percentage of used memory out of the total physical and virtual memory
available as reported back from Windows.
The % indication is not an absolute indicator; as more memory is needed Windows will automatically
reduce memory allocation for other functions or applications, typically by reducing the disk cache
LightJockey Help
37 LightJockey Help file - (C) Martin Professional 2010
Page 45
size.
The color of the memory 'bar' indicates the amount of free physical memory left.
Green indicates more than 3 Megabytes physical memory free.
Yellow indicates between 2 and 3 Megabytes free physical memory free.
Orange indicates between 1 and 2 Megabytes free physical memory free.
Red indicates less than 1 Megabyte physical memory free.
As long as the indicator stays in green everything is fine. When the indicator goes through yellow and
orange, it indicates that there might be a slight loss of performance as there is little physical memory
left. A red indicator means very little or no physical memory free, probably causing a pretty poor
performance. it is still perfectly possible to run LightJockey even if the bar is red, as long as Windows
supplies enough virtual memory (and it usually does) - just expect for slower performance.
Fixture icon popup
To access this menu right-click on any of the fixture icons on the desktop.
Fixture icon popup
Select All programmed of this type - selects all fixtures of this type that are programmed in the
current scene. This function requires that the Show programmed fixtures option is enabled.
Select All of this Type - Deselect All of this Type - selects or de-selects all fixtures of the same type
as the 'clicked' fixture. The 'clicked' fixture automatically becomes Host fixture when this function is
used.
Clear This Fixture - Clear Selected Fixtures - when clicked all fixture parameters are set to off in the
current scene in the current sequence.
Output generated by default DMX output, statics, the current cue or background cue is not affected.
Fixture Info - opens the fixture info panel
The info panel shows the fixtures DMX address and intensity group. If the profile contains DIPswitch
information the dipswitch shows the settings according to DMX address.
Fixture Notes - shows the fixture profile notes (same notes as shown in the fixture configuration)
DMX Output - opens the DMX output monitor aligned with the fixtures DMX address.
Fixture Configuration - opens the fixture configuration dialog with the fixture already selected.
Global Patch - opens the global patch dialog aligned on the fixtures DMX address.
LightJockey Help
38 LightJockey Help file - (C) Martin Professional 2010
Page 46
Define Fixture Profile - opens the fixture profile dialog. This option is only available for user definable
fixtures.
Customize Fixture - opens the customize fixture palette dialog. This option is only available for
selected built-in fixture profiles.
Fixture Icon Menu
Unassign Icon - select to de-assign the icon from the current tab. The fixture will go back into the
unassigned fixtures list and can be re-placed on another tab. See configuring the desktop.
Move Icon - toggles the Icons 'movement' mode on and off. See configuring the desktop.
Align Icon - select the align command from the sub menu. The command will align the icons of all
selected fixtures to the current icon, e.g. selecting Icon Right will align the right side of all selected
icons to the current icon. Note, alignment will not work on icons that are in 'move' mode.
DMX output monitor
Open the monitor from desktop main menu -> view -> DMX Output
This window shows the actual DMX values output from LightJockey. To align the view with a particular
fixture, right click the fixture icon and select "DMX Output" from the popup menu.
DMX output monitor
Preferences menu
Highlight value changes - channels with changing values display values in red
Highlight used channels - channels that are in use by at least one fixture shows with gray
background Highlight selected Host fixture - channels in use by the Host fixture is displayed with a
green background
Autoscroll to Host fixture channels - the DMX monitor automatically scrolls to bring the channels of
the Host fixture into view
Enable value overwrite - see below
Color scheme (background)
Gray background: DMX channel is used by at least one configured fixture
White background: DMX channel not used by any configured fixture
Green background: DMX channel used by selected Host fixture
Color scheme (text)
LightJockey Help
39 LightJockey Help file - (C) Martin Professional 2010
Page 47
Black text: unchanged DMX value (since the dialog was opened)
Red text: DMX value changed (since the dialog was opened)
Green text: DMX value overwritten
Control channel function
Highlight a specific output channel (click it's value) to see it's control function which is displayed in the
status bar at the bottom of the dialog.
Overwriting the DMX output values
Value overwrite enabled
The DMX output monitor allows DMX output values to be overwritten directly, without the need to
configure a fixture first. The output value is written directly to the DMX channel without regards to any
patches made with the global patch dialog. DMX output value overwriting must be enabled from the
Preferences menu. To overwrite DMX output values, select (highlight) the relevant DMX channel(s) and
use either the virtual fader or value field to enter/modify the DMX value. Click CLR to remove value
overwrite on the selected channels. DMX output channels that has their value overwritten displays the
value in green text.
Note: The DMX output can only be overwritten this way as long as the DMX output monitor is open
and DMX value overwriting is enabled. As soon as the monitor dialog is closed, the DMX values will
revert to non-overwritten values.
Searching DMX output channels
The DMX output monitor contains a tool that can be used to search for a specific DMX channel by
sending specific DMX values to specific channels in a search pattern. The tool is handy when trying to
locate DMX equipment that is connected and addressed but not yet configured and the address has
not been noted down. The tool uses a binary search algorithm that is capable of locating a specific
channel out of 2048 channels in a maximum of 11 'tries'. Click Tools in the menu to open the search
channel dialog and setup a channel search pattern.
LightJockey Help
40 LightJockey Help file - (C) Martin Professional 2010
Page 48
Search channel dialog
During the search 'DMX on' and 'DMX off' values are sent to the channels in the search pattern. Modify
the DMX off and DMX on values value if necessary.
Setting up the search pattern
Un-check include link 1-4 to exclude fixtures on any specific link from the search. Un-check exclude
configured channels to include channels that are already in use by configured fixtures.Default options
will search on all 4 output links but exclude channels already used by configured channels.
Click Start to start the search
The search algorithm first applies the on value to all channels in the search pattern to check that the
device is included in the pattern at all. Subsequent searches will apply the on value to half the
channels in the search pattern and for each search iteration the number of channels in the search
pattern is halved according to the answer in the search prompt.
Search channel prompt
Click yes if the channel is on - no if the channel is off.
LightJockey Help
41 LightJockey Help file - (C) Martin Professional 2010
Page 49
User libraries
User libraries
A user library contain all data that may be modified by the user, except for a few installation wide data
files such as hardware setup parameters. Using different libraries means that individual setups and
programs may be kept totally separate. Changing to a different user library requires a restart of
LightJockey.
After start up, LightJockey displays the current user library in the caption of the main window.
Main window caption. Current user library is "Default".
It is not possible to share or import data from different libraries. It is not advisable to manually copy or
move files from Windows explorer. The different data structures of LightJockey are often very
dependent on each other, and may not function if copied from different libraries. In any case don't ever
copy or move files while LightJockey is running - if, in special cases, it is necessary to copy or move
files, make sure that LightJockey is closed down first.
The User Library dialog is accessed from the main system menu (System -> User libraries..).
The user library dialog
The leftmost column of the list shows the (user-selectable) name of the library. The middle column
shows the Windows folder path while the rightmost column shows the creation date of the library.
The Default Library
The default user library is a special user library. It cannot be renamed or deleted. If the default library
is not present at startup, LightJockey will automatically create a new default library. Upon starting up
after initial installation LightJockey will always use the default library - further libraries must be created
by the user.
Creating a new user library
To create a new library, click Create New Library - this will prompt a new dialog.
New user library dialog
Type the new name of the new library. Check copy files to automaticallyl copy all data files from the
current to the new library, esentially creating a copy of the current library.
LightJockey Help
42 LightJockey Help file - (C) Martin Professional 2010
Page 50
Switching to a different user library.
Highlight the library in the list and click Select User Library. In order to load the information from the
newly selected library, LightJockey needs to restart. Answer yes at the prompt to change the library,
or no to cancel.
Deleting a user library.
To delete a user library, highlight the library in the list and click Delete Library. Note that it is not
possible to delete the current library.
Renaming a library.
Highlight the library in the list and click Rename Library.
Moving user libraries between PCs
To move an entire library from one PC to another use the built in backup/restore function.
Starting LightJockey in a specific user library
LightJockey may be started up in a specific user library by adding a parameter to the startup
command (Windows shortcut). The syntax is <LightJockey> <U:[userlib_name]> where userlib_name
is the name of the folder where the specific user library is located. Use the information displayed in
the user library dialog to see the path where the individual user libraries are located.
When specifying the name only the 'last folder name' should be used, examples:
LightJockey U:user0001 - will start LightJockey in the user library located in
<LJinstallation>\user\user0001
LightJockey U:Default - will start LightJockey in the default user library located in
<LJinstallation>\user\default
Note that some Windows versions may require the path a and name of the LightJockey executable to
be enclosed in quotes, eg:
Target: "C:\Program Files\Martin Professional\Martin LightJockey\LightJockey.exe" U:user002
LightJockey Help
43 LightJockey Help file - (C) Martin Professional 2010
Page 51
Modifying a Windows shortcut to LightJockey
See also backup & restore, using the data restore option
Backup & restore
LightJockey implements a function to backup and restore data from individual user libraries - it does
not implement functions to backup or restore the entire installation. To backup a complete installation
it is a good idea to use an application such as Winzip www.winzip.com to compress the backup into
one file or use the backup/restore function built into some versions of Windows. Note that restoring
from a backup completely replaces the existing contents of the user library.
Creating a backup
Select (highlight) the user library to backup from the list in the user libraries dialog. When creating a
backup of the current library make sure to close all LightJockey dialogs before backup - a number of
data files may not be properly updated until the corresponding dialogs are closed. Alternatively close
down LightJockey and re-start to make sure all relevant data has been saved.
Selecting a user library for backup (User library dialog)
LightJockey Help
44 LightJockey Help file - (C) Martin Professional 2010
Page 52
Backup dialog
The backup dialog includes a small note pad to add notes to the backup file - the notes are embedded
into the backup file and can be used as reference when later searching through backup files. Click
Create Backup File to start creation of the backup file. The backup procedure will collect and
compress the entire contents and structure of the selected user library into one backup file. Once the
file has been created save it using the standard Windows file dialog.
Using floppy disks for backup files
The backup file is saved as one large file, and it is the users responsibility that the media to which the
backup file is saved has sufficiently space to hold the file. However since the backup file is
compressed (often exceeding an 1:30 compression) most backup files will easily fit on a single floppy
disk. As floppy diskettes are not really known for their reliability, at least make sure that the diskette
is properly formatted before using it. If the backup is important or is to be stored for later, make
several identical backups to several diskettes rather than just relying on one diskette backup.
Restoring to a user library
A backup file can only be restored into an existing user library - to restore a backup to a new user
library, create a new, empty library first. Note: restoring a backup file to a library, will completely
replace the existing contents of the library. To restore from a backup file, select (highlight) the user
library to restore to in the user library dialog - then click Restore Library.
Restore user library dialog
Use drive and folder selectors to navigate to the drive and folder where the backup file is placed.
Select the backup file from the backup file list (the list will show all backup files in the selected folder).
When a backup file is selected, the embedded notes (if any) are displayed in notes field. Click
Restore Library to start restoring data to the user library. Note, if data is restored to the current,
active user library LightJockey will automatically restart after files have been restored.
Using backup files in different installations
Backup files may be used to transfer the contents of user libraries from one LightJockey installation to
the other - just make sure that the target installation is of the same or newer version as the one used
to generate the backup. Restoring a data file to an older LightJockey version may not work correctly.
See also using the data restore option, user libraries
LightJockey Help
45 LightJockey Help file - (C) Martin Professional 2010
Page 53
Fixture configuration
Fixture configuration
Before LightJockey can control a DMX fixture, the fixture's profile or 'personality' must be added to
LightJockey's fixture configuration. The fixture configuration contains a list of all the fixtures that
LightJockey is currently set up to control and contains information about the individual fixtures
capabilities, DMX address and other optional settings.
To access the fixture configuration dialog, select Setup -> Fixture configuration from the main
menu. Alternatively, right click any fixture icon on the desktop and select Fixture Configuration from
the popup menu.
Fixture configuration dialog
The fixture configuration dialog is divided into 4 different areas:
Fixture Configuration - a list containing the current configuration.
Fixture settings - individual fixture settings such as DMX address or pan/tilt options.
Available profiles - the list of available fixture profiles. The profiles are arranged according to
manufacturer, click the 'cross' symbol to the left of the manufacturer name to expand the list of
available fixtures under the manufacturer heading. Available profiles for unlisted manufacturer's fixtures
can be found under 'other'.
Profile notes - notes included in the profile selected in the available profiles list. Offline Visualizer
profile notes are only available if the Offline Visualizer is currently running and the LightJockey profile
is linked to an existing Offline Visualizer profile.
Built-in vs. user defined fixture profiles
LightJockey implements two different types of fixture profiles - built-in profiles and user defined
profiles.
Built-in profiles
The built-in profiles are usually used for Martin fixtures but also includes a number of generic profiles
(see below). Built-in profiles are hard-coded into the LightJockey program code and cannot be
modified by the user, although some built-in profiles allows for some degree of customization (see
customizing palette controls). New built-in profiles, or updates to existing built-in profiles requires an
update of LightJockey itself.
LightJockey Help
46 LightJockey Help file - (C) Martin Professional 2010
Page 54
User defined profiles
User defined profiles are based on a profile framework where attributes and capabilities of the fixture
are described in external data files. Using the generic fixture profile editor, it is possible for the end-
user to modify existing profiles or write custom fixture profiles. The profiles may be exported for use in
other LightJockey installations - indeed many of the user defined profiles supplied with LightJockey is
created by end-users. Most non-Martin fixture profiles are supplied as user defined profiles. Unlike the
built-in profiles, user defined profiles may be updated without updating LightJockey itself. The latest
collection of user defined profiles can be found and downloaded from the Internet at http://www.martin.
com/service/Software/controller/LJ/list.asp
Special Profiles
While most profiles are listed under specific fixture manufacturers, a number of profiles are listed as
'Generic' profiles.
Generic DMX control profiles
Generic DMX profiles are profiles that do not relate to specific fixture models. Use these profiles to
control 'generic' fixtures such as dimmer or switch packs. There are also generic profiles for
controlling DMX smoke machines or hazers as well as packs of RGB fixtures (e.g. LED banks). See
also generic DMX profiles
User defined profiles
The profiles listed under User Definable manufacturer are 'empty' profiles that can be used as a
starting point for creating a new profile (see user definable fixtures).
Other Profiles
Profiles with an unlisted manufacturer (or no manufacturer information) or for a specialized purpose are
listed under the Other heading.
Find profile
Find profile dialog
Use the find profile dialog (click Find below the list of available profiles) to search the available profiles
for a specific name or part of name. Enter the phrase to search for then click Find. The find dialog
searches both on manufacturer and fixture name and is not case sensitive.
No suitable profile found - what to do?
LightJockey does not ship with a profile for every fixture type in the world - there is a chance that there
is no matching LightJockey profile for a fixture amongst the available profiles.
Check if the profile has been added after the release of the LightJockey version running was made look for profile updates at http://www.martin.com/service/Software/controller/LJ/list.asp
Ask at the LightJockey end-user forum on the Internet (www.martin.com/forum) - maybe someone
have already made a suitable profile or will help making one. Make sure to post as much
information as possible, manufacturer, model, preferred DMX mode, relevant web site information
etc.
LightJockey Help
47 LightJockey Help file - (C) Martin Professional 2010
Page 55
In case of a new Martin fixture, odds are that it will first be included in a LightJockey beta release see LightJockey end-user forum for latest beta release notes.
Create new profile - see defining the generic fixture 2 profile
As a last resort, use a Generic DMX profile to control the fixture.
Not: user defined profiles exported from other installations must be imported to the current installation
before they can be used. See importing user defined fixture profiles for more details.
Adding profiles to the configuration
Selecting the right profile
As many new fixtures have several DMX modes available which may be selected on the fixture itself
(e.g. 8 or 16 bit pan/tilt modes), make sure to read the individual fixture profile notes (LJ profile notes
tab). The profile author has usually included notes that says which mode the profile is designed to
operate with. It may be necessary to change the mode on the fixture itself if a suitable profile is not
available but a profile for another mode is.
To add a profile to the configuration, first locate the it in the available profiles list, then drag it to an
empty slot in the fixture configuration list (or to an already occupied slot to replace the current profile).
To add multiple profiles at once, highlight the profile then click Add Fixture(s) and use the add
fixtures dialog to add one or more profiles.
Add fixtures dialog
Removing fixtures from the configuration
To remove one or more fixtures from the configuration, highlight the profile(s) in the Fixture
configuration list and click Remove Selected Fixture(s).
Setting individual fixture information
Each of the configured fixtures has a number of individual options. Select one or more fixtures in the
configuration list to set the individual options.
Individual fixture settings
Fixture DMX address
As a minimum the fixture's DMX start address must be set. The DMX address range of individual
fixtures should be unique and not overlapping/overlapped by other fixtures. Depending on DMX
transmitter hardware, one or more links may be available for addressing. Make sure to specify which
link the fixture is connected to. The DIP switch setting is only shown for fixtures where the associated
LightJockey Help
48 LightJockey Help file - (C) Martin Professional 2010
Page 56
profile specifies addressing through a DIP switch. Please refer to the fixtures documentation on how
to set the DMX start address on the fixture itself.
IMPORTANT!
When programming fixtures in LightJockey, the 'programs' and settings such as preset position data
are stored in data files according to the fixtures DMX address. If the DMX address is changed for an
already programmed fixture it will invalidate the programs - changing the DMX address for a fixture will
prompt a warning if the configuration was previously been saved. To change the DMX address for an
already configured/programmed fixture use the copy from fixture function (see below).
When new fixtures are configured re-using a fixture number previously used by another fixture, by
default, the program 'data space' for the new fixture will be cleared and re-initialized when saving the
configuration. To retain data, for example when replacing one fixture with another very similar fixture,
make sure to enable Prompt for clear data for new fixtures in the preferences menu (see clear
fixture data below). If not enabled, programmed data will be cleared without warning when the
configuration is saved.
Calculating addresses
Clicking Calculate address will open a dialog to calculate possible start addresses for the fixtures
selected in the configuration list. The calculation is based on addresses already in use by other
fixtures as well as the number of addresses used by the fixture profiles with the following exceptions:
Patches created with the global patch tool will not be taken into account.
user definable colors scrollers that needs a separate address for the scroller unit The address for
the color scroller is not taken into account, and might be overwritten.
Scanner 1 profiles. If the actual fixture profile takes up less than the 8 of channels used by the
scanner 1 profile, the free channels are not re-used when calculating addressing.
Calculate address dialog
Pan/Tilt options
Only available for fixtures with pan/tilt control. Check to invert control of pan or tilt or swap pan and tilt.
The pan and tilt inverting and swapping is performed by LightJockey just before pan and tilt DMX
values are transmitted to the fixture - setting any of these switches does not affect the contents of
programmed positions.
Intensity control options
Not all options are available for all profiles.
Ignore Blackout - Fixture ignores blackout commands
Ignore Grand Host - Fixture ignores Grand Host settings
Link Strobe/Grand Host - Fixture stops strobing when grand Host or group sub Host is at 0
Fixture User name
Use for an individual description of the fixture - the user name is used as caption on the fixture icon on
the desktop.
Saving the configuration
Any changes made to the configuration are temporary and will not take effect until the configuration is
saved (click save). Upon saving the modified configuration, LightJockey will check the new
LightJockey Help
49 LightJockey Help file - (C) Martin Professional 2010
Page 57
configuration for potential problems (such as overlapping DMX addresses or a missing DMX start
address). If a potential problem is found a warning list will be shown - to save the configuration
regardless of warnings click Save Anyway.
Advanced Options
DMX address range limit
By default, it is only possible to set a fixtures DMX address within the range supported by the
installed and configured DMX transmitter hardware, e.g. a single USB/DMX interface allows fixture
addressing on link 1 only. If no hardware is configured all 4 links are available for addressing. In some
instances it may be useful to address fixtures outside the address space supported by installed DMX
hardware - the Preferences -> Disable Hardware address range check will temporarily disable
the hardware range check and allow addressing on all 4 links regardless of configured transmitter
hardware.
Copy from fixture
Use the copy from fixture function to copy all programmed data from one fixture to another fixture of
identical type (profile). The copy from fixture function only works if the configuration has been saved
first and only for identical fixture profiles that has been assigned a valid DMX address. The copy from
fixture function should also be used to change the DMX address of an already programmed fixture.
See copy from fixture for more details
Clear fixture data
By default, when a configuration including new fixtures is saved, LightJockey will prompt for "Clear
data for new fixtures" before saving. Clearing the data space for newly configured fixtures will ensure
that no 'garbage data' is present in data files from the previous configuration. Normally data for a new
should be cleared (re-initialized), but in some circumstances, such as when reconfiguring a fixture
with a very similar profile using the same DMX address space it may make sense not to clear data for
the new fixtures - in this case click cancel when the prompt appears. Data may be cleared for
individual fixtures after the configuration has been saved by highlighting the fixture in the configuration
list, right-click and then select Clear Fixture Data from the popup menu. See clear fixture data for
more details.
The import menu - see importing user defined fixture profiles
The preferences menu
The entries in the preferences/warnings menu can be used to enable or disable different warnings
when saving a modified configuration.
Warnings - enable or disable warnings
Prompt for clear new fixtures - when checked the user will always be prompted to clear data for newly
configured fixtures.
Always apply default DMX values - when checked, default DMX values for new/modified fixtures will be
applied automatically. If unchecked, the user will be prompted to apply default DMX data (see
applying default DMX values to new fixtures).
Disable hardware address range check - enable to be able to address a fixture on any of the 4 links
regardless of DMX hardware. This setting is temporary.
The print menu
The configuration may be sent either directly to a printer or exported to a text file for import and
beautification in any type of word processing application.
Configuration warnings
Before saving the configuration LightJockey will check for the following potential errors in the
configurations:
Fixtures # XX has no DMX address - while not a critical error, LightJockey will not attempt to control
LightJockey Help
50 LightJockey Help file - (C) Martin Professional 2010
Page 58
fixtures without a valid DMX address. Furthermore it is not really possible define fixture profiles unless
the configured fixture has a valid DMX address.
Fixture #XX has invalid DMX address - the DMX address given to the fixture is invalid. Usually it is
because there is not enough DMX addresses left to contain all the fixtures control channels.
DMX address L:AAA is used by more than one fixture - two or more fixtures are using the same DMX
control channel - while this may be intentional it usually an error. Note that overlapping addresses
may lead to errors in internal control channel patching.
configuration warnings
To save the configuration regardless of the warnings click Save Anyway
Copy from fixture
From the fixture configuration dialog it is possible to copy the entire programmed contents from
another fixture if the two fixtures are of an identical type (profile). The configuration must be saved
before a copy from fixture can be performed. To copy contents from one fixture to another, select the
target fixture (the fixture to copy to), right-click and select Copy From Fixture from the popup menu.
Copy from source fixtures list
A list of possible source fixtures will be displayed in a list. Select the source fixture and click Ok.
Copy filter
LightJockey Help
51 LightJockey Help file - (C) Martin Professional 2010
Page 59
Now select what to copy from the source fixture (normally all options should be checked)
Copy Sequence Data - copies all data in all sequences from the source fixture.
Copy Presets - copies all preset data from the source fixture.
Copy Setup - copies all setup specific data (except DMX address) from source fixture.
Copy Generic Macros - copies contents of generic DMX macros from source to target fixture.
Copy Misc Data - copies what doesn't fit in the previous categories (e.g. default DMX output)
It is not possible to copy to multiple target fixtures in one operation, fixtures must be copied
individually. Also note that for user definable color scrollers only the intensity information will be
copied, the color information will not be copied.
Notes/Hints
Changing a fixtures DMX address
The copy from fixture function may also be useful to move an already programmed fixture's DMX
address. To move a fixtures DMX address do the following:
Configure a new fixture of identical type and apply an unused DMX address (range) to the new fixture.
Save the configuration. Copy the contents from the 'old' fixture to the new fixture. Change the old
fixture's DMX address. Copy the contents from the new fixture to the old fixture and then remove the
new fixture.
The copy function may also be used to build an entire library of sequences for various fixture
configurations. Build a sequence library by programming sequences for one of each (or more) of the
relevant fixture types. In the actual installation, copy sequence and preset data to each of the fixtures
configured for the rental job. Although all the fixtures will contain the exact same data as their
respective source fixture it may give a quicker starting point for the end-users than starting from
scratch.
Clear fixture data
The clear data dialog will be shown automatically to clear data for new configured fixtures (unless it
has been disabled in the preferences menu in the fixture configuration dialog)
Clear data prompt
When configuring a new fixture and re-using a DMX address range that has been used by a previously
configured fixture, sequences and presets and other programming elements will contain data that will
most likely appear as garbage for the newly configured fixture. To clear all sequences, presets, and
other programmable data so that the new fixture receives default data only, activate Clear Fixture
Data.
To manually clear one or more fixtures, select the fixture from list of configured fixtures. Right-click
the line and select Clear Fixture Data from the popup menu. Note that it is not possible to select
this option for a newly configured fixture before a valid DMX address has been assigned to the fixture
and the configuration has been saved. It is possible to clear data for multiple fixtures by selecting all
the relevant fixtures before right-clicking.
LightJockey Help
52 LightJockey Help file - (C) Martin Professional 2010
Page 60
Clear fixture data dialog.
Clear Sequence Data Clears all data in all programmed sequences.
Clear Presets Clears all preset data.
Clear Macro Data Clears contents of generic DMX macros
Clear Misc Data Clears data that does not fit in the 2 previous categories (e.g. default DMX
values or contents of static entries)
Note that the clear data operation is irreversible - once cleared it is not possible to restore the cleared
data.
Also note that for user definable color crollers only the intensity information will be cleared, the color
information will not be affected.
See also copy from fixture
Applying default DMX to new fixtures
Normally LightJockey assumes a default value of 0 for all DMX control channels. However a some
fixtures may implement DMX protocols where 0 values may have unwanted side effects, such as
switching off discharge lamps, also some profiles includes defaults such as default pan/tilt in 'home'
position.
LightJockey will automatically apply default DMX values to new fixtures when saving the configuration,
unless disabled in the preferences menu of the fixture configuration dialog - when automatic apply is
disabled the following dialog will appear when saving a configuration that contains new fixtures.
Apply Default DMX prompt
Click Yes to the "Apply Default DMX values to new/modified fixtures" dialog when saving the new
configuration to automatically apply default DMX values to newly configured fixtures.
See also the user definable fixtures profiles, special tab, default DMX output
Customizing built-in fixture profiles
Profile types
LightJockey contains 2 different types of fixture profiles; user defined profiles and built-in profiles.
Built-in profiles are mainly used for Martin fixtures. The palettes and functions of user defined profiles
are defined through a special configuration dialog (see user definable fixtures profiles). The functions of
a built in profile can not be modified, for several profiles however it is possible to customize the
palettes (e.g. after replacing gobos in the fixture) as well as the default link to an Offline Visualizer
profile (see below).
LightJockey Help
53 LightJockey Help file - (C) Martin Professional 2010
Page 61
Customizing palette for built-in profiles
Note: Any changes to the default fixture palette will NOT be reproduced in the Offline Visualizer. The
changes only occurs in the fixture controls in LightJockey. See below for how to link a different
Offline Visualizer profile to the built in fixture profile.
Most of the built-in fixture profiles uses palettes for easy selection of effects like colors or gobos.
MAC 500 color control with default palette
To customize color, gobo and effect palettes for a built-in profile, right click the fixture icon on the
desktop and select Customize Fixture from the popup menu to open the Palette Configuration
dialog. Note that not all built-in profiles support the customize Option.
Palette configuration dialog
The palette configuration dialog lists each of the possible fixture palettes on an individual tab, e.g.
color (wheel) 1 or gobo (wheel) 2. Each line in the list corresponds to one 'effect', e.g. first color on
color wheel 1. Each effect may be represented either by a 'pure color' or by a bitmap but not both.
When a color is assigned to an effect the color is shown in the RGB column, while a bitmap is shown
as a filename in the Bitmap column. If a bitmap file is assigned but does exist the filename is
displayed in red to indicate that the file is missing.
LightJockey already supplies a number of bitmaps for colors, gobos and effects - it is also possible
(and fairly simple) to design new bitmaps. See creating custom palette bitmaps.
Assigning a Color to an effect
To assign a color value to an effect, highlight the effect corresponding line and click Color RGB
Values. Use the standard Windows color dialog to select a color for the effect.
Assigning a bitmap to an effect
To assign a bitmap to an effect, click either Gobo/Effects Bitmaps or Color Bitmaps.
LightJockey Help
54 LightJockey Help file - (C) Martin Professional 2010
Page 62
Select Bitmaps dialog
From the select bitmap dialog, drag the bitmap to the line representing the effect. Alternatively
highlight the line corresponding to the effect, then double click the bitmap in the select bitmap dialog.
Default Palettes
All built-in fixtures have default palettes assigned to them when the fixture is configured. To restore all
the palettes to default values select Default all Palettes from the options menu. To default single
palettes (the one on the 'active' tab) select Default Palette from the options menu.
Copying Palettes from other fixtures
To copy one or more palettes from another fixture, click Copy from Source Fixture.
Copy palette dialog
Use the Copy Palette dialog to select the source fixtures and copy one or more palettes from the
source fixture. Finally, to assign the new palettes to the fixture click Apply.
To define palettes for user defined fixture profiles see user definable fixture profiles
Modifying the Offline Visualizer profile link
LightJockey Help
55 LightJockey Help file - (C) Martin Professional 2010
Page 63
Note: The Offline Visualizer must me running to
Built in fixture profiles with Offline Visualizer support contains a link to a specific Offline Visualizer
fixture profile. Miost built in fixtures has the option of modifying the default link. To modify, e.g. to a
profile with a different set of gobos, open the customize dialog and select the Offline Visualizer tab.
Modifying the Offline Visualizer link
Note that the Offline Visualizer itself must be running to extract the list of available profiles. Select the
new Offline Visualizer profile to link to from the list of available profiles.
To modify the Offline Visualizer link for user defined fixture profiles see user definable fixture profiles
The select bitmap dialog
The select bitmap dialog
The select bitmaps dialog is used to assign bitmaps to palette controls when creating fixture palettes
for user defined profiles, or customizing palettes for built-in fixture profiles. Bitmaps are organized into
two groups, Gobo/Effect bitmaps and Color Bitmaps. Click the corresponding button to change the
view between gobo/effect bitmaps and color bitmaps. LightJockey organizes the bitmaps into different
libraries. Libraries are listed below the bitmaps. To see bitmaps in a particular library only, click on
the library name in the list. To see all available bitmaps click All.
LightJockey Help
56 LightJockey Help file - (C) Martin Professional 2010
Page 64
To assign a bitmap to a Palette Value, drag the bitmap directly to the line in the list representing the
palette value. Alternatively, highlight the line in the list, then double click the bitmap to associate.
Note: when assigning a bitmap by double clicking, the list automatically advances to the next item
until the last item is reached.
LightJockey Help
57 LightJockey Help file - (C) Martin Professional 2010
Page 65
Controlling and programming fixtures
Selecting fixtures for control and programming
Selecting fixtures on the desktop
Fixtures configured for control are represented on the LightJockey desktop by fixture icons
Fixture icons on desktop
Fixture selection
There several different ways to select fixtures from desktop in order to activate them for programming.
Select by clicking icons - click with the left mouse button on the fixture icon on the desktop. This
fixture now becomes the "Host fixture". By subsequently clicking on other fixture icons, these will be
selected as well.
Rubber band selection - another method is "rubber banding" a number of fixtures in one go. Do this by
holding the left mouse button down and drag a dotted square to include the fixtures to be selected.
Fixture de-selection - to de-select the fixtures either left click on individual icons or "rubber band" an
empty piece of desktop to deselect all fixtures.
Fixtures may also be selected through the fixture groups dialog.
Selection modes and filters
/
This button, located on the fixture tool bar and duplicated in the fixture groups dialog, is used to
switch between selecting single (solo select) or multiple fixtures. Clicking the button toggles between
inclusive and exclusive modes. When in Inclusive mode, selecting new fixtures will add the fixture to
the current selection. When in Exclusive mode, selecting a fixture (or group of fixtures) will deselect
all other fixtures. This allows selection of one fixture at a time, just by clicking the fixture icon. This
function may also be assigned to a keyboard hotkey function.
These buttons, also located on the fixture tool bar, selects and de-selects all fixtures respectively.
See also next/previous fixture, fixture solo
Host and client fixtures Fixture
A fixture selection may be in one of 3 different states:
Unselected fixture - blue icon caption.
Host fixture (bright red icon caption)
When in Host mode all fixture controls will relate to that particular fixture type. The fixture controls
displays the functions that are currently relevant for the selected fixture type and the values
programmed for the particular fixture. Although it is possible to select different types of fixtures it is
not possible to access functions that are not supported by the current Host fixture. For example, it
LightJockey Help
58 LightJockey Help file - (C) Martin Professional 2010
Page 66
is not possible to select the gobo control while a RoboColor II (which has no gobos) is selected as
Host. Only one fixture can be Host fixture at any time.
Client fixture (dark red icon caption)
Selected fixtures which are not selected as Host are client fixtures. Client fixture means that it follows
the Host fixtures values when these are changed on the fixture controls. e.g. when 4 Roboscan 918
fixtures are selected, 1 as Host, the other 3 as clients, setting the Host to red on color wheel 1 will
automatically set the color to red for all 4 fixtures.
Programming selected fixtures
Once fixtures are selected, they can be controlled and programmed via their respective fixture
controls . Certain programmable effects are cross-fixture type compatible, this means that changes
to the Host will also change the client fixtures even if they are not of the same type as the Host
fixture.
See also configuring the desktop, fixture icon popup
Next/previous fixture selection
The Next and Previous buttons on the fixture tool bar may be used to select the previous or
next fixture respectively. Selecting fixtures this way is mainly useful during sequence programming
where there is a need to adjust fixtures one at a time. The next/previous functions may also be
assigned to keyboard hotkeys.
Default selection
By default the buttons select the previous or next fixture based on the icon's fixture number. The
new fixture is selected as Host while all other fixtures are de-selected. The new fixture selected will
always be next or previous fixture in relation to the current Host fixture. If no fixtures are selected,
next fixture will select the fixture with the lowest fixture number, while previous fixture will select
the fixture with the highest fixture number.
Custom order selection
The order of selection may be customized. To open the custom selection dialog, right-click either of
the two buttons, or select the dialog via the Setup -> Preferences -> Previous/Next Fixture
Selection.
Previous/Next fixture custom selection
Enable next/previous buttons - use this switch to show or hide the buttons on the tool bar. Only
select same type as Host Fixture - When enabled, only fixtures of the same type as the Host
fixture will be selected as next fixture.
Selection Tabs
LightJockey Help
59 LightJockey Help file - (C) Martin Professional 2010
Page 67
Any Tab - selects the fixture from any tab.
Same as Host - selects the fixture only if placed on the same tab as the Host fixture.
Current tab - selects the fixture if it is placed on the current tab only.
Selection Order
Fixture Number - uses the fixtures number as base for selection
Custom Order - uses a custom selection order (see below)
Previous/next custom order dialog
Open the selection order list by selecting Custom Order, or by selecting Set Custom Order from the
menu. The Custom Order allows precise control over the fixture selection order. When selecting
Custom order, the Only select same type as Host Fixture and any tab restriction will be disabled.
To add fixtures to the order of selection, enable the Auto-add Host Fixture button, and select the
fixtures to add to the list by clicking the fixture icons one by one. Alternatively, select the required
fixture as Host fixture, and right-click the list to insert or add the fixture to the list. Fixtures may be
removed from the list by highlighting the line(s) and selecting remove fixture or remove lines from
the right-click popup menu. Use the Clear All function in the preferences menu to clear all entries into
the list.
Selection breaks may be inserted or added to the list by selecting a line and right-clicking. Inserting or
adding a Selection Break creates a 'break' in the next/previous selections. In the example above, the
break after fixture number 8, means that when fixture 8 is selected as Host, clicking next fixture the
selection will loop back to fixture number 5 since this is the first fixture in the block contained by the
two breaks. Likewise when fixture number 5 is selected, clicking previous fixture will loop the
selection to fixture number 9 as this is the last fixture in the block.
Fixture groups
Click the fixture groups icon on the fixture tool bar to access the fixture group dialog.
LightJockey Help
60 LightJockey Help file - (C) Martin Professional 2010
Page 68
7
Fixture group dialog
Select or de-select a group of fixtures or individual fixtures by clicking on the corresponding line in the
group view. LightJockey will automatically build fixture groups by placing all the fixtures of the same
type into groups. Disable Preferences -> Show system groups in the menu to hide system groups
Fixtures in the list may be listed by profile name or user name. By default profile names are used;
select Preferences -> Show user names to switch to user name display. User names for individual
fixtures are changed via the fixture configuration dialog.
Custom fixture groups
To create custom fixture groups select "Add Group" from the menu. Name the group then click "Ok".
The new group will now appear in the group window. To assign fixtures to the group, first select the
fixtures, then right-click on the line with the newly created group and select Add selected fixtures to
group from the popup menu. The maximum number of user defined groups is limited to 99.
Custom fixture group right-click popup
The fixture groups can be expanded to show individual fixtures by clicking on the double arrows to the
left in the list. Collapse the list by clicking on the arrows again.
Select All and De-select All selects and de-selects all fixtures respectively.
Selection Mode: Inclusive/Exclusive - the lower, leftmost button in the window toggles between
inclusive and exclusive selection mode. Inclusive mode means that more than one group or fixture
may be selected at a time. In Exclusive mode, fixtures already selected are automatically de selected
before the new selection is applied. the function of this button may be assigned to a keyboard hotkey.
The selection mode is also available from the fixture tool bar.
LightJockey Help
61 LightJockey Help file - (C) Martin Professional 2010
Page 69
Selection Filter: All/Odd/Even - use the selection filter (click button to change) to set a filter for fixture
selection/de-selection via the group window. All selects/deselects all relevant fixtures - Odd selects/
deselects fixtures with odd fixture number and Even selects/deselects fixtures with even fixture
number.
Fixture group hotkeys
It is possible to assign selection of the first 10 user-defined fixture groups to keyboard hotkeys.
Using generic DMX profiles
Generic DMX profiles
The Generic DMX fixture profile allows control and programming of DMX effects that does not have a
suitable LightJockey profile. Although a generic profile is not really that usable for programming
intelligent fixtures it may be used as a last resort control if no suitable profile is available. The profiles
are mainly used for controlling 'channel devices' such as dimmer or switch packs or DMX controllable
smoke machines or stroboscopes.
The Generic fixture profile comes in 3 flavors: Level and Switch controls and specialized controls. All
generic controls implement 8 bit control channels.
The specialized profiles contains controls for RGB Packs which are profiles for controlling devices
consisting of multiple RGB elements (typically LED fixtures); other specialized profiles are for
controlling strobes, smoke machines or hazers.
The control is accessed from the levels/extended icon on the fixture tool bar. RGB Packs are
controlled through the RGB pack color control
Generic dimmer control
Use the generic dimmer profile to control 'level devices' such as dimmer packs. These profiles can be
found under the Generic heading in the fixture configuration dialog. A number of profiles with different
capacities (from 1 to 32 channels) are supplied - select a profile that matches or has a higher channel
count than the device to control. Note that to control devices of more than 32 channels, several
profiles may be configured and addressed in continuously in the DMX address space.
Level control (8 channel profile)
To program the control drag click the virtual faders to the desired values. Use the Preferences menu
to change the value format displayed on the fader between % (0-FF) values or digital values (0-255).
To set the value for all channels simultaneously (8+ channel controls only) - right-click any fader and
check All on the popup menu. Disable All to control channels individually. The control may be
customized to display a user defined label for each of the control channels (see below). Use the the
generic DMX control to control some or all of the channels allocated to level controls without going
LightJockey Help
62 LightJockey Help file - (C) Martin Professional 2010
Page 70
through individual fixture profiles.
See also fade state buttons
Generic switch pack control
Switch control (8 channel profile)
The switch is a specialized version of the level control and has only two states: on and off. Click the
on/off button to change the state - off is represented with DMX value 0 and on is represented with DMX
value 255. Also, the switch control doesn't allow the fade state to be set to fade. Channels controlled
by a switch control will not scale under control of the grand Host or sub-Host - programmed on values
will remain unaffected until the Grand Host or relevant sub-Host reaches a value of 0 where the output
of programmed channels will modified to off (value = 0).
Customizing the generic DMX control
Channel configuration dialog
To customize the channel labels for each of the control channels, right-click the fixture icon on the
desktop, then from the popup menu select Define Fixture Profile. From the channel configuration
dialog it is also possible to disable Grand Host control for individual channels. By default, all generic
DMX channels are affected by the Grand Host. Use the dialog to disable the Grand Host for individual
channels.
See also fade state buttons
LightJockey Help
63 LightJockey Help file - (C) Martin Professional 2010
Page 71
The generic DMX control
The generic DMX control
The Generic DMX Control may be used to program Generic DMX channels across multiple generic
DMX fixture profiles. This control is very useful when programming a large number of generic channels
where specific values has to be programmed into specific channels. The control contains a map of all
DMX channels controlled by generic DMX profiles and also features a keyboard command interface for
fast programming of DMX values. The control adds data into the current scene in the current
sequence like any other fixture control except that it is not related to a Host fixture or other selected
fixture icons. To make the Generic DMX control available, at least one generic DMX profile must have
been configured first.
When available, the control is accessed from the desktop main menu (Generics) or by assigning a
hotkey to toggle the control on and off.
Programming the DMX channels with the mouse
To program channels with the mouse, select (highlight) relevant channels in the map grid and use the
level fader and off/snap/fade buttons to program the channels. The level fader will act on all selected
channels, and the fade state of each channel will default to fade (unless already programmed as
snap). The number of selected channels is displayed in the top right corner above the group list - use
the clear button to deselect all channels.
The fade state of each of the channel in the map is shown in the grid in color codes: red for 'off'
channels, yellow for 'snap' channels and green for 'fade' channels. Note that these are default colors
which may be modified (see later below).
Absolute vs. relative mode
When in absolute mode, all selected channels are set to the exact value of the level fader. In relative
movement the values of the selected channels are increased or decreased with the same amount as
the level fader is changed; e.g. if the level fader is increased with 10%, all selected channel have their
value increased by 10%. Values for all channels are capped at 0 and 255. Use the absolute and
relative buttons to change the mode.
Keyboard shortcuts
By default a number of keyboard keys are mapped as shortcuts to the level fader - note that the keys
will only work if they are not used as hotkeys.
LightJockey Help
64 LightJockey Help file - (C) Martin Professional 2010
Page 72
[Cursor Up]: Increases level by 1 unit (% or 8-bit value)
[Cursor Dn]: decreases level by 1 unit (% or 8-bit value)
[Page Up]: Increases level by 10 units (% or 8-bit value)
[Page Dn]: decreases level by 1 unit (% or 8-bit value)
[Home]: sets level to full (100% or 255)
[End]: sets level to 0
Grouping Channels
Creating and modifying groups
It is possible to group channels for faster selection. A maximum of 32 groups may be created and
each channel may be assigned to any group.
To create a group, right-click the Group list then select Create New Group from the popup menu. To
rename or delete an already existing group, right click the group name, and select Rename or
Delete as appropriate from the popup menu.
Assigning Channels to Groups
To assign channels to a group, select the channels, then [Shift]-Right click the Group in the group
list, and select Set Group to Selected or Add Selected to Group from the popup menu. To remove
channels from a group, select the channels, then select Remove Selected from Group from the
popup menu.
Customizing the Generic DMX Control
The control can be resized by dragging any of its corners, the channel grid will automatically resize to
fit the available space. Use the preferences menu to show or hide the group list and level fader
respectively. If neither is visible, the channel grid resizes itself to fill out the whole control (the
keyboard command interface is still available even if the level fader is hidden).
Customizing the Grid
From the Preferences menu use the Grid Preferences menu to customize the grid cell-size, color
scheme and the font used in the grid.
Grid customization dialogs
Hiding Channels
By default all Generic DMX fixture channels are mapped in the Generic DMX control. Channels may
be removed from the map (hidden) by highlighting the relevant channels and then selecting Hide
Selected Channels from the options menu to remove the selected channels from the map. The
number of hidden channels will be noted in the window caption of the Generic Control. Click Show All
Channels to make all channels visible again.
Options Menu
Delete All Groups - deletes all groups
Clear All Groups - clears all groups without deleting the groups
Hide Selected Channels - hide selected channels.
Show All Channels - show all channels.
Preferences Menu
View Group List - toggles visibility of the group list
View Level Fader - toggles visibility of the level fader
Use % Values - when enabled all level values are displayed and programmed as % values (0-100%),
LightJockey Help
65 LightJockey Help file - (C) Martin Professional 2010
Page 73
when disabled all level values are displayed and programmed as 8 bit values (0-255)
Grid Preferences
Auto Set Matrix Size - When disabled the channel matrix does not automatically resize when the
control is resized
Mouse Select Rectangles - When enabled the mouse selects cells in the grid in spread-sheet style
(rectangles), when disabled the mouse selects by 'painting' cells.
Auto-Scroll to first selected channel - when selected, the grid will always automatically scroll to first
selected channel whenever selections are changed.
Grid Size, Grid Font, Grid Colors - see Customizing the Grid above.
Keyboard Preferences
Show Command Line - toggles the visibility of the command line (see below)
Lock Cursor keys to grid - locks the keyboard cursor keys to selecting cells in the grid (should not be
used together with the command line interface).
Empty Command Clears Selection - When enabled, an empty command line followed by [Return]
clears the channel selection.
The keyboard command interface
In addition to the mouse programming interface, the generic DMX control also implements a keyboardoriented command interface. The keyboard interfaces uses the command line below the channel map.
The command interface may be enabled or disabled using the show command-line option in the
preferences -> keyboard preferences menu. The command interface implements a quick way to
access and program channels, and to minimize the number of keystrokes it uses different symbols for
various functions:
Note that in order to be able to accept keyboard commands the generic control must have the
Windows focus (must be the active window) and the keys must not already be assigned as standard
hotkey functions. When the [Enter] key is pressed, the command line is automatically cleared. Use
the Recall button to recall the last command non-empty command line (if any).
Selecting or de selecting channels
To select a (highlight) channel simply type in the cannel number followed by [Return]. To select
multiple channels, use a + between channels, e.g.; 1+3+5 selects channels 1,3 and 5. To add
channels to the current selection, precede the first channel with the + operator, e.g.: +1+3+5 adds
channels 1,3 and 5 to the current selection. If there is no + operator, the current selection will be
cleared before selecting the new channels.
To deselect channels, precede the channel with a -, e.g.: -1-3-5 will deselect channels 1,3 and 5
from the current selection.
To select a channel range use / between low and high channel number, e.g. 45/77 selects channels
45 through to 77.
The select (+), deselect (-) and through (/) operators may be combined, e.g. the command: 1/10-4/6
+12 selects channels 1,2,3,7,8,9,10 and 12.
Selecting groups
To select groups rather than single channels use the #[group no] symbol, e.g.: #1 selects all
channels in group 1. The +, -, and / operators may be used the same way as when used with single
channels. When using the / operator, do not add a second # to the second group number, e.g.: #1/5
selects groups 1 through 5 while #1/#5 is considered an input error. Note that the '.' or ',' keys present
on the numerical keypad of most full-size PC keyboards may be used for the # symbol as well.
Setting levels
To set the value of the selected channels, use the @ operator. For example, the command @10 sets
the value of all selected channels to 10 (% or 8-bit value, see later). Use the + or - operators to set the
values relatively, e.g.: @+10 will increase the level value for all selected channels, @-25 will decrease
the value for all selected channels with 25. Note that the * key present on most numerical keypads on
LightJockey Help
66 LightJockey Help file - (C) Martin Professional 2010
Page 74
full-size PC keyboards may be for the @ symbol as well.
Setting Fade States
Use o or O to set the state to Off for selected channels. Use f or F to set the state to Fade for
selected channels. Use s or S to set the state to Snap for selected channels.
Special key combinations
## selects all channels. @@ programs all channels to the following value. [Return] on a blank
command line deselects all channels (may be disabled, see preferences menu)
Combining multiple commands
Since the whole command line is not evaluated before the [Enter] key is pressed, multiple commands
may be given in the same line, e.g: #1/3F@50-#2@+10 [Enter] selects groups 1 through 3, sets the
fade states to Snap, then programs the level to 50, deselects group 2, and finally increases the level
of the channels in the remaining groups (1 and 3) by 10.
The RGB pack color control
The RGB pack profile is designed to control packs of RGB only devices - typically devices that
consist of a number of Red, Green and Blue LED modules.
Each of the 'pack' profiles implements a number of individual RGB devices in one profile. The fixture
profiles can be found under the Generic manufacturer heading in the fixture configuration dialog.
Depending of the number of RGB modules, the profile may use up to 30 contiguous DMX channels
and expects device control channels being mapped as Red, Green and Blue intensity controls (in that
order) for each RGB module (Red, Green, Blue, Red, Green, Blue, Red...etc - a different control
channel layout may be patched via the global patch dialog).
Fixture Icon - RGB Pack x10
The RGB pack color control
The color control consists of two parts - status panels for each of the (up to) 10 individual RGB
modules and a programming panel to the right.
RGB fixture status panel
The RGB module panels displays the current programming status for each of the individual RGB
modules. Each panel shows the current DMX values for the red, green and blue control channels both
as a graphical bar and as numeric values. The panel also shows the color resulting from mixing the
LightJockey Help
67 LightJockey Help file - (C) Martin Professional 2010
Page 75
Red, Green and Blue colors - note that the color is a theoretical estimate and the actual color from
the device may look different.
Selecting the RGB fixtures for programming
Enable programming of individual RGB fixtures by enabling one or more status panels - click the
individual fixtures status panels to toggle enabled/disabled state, [Ctrl]-click to enable a single fixture
only. Enable fixtures have their caption highlighted in red just as fixture icons on the desktop.
The programming panel
When at least one status panel is enabled, program the RGB fixtures using the programming panel.
By default the programming panel remains hidden as long as no panels are enabled (check
preferences -> Always show programming panel to keep visible all the time). The programming panel
interacts with enabled panels only. The programming panel has controls for individual programming of
each of the 3 red green and blue control channels, as well as a controls for hue, saturation and value
(HSV) which affects two or more control channels at a time. Hint: to program pure white using the
HSV controls, push saturation to full white and use value to set intensity.
When using the control panel to program - ALL fixtures represented by the enabled status panels are
programmed. Click All to select all status panels - click None to deselect all status panels. Right
click a on panel and select Update to transfer contents of the control panel to the panel ; click the
Update button to update all selected panels with the values and fade states contained in the
programming panel.
Double click a panel (or right click the panel and select Get color from the popup menu) to transfer
the contents of the panel to the control panel.
Click Color Dialog to select a color value using the built-in Windows color picker to select an RGB
value directly (there is no feedback from the dialog to the fixtures - the color is not applied before
approved by clicking Ok).
Customizing panel captions
RGB pack configuration dialog
The captions of each of the individual fixture panels may be customized for better identification. To do
so, right click the fixture icon on the desktop and select Define Fixture Profile from the popup
menu. Use the RGB pack configuration dialog to set captions of the individual panels.
RGB Palette
Click Palette -> RGB Palette on the RGB control menu to access the built in RGB palette (select
Userpalette to access the standard user palette for color controls).
Note that RGB palette may not be available for all types of RGB controlled fixtures.
LightJockey Help
68 LightJockey Help file - (C) Martin Professional 2010
Page 76
The RGB palette
Unlike the standard user palette which contains and assigns color values to the RGB pack control as
one unit, the RGB palette is used to assign color values to individual RGB panels. The palette is user
definable and may contain different palette types, each type in its own folder. To apply a color entry
from the palette, enable one or more panels and double click the color. Alternatively enable browse
from the preferences menu to apply a color from the palette just by highlighting it.
Adding an entry to the palette
To add an entry to the RGB palette, right click a status panel containing the color and select Add
color to RGB palette from the popup menu; this will open the RGB palette with an extra panel.
Select the palette type from the Type drop down box (or type in a new designation for the type), and
type the color name in the name field. To delete an entry right click and select Delete entry from the
popup menu. Deleting a folder containing multiple entries deletes all entries in that folder.
To if a particular color is already included in the RGB palette, right click the status panel and select
Find color in RGB palette. Note that the function will find he fist entry of a given color only (the same
color value may exist with different type and or name).
See also fade state buttons
Fixture controls
All types of fixture effect control are included in the following control groups:
Intensity controls
Movement/position controls
Colors controls
Gobo controls
LightJockey Help
69 LightJockey Help file - (C) Martin Professional 2010
Page 77
Beam controls
Effects controls
Extended Controls
Lamp controls
Generic DMX level controls, Extended controls for built in profiles or Extended controls for user
defined profiles
Fixture reset
Each fixture control consist of one or more control elements
Fade state buttons
The fade state buttons together with scene and fade times to control the dynamic transitions of the
programmable effects. Each DMX channel programmable by the control, has an associated fade state
button.
Different effects will default to either snap or fade, however the fade state can be changed by clicking
on the fade state button; note that left and right-clicking on the button cycles the off, snap and fade
states differently. It may not be possible to set the state to fade for certain effects.
Off This effect will not be included in the scene.
Snap The value will snap, effectively move as fast as physically possible from its current
position to this programmed position (unless the effect is slowed down by a separate speed control
value)
Fade The effect will be moved from its current position to the new position in a timed fade. A
timed fade means that DMX values will be calculated in a way moves the effect at a certain speed to
reach the target. The time, and thus the speed, is determined by the current scene and fade time.
Note that the default scene fade time is 0.05 seconds - this value is interpreted as a snap by the DMX
output engine, so in order to have effects fading,
the scene fade time must be changed from 0.05 seconds to something higher using the sequence
control. Note that all effects programmed to fade in the same scene will use the same scene fade
time, the fade time is not individual from effect to effect.
To understand how snap and fade works, it is probably easiest to look at the DMX output monitor.
Select a single fixture, and default all values for the fixture (clear the current sequence and cue). Open
LightJockey Help
70 LightJockey Help file - (C) Martin Professional 2010
Page 78
the DMX output monitor by right-clicking on the fixture icon and select DMX Output. Select a simple
effect such as intensity or color and write two scenes that moves this effect from one position to
another. Try experimenting with snap and fade settings and different scene and fade times.
Multiple function buttons
Mac 500 Gobo Control - multiple functions to one fade state button.
One fade state button may control more than just one effect - actually, a normally fade state button
controls the transition of one DMX channel, for certain multi channel functions it may control the fade
state of more than one channel.
A fixture may also have more than one function on the same DMX control channel. This means that
the same fade state button determines the transition for all of the effects on that channel. e.g. the
MAC 500-S fixed gobo has 3 functions allocated to the same channel: gobo selection, wheel scroll
and gobo shake. Since these are all controlled via the same control channel, It is not possible to
program transitions for these effects individually.
Multiple fade buttons for the same channel
Roboscan 518 - linked fade buttons
Sometimes when fixtures contain different types of functions on the same DMX channel, the functions
are split on to different fixture controls - however the corresponding fade state buttons on each of the
controls are linked (in fact programming the same DMX channel transition). In this case it is not
possible to use individual fade state on the different effects. Also, usually the functions themselves are
exclusive, for example on the Roboscan 518 it is not possible to program a strobe AND a lamp
command into the same scene, as they use the same DMX channel for the commands.
Fixture control elements
Drag bar controls
Drag bar control
The drag control is used to select one out of a range of values (for example to select intensity value).
To set a value left-click anywhere on the bar, and hold the mouse button to drag the value left and
right in the control. Left-click on either the two arrow buttons to modify the values in small steps, or
right-click the buttons to set min or max values respectively. Usually the control is organized so that
values that result in lower or slower effect are to the left (low values) and higher or faster values to the
right. Note that even though the bar may display the selected the value in percentages, it does not
necessarily mean that these values have the same physical effect across fixture types. For example
50% gobo rotation speed on a MAC 500 is NOT the same speed as 50% on a Roboscan 1220.
LightJockey Help
71 LightJockey Help file - (C) Martin Professional 2010
Page 79
Scroll Controls
Scroll controls are used to select effects with an 'image' effects such as colours, gobos and prisms.
Scroll controls are often combined with palette controls.
Gobo scroll control
These buttons operates much like buttons a CD player, click on this button to shift the effect
one complete 'effect' (e.g. one complete gobo).
Clicking these buttons decrements or increments the corresponding DMX control channel by
one. For example. when programming a color wheel it will only move a small amount compared to a
complete color using the 'complete effect' buttons. Use these buttons to achieve split effects for
fixtures that includes this option in the DMX protocol (not all fixtures support split effects).
Programming split colors
Scroll controls are only available for built-in fixture profiles.
Palette controls
Palette controls are used to select effects such as colors, gobos or prisms directly, to select the
effect left-click on the icon. Note that palette controls may be hidden via the local control preferences
menu to reduce the overall size of the fixture control.
Color palette
Effect palette
Special controls
Some fixture controls include special function controls. The special functions calls up predefined
functions that are built into in the fixture. These functions are usually dynamic effects such as pulse
effects, or relies on the fixture to call up random values such as a random CMY value. Special
controls are only available for built-in fixture profiles.
Mac 500 intensity control - special controls section
The special control section may be shown or hidden from the local control preferences menu.
See also fade state buttons
LightJockey Help
72 LightJockey Help file - (C) Martin Professional 2010
Page 80
User palettes
The user palettes are accessible from the menu of most of the fixture controls (except lamp control,
and pan/tilt controls) and offer a quick way of assigning predetermined values to the fixture controls.
Note that the user palettes may not be available for fixture types.
User color palette
When using palettes please observe the following:
1. When assigning a user palette entry to a fixture the actual values are assigned, not a reference.
This means that if a palette entry is changed - this change will not affect scenes and sequences
already programmed with the old values.
2. The fade state of each of the effects is saved together with the actual values. When applying the
palette values, only entries with a fade state of fade or snap will be applied. This way it is possible to
create palettes covering a sub-set of the palette functions, making it possible to create combinations
of palette entries of same type; for example separate entries for iris and for focus even though they
both are beam controls.
3. Palettes must be manually updated when new fixtures are added or modified in the fixture
configuration.
Fixture selection filter
Use the fixture selection buttons in the lower left to decide which fixtures to include when creating,
modifying or applying palette entries:
Host fixture - applies values to the entry for the Host fixture only
Selected fixtures - applies values for all selected fixtures
All Fixtures - applies values for all fixtures
Creating and modifying user palette entries
Program the contents of a user palette entry in the current scene and click Save. To modify an
existing entry, highlight it first before saving. In the save dialog, click Save as New to save as a new
entry, or Save to modify an existing entry.
Using palette entries
To apply a palette entry to one or more fixtures, first select the fixtures then either highlight the entry
and click Assign, or simply double click the entry. Note that the fixture selection filter is also applied
when assigning palette entries.
Clear
Clicking the Clear button will clear values from selected fixtures if the values are identical with the
values contained in the palette entry.
LightJockey Help
73 LightJockey Help file - (C) Martin Professional 2010
Page 81
Intensity control
Intensity controls for built in profiles
Click the Intensity icon on the Fixture tool bar to access the fixture intensity control.
Example MAC500/Roboscan 918 intensity control displaying special functions
An intensity control usually contains a shutter button, a strobe and an intensity drag bar. The shutter
button controls the fixture shutter (light on/off), while the intensity bar controls the actual intensity of
the light output. Note that not all fixtures have separate shutter and intensity controls, and some
fixtures do not have any intensity controls at all (e.g. Roboscan 812 that uses color and gobo wheels
to obtain a blackout). However with fixtures implementing both a shutter and an intensity control, the
shutter must be opened in addition to the intensity setting to enable any light output (hint: the default
DMX output may be modified so the shutter by default is open). The strobe drag bar controls the
strobe frequency.
Note that shutter, intensity and strobe controls are compatible across fixture types.
Intensity control with lamp on/off
Some intensity controls may implement lamp controls to control power to a fixture equipped with a
halogen lamp. Do NOT confuse this with the lamp control that is for discharge lamps only.
The special functions controls seen in the above example may be shown or hidden from the local
preferences menu.
See also fade state buttons, fixture control elements, Intensity controls for user defined profiles
Intensity controls for user defined profiles
Click the Intensity icon on the Fixture tool bar to open to the fixture Intensity control.
Intensity control
An intensity control may contain a shutter button and drag bars for strobe and intensity drag. The
actual controls depends on the user defined profile. Some profiles may not have intensity functions at
all, while other fixtures may combine controls on the same channel making it impossible to program
effects individually. Use the shutter button to open and close the fixtures shutter (light on / off) - note
that some fixtures may not have separate shutter and emulates shutter with the gobo or color wheel.
Use the strobe drag bar to program the strobe speed from minimum to maximum frequency - some
fixtures may not implement a separate mechanical strobe but use the gobo or color wheel to strobe.
Use the intensity drag bar to program the intensity level for the fixture.
LightJockey Help
74 LightJockey Help file - (C) Martin Professional 2010
Page 82
See also fade state buttons, fixture control elements and intensity controls for built in fixtures
Movement and position control
Position control
Pan/tilt control
Important note: Mouse vs. touch devices for position control: In order to obtain the maximum
resolution for fixture pan/tilt positions, the pan/tilt grid implements a special interpretation of normal
mouse commands so the virtual size of the grid may be extended to a maximum size of 65536 x
65536 (representing full 16 bit pan/tilt resolution). The special interpretation involves a
programmatically reset of the mouse cursor position each time the mouse is moved. This approach
does not t work very well with touch devices where the cursor position (e.g. the users finger) cannot
be reset by LJ.
To make the position grid work with touch devices, select Preferences -> Left-Click Mode -> Touch
from the position control menu. To switch back to normal mouse mode, select Preferences -> Left-
Click Mode -> Mouse. Note that touch mode, can also be used with a mouse device - a touch device
is not a requirement for using touch mode. For more details on touch control, see below.
Typical pan/tilt position control
The picture shows a typical position control with pan/tilt control for fixtures such as scanners with a
mirror, or moving yoke fixtures. The primary control is the position grid. The dot represents the
absolute pan and tilt position of the mirror or yoke.
Mspeed control
Some fixture profiles implement an extra 'speed' control on the position control. The exact function of
the speed parameter depends entirely on the fixture itself, different fixtures may use the parameter in
different ways (e.g. slow or fast at low values).
Adjusting the position of one or more fixtures
To adjust the position of one or more fixtures, select the fixtures, then in the grid left-click and drag
the white dot to the desired position.
LightJockey Help
75 LightJockey Help file - (C) Martin Professional 2010
Page 83
It is also possible to move the pan and tilt by using the arrow buttons in the lower right side of the
control. Click and hold a button to move the fixture in one direction to a given direction.
Click home . to center the fixtures position.
The two buttons marked pan lock and tilt lock will lock the and tilt positions respectively. When
locked the position can be moved in one plane only.
Use the "Resolution" drag control to adjust the fineness of the position controls. The less the delta
value, the less the position will change when dragging in the position grid, or when clicking the arrow
buttons.
Click to clear an active movement macro.
Left-click options
Use the preferences menu to select one of two left-click modes: Mouse Mode (default) - select this
mode when using a mouse or trackball type device to control position. Touch mode - select this
mode when working with a touch type device.
Touch Mode
When in left-click touch mode, there are two distinct operation modes. Direct mode or 'joystick' mode.
The two modes are toggled between by clicking the Dir/Joy button located next to the 'arrow' buttons.
Position grid, joystick mode
Direct Mode
When in Direct Mode (Dir), the pan/tilt is set according to the position in the grid - resolution factor is
ignored.
Joystick Mode
In Joystick mode, the pan/tilt position is continuously modified as long as the device is 'activated' The
distance from center is combined with the resolution parameter to define a 'speed' of position change the direction of change is given by the direction of the 'line'. The direction/speed is illustrated by a
LightJockey Help
76 LightJockey Help file - (C) Martin Professional 2010
Page 84
'joystick' superimposed on the pan/tilt grid.
Note: Joystick mode has nothing to do with a physical joystick. The position grid cannot use an
attached Joystick to control position.
Right-click options
Use the preferences menu to select one of two right-click modes. Goto Position (default mode) - the
'dot' jumps to the position where the cursor is located. Note that relative movement (see below) does
not work with goto position. Lock Cursor in Grid - the mouse cursor locks to the 'dot' until the next
mouse click (handy option when using the follow spot option).Note: that if Left-click Touch mode is
selected, all right-clicks will be Goto Position regardless of setting.
Position presets
Apply or clear presets
Click Apply to the currently selected preset, clear to clear any assigned preset - see position presets
Absolute positioning vs. Relative movement
Use the absolute/relative button to toggle between 'Absolute Position' and 'Relative Movement' mode.
When in absolute position mode all selected fixtures are programmed with the same position
information (e.g. pan, tilt = -1234,1234). In relative movement mode all selected fixtures are
programmed with the same relative movement distance. This means that if the pan position of the
Host fixture is moved 50 positions to the left, all selected fixtures are programmed to move the
position 50 positions to the left. The relative mode may be used to keep beams together, or held in a
specific pattern, when moving multiple fixtures around, although the usefulness depends on the
fixtures position and where the pan and tilt is pointed. See also follow spot function. Right-clicking on
the position grid or clicking the home button always uses absolute position mode.
Notes on relative movement
Since fixtures with 8-bit pan/tilt has much less resolution on pan and tilt positions than 16-bit fixtures,
moving both 8- and 16-bit fixtures in relative mode in a 16-bit position control (16-bit fixture as Host
fixture) does not work properly. Small movement values are simply rounded off and possibly ignored
when sent to 8-bit fixtures. To move 8- and 16-bit fixtures together in relative mode, make sure an 8bit fixture is selected as Host fixture.
The Options Menu
Position Options
The position options control
Mirror Pan - the pan position is mirrored over the vertical centerline (pan = 0) on the position grid.
Mirror Tilt - the tilt position is mirrored over the horizontal centerline (tilt = 0) on the position grid.
Swap Pan / Tilt - the fixture's pan and tilt coordinates are swapped.
Pan 360 - may be used to program fixtures with more than a 360º pan range (moving yoke fixtures) -
clicking the button will, if possible move pan a full 360 degree rotation.
Fan Out - see position fan out
LightJockey Help
77 LightJockey Help file - (C) Martin Professional 2010
Page 85
See also movement macro engine, position fan out and non pan/tilt movement controls
Position fan out
Fan out dialog
Select Options -> Fan Out from the position control's menu to open the fan out dialog.
The fan out dialog is used to set various fan-out patterns quickly in installations where fixtures are
hanging symmetrically. The fan out tool works by modifying pan and tilt values on all selected fixtures
in the current scene by symmetrical amounts. To create a fan out pattern, select two or more fixtures
and drag the delta pan and delta tilt bars to set the range of the fan out. If an odd fixture number is
selected, the 'middle' fixture will act as a center for the pan and tilt fan-outs respectively. If an even
number of fixtures is selected, the pattern will form around a 'virtual' center fixture.
Enable Center Delta on Home to default the middle fixture's pan and tilt to the home position.
The spread functions are used to spread the pan and tilt over a 'physical' range. It works by
distributing the pan and tilt delta from the actual position of the first and last fixture in the selection
order. The effectively of the spread function depends very much on the actual physical locations of the
fixtures.
Custom order
The order of which the pan and tilt delta values are applied to the fixtures may be changed in the apply
values by selections. Using the custom options opens up a list where the fixture order may be
customized. To add a fixture to the list, select the fixture icon. To remove a fixture from the list,
deselect the fixture icon. The selection order may be changed further, by dragging the lines around in
the list. Custom selections may be saved for later use.
click to open the save selection dialog.
Click save to re-save an existing selection or save new to save the current selection as a new
custom selection. Previously saved selection are available from the selection box in the lower right
hand corner of the control.
LightJockey Help
Click to clear the current selection.
Click to delete the selection.
78 LightJockey Help file - (C) Martin Professional 2010
Page 86
Movement macros
LightJockey features a built-in engine for automatic generation of pan and tilt movements. To access
the movement macro control, select Macros in the pan/tilt position control menu.
Movement macro control
The major difference between the movement macros and normal position programming using the pan
and tilt position control is that the a movement macro is a continuous dynamic movement on pan and
tilt contained in one static scene, for example continuous movement in a circle or a figure eight. A
movement macro overlays the programmed pan and tilt, so it is possible to move the macro figure
around by modifying the regular pan and tilt positions.
To stop a macro from executing in the current scene, set the fade state of the macro type to off,
select No Macro from the drop down or click Clr Macro on the position control to clear the macro
settings from the current scene.
Macro display window.
The the left side of the control displays a real time representation of the progression of the macro by
tracing the fixtures pan and tilt coordinates. The display tracks the macro of current Host fixture only.
To show the position for all selected fixtures, enable preferences -> Show all selected fixtures non Host fixtures positions are displayed as red dots.
Macro - traces the pan/tilt values generated by the macro.
Fixture - traces the pan/tilt position of the fixture(s) with the macro overlaying current pan/tilt position
Clear Image - Clears and restarts the tracing.
Macro Type
This list contains the possible macro types. There are 6 different system macros built into
LightJockey. System macros are all based on variations of continuously repeating variations of sine
and cosine curves. To create a new, user defined macro shape, select Bézier Shapes from the
menu.
Macro parameters
Pan Amplitude - this parameter controls the amount of amplitude applied to the pan parameter. The
higher the value, the further the pan will be moved by the macro.
Pan Cycle (time) - this parameter controls the 'speed' at which macro executes for pan control. The
value displayed is the time taken for one cycles of the macro. Pan and tilt cycle times are combined
into one common cycle time control for ellipse and stepped ellipse macros.
Tilt Amplitude - this parameter controls the amount of amplitude applied to the tilt parameter. The
higher the value, the further the tilt will be moved by the macro.
LightJockey Help
79 LightJockey Help file - (C) Martin Professional 2010
Page 87
Tilt Cycle (time) - this parameter controls the 'speed' at macro executes for tilt control. The value
displayed is the time taken for one cycle of the macro.
Macro Step size (Stepped Ellipse Macro only) - the Macro Step size parameter regulates the
'coarseness' of the macro by reducing the number of positions contained in the macro. Altering the
macro step size does not change the macro cycle time. The higher the step value the coarser the
macro appears - at step size 512 the ellipse only contains 8 pan and tilt positions. Reducing the
number of points may cause slower moving fixtures to 'perform better' on faster ellipse macros. The
actual 'look' of the macro depends on the fixture used as well as the combination of cycle time,
amplitude and step size - some fixtures may not show any improvement at all. Since a high step size
combined with a low speed (high cycle time) produces a very pronounced stepped movement, the
stepped ellipse macro may also be used to produce 'special effects'.
Delay - this will 'delay' the fixtures position in the macro cycle. Assign individual delays to fixtures
performing the same macro for a more varied look. See below for a detailed explanation, also see
auto-delay.
Tweak - this will tweak the macro a little (by tweaking the phase of one axis) - the result depends on
the actual macro and the other parameter settings.
Auto Delay - click the auto-delay dialog (in the menu) to systematically apply delays to several
fixtures.
See also generic DMX macros
Select Bézier Shapes from the menu on the movement macro dialog to extend the dialog with the Bézier shape editor (the editor will also automatically be displayed if a Bézier shape is selected from the macro types drop down).
Bézier shape editor
A Bézier shape macro is a kind of macro where the shape is defined by generating a number of
positions from lines between points. Bézier shape macros can be created, modified, saved and
retrieved by the user. To create a new shape, click Bézier Shape in the menu and select New
Shape - the movement macro control is now displaying the Bézier shapes editor (on the right) with
the default diamond shape in it. The shape has a number of 'points' - the square points are called
nodes, the round ones are handles, there are two handles for each node. It is very easy to re-define
the shape simply by dragging the nodes or handles around, manipulating it into another shape. Rightclicking either of the nodes (the square ones) or somewhere on the grid gives several further
manipulation methods. It is possible to add or remove nodes, rotate and zoom the shape, etc. It is
also possible to straighten elements between nodes by making them into lines, or re-convert them
into curves again.
When the Bézier macro is modified the system re-calculates the array values on the fly. Note that the
values are calculated with a fixed amount of points between nodes - this means that the time taken for
the macro to move between nodes are the same, regardless of the distance involved. This means that
a fixture will move slower between nodes that have a short path between them, and faster if the path is
longer.
To the macro engine, there is really no difference between the system macros and the Bézier macros,
both are still represented as two sets of values, one for pan and one for tilt and the cycle time and
LightJockey Help
80 LightJockey Help file - (C) Martin Professional 2010
Page 88
amplitude parameters applie to the Bézier shape macros as well as the regular system macros.
Saving a new shape
Save the current shape by selecting Save shape or Save as new shape from the Bézier Shapes
menu.
Using an existing shape
To use an already existing shape simply select it from the Macro type drop down list.
Deleting shapes
Delete Shapes from the Bézier Shapes menu. Select Delete Shape to delete the current shape
and Delete Shapes to delete multiple shapes at once.
The auto delay function is accessible from the menu of the movement macro control.
Auto delay dialog
The auto delay works by automatically and systematically applying a delay value for the movement
macro to each selected fixture. To apply a delay to a range of fixtures, simply select the fixtures on
the desktop. While the delays will normally be a part of the same sequence that contains the other
macro parameters, they don't have to be - they can part of another sequence in the cue. When
applying the delays, use the Macro Control to visualize the result - check Track All Selected
Fixtures in the preferences menu.
Max Delay
The delays applied to the fixtures are normally spread over a range of 0% to almost 100% (100% is
identical to 0%). Use the Max Delay parameter to limit the maximum delay applied. The Max delay
values ranges from 1 to 256, 256 represents the maximum delay, 128 represents a maximum 50%
delay, etc. Lower the Max Delay value to generate Follow the Leader type of effects.
System Ellipse, Max Delay = 256 (100%)
LightJockey Help
81 LightJockey Help file - (C) Martin Professional 2010
Page 89
System Ellipse, Max Delay = 128(50%)
System Ellipse, Max Delay = 64(25%)
Delay Style
Linear delay is applied to the fixtures in a linear fashion, ranging from 0% to 100%. For example if a
linear delay (max = 255) is applied to 4 fixtures the following delays are applied:
Fixture 1: delay 0% - of Max Delay.
Fixture 2: delay 25% - of Max Delay
Fixture 3: delay 50% - of Max Delay
Fixture 4: delay 75% - of Max Delay
The linear delay ensures that two fixtures will never get the same delay value.
Circular delay means that the fixtures are applied a linear delay in a circular (repeating) pattern. Use
the circular fixture count value to indicate how many fixtures in the pattern. For example if a circular
delay is applied to 6 fixtures with a fixture count of 3 the following delays are applied :
Fixture 1: delay 0% - of Max Delay
Fixture 2: delay 33% - of Max Delay
Fixture 3: delay 66% - of Max Delay
Fixture 4: delay 0% - of Max Delay (repeating the pattern)
Fixture 5: delay 33% - of Max Delay
Fixture 6: delay 66% - of Max Delay
Segments applies the delay to the fixtures in segments. This usually means that two more fixtures in
the delay order (see later) will get the same delay. The function will divide the fixtures into the number
of segments indicated in the segments value, so if 6 fixtures are applied a segmented delay with a
segment count of 3, the following delays are applied to the fixtures:
Fixture 1: delay 0% - of Max Delay
Fixture 2: delay 0% - of Max Delay
Fixture 3: delay 33% - of Max Delay
Fixture 4: delay 33% - of Max Delay
Fixture 5: delay 66% - of Max Delay
Fixture 6: delay 66% - of Max Delay
Random delay is applied to the fixtures randomly (taking the Max Delay value into account).
Delay Order
Use delay order to in which order the delay values are applied to the fixtures. The order can be either
by fixture number or fixture icon horizontal or vertical position.
LightJockey Help
82 LightJockey Help file - (C) Martin Professional 2010
Page 90
Position presets
What is a position preset
Presets, are also known as 'preset focus' (position focus, not optical focus). Scenes containing
presets for effects contain references rather than an absolute 'physical' values. The result generated
by the sequences depends on the actual contents of the reference, not the absolute contents of the
scene. LightJockey implements presets for pan/tilt positions only. The maximum number of position
presets that can be created is 99.
Example of using presets:
When programming for a band on tour, it is often useful to use presets for beam positions rather than
absolute pan/tilt values via the pan/tilt position control. For example, when lighting the drummer,
create and use a preset rather than moving the pan and tilt values directly to the drummer position in
every relevant scene. Later, when in another venue, or when the drummer position or the fixtures are
physically moved, simply change the values that are contained in the preset; now all every scene
where the 'drummer' preset is used will automatically use the new physical values. Without presets
every fixture in every scene that lights the drummer will have to be modified one by one. Also, since it
is possible to name a preset, it is often much faster to apply named positions to fixtures, rather than
have to move them one by one to the desired position. It is not necessary to move fixtures to the
same physical position in a preset, a preset could easily contain a for example beam fan pattern. It is
also possible to use different presets for different fixtures on the same scene, for example 2 fixtures
on preset 'drummer', and 2 on preset 'lead vocal.
Using position presets
The position preset dialog is accessed through the Preset menu on the pan/tilt position control.
Position preset dialog
Creating and editing presets
Before any presets can be applied to fixtures, they must be created first. Create a preset by moving
the individual fixtures to the desired position and click Save Preset (hint : give the preset a good
name that identifies that position clearly - this will save time later when editing presets). The saved
preset will now be displayed in the list. When saving a new preset, a value will be saved for all fixtures
- fixtures excluded by the fixture selection (see below) will save the default top/left pan/tilt position.
When editing an existing preset the fixture selection will decide for which fixtures the preset is
modified.
Host fixture
Selected Fixtures
All Fixtures
Make sure that the correct preset is selected in the preset list before re-saving the preset.
LightJockey Help
This will modify values for the Host fixture only
This will modify values for all selected fixtures.
This will modify values for all fixtures.
83 LightJockey Help file - (C) Martin Professional 2010
Page 91
Applying presets to fixtures
There are two methods to apply existing presets to fixtures.
Applying presets from the pan/tilt control
The first method is to open the preset dialog, and high-light a preset in the list, and then use the apply
button on the pan/tilt control. This will apply the preset to all selected fixtures. The second method is
to select highlight the preset line in the preset list, and then click Apply. Or simply double-click the
preset line. When using the dialog the local selection filter is used:
Host fixture
Selected Fixtures
All Fixtures
This will apply the preset to the Host fixture only.
This will apply the preset to the selected fixtures.
This will apply the preset to all fixtures
Once a preset has been to a fixture applied, the pan/tilt coordinates in the bottom of the position
control will be replaced by the preset name.
Clearing presets
There are several ways to clear an applied preset. The easiest is to select Clear on the position
control, this will 'dissolve' the preset into the pan and tilt values contained in the preset. Alternatively
click Clear on the preset list, and set the fixture selection accordingly. Finally, any changes in pan
and tilt values in the position control, will clear automatically clear the preset and replace the preset
with the physical pan and tilt values.
Deleting presets
To delete a preset, right-click the preset in the list and select Delete preset. Note that it is possible
to delete a preset that is all ready in use in sequences.
Auto Apply Preset
The preferences menu contains an option to automatically apply the preset to the fixtures when saving
the preset. Saving with this option enabled is identical to first saving the preset, and then clicking
Apply on the preset list.
Non pan/tilt movement controls
A number of built in fixture profiles implements movement controls that aren't really traditional pan tilt
controls. Examples are Martin Wizard, SynchroZap or Centerpiece. Although accessed the same way
as the pan/tilt position control, they do not include options such as position presets or movement
macros. Often the controls are used to set continuous movement such as rotation of the mirror drum
of the Martin Wizard as well as a static position such as the swivel position of the Wizard's mirror
drum.
Wizard movement control
LightJockey Help
84 LightJockey Help file - (C) Martin Professional 2010
Page 92
Centerpiece movement control
Color control
Color controls for built in profiles
Click the color icon on the fixture tool bar to access the fixture color control.
Color control for Roboscan 1220 CMYR with two color wheels, wheel scroll and CMY color mixing
The control implements two methods for selecting a color. Use the scroll control to select a color.
Click to select next or previous colors on the wheel. Click to position the color wheel
between colors for a split color effect use the split buttons (not all fixtures allow selection of split
colors)
Alternatively, use the color palette to select colors directly by clicking on the color icons.
Color palette
To make a control take up less desktop space, the color palette may be hidden by de-selecting
Preferences -> Show palette on the main control.
Color controls for multi-head fixtures
LightJockey Help
85 LightJockey Help file - (C) Martin Professional 2010
Page 93
RoboColor multi-head mode
RoboColor single-head mode
Controls for fixtures with multiple heads such as the Martin RoboColors may be switched between
single and multi head mode by setting Preferences -> Show all heads. When in single head mode
only one control/palette appears and all heads are automatically synchronized during programming.
CMY Color Mixing
CMY controls
Use the drag bars to set cyan, magenta, and yellow saturation.
CMY Mixing Palette
The mixing palette consists of 3 primary mix buttons, a color picker and a resulting mix color
indicator. Use the three buttons to right of the CMY drag to select the primary color mix to work in
cyan/magenta, yellow/magenta or cyan/yellow. Use the color picker to select a mix by dragging the
mouse around the picker while holding down the left mouse button. Example: to select an orange
color, select the Yellow/Magenta button and drag the mouse in the color picker to the right hand side
of the box until the required orange color is found.
Other Color Controls
Some profiles implements other color options as well as selecting colors - the options depend on the
actual capabilities of the fixture.
Color wheel scroll
Continuous rotation of the color wheel (scroll)
Use the control to set the scroll direction and speed. Not all fixtures may allow the wheel to scroll
both ways.
Special Color Functions
MAC 2000 special color functions
Fixtures may implement special commands such as random color selection or random CMY. When
used, LightJockey instructs the fixture to use build in effects. The special commands section may be
shown or hidden by checking or un-checking preferences -> Show Special the menu.
LightJockey Help
86 LightJockey Help file - (C) Martin Professional 2010
Page 94
Fixture trigged colors
The command sets the fixture to control the color wheel in either auto or sound trigged mode, other
control attributes (movement, gobos) are not affected. The actual mode is usually programmed via the
extended controls. If neither auto or music trig has been programmed, the button displays a ?
indicating an unselected trig mode.
Fixture trigged: auto, sound, unselected
See also color controls for user defined profiles, fade state buttons, fixture control elements,
customizing palettes
Color controls for user defined profiles
Click the color icon on the fixture tool bar to access the fixture color control.
Color control for user defined profile
The actual contents of a color control depends on the user defined profile. The control usually
implements both drag bars for programming of DMX values directly and palette buttons for direct color
selection (see fixture control elements). The drag controls and palette buttons may affect one or more
DMX control channels. Some controls may also implement palette buttons for color related functions
such as color wheel scroll. ; functions like these may often be tweaked (e.g. the speed of the cobo
wheel scroll) by adjusting the value using the corresponding drag bar. Note that the control may
implement control of more than one color wheel.
CMY and RGB Controls
CMY control with CMY color picker
Use the drag bars to program cyan/magenta/yellow saturation or red/green/blue saturation
respectively.
CMY color picker
Profiles for fixtures with CMY color mixing may also implement a CMY mixing palette. The mixing
palette consists of 3 primary mix buttons, a color picker and a resulting mix color indicator. Use the
three buttons to right of the CMY drag bars to select the primary color mix to work in cyan/magenta,
yellow/magenta or cyan/yellow. Use the color picker to select a mix by dragging the mouse around
the picker while holding down the left mouse button.
Example: to select an orange color, select the Yellow/Magenta button and drag the mouse in the
color picker to the right hand side of the box until the required orange color is obtained.
HSV controls
LightJockey Help
87 LightJockey Help file - (C) Martin Professional 2010
Page 95
RGB control with HSV control bars
Fixtures with RGB control may color selection implement Hue, Saturation and Value control bars (or
just the Hue control bar for fixtures with independent intensity control). Note that setting RGB values
through HSV controls sets fade state for all 3 RGB channels.
See also fade state buttons, user definable fixtures, fixture control elements, color controls for built-in
fixtures
Gobo control
Gobo controls for built in profiles
Click on the fixture tool bar to access the fixture gobo controls.
Controlling static gobos
MX-4 with one static gobo wheel
The control implements two methods for selecting a Gobo. Using the scroll control : Click to
select a full gobo or to position the gobo wheel between gobos for a split gobo effect. Note
that not all fixtures may allow split gobo positions.
Alternatively, use the gobo palette to select gobos directly by clicking on the individual gobo icons.
The gobo palette may be hidden by un-checking preferences -> show palette in the controls
preferences menu - check show palette to make the palette visible again.
Rotating Gobos
MAC500/Roboscan 918 Rotating gobo controls
Select rotating gobos the same way as selecting fixed gobos, using either the scroll control or the
gobo palette.
LightJockey Help
88 LightJockey Help file - (C) Martin Professional 2010
Page 96
Gobo Indexing
If the fixture is capable of indexing the gobo use the index drag bar to set the actual gobo index. For
profiles with 16-bit gobo index, hold down [Shift] and [Ctrl] keys to increase the changes in index
when clicking the buttons.
Gobo Rotation
Use the rotation control to set rotation direction using the CW and CCW buttons and speed using the
drag bar.
Rotating gobo mode
Profiles may often use the same control channel for rotation and indexing parameters. In this case it
is not possible to program individual rotation and indexing parameters in the same scene (it would
also not make much sense) - setting a rotation value effects the index value and changing the index
value effects the rotation values. The actual response from the fixture (rotation or index) is determined
by the rotation mode setting. Use the rotation mode buttons to select mode - note that it is usually
not possible to rotate the first open gobo.
Other Gobo Controls
Some fixtures offer other gobo options as well as selecting or rotating gobos.
Gobo Shake
Gobo shake, the fixture 'shakes' the gobo wheel around the selected gobo. Use the "gobo shake"
control to enable and adjust the speed of the gobo shake. Note that the fixture may not implement
gobo shake on all selectable gobos.
Gobo Wheel Scroll
Continuous rotation of the gobo wheel. Use the control to set the scroll direction and speed. Not all
fixtures with gobo wheel scroll may allow the wheel to scroll both ways.
Gobo Swing
Gobo swing instructs the fixture to 'swing' the selected gobo (rotate the gobo wheel back and forth).
Use the control to set the swing speed and amplitude.
Special Gobo functions
Some fixtures may implement uncommon special functions. Check Show Special in the gobo
controls preferences menu to see any special functions. Un-check Show Special to hide any special
functions.
MiniMac profile random gobo settings
LightJockey Help
89 LightJockey Help file - (C) Martin Professional 2010
Page 97
Fixture Trigged Gobos
Available on the Martin MX/CX series. The command sets the fixture to control the gobo wheel in
either auto or sound trigged mode, other control attributes (movement, colors) are not affected. The
actual mode is programmed via extended controls. If neither auto or music trig has been programmed,
the button displays a ? indicating an unselected trig mode.
Fixture trigged: auto, sound, unselected
See also gobo controls for user defined profiles, fade state buttons, fixture control elements,
customizing palettes
Gobo controls for user defined profiles
Click on the fixture tool bar to access the fixture gobo control.
The actual contents of the gobo control depends entirely on the user defined profile. The control
usually implements both drag bars for programming of DMX values directly and palette buttons for
direct gobo selection. The drag controls and palette buttons may affect one or more DMX control
channels. Drag controls are also often used to control functions such as gobo rotation or indexing, or
gobo wheel scroll. Some controls may also implement palette buttons for gobo related functions such
as gobo wheel scroll; functions like these may often be tweaked (e.g. the speed of the gobo wheel
scroll) by adjusting the value using the corresponding drag bar. Note that the control may implement
control of more than one gobo wheel.
See also gobo controls for built in profiles, fade state buttons, fixture control elements, customizing
palettes
Beam control
Beam controls for built in fixtures
Click on the fixture tool bar to open the beam control. The beam control is used to control beamrelated effects such as focus, zoom, iris, beam shapers and frost effects.
MAC500 beam Control
LightJockey Help
90 LightJockey Help file - (C) Martin Professional 2010
Page 98
MAC 2000 beam control with iris pulse control
Use the drag bars to set the effect values. The profile may implement special functions controls to
access effects such as automated iris pulse.
See also fade state buttons, fixture control elements, beam controls for user defined profiles
Beam controls for user defined profiles
Click on the fixture tool bar to open the beam control.
Beam control
The beam control is used to control beam effects such as focus, zoom, iris, beam shapers and frost
effects; The actual contents of the control depends on the user defined profile. Use the drag bars to
set values for the individual effects.
See also fade state buttons, user definable fixtures, fixture control elements, beam controls for built in
profiles
Effect control
Effect controls for built in profiles
Click on the fixture tool bar to access the effects control. Effect controls typically controls effects
such as prisms in scanners or moving heads or various rotating effects in intelligent club/DJ effects.
Static effects
Roboscan 518 with one static effect wheel
Use the scroll control to select an effect: click to select a full effect, and to position
the effect wheel between effects for a split effect. Not all fixtures may allow split effect positions.
Alternatively, use the palette to select effects directly by clicking on the individual effect icons. The
effect palette may be hidden by un-checking show palette in the control preferences menu - check
show palette to make the palette visible.
LightJockey Help
91 LightJockey Help file - (C) Martin Professional 2010
Page 99
Controls for a single effect
Mac 500 Effect Control (single prism)
Some fixtures such as the MAC 500 implement a single effect only. In this case click the 'effect
button' to enable or disable the effect.
Rotating effects
MAC 2000 rotating effects control
Select rotating effects the same way as selecting fixed effects, using either the scroll control or the
effect palette.
Effect indexing
If the fixture is capable of indexing the effect use the index drag bar to set the actual index. On
fixtures with 16-bit effect index, hold down [Shift] and [Ctrl] keys to increase the changes in index
when clicking the buttons.
Effect rotation
Use the rotation control to set rotation direction using the CW and CCW buttons and speed using the
drag bar.
Rotation mode
Fixtures may often use the same control channel for rotation and indexing parameters. In this case it
is not possible to program individual rotation and indexing parameters in the same scene (it would
also not make much sense) - setting a rotation value effects the index value and changing the index
value effects the rotation values. The actual response from the fixture (rotation or index) is determined
by the rotation mode setting. Use the rotation mode buttons to select mode - note that it is usually
not possible to rotate the first open effect.
Other effect types
LightJockey Help
92 LightJockey Help file - (C) Martin Professional 2010
Page 100
Punisher effect control
Some effect controls may control other types of effects as well. In the above example the effect
control is used to set the rotation direction and speed, as well as the shaking effect of the Punisher
mirror parabola.
Special effect functions
Some fixtures may implement special controls, such as macros or random functions. Check Show
Special in the effect controls preferences menu to see any special functions. Un-check Show
Special to hide any special functions.
See also fade state buttons, fixture control elements, customizing palettes, effect controls for user
defined profiles
Effect controls for user defined profiles
Click on the fixture tool bar to open to the Effects control. Effect controls typically controls
effects such as prisms in scanners or moving heads and various rotating effects in intelligent club/DJ
effects.
The actual contents of the effect control depends entirely on the user defined profile.The control
usually implements both drag bars for programming of DMX values directly and palette buttons for
direct effect selection. The drag controls and palette buttons may affect one or more DMX control
channels. Drag controls are also often used to control functions such as prism rotation or indexing, or
effect wheel scroll. Some controls may also implement palette buttons for effect related functions
such as effect wheel scroll. Note that the control may implement control of more than one effect wheel
or type of effect.
See also fade state buttons, fixture control elements, customizing palettes, effect controls for built in
profiles
LightJockey Help
93 LightJockey Help file - (C) Martin Professional 2010
Loading...