Echameleon Manual V8-3

eChameleon Suite
Reference Manual
For:
Acrobat G6, Nomad, Illusionist,
PC Wing, Solo G3, Solo G3W & Preset Station
Revision 0.8 August 2010

Notices
Notices
About this document
This user’s manual has a two-fold purpose: to provide background information about the proper use
of the system, and to act as a guide to the functionality of the control system. It is intended to
supplement, not replace, authorised classroom and hands-on training.
Details of operation may vary due to differences in mechanical or electrical implementation at your
venue. Local safety regulations may require further training and operating procedures to those
discussed in this document for proper operation of the equipment.
Copyright Notice
This document contains material that is proprietary to Stage Technologies Ltd. This information is
provided on the understanding that it is used solely for the purpose of installing and maintaining the
equipment described, and that `it will not be revealed to third parties or otherwise disposed of
without the prior written consent of Stage Technologies Ltd.
Copyright for all design, software, electronic circuits, drawings and the text of this manual remains
with Stage Technologies Ltd. The publication of any part of parts thereof in any form, by any
method, for any purpose is prohibited without prior written consent of the copyright holder.
Further copies may be obtained from Stage Technologies Ltd on request.
eChameleon Suite Reference Manual Revision 0.7 i.

Contents
Table of Contents
Notices ..................................................................................................................................................... i
Table of Contents .................................................................................................................................... ii
1 Introduction .................................................................................................................................... 6
1.1 The Manual ............................................................................................................................ 6
1.2 eChameleon Features Overview ............................................................................................ 6
1.2 eChameleon Features Overview ............................................................................................ 7
1.3 System Overview..................................................................................................................... 9
1.3.1 Control Desks .................................................................................................................. 10
1.3.2 Server .............................................................................................................................. 11
1.3.3 Database.......................................................................................................................... 11
1.3.4 Nodes .............................................................................................................................. 11
1.3.5 Networks ......................................................................................................................... 11
1.3.6 Control racks ................................................................................................................... 12
1.3.7 Mechanics and power transmission................................................................................ 12
1.4 Definitions ..................................................................................................................................... 13
1.4.1 Axis .................................................................................................................................. 13
1.4.2 Playback (PB) ................................................................................................................... 13
1.4.3 Deads ............................................................................................................................... 13
1.4.4 Groups ............................................................................................................................. 13
1.4.5 Action .............................................................................................................................. 13
1.4.6 State ................................................................................................................................ 14
1.4.7 Macro .............................................................................................................................. 14
1.4.8 Control points.................................................................................................................. 14
1.4.9 Control Graph .................................................................................................................. 14
1.5 The Control Desk ................................................................................................................... 15
1.5.1 Powering up .................................................................................................................... 15
1.5.2 Keypad ............................................................................................................................. 16
1.5.3 Button functions.............................................................................................................. 17
1.5.4 Playback........................................................................................................................... 17
1.5.5 Dead Man’s Handle ......................................................................................................... 17
1.5.6 Shortcut Panel ................................................................................................................. 18
1.5.7 eChameleon Launcher .................................................................................................... 18
2 Features and Functionality ........................................................................................................... 20
2.1 Playbacks ............................................................................................................................... 20
2.1.1 Joystick mode .................................................................................................................. 21
2.1.2 Speed mode .................................................................................................................... 21
2.1.3 Reverse mode.................................................................................................................. 22
2.1.4 Speed Override................................................................................................................ 22
2.1.5 Playback Stealing ............................................................................................................. 23
2.2 Axes ....................................................................................................................................... 24
2.3 Groups ................................................................................................................................... 25
2.3.1 Free Group ...................................................................................................................... 25
2.3.2 Safe Group....................................................................................................................... 25
2.3.3 Locked Group .................................................................................................................. 25
2.3.4 Sculptor Group ................................................................................................................ 26
2.3.5 On Demand Groups ......................................................................................................... 26
2.4 Deads .................................................................................................................................... 27
2.4.1 Recording Deads ............................................................................................................. 27
2.5 Move Parameters.................................................................................................................. 29
2.5.1 Target, Move & Dead ...................................................................................................... 29
eChameleon Suite Reference Manual Revision 0.7 ii.

Contents
2.5.3 Speed and Time ............................................................................................................... 30

2.5.4 Accel and Decel ............................................................................................................... 31
2.5.5 Ramps .............................................................................................................................. 32
2.5.6 Delays .............................................................................................................................. 33
2.5.2 Multi-Target Moves......................................................................................................... 33
2.5.7 Repeat ............................................................................................................................. 35
2.6 Actions .................................................................................................................................. 36
2.6 Triggers.................................................................................................................................. 37
2.7 Shows .................................................................................................................................... 38
2.7.1 Show Modes .................................................................................................................... 38
2.8 States & Roles ............................................................................................................................. 39
2.8.1 State ................................................................................................................................ 39
2.8.2 Roles ................................................................................................................................ 40
2.8.3 Tracking ........................................................................................................................... 41
2.9 Simulation ............................................................................................................................. 42
2.9.1 Offline .............................................................................................................................. 42
2.9.2 Preview ............................................................................................................................ 42
2.10 Undo & Redo ......................................................................................................................... 42
2.11 Multiple Desks....................................................................................................................... 43
2.11.1 Axis Locking ........................................................................................................................ 43
2.11.2 Refresh ............................................................................................................................... 43
2.12 Labelling ................................................................................................................................ 44
2.13 Shortcuts ............................................................................................................................... 45
3 eChameleon User Interface .......................................................................................................... 47
3.1 Login Screen .......................................................................................................................... 47
3.2 eChameleon Main Screen ..................................................................................................... 48
3.2.1 Playback Colour Border ................................................................................................... 49
3.2.2 Information Circles .......................................................................................................... 49
3.2.3 Information Strip ............................................................................................................. 49
3.2.4 Playback Display .............................................................................................................. 49
3.2.5 Soft Desk.......................................................................................................................... 49
3.2.6 Devices Overview ............................................................................................................ 49
3.2.7 Menu ............................................................................................................................... 50
3.2.8 Tab Bar ............................................................................................................................ 53
3.2.9 Exit / Logout .................................................................................................................... 53
3.3 Command Line ...................................................................................................................... 54
3.3.1 Syntax Checking............................................................................................................... 54
3.3.2 Query as you Type ........................................................................................................... 54
3.3.3 Command History............................................................................................................ 55
3.3.4 On Screen Keyboard ........................................................................................................ 55
3.4 Current Show .............................................................................................................................. 56
3.4.1 State List .......................................................................................................................... 56
3.4.2 Current State ................................................................................................................... 56
3.4.3 State Options................................................................................................................... 56
3.4.4 State notes ...................................................................................................................... 57
3.4.5 Error Stack ....................................................................................................................... 57
3.5 Devices Tab ........................................................................................................................... 58
3.5.1 Nodes .............................................................................................................................. 58
3.5.2 IO Groups & IO ................................................................................................................ 58
3.5.3 Mini Devices View ........................................................................................................... 59
3.5.4 Device History ................................................................................................................. 59
3.6 Control Graph Tab................................................................................................................. 60
eChameleon Suite Reference Manual Revision 0.7 iii.

Contents
3.7 Display Tab ............................................................................................................................ 61

3.7.1 Current View ................................................................................................................... 61
3.7.2 Recorded Views ............................................................................................................... 61
3.7.3 Tabular Grid..................................................................................................................... 62
3.7.4 I/O Grid............................................................................................................................ 62
3.7.5 Macro Grid ...................................................................................................................... 62
3.7.6 3D Grid ............................................................................................................................ 63
3.7.7 Dynamic Grids ................................................................................................................. 63
3.7.8 Adding & Removing Grids ............................................................................................... 64
3.7.9 Moving Grids ................................................................................................................... 65
3.7.10 Deleting Grids ................................................................................................................. 65
3.7.11 Send to Other Screen ..................................................................................................... 65
3.7.12 3D Display controls ......................................................................................................... 66
3.7.13 3D Grid controls (Views Tab) .......................................................................................... 66
3.7.14 Other 3D screen controls ............................................................................................... 67
3.7.15 Perspective vs. Orthographic ......................................................................................... 67
3.7.16 Default Cameras ............................................................................................................. 67
3.7.17 Recording Cameras......................................................................................................... 68
3.7.18 Deleting Cameras ........................................................................................................... 68
3.8 Query Tab.............................................................................................................................. 69
3.8.1 Query Home ......................................................................................................................... 69
3.8.2 Axis List Query ................................................................................................................. 70
3.8.3 Axis Query ....................................................................................................................... 70
3.8.4 Group List Query ............................................................................................................. 71
3.8.5 Group Query.................................................................................................................... 71
3.8.6 Action List Query ............................................................................................................. 72
3.8.7 Action Query ................................................................................................................... 72
3.8.8 State List Query ............................................................................................................... 72
3.8.9 State Query ..................................................................................................................... 72
3.8.10 Shows Query................................................................................................................... 73
3.8.11 Macros Query ................................................................................................................. 73
3.8.12 Control Points Query ...................................................................................................... 73
3.9 Multi-Target Editor ............................................................................................................... 74
3.10 Shortcuts Editor .................................................................................................................... 76
3.10.1 Input Display Shortcut .................................................................................................... 76
3.10.2 Command Shortcut ........................................................................................................ 77
3.10.3 Action Shortcut............................................................................................................... 77
3.10.4 Macro Shortcut............................................................................................................... 78
4 Command line reference .............................................................................................................. 79
4.1 Clear down Commands ......................................................................................................... 79
4.1.1 Clear ................................................................................................................................ 79
4.1.2 New (Clear All)................................................................................................................. 79
4.2 Selection Commands ............................................................................................................ 80
4.2.1 Resources ........................................................................................................................ 80
4.2.2 Plus, Minus and Thru....................................................................................................... 81
4.2.3 Implicit Selection ............................................................................................................. 82
4.2.4 Playback Stealing ............................................................................................................. 82
4.3 Axis Operations (modifiers) .................................................................................................. 83
4.4 Speed and Time commands .................................................................................................. 84
4.5 Accel, Decel, Accel time and Decel time commands ............................................................ 85
4.6 Ramp shape commands ........................................................................................................ 85
4.7 Multi-target and Trigger commands ..................................................................................... 86
eChameleon Suite Reference Manual Revision 0.7 iv.

Contents
4.8 Record, Delete and Enter Commands ................................................................................... 87

4.8.1 Recording and Deleting States ....................................................................................... 88
4.8.2 Recording and Deleting Deads ....................................................................................... 88
4.8.3 Recording and Deleting Actions ..................................................................................... 89
4.8.4 Recording and Deleting Shows ....................................................................................... 89
4.8.5 Recording and Deleting Roles ........................................................................................ 89
4.8.6 Recording and Deleting Groups ..................................................................................... 89
4.8.7 Recording and Deleting Cameras and Views.................................................................. 91
4.9 Text Commands .................................................................................................................... 92
4.10 Mode commands ...................................................................................................................... 92
4.11 Query Commands ................................................................................................................. 93
4.12 Immediate Commands .......................................................................................................... 94
4.12.1 Undo & Redo ................................................................................................................... 94
4.12.2 Preview ........................................................................................................................... 95
5 Appendix ....................................................................................................................................... 96
5.1 Keypad functions chart ......................................................................................................... 96
5.2 Database Backups and Archiving ........................................................................................ 101
5.3 eChameleon Settings .......................................................................................................... 103
5.3.1 System Options ............................................................................................................. 104
5.3.2 Display Settings ............................................................................................................. 105
5.3.3 Network Settings ........................................................................................................... 105
5.3.4 System Settings ............................................................................................................. 106
5.3.5 System Information ....................................................................................................... 107
5.4 Creating a New Database .................................................................................................... 108
5.5 Sculptor ............................................................................................................................... 109
5.5.1 Introduction to Functionality ........................................................................................ 109
5.5.2 Teach and Learn ............................................................................................................ 109
5.5.3 Visual Creator ................................................................................................................ 109
5.5.4 Object Orientated Plotting ............................................................................................ 110
5.5.5 Single Axis Motion Profiling .......................................................................................... 111
5.5.6 Animation Importer ...................................................................................................... 111
5.5.7 Application Example:..................................................................................................... 112
5.6 Further Setup ............................................................................................................................ 114
5.6.1 Windows Embedded ..................................................................................................... 114
5.6.2 Example eChameleon Settings.xml ............................................................................... 115
5.6.3 eChameleon File Structure ............................................................................................ 116
6 Glossary of Terms........................................................................................................................ 117
7 Index............................................................................................................................................ 121
eChameleon Suite Reference Manual Revision 0.7 v.

Introduction
1 Introduction
eChameleon is the common software platform across all Stage Technologies control consoles,
offering unrivalled ease of use, power and flexibility. It is the next generation of Chameleon
software, simplifying the tried and tested concepts of its predecessors whilst enhancing the deeper
functionality aimed at running the most demanding of performances.
The software is easy to learn and fast to operate, making eChameleon suitable for all scales of
automation systems, from small school theatres to the largest of casino shows.
eChameleon offers real-time, 3D and tabular views of automation systems and can be used with
touch screen operation on the Nomad control console. The package also includes a full, logical
command line interface for rapid programming. eChameleon offers practically inexhaustible storage
and allows multiple consoles to operate together seamlessly. It also integrates with our Connect
service for continuous off-site backups of show data.
As a security enhancement, eChameleon runs on Windows Embedded Standard, which means that
the user is only given access to the eChameleon launcher. The user is only allowed access to the
Stage Technologies software, thereby configuring the console in a safe and simple manner.
1.1 The Manual

This manual is broadly broken into 3 sections:
• Introduction
A general description of the man parts of a Stage Technologies Automation system, and
explanation of the broad philosophies and nomenclature utilised within Stage Technologies
eChameleon and control desks.
NB: For a detailed description of system elements please refer to the individual hardware
manuals.
• Features and Functionality
Detailed coverage of concepts which are shared by all elements within the Stage
Technologies eChameleon Suite, description of specific features, and the best practices
available to the user.
• The Software
Specific instructions for each element of the eChameleon Suite of software.
Command line examples:

Where command line examples are used within this manual they are surrounded by square brackets
and use the wording number to indicate a numerical input. For example:
[Target number Dead number Text “IN Dead” Record]
The examples show the result of a command line input without defining each process to achieve this
input. In some cases abbreviations are used such as DMH for Dead Man’s Handle or PB for Playback;
these abbreviations may be explained throughout the manual.
For more information on command line inputs and Keypad functions; please refer to the
“Keypad functions” section of this manual.
eChameleon Suite Reference Manual Revision 0.7 Page 6

Introduction
1.2 eChameleon Features Overview

A brief summary of the features which the eChameleon Suite offers is provided below. These
features are covered in detail throughout this manual:
• Control of unlimited axes of automation

• Program motion to millimetre precision
• Powerful command line operation for rapid operation
• Mouse or touch-screen operation for ease of use
• Sculptor (“teach and learn”) 2D/3D motion record functionality
• Full integration with Visual Creator for editing 3D paths
• Direct joystick (manual) control of individual or multiple axes

• Target axes to absolute and relative positions
• Record deads or trim heights for each axis
• Program moves with speed, acceleration and deceleration
• Simple but powerful time plotting facilities
• Variable delay (wait) times
• Multi-target moves for complex sequences
• Trigger axes to start, stop or change motion parameters mid-sequence
• Trigger conditions based on position, speed, torque, move number or system input
• Repeat (loop) multiple targets
• Definable acceleration and deceleration ramps
• Record actions for reusable complex sequences
• Record free or safe groups of axes

• Locked (synchronous) group behaviour
• Safe-on-demand and locked-on-demand for temporary axis grouping
• Groups can be nested to any depth
• Up to 6 playbacks with individual start/stop buttons and speed override controls
• Load unlimited axes per playback
• Dead man’s handle to override all playbacks
• Reverse mode for quick reset of axes
• Record an unlimited number of states (cues) in any show

• Switch between multiple shows instantly
• Load states in any order, or next and last between them
• Tracking for continuous motion between states
• Update states at any time
• State notes for an on-screen cue sheet
• Reset axes to the start of any state
• Performance mode to prevent unintended changes
• Full undo-redo functionality
• Real-time data update between multiple consoles

Introduction
• Roles to partition states between multiple consoles

• Instant role switching and cross-role plotting
• Rig axes in specific shows
• Reference axes to scenery height
• Instant preview for blind programming and simulation

• Full offline programming and simulation
• Dynamically assign remote dead man’s handle to axes or states
• System input display and history
• Macros (system outputs) can be controlled in states
• Tabular (spreadsheet) and 3-dimensional graphical axis views
• State associated views and cameras
• Shortcuts to execute actions and macros, display inputs or issue commands
• Freeze axes for maintenance lock-out

• Control point detection to restrict axis usage, maximum speed or limits
• Individual user logins and definable permissions and axis restrictions
• Available in multiple languages

• Automatic and scheduled show and system backups
• Integrated error reporting and diagnosis
• eChameleon Manager to configure the system
• eChameleon Monitor to log user actions and real-time system data
• Integrates with Connect service for off-site backup

Introduction
1.3 System Overview
A Stage Technologies automation system will contain a varying number of parts and peripherals. The
actual layout of the system and constituent parts will vary according to the application; however the
basic infrastructure will remain the same:
Control Server (optional)

Desk
Control racks and Mechanics i.e.
networks winch/hydraulics
Stage Technologies utilise a modularised control system with standardised components and a
selection of control desks, control and processing units and hardware to suit the requirements of the
application.
A standard system will comprise one or more control desks, mobile panels or wall mounted control
panels, an Emergency stop and safety system, a range of control gear suitable for the application
(containing intelligent drives and communication nodes), an industrial standard network and a range
of mechanical solutions (that may include winches, hydraulics and any other driven systems).

Introduction
1.3.1 Control Desks

Stage Technologies provide a range of control desks to suit all applications. The selection of desk or
control platform will depend upon the nature and application of the install, the expected work load
of the desk, the expected level of competence of the users and the physical characteristics of the
space available for operation. All control desks feature the standardised eChameleon Suite software
package.
For example: a west end show may expect a high level operator to deal with a great many axis
simultaneously and would not normally expect to re-position the desk or an opera house may
require several desks running only a few axis, but with the ability to easily re-position the desk or a
lower level operator may be asked just to fly in a projection screen in an arts centre or cruise ship
and as such would prefer an immediate wall mount solution rather than a fully functional control
desk.
Stage Technologies Control desk range includes:
Acrobat G6: Latest generation of Acrobat desk, with unique dual redundancy, dual
widescreens, instant shortcut panel and 6 playbacks and enhanced
functionality. This desk is designed primarily for high productivity with
flexible operation and programming.
Nomad: The perfect solution for a multi-operator or large multi venue application.
The desk is designed to be portable requiring only a single connection to
any control point throughout the installation and features low weight and
brief case size and a user friendly touch screen.
Illusionist: The economical solution to control, featuring the full eChameleon package,
rack mount options, 3 playbacks and is offered as a perfect solution to the
smaller installation.
Solo and Solo G3W: Solo is a handheld, multi axis controller. It can be used as the primary
venue controller or a part of an integrated solution with other control
desks. Solo runs a version of eChameleon feature many of the functions of
the full software suite. Solo G3 is available as a wired or wireless (G3W)
option using an industrial Ethernet radio link.
Preset Station: The Preset Station is a robust touch screen offering simplistic control for
lower level operation. It is easily configured and restricted and can be an
invaluable addition to a system or used as the primary operational option.
PC Wing: The PC wing is a USB interface for eChameleon running on a PC. The PC
wing can provide invaluable support for training and offline program
applications.
NB: For more information on Stage Technologies’ control desks please refer to the Control
Desks appendix at the back of this manual and the individual data sheets and
hardware manuals supplied by stage Technologies or available on our web-site.

Introduction
1.3.2 Server
A server is generally added to a multi-desk or multiple operator system or a system requiring a large
amount of data backup or archiving. A server will always be present on installations featuring a Solo
G3.
The server holds the current database and any archives created and provides a networked
centralised data source for all control desks.
1.3.3 Database
The eChameleon Suite utilises a centralised System database, held on a server for multiple desk
applications, or stored locally in single desk applications. The database contains all information
pertinent to all axis parameters, defaults and higher level commissioning options. The database
holds any number of shows and all pertinent information relating to those shows including all user
recorded show information including states, actions, views, soft limits etc.
In a multiple desk application, the System database will be held securely on the server and accessed
simultaneously every control desk or mobile controller. This ensures that no conflicts can occur
between ownership of axis and data update refresh (i.e. an axis may only be controlled by one desk
at a time and any changes made to the database from any control platform will be reflected at each
and every desk).
A duplicate of the System database is also held locally on each desk, which allows work to continue
from the desk if for any reason communication to the server is unavailable, however in a multi-desk
environment this should be considered an emergency situation only suitable for running tried and
tested sequences, as the safety features provided by a shared database are no longer available.
eChameleon Monitor also uses an Events database for logging all user operations and events, and a
Telemetry database for storing of system status information for detailed diagnosis.
1.3.4 Nodes
A node is the centralised communications point for a system of axis.
Stage Technologies eChameleon defines five types of nodes:
• Normal: standard system
• Radio: system with radio data
• F:light: This node provides communication for the Stage Technologies F:light automation to
moving light integration system
• Monitoring : a node external from the main system used for SIL 3 applications
• Legacy: A node allowing integration of older hardware systems
1.3.5 Networks
Stage Technologies offers a selection of network types, additional to the standard Ethernet
communications. These network types can be used in combination and will be assigned during
commissioning, as appropriate for the installation.
Network options are:
• Safe: allows for safe groups across nodes

Introduction
• Sync: allows for locked groups across nodes

• Trigger: allows for triggering across nodes
• Monitoring: allows for independent system monitoring for SIL 3 applications
1.3.6 Control racks

Stage Technologies’ control racks come in several formats for differing installations (i.e. fixed
cabinets for permanent installations or Au Tour cabinets for temporary installations). However they
generally break down into MCR and MCCs.
The MCR (Motion control rack) will contain the network Nodes and Hubs and often any integrated
safety solutions, including system level PLCs and often also include the server.
The MCC (Motor control cabinet) will usually contain the intelligent drives, networking to the MCR,
axis level PLCS and all applicable power solutions.
Stage Technologies control solutions may be centralised or localised (i.e. centralised within a control
“rack room” or localised to the winches or moving axis)
1.3.7 Mechanics and power transmission

The mechanics of the system will vary hugely depending on the application.
Stage Technologies supply a range of “Big Tow” winches with varying safe working loads and speed
options, however Stage Technologies systems can control any electrically or electronically controlled
automation device.
i.e. hydraulic systems, pneumatic systems, custom mechanics etc.

Introduction
1.4 Definitions
This section briefly describes the names and definitions used within this document to describe the
functions and elements within the Stage Technologies system:
1.4.1 Axis
Stage Technologies uses the term AXIS to refer to any individually controlled element of motion. A
single axis might be a single winch, hydraulic ram, I/O axis. A piece of scenery or lift may, for
example, use a single axis or many axes to create its movement. Axes may be grouped together in
several differing ways to create groups appropriate to their usage.
1.4.2 Playback (PB)

A Playback is a method of gaining control of an axis. Any number of axis and move parameters may
be written to any of the desks playbacks for immediate execution. The playback maybe used for
temporary (unrecorded) moves or to execute pre-recorded cues (states).
Each playback is colour coded, for selection and recognition.
A Playback has one or more buttons capable of Starting and Stopping the axes loaded on it, and a
speed override, which allows cues to be executed at 0 – 200% of programmed speed.
1.4.3 Deads
(Also marks or trims (US)) - A designated height for a piece of scenery or bar; a label or marker for a
physical position or target. Manual flymen use a Dead on a rope as an indication of the position of a
scenic piece i.e. all the way in (in view) or out (out of view) or at a mid point. For manual operation,
this mark would traditionally be a cotton tape wound through the strands of the rope but this has
been replaced more recently with PVC tape or similar. Automation operators label Deads with a
number and/or colour system such as ‘Dead 1’.
1.4.4 Groups
Many theatrical effects in modern productions require the synchronised movement of multiple axes,
and in many cases these axes are used together to lift a single, large piece of scenery. To address
these issues Stage technologies use GROUPS.
eChameleon offers a variety of permanent and temporary group types including free, safe and
locked. Each grouping will consist of a number of axes that are required to be addressed or act as
one entity.
Grouping within eChameleon is dynamic, meaning that multiple group definitions may be created
and held within a show and each axis maybe a member of several groups simultaneously.
1.4.5 Action
An ACTION is a way to record anything that can be achieved on a single playback and store it for later
recall to any other playback.

Introduction
Actions may be simple building blocks with which to plot your show and design States. They can
equally be used to store commonly-used moves, groups of moves or complex moves that would
normally require a long command line.
Actions may be called to any of the shortcuts for immediate execution.
1.4.6 State
eChameleon uses the nomenclature STATE for what is often referred to as CUES. Stage Technologies
use the terminology of states to describe a page of pre-recorded axis move parameters. eChameleon
makes use of multiple playbacks, giving the user the choice to fire one or multiple playbacks
concurrently. One page could therefore contain one or multiple cue points.
A state therefore contains all move data relating to any axis assigned to any playback, also any
screen layouts (VIEWS) and notes associated with that state.
1.4.7 Macro
A Macro is a means of controlling a System Output, such as hydraulic pumps, or a kabuki drop. A
Macro can be loaded onto a playback in the same way as an axis, and recorded into States, and will
then execute when the playback Start button is pressed. A single output could be controlled by
multiple Macros, for different operations including Activate, Deactivate and Pulse.
1.4.8 Control points

A control point is simply an addressed plug-in point for a control desk or mobile controller. Many of
Stage Technologies control platforms are designed to be portable and able to be moved to the most
advantageous position for operation.
eChameleon provides a soft-control point ID for instances when a hardware control point ID is
unavailable.
1.4.9 Control Graph

Control Graph – a contextual representation of the axes under control. Includes: controlled the
axes, what playback they are loaded on, how they are loaded (as a group, or individually), and the
motion parameters for each axis.

Introduction
1.5 The Control Desk

1.5.1 Powering up
Acrobat
The Acrobat∙G6 has a main supply rocker switch at the rear of the desk. The Acrobat has 2 machines
(A and B) – each machine has a momentary power button at the front of the desk, which should be
pressed once to power up each desk. The Acrobat has a 2 position rotary selector switch for A/B
machine selection. One machine should be selected and fully powered up into the software before
switching to the other machine and powering up fully. The Acrobat G6 must always be shut down
correctly from within the software.
Nomad
Once connected to a Control Point the power button on the left side of the desk will flash green
rapidly for 5 seconds, and then begin to flash slowly. Push the button once the slow flashing begins
to power up the desk. The Nomad must always be shut down correctly from within the software.
Illusionist
The illusionist desk has a single main power rocker switch at the rear of the desk. Switch this to ON
to power up the desk. The Illusionist must always be shut down correctly from within the software.
When the desk has powered down, this rocker switch should be manually switched to the OFF
position. The user must wait for approximately 30 seconds after switching to OFF before attempting
to restart.
Solo G3
The Solo G3 is self-powered from a control point and has no power switch. It does not have a shut
down process; however the software should always be exited correctly before unplugging the Solo
G3.
Solo G3W
TBC
Preset Station
The Preset Station has a momentary power switch on the front of the panel, which should be
pressed once to power up the device. The Preset Station must always be shut down correction from
within the software.

Introduction
1.5.2 Keypad
NB: For a detailed description of eChameleon keypad functionality please refer to

the Keypad functionality chart in the appendix at the end of this manual
Each control desk has a keypad for command line entry and functionality. The keypad can be split
into several sections for ease of description:
• Resource keys – The object to be addressed such as axis, group etc

• Parameter modifiers – command line move parameters.
• Command line terminations – keys that action and close the command line.
• Instant function keys – Keys that have an instant function
• View and query display keys
• Number and arrow pads
Primary Parameter Command Line

Operations modifier Keys terminations
Push and Hold
Resource Keys
Toggles
(cyclic)

Introduction
1.5.3 Button functions

Each keypad button may have one or more uses:
The top text on each button is the result of a toggle of the button.
The bottom text on each button represents the result of a Primary

operation.
In some cases the button may have 2 or 3 toggle functions. These

functions (therefore command line entries) will cycle as the key is
pressed.
In a few cases the buttons also have a push and hold function.
1.5.4 Playback
The Playback includes the playback colour selector, playback eBelt (used for varying plotted velocity
percentages) and the Start/Stop button.
Each type of desk has a differing number of playbacks. The Acrobat∙G6 has 6 playbacks, Nomad 5,
Illusionist 3 playbacks etc. The playbacks are colour coded for simplicity and their percentage status
is displayed within the E-Belt with LEDs and also onscreen in the playbacks section.
E Belts
Start/Stop Buttons
1.5.5 Dead Man’s Handle

Each control desk and control platform contains a Dead Mans Handle. The Dead mans handle must
be pressed during any motion and if released all axis in motion will come to a controlled stop.

Introduction
1.5.6 Shortcut Panel

The Shortcuts panel is available as a set of 24 assignable shortcut buttons on the Acrobat∙G6.
The Nomad, Illusionist and other Stage Technologies control platforms use an “On screen” version of
these buttons via the Shortcut pages.
NB: See Shortcuts below
1.5.7 eChameleon Launcher

Once an eChameleon desk powers up the user is presented with the eChameleon Launcher:
The Launcher (home screen) contains shortcuts for eChameleon, General Settings, eChameleon
Manager, eChameleon Monitor and Archives.
Settings &
Archives
Control Panel
eChameleon eChameleon eChameleon

Monitor Manager

Introduction
NB: for detail on the functions and use of Manager, Monitor, Archives and Settings please
refer to the associated appendix items and the end of this document.
eChameleon
eChameleon provides the main user interface for all plotting and movement functionality
of the desk. This is the main user interface and will provide all tools and links for day to
day operation.
eChameleon Manager
eChameleon Manager provides the user and commissioning engineers with tools to set up
the “front end” of the system. This tool provides database management and allows the
user to set up or modify system level axis, IO, Nodes, Control points, roles, users and
restrictions and administrative tools including database scheduled archiving. eChameleon manager is
pin code protected.
eChameleon Monitor
eChameleon Monitor displays a live and historical system status, displaying real time axis
telemetry and historical timelines of system errors and user inputs. This auditing software
allows for filtering for specific historical events in several methods.
Archives
The Archives button allows quick shortcut buttons for archiving and retrieving system
databases.
Settings
The settings button supplies quick selections for fundamental system set up options. Most
of these options are self-configuring. The settings include: Display, Network, System
Options and general system information.

Features & Functionality
2 Features and Functionality
NB: for a detailed description of commands and command line entries, please refer to
the “Command line reference” section later in this manual.
2.1 Playbacks
• A Playback is a method of gaining control of one or more axes. Axes, Groups and Actions
may be loaded onto a Playback, which then provides the means to Start and Stop the axes,
and a “speed override” capability for varying the plotted velocity by percentage.
• Each Playback is colour coded, for selection and recognition – depending on type of control
desk, a subset of the 6 possible Playbacks may be provided, coloured Red, Blue, Yellow,
Green, Orange and Purple.
• Playbacks can generally be considered to have a Select button, Start button and Stop button
irrespective of type of control desk.
• A Playback has two primary modes:
Joystick mode: Allows the User to “Jog” an axis or group of axis between pre-defined software limits.
The playback slider, in this case, determines “jog” direction and percentage of positive or negative
velocity.
Speed mode: Speed mode is used for all moves where a target is defined. In this case the playback
does not need to determine direction and therefore the playback slider becomes a speed override
function from 0 to 200% of plotted speed.
This picture shows the eChameleon

graphical representation of the Playbacks.
Please note that these playbacks are in
Soft Desk mode!
• eChameleon presents the playbacks as a graphical representation of the number of physical

playbacks available on the desk. The percentage at the top of each playback represents the
percentage of plotted speed at which the axis will run. The number in the white square is the
time left for the axis to complete its move, taking into account the current speed override
percentage.

• The currently selected playback’s mode may be cycled between Speed and Joystick by
pressing the PB Mode keypad button, or by pressing the playback select button. Toggling
between modes will not affect the Speed mode moves programmed, allowing the user to
switch into Joystick mode to jog an axis if necessary, and then switch back to run the cue.
• A playback will automatically change mode from Joystick to Speed mode if a target is
assigned to an axis. If Speed mode is selected without a target given, the current position
will be taken as the target.
2.1.1 Joystick mode

When an axis is initially taken into playback control and before a target is assigned;
[Axis 1 Enter]
The axis is regarded as being in joystick mode.

Joystick mode offers a JOG function between preset software limits.
Joystick mode is shown as a joystick icon on the axis PB designation within the main screen and also
on the PB colour selector at the top of the PB.
To run an axis in joystick mode:
• Take the axis into playback control

[Axis number Enter]
• The axis will now appear on the main screen under PB control with default speeds assigned.
• Hold down the DMH
• Press START on the PB Start/Stop button.
• At this stage the axis will not move until a direction and velocity are applied using the E-Belt.
• Move the E-Belt up to move the axis in a positive direction and down for negative direction.
• The actual velocity may now be varied by moving the E-Belt up or down to the desired
percentage of default speed.
There are four ways to bring the axis to a stop:
• Press “STOP” on the PB

• Slow down the axis by moving the E-Belt to zero percent and then press “STOP”
• Release the DMH
• Hit the E-Stop (in an emergency only!)
2.1.2 Speed mode

Speed mode is defined as the axis having a target assigned. This can be achieved in many ways;
[Axis number Target number Enter] or [Axis number Dead number Enter] etc.
Naturally most pre-recorded states and actions will have playbacks in speed mode.
If no speeds, accelerations or decelerations have been defined then the axis will utilise the defaults
preset within the database.

To run an axis in speed mode:
• Hold down the DMH

• Press start on the relevant PB. In this case the axis will accelerate and move immediately.
• The axis speed may now be varied by using the E-Belt to vary the percentage of plotted
speed.
NB: In speed mode zero percent is at the base of the E-Belt’s travel (as no negative percentage is
required)
There are four ways to bring the axis to a stop:
• Press “STOP” on the PB

• Slow down the axis by moving the E-Belt to zero percent and then press “STOP”
• Release the DMH
• Hit the E-Stop (in an emergency only!)
2.1.3 Reverse mode

Reverse is the third Playback mode, and allows all axes on a single playback to be returned directly to
their previous position (position before the current move was executed). On entering Reverse
Mode, all axes will be assigned targets which correspond to the axis positions at the start of the cue,
ignoring multi-target moves, delays and triggers. The speed override will default to 0% in order to
encourage careful running of the Reverse moves.
In eChameleon, Reverse is the push and hold function of the PBMode key and affects the current
playback.
NB: This function is only designed to provide a quick re-set, it is not a “run backwards” function and
so there is the potential that axes could be given targets which would cause a collision, and it is the
Operator’s responsibility to ensure the moves generated are safe to execute
2.1.4 Speed Override

The Speed Override acts to allow the user to speed up or slow down all axes on a Playback. Slowing
down the playback can be a useful alternative to stopping a sequence if for example a scene change
is running behind, and this then may lead to a need to speed up the sequence again to catch up.
When a playback is in Speed mode, it will generally default to 100%, with a maximum of 200%. The
maximum will be automatically limited based on the maximum speeds of the axes on the playback,
such that the relationship between moves is always maintained, and maximum speeds are never
unintentionally exceeded.
When recording a State, Playback Start and Maximum Percentages may be specified:
Start Percentage
A playback start percentage is the percentage of plotted speed (that the playback loads at on each
given state. In most cases this will be 100% for “show running” and Zero% for “out of show” states
for safety.

Maximum Percentage
A maximum playback percentage is a percentage limitation on the override of a playback percentage
speed. If unspecified a playback may be overridden to either 200% of the plotted speed or the
maximum allowable axis speed if below 200%. Whilst the speed override can be a useful feature if a
cue is delayed and needs to be sped up to catch up with a sequence, there may be scenarios where it
is undesirable to ever exceed a specific percentage of plotted speed.
2.1.5 Playback Stealing

Playback Stealing refers to the ability to quickly move axes between playbacks on the same desk.
This is of course possible by removing the axis from one playback, and adding it to another, however
this loses any plotted move information, and requires double the key strokes. When stealing an axis,
it transfers between playbacks with all moves intact.
In order to steal an axis or group, select a new playback, and enter a selection only command (i.e.
Axis # Enter), and the axis will be transferred. If any other operation is applied on the same
command line, an error will be thrown reminding you that the axis is already on another playback.

2.2 Axes
Stage Technologies control systems can control a selection of different axis types; theses types are
defined within the database and can be a selection of Variable Speed, Fixed Speed, Non-Positioning
and Rotary.
The parameters relating to each type are customisable and defined within eChameleon Manager.
Axis maybe labelled with a name relevant to their current application. The Axis will have a name
associated to it from the initial database setup and the user may choose to retain this name or to
change it per show.
For example: a single show application will generally use the axis name set up in the database as the
name throughout its use (as this will generally be the only use of this axis), however a Repertory
house may use standardised labels (such as Bar 1, Bar 2) within the database and show specific
names throughout the shows.
This is simply achieved by the command
[Axis number Text name Record]
within the current show.

2.3 Groups
Many of the major reasons for installing an automation system are realised by using Groups. Many
theatrical effects in modern productions require the synchronised movement of multiple axes, and in
many cases these axes are used together to lift a single, large piece of scenery. To address these and
other demands eChameleon utilises Group functionality.
In order to record a Group, the user must select more than one axes, and specify a Group number to
record as, such as:
[Axis 1 + Axis 2 Group 1 Record]
This command will start to create a Group 1 using Axes 1 and 2 and will prompt the user for which
type of Group to create.
For more information about multiple axis selection; please refer to the Command
reference section of this manual.
eChameleon supports four primary types of group - Free, Safe, Locked and Sculptor which are
described below.
In order to delete a Group the syntax is such as:
[Group number Delete]
This command will only allow a Group to be deleted if it is not used in any States or Actions.
2.3.1 Free Group

A Free Group is simply a method to address multiple axes with a singular command line.
The members of the group have no inter-relationship, and the Group will only appear as single axes
once loaded.
2.3.2 Safe Group

A safe Group is a selection of axis with an inter-relational safety relationship, such that if one
member of the groups sees an error, then all members of the group will come to a controlled stop.
A safe group is used for a group of axis that may need to move independently, but should all stop if
an error occurs.
2.3.3 Locked Group

A locked group contains a single master axis and one or more slave axes.
A Locked Group is used to move multiple axes which are interconnected and are rigged such that
each axis must maintain the same position relative to the others in the group at all times. For
example, a heavy ceiling flown on 6 point hoists. As with safe groups, if one axis in the group faults,
all axes in the group will stop.

NB When a locked Group is created the User is presented with the options to “Rig” or
“Not Rig” the Group.
If the Group is rigged, then a warning is given to the User when the Grouping is
broken i.e. axis addressed separately.
2.3.4 Sculptor Group

A sculptor group is required for use within the Sculptor software for multi dimensional and complex
plotting. The Sculptor group will have a geometrical maths module associated with it; such as 2D
Bridal, 3D Bridal, Track and Trolley or Roving Truck.
2.3.5 On Demand Groups

An On Demand Group is a temporary grouping of all axes on a playback, relevant only to that specific
state, avoiding the need to record a group for every dynamic scenario. An On Demand Group may
either be Safe or Locked.
Safe on Demand creates a temporary Safe Group of all axes on the playback, ensuring that if one axis
was to fault or error all axes will stop.
Locked on Demand creates a temporary Locked Group, with an arbitrary axis as master, ensuring
synchronisation between all axes on the playback based on the positions when the Locked on
Demand Group is loaded.
To remove the On Demand Group, either Clear Down the playback, or issue the On Demand
command again.

2.4 Deads
A “Dead” is a numerical label for a target.
Deads are commonly used for targets that are repeatedly used throughout a show i.e. IN Dead or
OUT Dead.
If a Dead is recorded into a selection of States, any subsequent change to that Dead will be reflected
throughout the plotted states.
The currently recorded Deads list for each axis may be views by query the axis.
The Axis level query can be accessed by:
1. Clicking the Query Tab, then clicking Axis, then clicking the query on the required axis
2. Right clicking the Axis number at the top of it’s grid and clicking Query
3. By typing [Axis number Query]
For more information about Query; please refer to the Query Tab section of this
manual
2.4.1 Recording Deads

A Dead maybe recorded with a simple command line; however the outcome of the command line
will depend upon the current mode of the playback:
[Dead number Record]

• If the current playback is in “Joystick mode”:
This command line will result in the current position of each axis on the currently selected
playback being recorded as the Dead number specified in the command line
• If the playback is in “Speed Mode”:
The above command line will result in the current target of all axis held on the current
playback being recorded to the desired Dead number
Please refer to “Current Playback” and “Playback modes” for more information
The command line may also contain a text entry in order to label the Dead:
[Dead number Text “IN Dead” Record]
The command line may also contain an absolute target:
[Target number Dead number Text “IN Dead” Record]

A Dead maybe recorded for a single or selection of axis or groups on a particular playback by
specifying the selection within command line:
[Axis1 + Axis2 + Group1 Target number Dead number Text “IN Dead” Record]
Please refer to “selection commands” for more information on multiple or discreet

selections

2.5 Move Parameters

eChameleon offers the user several different move types, each have individual characteristics and
each can be useful in variety situations:
Moves can be:
Joystick mode; Jog to soft limits
Target mode: move to an absolute position
Move to a known Dead (absolute position)
Move relative: Move from current position by a known amount
Reverse: Move directly back to the start position of the move that has just completed
Multi-target: Move between a programmed list of targets or Deads
Triggered: Any of the previous move types maybe triggered in a variety of ways
Sculptor: Move in a 1D, 2D or 3D path either along a plotted course or via joystick input
2.5.1 Target, Move & Dead

There are 3 distinct ways to assign a target (the final position of a move) to an Axis:
• Absolute Target (Target)

• Relative Target (Move)
• Recorded Target (Dead)
An absolute target is specified relative to the axis zero position:
[Axis 1 Target 1000 Enter} would program a move to an absolute position of 1000mm
A relative target is specified relative to the current axis position:
If Axis 1 was at 1000mm, then
[Axis 1 Move minus 1000 Enter] would generate an absolute target of 0.
It should be noted that relative moves are only a means of programming an absolute target, once
the move is recorded then only the target is recorded, the fact that it was recorded as a move
relative is ignored. It should also be noted that in all cases the move will be verified as valid, before
the user can continue i.e. the move relative does not take the axis beyond its working limits.
A Dead (also known as Mark or Trim) allows the recording of absolute targets which may be used in
multiple states. A Dead has a target position, saved with an associated name and number, and is
unique to a single axis.

The benefit of using a Dead is that if the user wishes to change a target position in multiple states,
they can simply re-record the Dead position and it will be automatically changed in every state.
2.5.3 Speed and Time

The speed of a move may be programmed using either an explicit Speed or with a Time which
calculates the Speed required. The two are mutually exclusive, such that a move will either show a
Speed or a Time based on the last command.
Speed is described in user units per second (millimetres, feet, inches etc.), and Time is always
displayed and entered in seconds.
A maximum speed for each axis will be configured in the database during commissioning and the
User will not be allowed to plot speeds above this maximum axis speed or above any User axis
restrictions that may be applied.
A default speed will also be configured for each axis during commissioning. This speed is nominated
as a generally safe speed and utilised by eChameleon if the User does not specify any other speeds.
Whilst eChameleon constantly displays “time left” (to complete the plotted move) for all axes under
control, it is often useful to plot moves over a time, rather than entering speeds for each axis. A
traditional scene change will often use many axis travelling in different planes, from differing
positions and starting at different times but all finishing at the same point in time.
When a Time command is entered the user is presented with several options of calculation:
Time can be calculated from:
• Current Position
• Previous Position (Either the last position that the axis moved to within the state list, or the
target of the preceding Multi-Target move)
To Time a move:
• Plot the final target for each axis (target, dead, move etc.).
• Plot any other move parameters (Accel, Decel, delay etc.)
• Time the move (i.e. Axis Time 20 Enter)
• Select the type of timing calculation from the presented options (from current position,
previous state position, with/without delay).

Timing will only be applied if the generated speed is within allowable limits. If this is not the case an
error will be thrown indicating the minimum achievable time.
Timings should always be applied as the final part of a command line – any changes to any other
move parameters subsequent to the timing calculation will result in an invalid speed for the altered
move.
It is also possible to convert to and from a Timed Move. By entering Axis # Time Enter, a move
programmed with Speed will be issued a Time command which matches the plotted speed.
Conversely, if a Time is no longer relevant to the control graph, then Axis # Speed Enter will remove
the Time parameter, but retain the same Speed.
NB: The speed and subsequent timing of an axis will never be automatically adjusted. When
loading a move programmed with time it will always run at the same Speed as when
programmed. If the current distance to travel makes the Time invalid, it will be displayed in Red.
2.5.4 Accel and Decel

The Acceleration and Deceleration portions of a trapezoidal move can be plotted in one of two ways:
• As user units per second squared (i.e. mm/s/s, feet/s/s)

• Or as a time (i.e. Acceleration over 2 seconds, Deceleration over 3 seconds)
Acceleration rate may be entered into the command line by pressing the Accel Key
Acceleration time may be entered into the command line by using the toggle function of the Accel
Key.
Deceleration rate may be entered into the command line by pressing the Decel Key
Deceleration time may be entered into the command line by using the toggle function of the Decel
Key.
Whilst both methods have merit in differing applications, it is often simpler to consider Accel, Decel
rates in times, especially when using an overall time for a cue.
If a time is used, then changes in the cue speed will not affect the general move shape (particularly
useful when using multiple joined axis i.e. bridals)
However, in some cases a basic rate of Accel or Decel is preferable, if for example, an axis is
mechanically designed to work at its optimum at a fixed rate of Accel, Decel.

2.5.5 Ramps
A standard move within eChameleon employs a
trapezoidal ramp shape.
In this example the Accel and Decel are constant rates of

250 mm/s/s and the speed is 500 mm/s, which equates
to a 2 second ramp up and 2 second ramp down time.
Mathematically, this means that the “Jerk”, which is the

rate of change of acceleration, is infinite at the start and end of each acceleration phase, and that
the acceleration is constant in these phases.
In some applications this is not desirable, since it can lead to the sway or bounce of an axis, and as
such it is useful to apply and remove the acceleration or deceleration in a more gentle manner, with
what eChameleon calls a Ramp Shape.
The most extreme case is known as an S-Ramp, due to the speed graph resembling an S, with no
constant acceleration phase, however this can dramatically alter the ‘look’ of a move, and
sometimes more subtle correction is all that is required.
Ramps can be defined by the user in eChameleon Manager, although eChameleon offers 3 standard
Ramp Shapes:
• Ramp 1 - S-Ramp
• Ramp 2 - Intermediate
• Ramp 3 - Nearly Trapezoidal
When defining a Ramp Shape, the user must specify the percentage of time the axis should spend in
each of the regions shown below. The whole acceleration or deceleration phase must add up to
100%, ranging from the trapezoidal case where all are set to 0% and so 100% of the time is spent at
constant Accel through to a true S-Ramp which has 50% in each of regions 1 to 4, leaving no constant
acceleration phases.

This definability allows the user to create asymmetrical behaviour between Accel and Decel, and
even within each phase, and so some quite complex effects can be achieved if desired.
Ramps are can be particularly useful in situations with high inertia. The user should take care,
however that the use of a ramp does not mask an inherent mechanical problem. Equally a ramp can
become a problem if the axis has other mechanical issues, such as lost motion due to slack
counterweight assist lines. In this case the gentle part of the acceleration will be lost during the lost
motion and the full load will be hit with a greater rate of acceleration than a standard trapezoidal
move.
Ramp shape is the toggle function on the Speed key, and a ramp may be entered using the following
command:
Axis # Ramp Shape 1
To remove:
Axis # Ramp Shape 0
or Axis # Ramp Shape Enter
In the case of a Multi-target move (see Multi-targets) differing accelerations, decelerations and ramp
shapes may be applied to each section of a multi-target move.
This again is a simple command line entry:
i.e. Target 3 Ramp Shape 2
2.5.6 Delays
Simple Pre-move delays may be added to any command line using the toggle function on the
Time/Delay button.
i.e.
[Axis 1 Delay 10.5 Enter]
This will result in the move for axis 1 executing 10.5 seconds after the playback is fired. During this
delay period the axis will enable, but not move, while the delay is counted down within the “Time
left” display on screen.
Delay can be entered into the command line with the toggle function on the time key.
2.5.2 Multi-Target Moves

A move in eChameleon may consist of various properties, at least Target, Speed, Accel and Decel.
eChameleon has the ability to chain these moves together in what is known as a “Multi-Target
Move”.
By default all axes in Speed Mode have a single target, which is implicitly referred to when applying
an operation to an axis. If an axis has more than one move, they must then be referred to explicitly,
using the Target Number command, counting the first move as Target Number 1.

When addressing Multi-Target moves, the Plus, Minus and Thru commands may be used to select
multiple moves at once.
If a Target Number is selected which does not exist, this will be added as long as it is the next
incremental move in the list. Targets may also be inserted using the Insert Target Number
command.
The Target Number functions can be found as 2nd and 3rd toggles on the “Dead/M-Tgt” button.
eChameleon offers the user the ability to plot multiple-target moves for single or multiple axis. A
Multi-target has many uses but in most cases will be a string of linked move parameters with varying
targets, speed, accels, delays etc.
A singular point to point move is regarded by the system as “move 1” and as such it becomes a
simple user command to add “move 2, move 3” etc and even to insert a move in between existing
moves.
A multi-target command is entered using one of two methods, the simplest of which is by the use of
the “Dead/MT” button.
Pressing “Dead” once reflects on the command line as “Dead”, the second press enters “Target
number” and the third press “Insert target”
It is then a simple step to create a multi-target such as “Target number 1, Dead 2, target number 2,
Target 2000, speed 1200” etc .
When a multi-target is present then the move profiles are displayed as a graphical list within the
control view and a target symbol is displayed on the grids or dynamic axis grids. The target symbol
forms a drop down displaying the list of move parameters. The move parameters may be edited
simply by clicking on any of parameters displayed, this will enter the relevant command line for
editing or issue.
Pushing and holding the “MTarget” button will open the Multi-target and triggers editor.
The multi-target editor displays any multi-targets already present as a list, with options to add a
selection of triggers for each move.
Only axis under control of the current playback will be displayed as available for editing.

2.5.7 Repeat
If an Axis has a Multi-Target Move with two or more targets, a Repeat may be used to loop back to
the beginning after the completion of the last move.
A Repeat may be either infinite or a specified number of repeats. A normal Multi-Target move has a
repeat of Zero, and so a Repeat of 1 implies the moves will execute twice.
[Axis 1 Repeat Enter] Repeat until Stop button is pressed.
[Axis 1 Repeat 10 Enter] Run moves, and then repeat 10 times,

Before coming to a normal stop.
[Axis 1 Repeat 0 Enter] Remove Repeat, only run initial moves.
A Repeat may be programmed from the Multi-Target Editor, or using a Command Shortcut.

2.6 Actions
An Action is a collection of Axes and/or Groups with associated move data.
In order to record or delete an Action, the user must have appropriate privileges.
An Action is especially useful for sequences which are used often, or as a more permanent clipboard.
They also are ideal for saving moves for emergency show recovery scenarios which do not belong in
a specific State.
When recording an Action, the user may either select a specific sub-set of axes from the current
playback, or simply record the whole playback using the commands such as:
[Action number Record]
[Action number Text name Record]
[Axis 1 + Axis 2 + Group 1 Action number Record]
To delete an Action the command is:
[Action number Delete]
Please note that an Action may be deleted at any time without affecting previously programmed
States. In the same way, updating an Action will not update any States which had used it.

2.6 Triggers
A Trigger is a means of starting, stopping or modifying motion of an axis, based on the movement of
another axis. There are many forms of types and conditions of triggering available within
eChameleon. The axis/group or playback involved in the triggering should be considered in two
ways: the “triggerer” or source (the object that is providing the trigger point) and the “triggeree” or
target (the object that receives the trigger.
The condition of the Trigger (i.e. at what point is the Trigger executed) from its source may be:
• By absolute position
• Dead (i.e. Dead position reached)
• End of move (number)
• Speed reached
A single trigger condition can cause multiple actions to

occur at the same point. The action of the trigger will
change depending on the type of triggered object,
which may be:
• A Playback
• A Group
• An Axis
• A Macro
If a Playback is triggered, then it may be:

• Started
• Stopped
• Paused
• Resumed
If an Axis or Group is triggered, it may be:

• Started
• Stopped
• Paused
• Resumed
• Issued a Speed Change
• Caused to “Jump to Move Number” (within a multi-target)
NB: Triggers do not only refer to multi-target moves, they can be used with
standard point to point moves!
As eChameleon sees every move as a move number, then a single target

point to point move can be considered as Move 1 within the multi-target
editor, even though there are no subsequent moves

2.7 Shows
A Show is the basis of all States, Groups, Actions, and Deads and much more in eChameleon. As with
all items in the system, it must have a unique number.
A new Show can be created at any time from eChameleon using the syntax
[Show number Text name Record]
Shows may not be recorded over, and so must be deleted before a show number may be reused.
To delete a Show use the syntax
[Show number Delete]
However this process is not one which can be undone, and may result in the loss of a large amount
of data if accidentally issued. For this reason the user will be prompted to confirm this in a message
box which will prevent input until the user has clearly read the warning message.
2.7.1 Show Modes

A Show may be in either Edit or Performance Mode.
In Edit mode, all operations are possible (depending on user privileges), however on desks without a
dedicated Next and Last key, States must be loaded numerically since the arrow keys are performing
command line cursor navigation.
In Performance mode (indicated by a White background on the Current State bar in eChameleon), it
is intended that the user is running a pre-programmed show, and thus should not be making
changes. It is therefore not possible to Record or Delete any item whilst in Performance Mode.
Show mode may be toggled at any time, including during a show, without affecting the currently
loaded state.

2.8 States & Roles

2.8.1 State
eChameleon uses the terminology State for what is often referred to as a Cue. This is because
eChameleon makes use of multiple playbacks in one State, thus giving the user the choice to either
split a Cue across multiple playbacks, or to place one Cue per playback for rapid sequences.
It is worthy of note that any axis loaded to any playbacks are always live and ready to execute and
that states are simply a method of recalling a known set of sequences.
The state list is essentially a list of pre-defined sequences with axis and move parameters recorded
to the playbacks. For show running purposes the operator will use the Next key to advance through
the states after each state has been run.
It is usual to build a state list to include sections for axis testing, pre-show checks, preset moves,
show cues and après show moves. This obviously differs from show to show and venue to venue
where and in venues where the system is used more for performance space modification rather than
show running.
The states are numbered in a way useful to the user and have an option to add a textual title. The
state list also displays coloured indicators of available state, loaded state, tracking state and other
roles states.
To record the current moves as a state:
[State number Text name Record]
To delete a state:
[State number Delete]
To re-name a state:
[State number Text name Enter]
In this case we do not need to re-record all the state detail.
NB: In order to facilitate Tracking (see below), when a new State is ready to be
created, the “Clear All Playbacks”, or “New” command must be issued, which
remembers the prior state number (indicated with brackets in eChameleon), and
assumes that the next state to be recorded follows this in sequence. If states are to
be recorded out of order, it is recommended that the operator loads the state
immediately preceding the intended new state first.

2.8.2 Roles
A Role is means of partitioning the cues in order that multiple operators may share the operation of
single show.
A Role is a system item which is created using eChameleon Manager, and has a unique number and
name. Roles will often represent a location of operation, for example “Fly Floor”, or “Sub Stage”, as
this location will have a set of cues assigned to it. It is important not to confuse Roles and Control
Points. A Control Point is a physical connection location which may have restrictions on the axes
which can be operated, whereas a Role may be used from any Control Point, and merely represents
a sub set of the cues for a Show.
A single state may have an entry for multiple roles, each of which can have a unique name. This can
allow for cues to be called with the same number for all operators. When multiple roles all
participate in a state, it is assumed that all roles will load their states at the same time, therefore
eChameleon will not allow a state to be recorded which use the same axis in multiple roles.
Multiple users may have the same Role loaded at one time, which allows for powerful multi-desk
plotting, and running of cues for other operators in unexpected show situations.
When logging in to eChameleon, a specific role must be selected, which then determines which role
all states are loaded for, however at any time a state may be loaded for another role:
[Role number State number Enter]
States may also be recorded for another role:
[Role number State number Text name Record]
At any time, it is quickly possible to switch roles:
[Role number Enter]

2.8.3 Tracking
A tracking or tracked state allows a playback/s and associated move parameters to be carried
forward into subsequent states. This option allows the operator to Next or Last to add additional
states whilst playbacks are in motion and hence allows continuous motion throughout state
advances.
A simple example of this would be:
A revolve (turntable) moving throughout a scene change, whilst, on a called cue, a flown piece flys in
and then flys out. The operator in this case needs to set the revolve in motion and execute the flying
“IN” cue, then “Next” in order to load an “OUT” cue for the flown piece, without affecting the
revolve.
Tracked playback/s may be tracked through any number of subsequent states, but must be explicitly
recorded into those states. The tracked playback move parameters remain in the base state, and the
subsequent states merely link to the same information.
When loading a state which uses Tracking (indicated in eChameleon with a purple icon in the state
list), it will always load with all tracked information present, irrespective of the order that state is
loaded in.
If alterations are made to tracked playbacks in anything other than their originating state, they will
not be recorded. The changes must be made to the original state and will therefore appear in all
Tracked states. When running states in sequence, alterations to tracked playbacks will remain
current if using Next and Last commands, however if a state is loaded by number, the original
Tracked information will be reloaded.
Enabling Tracking in eChameleon:
• The Tracking selections are accessed using the “State Options” button
• Tick playback is the box for the playback to be carried forward into the current state (only
allowable if the playback is unused in the current state and the axis concerned are not
assigned playbacks in the current state)
• Once the playback is “ticked” then the move information (brought forward from the last
state that the playback was used) will be displayed in the current state and a “Tracked”
statement will appear next to state options
• The current state must now be re-recorded in order to retain the tracking.

2.9 Simulation
eChameleon features a full simulation, which allows axes to loaded and run in real time, however no
move data is transferred to the nodes and no ‘real’ axis will be set in motion. The simulation can be
used in Offline mode, or temporarily enabled in Preview mode.
2.9.1 Offline
Offline mode is selectable at log in of eChameleon, and is also used in the event that the automation
network cannot be contacted on boot (an error will warn the user). It is most useful for pre-plotting
and training of new operators, as there is no risk of accidental real-world motion. To exit offline
mode and return to a live online configuration, the user must restart eChameleon.
2.9.2 Preview
The Preview function within eChameleon allows the control desk to be placed in an instant
simulation mode. All standard functionality remains available and all states may be accessed and
run. If positions are changed for axes in Preview, this will not affect the real axes.
When in Preview mode, there is an option to “Preview state start positions”. This means that when
a State is loaded, then the axes current positions are snapped to the appropriate starting positions to
run the loaded state. These positions are calculated from target position on the last occasion that an
axis was used in a state prior to the loaded state. It is always, therefore, advisable to plot a ‘preset’
state at the beginning of a show’s state list which includes all axes targeted to their show starting
positions.
When exiting preview mode then the axes current positions and status are updated to that of the
real system.
2.10 Undo & Redo

Undo and Redo operate on the current state only, allowing the user to undo changes made to axes
loaded, targets, speeds etc. eChameleon will remember up to 10 previous command line operations
which can be undone (and then re-done if required).
When any item is recorded or deleted, the undo chain is broken, and so it is impossible to go back.

2.11 Multiple Desks

2.11.1 Axis Locking
In a multiple desk application, it is important to ensure that only one user has control of an axis at
any one time. The first user to acquire an axis will have sole use of that axis until it is released from
all Playbacks on that desk. If other users attempt to load an axis which is already under control, they
will receive an error which indicates which user has control of the axis.
2.11.2 Refresh
In a multi-desk environment, it is necessary to keep up to date items which may have been altered
on another desk. This typically includes States, Deads, Groups and Actions. eChameleon performs
automatic updates of this data in most circumstances as it is altered on other desks, but to avoid
conflict with loaded axes and states, there may be some items not updated instantly. In this case an
explicit Refresh command may be performed in order to synchronise the data with other desks.
Refresh may take a longer amount of time to execute than most commands, due to the quantity of
data being exchanged.

2.12 Labelling
The Text key allows alphanumeric data to be entered on the command line, in order to name any
recorded objects such as States or Deads or Actions and also allows re-naming of Axis within a show
Text can either be specified within the command line at the point of Record, or it may be added or
modified at a later date. For example:
[Dead 1 Target 16000 Text “OUT Dead Record]
[Dead 1 Text “Higher OUT Dead”]
Note that when used to alter the name of a recorded item, the command is followed by Enter and
not Record.
The Text command also offers the ability to textually edit the name of an item. When selecting an
item to rename, if Text is pressed twice it will populate the command line with the existing name,
allowing the use of the command line cursor to edit it. On typing Enter, the item is then renamed as
normal.
NB When labelling objects such as Deads, States and Actions it is worth thinking
about a standardised approach to your labelling before you start work. This will
help with consistency across your shows, the aid the operators and provide you
with an efficient way of referencing back to your work at a later date.
Names like “Current” “This one” “new” and “amended” should be avoided as
inevitably you will end up with several “new” or “current” objects.
It is worth having a few basics such as “IN Dead”, “Out Dead” and “Show Dead” as
venue standards and then potentially labelling further objects with some relevance
to their use.
It is also worth avoiding hugely long and cumbersome textual or numerical labels,
especially with Deads, where a quick look up is essential and with States when a
quick reference of called Cue number is often all that is needed.
Always remember that you can add separate notes to States.

2.13 Shortcuts
eChameleon shortcuts offer the user a powerful selection of tools enabling instant access or
execution.
eChameleon shortcuts are available for:
• Input displays - Displays the status of monitored IO

• Command line entry - Captures and re-issues any command line
• Execution of Actions - Allows any recorded Action to be instantly executed
• Execution of Macros - Allows instant execution of external Macros, IO and
• combinations of Macros
eChameleon presents Shortcuts as a series of editable pages
Shortcuts may be executed directly from the shortcut pages (via mouse or touch screen)
When using an Acrobat with integral shortcut buttons, the first page of shortcuts relate directly to
the hardware buttons
The shortcut buttons on the Acrobat∙G6 are in the form of full colour OLEDs and as such can be
labelled and colour coded to match the generated shortcuts.
The shortcuts are colour coded for ease of recognition.
Shortcuts that execute external motion may be assignable and push and hold to execute and dead
man dependant.
Shortcuts may be combined to offer full sequence execution and monitoring from one button.
NB: Please refer to “Shortcuts Editor” for Shortcut setup procedures in eChameleon.

Shortcuts are a very powerful tool within eChameleon. The shortcuts screen may be accessed via the
“ …” button. The current shortcuts will be displayed on screen as a selection of pages and maybe
executed directly from the touch screen, if using a Nomad.
NB: The first page of shortcuts relate directly to the shortcut buttons on an Acrobat∙G6, from
where they can be immediately executed.
NB: Pushing and holding the “…” button opens the shortcut editor. See “Shortcuts Editor”
Shortcuts come in several formats:
• Actions:
o Allow a pre-defined action (sequence of motion (any series of moves that can be
programmed to a playback)) to be loaded to a shortcut. Very useful for “get out of
jail” cues and emergency cues
• Command capture:
o Allow any command typed into the command line to be allocated to a shortcut. Very
useful for frequently used commands and complex sequences.
• IO Tracing:
o Allows any system IO to be permanently displayed on a shortcut
• Macros:
o Allow any digital axis or sequence to be allocated to a shortcut

eChameleon User Interface
3 eChameleon User Interface

3.1 Login Screen
The eChameleon icon opens a log in screen at which the User is prompted to input their unique
numerical pin code.
In most cases this is all a user needs to do to access the system, however options are also presented
for User, Show, Online, Offline, local and server connections. These options will relate to pre-defined
or recorded selections within the database.
In order to select a different or new database, the user must open the eChameleon settings (please
refer to the appendix “eChameleon settings” or “Starting a new database”)
The User and Pin number options are defined within eChameleon manager, the Show and Role
options are defined within eChameleon.

3.2 eChameleon Main Screen
Menu and
Launcher Information Bar Axis Grids Tabs
Information
Circles
Dynamic Grids
Playbacks State Notes and

Devices Overview State Current
Errors
List State

3.2.1 Playback Colour Border

The border around the eChameleon main screen is colour coded to match the currently selected
playback. This colour is also reflected in the borders of any subsequently opened windows.
3.2.2 Information Circles

The information circles within the eChameleon main screen display a variety of real time
information.
The bottom left circle displays the last selected “resource” i.e. axis, group, state etc. –
this is important as a numerical selection alone will always add the last selected
resource as the initial command line entry.
The circle bottom right has toggle functions to display the currently used control
point, local or server connection, Online or Offline and A or B machine (if using an
Acrobat G6
3.2.3 Information Strip
The information strip sits at the top of the main screen and displays current selections of Show, Role,
Filter, User, view and time. These displays are drop down options enabling the User to change any of
these selections on the fly.
3.2.4 Playback Display

The bottom left section of the eChameleon main screen is the Playback mimic. The numbers of
playbacks vary per control desk.
The Playback display provides information on the percentage of plotted speed applied to each
playback (therefore controlled axis) and the time left for each move. The Playback graphic is
dynamically related to the physical E Belt adjustments.
3.2.5 Soft Desk

The Soft Desk allows a user to run eChameleon from a PC without a desk. The playbacks become
dynamically adjustable and a start/stop function is displayed below each playback.
3.2.6 Devices Overview

The Devices Overview allows the user to see at a glance the status of the most relevant
devices such as Emergency Stops, without requiring the Devices Tab to be visible. The
groups of System Inputs which appear here are user configurable, although Node Status
will always be shown.
In addition to Device status, when using a SIL3 system, there is an additional border which
displays SIL3 verification status. The border will be striped yellow and black if the state is

un-verified, and green if verified. See Features -> SIL3.
3.2.7 Menu
The eChameleon icon (extreme top left) contains option for basic system set up of Units,
Language, Display, Control surface, System and State Management. There is also an
option to print screen.
NB: Any options selected will persist between eChameleon

sessions for the logged in User.
Units allow the user to select units for position display, Load
and Torque.
NB: Load and Torque will only be displayed if they are

configured to output from the control system.
Language provides the user with a selection of

appropriate languages

Display allows the user to customise the

look and display functions of the control
surface and main screen:
• Show all Role states – includes all states within the state list regardless of Role ownership. If
not selected then only the states belonging to the current role will be displayed
• State list Queries States – when selected, clicking on a state title within the state list will
display the state query. If not selected then clicking on the state title in the state list will load
the state
• Always show dynamic grids – when selected dynamic grids will always be displayed,
regardless of any Tabular grids in the current view – this option is particularly useful for early
commissioning
• Query as you type - This option will enable or disable the dynamic command line syntax
checking. If the command line is valid, the text will be white; if invalid then the text will be
red.
• Show Torque and Load – these options are only applicable if the control system is configured
to output these values to the desk. The user may choose to display these values within the
grids
• Flash Dynamic Grid Errors – this option enables or disable the flashing status of the dynamic
grids when an axis is in error
• Show Last Command – when ticked this option displays the last command line entered in
Italics, within the command line entry box. If un-ticked then the command line entry box will
clear once a command is entered or executed. The last commands may always be viewed or
re-issued via the command line history
• Show Sculptor Borders – this is an option for use within the Sculptor graphical interface and
allows the user to view or not view any borders that are in place. Borders appear as semi-
transparent blocks within the performance space.

Control Surface allows the user to customise

the functionality of various elements of the control
surface.
• When Show Soft Desk is enabled the playbacks area of the main screen mimics the
behaviour of the hardware playbacks and provides Start/Stop buttons and the ability to vary
the playback percentage. This function is normally used by engineers running eChameleon
on a pc rather than a desk and is not intended for show running.
• Logarithmic speed override – this function affects the scaling of the playback e belts. In its
normal state the playback eBelt will return a linear change in percentage increase or
decrease (essentially it will take two full strokes of the eBelt for a 100 percent change in
speed override. If Logarithmic override is enabled then the eBelt response is no longer linear
and provides more granular control at the lower percentages than the higher percentages.
• Disable playback flashing – This function disables the flashing of the currently selected
playback selector button (at the top of each playback).
• Disable Playback Mode toggle – In its normal state the playback selector button will toggle
the playback mode from speed mode to joystick mode. Some users prefer to disable this
functionality and keep the selector buttons solely as a playback selection as this
functionality is also available from the playback mode button on the keypad.
• Next/Last Keys in Edit Mode – Whilst the Acrobat G6 has permanent Last and Next keys, the
Nomad and Illusionist do not and instead use the arrow keys for last and Next in show mode.
In Edit mode the arrow keys allow movement

System allows the user to modify the

behaviour of a few system level functions:
• SIL3 Monitoring – This function enables or disables the Sil3 safety monitoring functionality
within eChameleon. Sil3 is an option within Stage Technologies systems and will not be
available on all systems.
• Preview State Start Positions sets the Preview Mode behaviour to one of two options. When
this option is un-ticked the axis current positions are unaffected when eChameleon is taken
into instant Preview mode. If this option is ticked then the current axis positions are changed
(temporarily and only within preview) to be the correct position to run the currently loaded
state. This position is derived from the last target assigned within the state list. The axis
current position will be returned to its true state when Preview mode is de-selected.
• Disable State Skip Warning – State Skip warning will display a warning when Next is used to
advance a state (within the state list) without having executed any of the moves from the
original state, whilst in show mode. This is essentially a tool to provide warning of a “double
Next” in show mode.
3.2.8 Tab Bar

The Tab Bar appears on the right hand side of the screen, and contains a button for each of 5 distinct
tab areas. When clicking one of the buttons, the tab window will appear next to the tab bar. Only
one tab can be visible at any one time, and clicking again on the selected tab button will minimise
the tab.
If using multiple screens, a different tab may be visible on each screen at the same time. Each tab
button may be sent to the other screen by right clicking on it, which will then cause that tab to open
on the alternate screen.
3.2.9 Exit / Logout

Exit eChameleon and shutdown:
To exit eChameleon:
Click on the X icon on the top right of the main screen and acknowledge the confirmation. The user
will now be returned to the Launcher, with options described as above.

To exit the Launcher:
Click on the X button top right of the screen. The user is now presented with another screen
containing buttons for shutdown, restart, exit and cancel. If no action is taken then the desk will
power down after 25 seconds.
3.3 Command Line
eChameleon makes full use of the command line for User input – all functions and inputs can be
made directly through the command line allowing the user to input solely with the keypad and in
most cases avoid mouse or keyboard use.
Command lines however can be entered in several ways, either directly from the keypad or by
double clicking any parameter field within the user interface. The command line can also be
generated directly from immediate action keys and from command line captures held within
shortcuts.
The command line entries are stored in a history (of the entire eChameleon session). These historical
entries may be accessed either from a drop down at the end of the command line or by scrolling up
and down the history with the arrow keys. The historical command line may be dropped back into
the current command line, edited and re-issued.
A cursor is available within the command line. The cursor may be manipulated with the arrow keys.
Backspace will retard a single character, push and hold backspace will delete the entire command
line.
All data and move parameter changes are made through the command line. The command line is
displayed along the base of the main screen (above the playbacks and state list). The Acrobat has a
second command line mimic on the base of the second screen.
3.3.1 Syntax Checking

eChameleon will monitor the user input within the command line. Whilst the input is valid i.e. Axis is
followed by a number, then the command line will display in white text. If the user input is invalid
i.e. Axis is followed by Target, then the command line text will be displayed in Red, prompting the
user to correct the input.
3.3.2 Query as you Type

Query as you type is a configurable option within the Menu (top left of main screen)
This option allows the Query pages to expand to the relevant section as each command is typed and
hence display to the user all options and parameter relevant to the command line being typed.

3.3.3 Command History
Each command line entry of an eChameleon session is stored as an entry in the command line
history. The history can be viewed and command lines re-selected (re-issues) from either the drop
down to the right of the command line (with the mouse) or via the up/down keys.
A historical command line may be “dropped” back into the current command line and re-issued by
selecting the command line with the mouse.
3.3.4 On Screen Keyboard
The On Screen Keyboard is an option, selected through the menu settings. If selected, the keyboard
will be displayed on screen on each occasion that text entry is demanded. (If using a Nomad or other
touch screen device then the keyboard can be controlled via the touch screen.) The keyboard will
close once the text is entered.

3.4 Current Show

The current show section of the main screen contains all cue/state information pertinent to the
current show. This includes state list and state notes, current state, state names and role states.
3.4.1 State List

The state list is essentially a list of pre-defined sequences with axis and move parameters recorded
to the playbacks. For show running purposes the operator will use the Next key to advance
through the states after each state has been run.
The states are numbered in a way useful to the user and have an option to add a textual title. The
state list also displays coloured indicators of available state, loaded state, tracking state and other
roles states.
3.4.2 Current State

The current state shows a green indicator next to the state list number. The current state is also
displayed in the state title indicator above the state list, with “current state” in green followed by
the state number and state name.
If a change is made to a state (a change made to any axis parameter) then the state will be identified
as a “modified state” in red, hence prompting the user to re-record the state, if the changes are to
be saved.
3.4.3 State Options

State options are accessed via an on screen button above right of the state notes.
The recordable options for each state are:
• Start percentage for each playback on state load

• Maximum allowable percentage for each playback per state
• Options to Track any playback from a previous state (See Tracking)
• A selection for the recorded view required for the state:
Recorded view relates to the general screen layouts. The user can choose to record a
selection of views containing a number of differing grids, layouts and 3D camera views.
These views maybe assigned to particular states such that the general view will be loaded at
state load and only relevant information is displayed to the operator.

3.4.4 State notes

State notes allow the user to add textual notes to each state. These notes will be displayed each
time the state is loaded.
State notes can be used for any useful and pertinent text I.e. warnings, checks or Q sheets.
To add State notes:
• Confirm any errors present to clear the state notes field and click the “Edit” button
• Add your notes using the standard text functions and options and click the “Apply” button
• The current State must now be re-recorded to include your new state notes
• If state notes already exist, then use the “Clear” button within the state notes section to
clear these notes.
NB: This screen area is also used for user input and system errors and will therefore be masked
by any current errors until they are “confirmed”
3.4.5 Error Stack

The error stack, as previously noted, is displayed in the same area as the state notes. The errors
displayed are plain English errors describing invalid commands and user inputs. The errors are
logged within the auditing software “Monitor”.
Any errors displayed are layered in order of generation and the errors may be “confirmed”
individually or as a group. The user confirmation is also logged within “eChameleon Monitor”.
Once all errors have been confirmed then the state notes will again be displayed.

3.5 Devices Tab
Associated axis drop
Node in maintenance
3.5.1 Nodes
The Nodes section of the Devices Tab displays the status of all Nodes within the system.
• A green light beside the Node name indicates that communication to the node is good. A red
light indicates that communications are down.
• Any Node may be immediately placed into Maintenance mode (see below) via the tick box
beside the Node name.
• The drop down box selection (left of the maintenance selector) will display all axis associated
with the Node.
Maintenance
• Any Node may be placed in maintenance mode via the Devices query. Each Node has a tick
box selection for maintenance node (to the left of the title).
• When a node is placed in “maintenance” the desk ceases polling the node. This enables the
user to continue working in an online configuration, whilst a nodes communications are
down, without receiving warnings and faults.
• All axes relating to a node in maintenance will be displayed in
“maintenance”.
• A screen tip will display the IP address for each Node
3.5.2 IO Groups & IO

• System level IO is defined within eChameleon Manager.
• The IO section of the devices Tab displays the current status of all
system level IO (any traced IO within the system as distinct from Axis
level IO)
• General IO is usually grouped into several sections.
• I.e. E-Stops, MCC E-stops, Power, Outputs and other customer
specifics.
• A green IO status indicates that the IO is in its normal state.

• An IO state can be of serious consequence (i.e. E Stop struck) or simply information (i.e.
Pumps running). eChameleon therefore provides several colour, hence severity warnings and
indications for the state of the IO.
• A struck E Stop, therefore would indicate as Red (Critical), whilst a pumps running may
indicate as Blue (Information).
• The IO header groupings are reflected within the mini-devices view (see below).
• The tick boxes beside each IO nominate whether the IO status change is reflected within the
Mini devices View.
• A tick box is provided for Io groups (within each header) to “auto-tick” the entire group.
3.5.3 Mini Devices View

The mini devices view (to the left of the state list) is a mimic a user definable selection of the Devices
general I/O group’s headers.
The view is designed to be a permanent and instant general view of the system status. As with the
Devices query, the mini view is for the most part green for good and red for bad. If, for example, an E
Stop is struck, then the E Stop section of the mini view will turn red. Clicking on this section will
immediately return the user to the individual devices I/O query where the Input/Output can be seen
immediately with its corresponding label (i.e. DSL E Stop Hit)
3.5.4 Device History

The Device history is located on a button at the top right of the Devices Query tab. The history
contains a list of all device status changes made within the current session of eChameleon.

3.6 Control Graph Tab

The control graph tab is accessed by:
• Clicking on the control graph icon in Query

• Primary operation of Control/Devices button
The control graph shows a graphical representation of trapezoidal move for each playback with axis
under control.
Each PB may be expanded or contracted with the drop down arrow. All playbacks may be extracted
or contracted via the state drop down arrow.
Speed
Move number Deceleration
Target
Acceleration
Delay
Dead number
Playback and start percentage
Example:
A user input of [Axis 1 Dead 2 Speed 1000 Accel 300 Decel 200]
Would result in a control graph of

3.7 Display Tab

The Display Tab offers options for creation and customisation of the grids within the main screen.
The eChameleon main screen contains sectioned displays for all stored data, live data and feedback.
The centre section of the GUI (graphical user interface) is entirely user-customisable and is formed
of various types of grids (information displays). The user need not create any grids in the first
instance as eChameleon will create dynamic grids as required for any axis under control
A view is a generic name for a main screen layout. These layouts may be constructed, by the user,
from a selection of differing grid types. A selection of views may be recorded and subsequently
assigned to the loading of any state.
The grids have many options for customisation, available within the tabs. The grid options become
available as each grid is highlighted.
The grids may be positioned within the screen layout as required and eChameleon will not allow
grids to overlap and therefore hide controlled axis.
3.7.1 Current View
• The current view is displayed in the Information bar, with a drop down for all available views.
• The current view contains all information for the current main screen layout (including grids:
positions, members, rows etc.)
• The current view is definable within the Views Tab.
3.7.2 Recorded Views

Recorded view relates to the general screen layouts. The user can choose to record a selection of
views containing a number of differing grids and layouts. These views may be assigned to particular
states such that only relevant information is displayed to the operator.

3.7.3 Tabular Grid
A simple tabulated grid displaying individual axis move parameters and status (user definable).
Tabular grids contain a selection of grid rows or” fields”.
The user has the option to remove rows as necessary.
The row options are found in the view tab, when the grid to be edited is highlighted.
Certain rows cannot be removed for obvious reasons:
• Current position – displays current position in user units

• Status – Displays current drive status (ON, OFF, Move etc)
• Error – Displays plain English errors (if present)
Removable fields:
• Name – Axis name taken from eChameleon manager

• Group – group number displayed if group is selected
• Dead – Dead number displayed if a Dead is plotted
• Speed – speed displayed in user units (mm, ft etc.) per second
• Accel – Acceleration displayed as user units per second/second
• Decel – Deceleration displayed as user units per second/second
• Time – Displayed if current move is plotted using the time function
• Repeat – Repeat a cycling move if repeated is plotted
• Delay – Displays a pre-move delay in seconds, if plotted
• Load – displays a dynamic loading if system configured to output loads
• Torque - displays dynamic torque if system configured to output torque
• Time Left – constantly displays a time left for the current move including delays and based
upon a calculation including the current playback percentage
• 3D X, Y, Z – Displays 3D co-ordinates if Sculptor actions are plotted.
3.7.4 I/O Grid

Simple grid displaying status for an item of General I/O
3.7.5 Macro Grid

A Simple grid display of Macros loaded on playbacks

NB: See Macros and Playbacks
3.7.6 3D Grid
3D graphical representation of the performance space showing axis under control and in motion
(User definable).
3.7.7 Dynamic Grids

Axis number
Time left
Current position
Target
Dynamic grids are displayed either always by User option from the menu or at any point that an axis
is under playback control but not displayed within a defined grid.
They appear dynamically on the left hand side of the main screen and contain all information
pertinent to axis move parameters, current position, errors, status and time left.

3.7.8 Adding & Removing Grids
All grid types can be added via the Views tab with simple Add grid
buttons.
If using an Acrobat, the grid will appear on the primary screen
Once a grid has been added, it must then be populated.

Highlight the Grid to be populated and return to the views Tab.
The selection of objects with which to populate the

grid will vary depending on the type of grid, however
in all cases a window of available axis or objects and a
window of existing axis or objects will be displayed.
It is a simple tick box selection to then populate the

grid.

3.7.9 Moving Grids
Any grid within the main screen may be manually positioned.
To move a grid the User must click and hold the left mouse on the name tab of the grid. The grid
may now be dragged to the desired position.
A grid cannot be placed in a position obscuring another grid.
If the grid is dragged to an invalid position then the grid will be shown in red and if dropped by the
user, the grid will return to its original position.
Grids will naturally auto-size as other grids are added or re-positioned.
All grids within the main screen may be enlarged or shrunk within allowable limits with use of the +
and – buttons (bottom of Tabs field).
A “View” may be recorded once all grids have been positioned as desired.
Multiple views with separate grid layouts may be recorded and re-called.
3.7.10 Deleting Grids

Any grid or grid member may be deleted.
To delete a grid the User must:
• Open the “View” tab

• Highlight the grid to be deleted
NB: Once a grid is highlighted then the “Delete grid” option becomes
available (Grids field within View Tab). Press “delete Grid” – grid will be
removed and other grids re-sized.
3.7.11 Send to Other Screen

When a new grid is created it always appears in the primary screen (if using multiple screens).
To move the grid to the other screen:
• Highlight the grid to be moved

• Press the “move to other screen” button (available in Grids, within “Views” Tab)

3.7.12 3D Display controls

3D Grids have many user definable options.
The buttons along the top right of each 3D grid are instant camera options.
The first six buttons along the 3D menu bar are quick select camera views. The highlighted portion of
the cube, pictured, shows the location of the camera relative to the defined graphic.
The - and + buttons zoom act as zoom in and out.
The button between the – and + toggles between rotation and flat plane motion when moving the
graphic with the mouse. These functions are also available directly via the mouse.
3D manipulation with the mouse:
• Holding the left mouse button and moving the mouse moves the graphic in a single plane.
• Holding the right mouse button and moving the mouse moves the graphic rotationally.
3.7.13 3D Grid controls (Views Tab)

The 3D controls section of the Views Tab contains buttons and
functions for:
• Adding and deleting axis from the graphic

• Renaming the grid via the “…” button
• Recording, deleting, naming and ordering cameras
NB: If an axis is added to the graphic, then the axis will always
appear within the graphic – if the axis is into added to the graphic,
then it will only appear when the axis is under playback control.

3.7.14 Other 3D screen controls
3D Quick access default cameras Perspective/Orthographic view

Full Screen
Drag to re-size
3.7.15 Perspective vs. Orthographic
Perspective/Orthographic button toggles between a perspective view and a “flat” view without
perspective.
3.7.16 Default Cameras

The standard set of default cameras are designed to give camera views for all 6 standard planes
front, back, above, below and each side.
The standard cameras may well be useful without modification, however if the user requires a more
specific camera view, then the graphic can be manipulated, as described above and a new camera
view recorded. The User defined cameras do not appear as quick access keys, but instead appear as
cameras (which may now be named) within the Cameras section of the Views Tab.

3.7.17 Recording Cameras

To record a new camera:
• Press the “New” button within the camera section of the views tab.
• Manipulate the graphic, as described above, until the desired camera view is achieved.
• Press the “Save” or “Save as” button within the camera section of the views Tab.
• The new camera will appear as a numbered camera in the list of currently recorded cameras.
• The order of the recorded cameras may be changed using the “move up” and “move down”
buttons.
3.7.18 Deleting Cameras

To delete a camera view:
• Select the camera view to be deleted: either click on or press on the camera within the
cameras section or use the Camera number Enter command line entry.
• Press the “Delete” function button within the current cameras section of the Views Tab.

3.8 Query Tab

3.8.1 Query Home
The Query Home Tab contains shortcut s for a selection of queries. The
available selection depends upon the control desk type and system
configuration.
The Query home contains standard options for Home, Back and Up Level
NB: If the Dynamic Query option is selected and Query Home is displayed
then the appropriate queries will be displayed as the user inputs command
lines. (I.e. as Axis 1 is typed then the axis level query, for axis 1 will be
displayed, showing all telemetry, properties, Deads and inputs.)
Query Home may contain query information for:
• Axis
Axis Query displays all individual axis telemetry, properties, associated Deads and axis level
inputs (i.e. limit switches, slack ropes etc.). The axis level query also gives the user options to
change/set software limits (high and low), current position and to acknowledge a drive fault
and “Freeze” an axis.
• Groups
The groups query contains information about each group currently recorded within the
current show. It displays group type and axis members.
• Actions
The action query displays information about all actions currently recorded within the current
show. When an individual action is queried then the display shows a graphical representation
of all associated axis and move parameters.
• States
The state query displays information about all actions currently recorded within the current
show. When an individual action is queried then the display shows a graphical representation
of all associated axis and move parameters.
• Shows
The shows query displays a list of all current shows within the database. Querying an
individual show displays a few properties for the show type.
• Macros
The Macro query displays a list of all Macros currently recorded within the show. Querying an
individual Macro will display a description of the Macro properties.
• Control points
The control point query displays a list of control points currently defined within the database
along with the current usage status (i.e. if a desk is currently connected, with the user role
and logged in user.
NB: The available Queries are dependent upon desk type and system configuration.

3.8.2 Axis List Query

The Axis List Query displays a list of all
Display Options
available axes within the system.
Display Options
The “Show” button toggles views (Display

Options) of: Current position, Low and High
soft limits and Query – these displays allow
concurrent multiple axis comparison.
Each Axis shows its name, a tick box for

multiple selections and a shortcut to the axis
level query.
Operations Axis Selector
The Axes Query also contains buttons for

changing/editing soft limits, current position
and for Drive Resets, Freezing and Thawing
axes. (Operations)
These options can be made as multiple axis

selections by using the Axis selection tick
boxes. These buttons result in the generation
Axis Operations
of a command line.
3.8.3 Axis Query

The Axis level query contains all current and recorded information for an
individual axis
Summary
The summary displays the current status of an axis – position, Status, any
errors present, load and torque (if applicable).
Properties
The properties section displays all axis level properties (as defined within
eChameleon Manager)
Deads
The Deads section displays a list of current Deads defined for the axis.
Each Dead has a numerical selection, name and target (in user units)
If the axis current position matches any of the Deads targets, then the Dead
will be displayed in green.

Axis Inputs
The axis inputs section displays the current status of any traced inputs associated with the axis.
These would normally be traced safety devices local to the axis (I.e. hardware limits, cross groove
switches etc.
Associated Inputs
The Associated inputs section displays the current status of any general IO associated (within
eChameleon Manager) with the current axis.
NB: See Associated IO
Associated IO would normally be any general level IO that impacts on the functionality of an axis (I.e.
a hydraulic lift may have pumps running and pumps pressure associated with the axis)
Operations
The Axes Operations section contains buttons for immediate changing/editing soft limits, current
position and for Drive Resets, “Freezing and Thawing” axes.
3.8.4 Group List Query

The Groups list query displays a list of all recorded groups within the current
show.
Each group displays the group type:
• Free, Safe or Locked (See Groups)

• Group numerical selection
• Group Name
• Group Query selection
3.8.5 Group Query

The Group Query selection button, in the Group list Query, takes the user to
the Group level Query.
• The Group level Query Displays:

• The Group type, number and name
• The Group members (If the group is locked, then the Master axis is
displayed in green)
• The Query button on each group member takes the user directly to the axis level query.
Operations
The Group operations selections live at the base of the Group Query
window.
The available Group operations are:
• Change Group type – allowing instant group type changes

• Set master Axis – allowing the master axis of a locked group to be re-defined
• Set Alignment – allows a locked group alignment to be set, after the group has been recorded
• Correct alignment – allows a locked group to be reset to its alignment, relative to the master
axis position.
• Freeze/Thaw – Allows a group to be frozen/thawed
3.8.6 Action List Query

The Actions Query displays a list of all actions recorded within the current show
Each Action contains a numeric reference, name and Query selection.
3.8.7 Action Query

The Query button within each Action displayed in the Action List, takes the User
to the specific query for that action. This is displayed as a “greyed out” control
graph for each axis used within the action.
The action is not editable from this control graph view.
3.8.8 State List Query

The State List Query displays a list of all recorded states within the current
show.
This list mimics the State list within the main screen, with the additional option
of a state level query button.
Filter By Role
The State list Query may be filtered by Role. The currently defined Roles are
displayed within the drop down (top right of the State Query). An individual role
may be selected to filter the state list query to only those states recorded to
that Role.
3.8.9 State Query

The Query button within the State List Query takes the User to the State Query
(individual state).
The State Query displays as a control graph for all axis recorded within the
state.

Move parameters cannot be edited from this screen.
3.8.10 Shows Query

The Shows Query displays a list of all shows currently recorded within the database.
Each show has a Query selection button
3.8.11 Macros Query

The Macro list query will only be visible if Macros are recorded within the database.
The Macro list Query displays a numerical selection, name and a Query button
The Macro Query (individual Query) displays the Macro name, mode and any other associated
parameters.
3.8.12 Control Points Query

The Control point Query displays the connection status of all control
points configured within the system.
Each control point displays the current logged in User name and Role.

3.9 Multi-Target Editor

To create a multi-target move on one or more axis:
Command line approach: (NB in all cases Target may be replaced with Dead)
[Axis number Target number Enter] applies the first Target to the
chosen axis
[Axis number Target number 2 Target number Enter] applies a second move to the axis
[Axis number Insert Target number 2 Target number Enter] applies a new target for move 2
and shifts the old move 2 to
move 3
In the same manner a complex command line may be created:
[Axis 1 Target number 1 Dead 3 Speed 500 Accel time 3 sec Target number 2 Target 3000
Accel 250 Decel 300 Time 15 sec Enter] etc.
Once a multi-target move has been entered it may be edited in the same method or by directly
clicking on the appropriate fields in the grids or control graph
NB It is often simplest and most efficient to edit existing multi-targets directly from the
Control Graph.

Alternatively the Multi-target and Triggers editor may be opened:

Editable fields
[Speed] Push and hold
The picture below shows a multi target for a single axis, again any of the fields may be edited by
clicking on them. Add a Trigger to this move
New multi-target move
Axes under control

of the current
playback

3.10 Shortcuts Editor

The Shortcuts editor is opened by pushing and holding the shortcuts key “…”
To add or edit a shortcut:
• Select the required shortcut

• Select the required shortcut type from the drop down
• Enter required data for shortcut (see below for types and required data)
• Save and Close editor
3.10.1 Input Display Shortcut
An input display allows a shortcut to constantly display the status of any system level IO.
Required data input:
• Good message: textual message entered via the … - should be a simple

indication of the normal state of the IO (i.e. E Stop = Good)
• Bad message: textual message entered via the … - should be a simple indication of state of
the IO when it is not in its normal state (i.e. E Stop Struck)
• Display input : drop down selection of all available system level IO

3.10.2 Command Shortcut
Command line shortcuts allow any valid command line to be stored on a shortcut and re-issued at
will. This can be useful for command lines that are regularly used, especially during plotting; it can
also be used for “get out of jail” cues or cues that may require instant, out of sequence execution.
(I.e. front tabs IN, performer flying rescue etc.)
• Message textual message entered via the … - this message should be a simple
description of the result of the command line
To capture command line:
• Choose “close shortcuts window” if the shortcuts window may obstruct the desired
command line input.
• Press “Start Capture”
• Input desired command line (with or without “Enter”)
• Press “Stop Capture”
• Save and close
NB: It can be useful to use the arrow keys UP and Down to reinstate or edit a previous command line.
3.10.3 Action Shortcut
Action shortcuts allow instant execution of any previously recorded action.
• Action number: Numeric selection entered via the … - will only allows input of
available Actions.

• Require DMH: Tick box selection making allowing the Action to be deadman’s
dependant
• Latch: Tick box selection – making the execution single push or push and
hold.
3.10.4 Macro Shortcut
Macros are currently created within the database and display as a drop down selection within the
shortcuts editor.
• Message: Textual selection entered via the … - This should be a simple

description of the outcome of the Macro (i.e. Fire Kabuki)
• Colour: Drop down selection of colours denoting severity of Macro
• Macro: Drop down selection of available Macros

Command Line Reference
4 Command line reference

The command line within eChameleon has several generic principles that can be applied to all User
inputs. Once the basic methods and philosophies are understood, then it is an intuitive extension to
apply these methods to further functionality.
NB: For more information command line entry please refer to the “Command line” section
within features and functions
4.1 Clear down Commands

4.1.1 Clear
Clear is a primary command of the “PBClear” keypad button.
A press of this key will release all axes, groups and macros assigned to the current
playback, leaving it empty.
[Clear] will clear the current playback
4.1.2 New (Clear All)

New State (or Clear All) is a push and hold function of the “PBClear” keypad button.
This function clears down all playbacks, releasing all objects currently loaded.
It creates a new, blank state to record into, and must be used to ensure Tracking playbacks link to
the correct state when plotting multiple states.
[Clear] push and hold will clear all playbacks

4.2 Selection Commands

4.2.1 Resources
Most command lines will start with a resource (object) selection of an Axis, Group or
Action followed by a numerical label (i.e. Axis 1).
If an Axis is not loaded onto the current playback, eChameleon will attempt to gain
control, and thus load the Axis. If the axis is already under the control of another desk,
this operation will fail, however if it is on another playback on the current desk then it
may be ‘stolen’ depending on the syntax used. See Playback Stealing.
Once the object has been selected it can then be modified by other commands.
If loading an Action or Group, then multiple axes will be loaded onto the playback at once, and must
all be available for the command to succeed.
When selecting a resource, it is not always necessary to explicitly prefix the numerical selection with
a key press. The command line remembers the last resource type to be used and as such will
automatically enter the previous resource for you.
This is displayed on the screen to the left of the command line, and on a Nomad control desk the
appropriate key will be illuminated in Orange.
[Axis] writes Axis in the command line

[Group] writes Group in the command line
[Group] Push and hold Adds on demand functions to the current playback
[Action] writes Action in the command line
[Sculptor action] writes Sculptor action in the command line
[Role] Toggle State writes Role in the command line
[Macro] writes Sculptor action in the command line
Examples:
[Axis 1 Enter] takes Axis 2 into playback control
[Role 1 State 1 Enter] Loads State 1 for Role 1

4.2.2 Plus, Minus and Thru

These modifiers have two distinct uses within eChameleon. They may dictate whether to load or
remove an object from a playback, or simply filter the selection of objects on which an operation is
required
If a command line is prefixed by Plus, this will add the selection of objects to the current playback.
If a command line is prefixed by Minus, this will remove the selection of objects from the current
playback (if they are already loaded)
A complex selection of objects can be achieved by the use of Plus, Minus and Thru within the
command line, where the modifiers add or subtract objects from the selection.
The Thru command (which is accessed by pressing the + key twice), represents an inclusive selection.
i.e. Axis 1 Thru 3 means axes 1, 2 and 3.
NB: Minus may also be used numerically, for example when entering a soft limit of -1000mm.
Examples:
[Axis 1 + Axis 2] results in Axis 1 and Axis 2 taken into playback control
[Axis 1 + Axis 2 Target 1000] results in Axis 1 and 2 being assigned a target of 1000
[Axis 5] replaces the current playback control with Axis 5
[+ Axis 5] Adds Axis 5 to the current playback control
[-Group2] removes Group 2 from playback control
[Group 1 Thru. Group 6 speed 200] assigns a speed of 200 for groups 1,2,3,4,5 and 6
[Axis 1 Thru 5 – Axis 3 + Axis 7] takes axes 1,2,4,5 and 7 into playback control
[Axis 1 Dead 2] assigns the target for Dead 2 to Axis 1
[Axis 5 Target - 1500] Assigns a target of -1500 to Axis 5

4.2.3 Implicit Selection

Any object (axis, group, macro etc.) may be selected or commanded implicitly. In other words, a
command line without a selection command will be applied to all axes, groups etc. under control of
the current playback.
Since not all objects of differing types may have the same properties or capabilities, it may not
always be possible to use implicit selection.
Examples:
If Axis 1, 2, 3, 4, 5 and 6 are already held under a single playback control:

[Axis 1 + Axis 2 Target 1000] Assigns a target of 1000 to Axis 1 and 2 without affecting
any other axis
[Axis 1 Thru Axis 4 Speed 500] Assigns a speed of 500 to Axis 1, 2, 3 and 4 without
affecting any other axis
[- Axis 3 – Axis 4] removes axis 3 and 4 without affecting any other axis
[Axis 3 Target Number 2 Dead 3] Assigns a target of Dead 3 as a second target to Axis 2
without affecting any other axis
4.2.4 Playback Stealing
To swap axis from one playback to another:
Select the coloured playback for the axis to move to (with playback colour selectors)
Type:
[Axis numbers Enter] will remove the any currently controlled axis and replace
with the new selection
[+ Axis numbers Enter] will add the axis selection to the new playback

4.3 Axis Operations (modifiers)

Once one or more axes have been selected on the command line, the user can then use the Axis
Operation commands in order to program moves.
As discussed in Implicit Selection above, if no axes are explicitly selected, the operations are applied
to all axes on the current playback.
Examples:
[Axis 1 Accel 250] Assigns an acceleration rate of 250mm/s/s (of feet/s/s)
[Axis 20 + Axis 21 Accel Time 3] Assigns an acceleration time of 3 seconds to Axis 20 and 21
[Group 4 thru Group 6 Decel 1100] Assigns a Deceleration rate of 1100 to Groups 4, 5and 6
[Group 15 Decel Time 4] Assigns a deceleration time of 4 seconds to Group 15
[Axis 3 Target 550] Assigns an absolute target of 550 to Axis 3
[Axis 1 + Axis 5 dead 2] Assigns a Dead and associated Target to Axis 1 and 5
[Axis 3 + Group 2 Move 330] Assigns a target to Axis 3 and Group2 that is +330 from
their current positions
[Axis 4 Target number 2 Dead 2] Assigns the target of Dead 2 to the 2nd move (in a multi-
target for Axis 4
[Axis 4 Insert Target number 2] Inserts a new move number two in a multi-target and
shuffles all further moves down a number i.e. what was
move 2 becomes move 3 etc.

4.4 Speed and Time commands

To assign a speed to an axis or Group:
[Axis number Speed number Enter] Assigns a speed to the selected Axis
[Axis number + Axis number Speed number Enter] Assigns a speed to the selected Axis
[Group number + Axis number Speed number Enter] Assigns a speed to the selected
Axis/Groups
[Axis number Time number Enter] Assigns a time to the selected Axis
[Axis number + Axis number Time number Enter] Assigns a time to the selected Axis
[Group number + Axis number Time number Enter] Assigns a time to the selected
Axis/Groups
In the case of time commands the User is presented with several options
The user may select the time calculation either with the mouse, Keypad 1, 2, 3, or 4 or touch screen

4.5 Accel, Decel, Accel time and Decel time commands
[Axis 1 Accel number Enter] Assigns an acceleration rate to Axis 1
[Group 1 Accel number Enter] Assigns an acceleration rate to Group 1
[Axis 1 Decel number Enter] Assigns an deceleration rate to Axis 1
[Group 1 Decel number Enter] Assigns an deceleration rate to Group 1
[Axis 1 Accel time number Enter] Assigns an acceleration time to Axis 1
[Group 1 Accel time number Enter] Assigns an deceleration time to Group 1
[Axis 1 Decel time number Enter] Assigns an deceleration time to Axis 1
NB Changing an acceleration or deceleration rate or time will affect the overall

time of a recorded cue. This change will be reflected in the time left display.
To maintain a cue timing after any change, the cue must be re-timed after the
changes are made.
4.6 Ramp shape commands
To add a ramp shape to a playback:
Toggle [Speed] enters ramp shape into the command line
Ramp shapes are defined within the database and can be selected with a numerical selection
For more information on Ramp shapes: refer to the Ramp Shape section in
Functions

4.7 Multi-target and Trigger commands

Multi-targets can be entered or edited directly through the command line, Triggers however need to
be entered or edited via the multi-target and trigger editor [Dead] push and hold.
NB For more information on multi-target and triggered moves; please refer to the
multi-target and Trigger sections in the functionality section of this manual
Multi-target commands are cyclic toggles of the “Dead” key
Examples:
To enter a single target for an Axis:
[Axis 1 Target 500] enters a target of 500 for Axis 1
[Axis 1 Dead 2] enters a target of Dead 2 for Axis 1
To add a second target for Axis 1:
[Axis 1 Target number 2 Target 1000] adds the target 1000 as the second
target for Axis 1
[Axis 1 Target number 2 Dead 1] adds the target Dead 1 as the

second target for Axis 1
To edit the move parameters for a particular move:
[Axis 1 Target number 2 Speed 200] changes the speed of Move 2 to 200
[Axis 1 Target number 2 Accel time 2 Decel time 2 time 20] changes the Accel and Decel rate
and adds an overall timing of 20
seconds to move 2 for Axis 1
To insert another move prior to existing moves:
[Axis 1 Insert Target number Target 300] Inserts a Target of 300 as move 2
and shifts the original move 2 to
move 3
[Axis 1 Insert Target number 2 Dead 5] Inserts Dead 5 as the second Target
for Axis 1 and shifts the original
move 2 to move 3
This can be combined into a single complex command line:
[Axis 1 Insert Target number 2 Dead 5 Accel 500 Decel time 2 Delay 5 time 15 + Group 2 Dead 4]

4.8 Record, Delete and Enter Commands

Record, Delete and Enter are command line terminations and as such will execute and close the
command line.
NB The eChameleon Menu provides an option of clearing the command line on

Enter or showing the last command entered in Italics. Please refer to Menu Options
for further information
Examples:
[Axis 1 Text “Front cloth” Enter] Assigns the name “Front Cloth” to Axis 1 in
the current show – this method of labelling can be
employed for all objects (states, actions etc.)
[State 10 Enter] Loads State 10
[Action 15 Enter] Loads Action 15 to the current playback
[Action 15 + Action 17 Enter] Loads Actions 15 and 17 onto the current playback
[Sculptor action 100 Enter] Loads Sculptor action 100 onto the current playback
[State 5 Record] Records all current axis moves to State 5
[Action 99 Record] Records the contents of the current playback to Action 99
[Group 1 Record] Records the currently selected axis to group 1 and offers
the selection of group type
[State 99 Delete] Deletes State 99
[Action 3 Delete] Deletes Action 3

4.8.1 Recording and Deleting States

A State may be recorded using syntax such as:
[State 1.01 record] Records State 1.01 for the current role
[Role 3 State 1.01 Record] Records this state into another Roles State list
A State may be numbered up to two decimal places.
When recording a State with entries for multiple Roles, the contents of the State are assumed to be
loaded at the same time, and so eChameleon will check that the same axes are not used in another
Role at the point of Record.
The currently loaded State may be re-recorded by simply pressing Record without any other
command line entry.
To Delete a State, the syntax may be used as above, replacing Record for Delete.
NB: eChameleon uses the terminology of State for what is often referred to as a Cue. This is because
eChameleon makes use of multiple playbacks in one State, thus giving the user the choice to either
split a Cue across multiple playbacks, or to place one Cue per playback for rapid sequences.
4.8.2 Recording and Deleting Deads

To record a Dead, the user may explicitly or implicitly specify the Target to be used. For example:
[Axis 1 Target 1000 Dead 1 record] Will record Dead 1 using a target of 1000 for Axis 1
[Axis 1 Dead 1 Record] Will record the current position as the target for
Dead 1 if the current playback is in joystick mode. If
the Playback is in Speed Mode then the current
target will be recorded.
Deads may be overwritten at which time eChameleon will update the targets for all States in which
the Dead is used.
A Dead may only be deleted if it is not used in any States. Once it is no longer used, it may be
deleted using syntax such as:
[Axis 1 Dead 1 Delete]
NB When recording Deads the following rules apply:
• In Joystick mode, the current position is used.

• In Speed mode, the target position is used.

4.8.3 Recording and Deleting Actions

When an Action is recorded the contents of the current playback are recorded as an action in the
Action list. Any number of recorded Actions may be recalled to any playback at any time (if valid)
To record an Action:
[Action number Record]
[Action number Text name Record]
To Delete an Action:
[Action number Delete]
4.8.4 Recording and Deleting Shows

Recording a show is as simple as giving it a name and number i.e.
[Show number Text name Record]
The user may now select the show with the Show number specified
4.8.5 Recording and Deleting Roles

Role creation and editing are functions of eChameleon manager
4.8.6 Recording and Deleting Groups

When more than one Axis are under a single playback control they may be recorded as a Group
[Group number Record]
[Group number Text name Record]
[Axis 1 + Axis 2 Group 1 Record]
The User is now presented with the Group type options

These options maybe selected with the mouse, touch-screen or via the keypad with 1, 2, 3 or 4
In the case of a Locked Group the first axis

selected will be taken as the master (this
may be changed later)
When a locked Group is recorded the User

is asked to Rig or not to Rig:
In the case of a Sculptor Group the User is

presented with a selection of geometries
relevant to the number of axis members
of the Group – the selections may be
made in the usual manner
For more information on Group types and rigging please refer to the Group types
section of this manual
For more information on Sculptor Groups please refer to the Sculptor section of
functionality in this manual .

4.8.7 Recording and Deleting Cameras and Views

Cameras are User created Camera angles within a 3D grid. Once the User has manipulated the 3D
graphic to the desired position then this Camera may be recorded via the functions of the Views Tab
or directly from the command line i.e.
[Camera number Text “Front view” Record]
The cameras may now be selected with:
[Camera number Enter]
A view is the overall layout of grids within the eChameleon screens, including any cameras and
specific settings.
Once the layout of a screen has been established it may be recorded as a view and applied to a
particular state either from the Views Tab functions or directly via the command line:
[View number Text “Act 1” Record]
To apply a View to a State:
The view must be selected from the State options section of the main screen
Tick the Recorded View box and select the appropriate view
The current State must now be re-recorded for this view to remain associated with the state.

4.9 Text Commands

The Text key allows alphanumeric data to be entered on the command line, in order to name any
recorded objects such as States or Deads or Actions and also allows re-naming of Axis within a show
Text can either be specified within the command line at the point of Record, or it may be added or
modified at a later date. For example:
[Dead 1 Target 16000 Text “OUT Dead”]
[Dead 1 Text “Higher OUT Dead”]
[Axis 1 Text “Front Cloth”]
[View 2 Text “Maintenance View”]
Note that when used to alter the name of a recorded item, the command is followed by Enter and
not Record.
The Text command also offers the ability to textually edit the name of an item. When selecting an
item to rename, if Text is pressed twice it will populate the command line with the existing name,
allowing the use of the command line cursor to edit it. On typing Enter, the item is then renamed as
normal.
4.10 Mode commands

To toggle the current playback from Joystick mode to speed mode:
[PB Mode]
To select Reverse Mode:
[PB Mode] push and hold
To toggle show mode:
[Show] push and hold

4.11 Query Commands

The Query function is one of the most powerful features of eChameleon.
The Query tab, as described previously, allows the user to view, for example, all of the Axes on the
system, or the specific properties of an individual axis by navigating on screen.
The Query key is an extension of this allowing rapid access to every query page from the command
line.
Query commands are generally logical extensions of the related selection commands, for example:
[Axis Query] displays the list of Axes available
[Axis 1 Query] displays of the axis level query for Axis 1
[Axis 1 Dead Query] displays the dead list for Axis 1
The same logic applies for any item which can be accessed in the Query tab using the mouse, such as
groups, states, roles, actions etc.
NB For further information on Query; please refer to the Query Tab section of
this manual and also the Query on demand section of this manual

4.12 Immediate Commands

4.12.1 Undo & Redo
Undo and Redo operate on the current state only, allowing the user to undo changes made to axes
loaded, targets, speeds etc. eChameleon will remember up to 10 previous command line entries
which can be undone (and then re-done if required).
When any item is recorded or deleted, the undo chain is broken, and so it is impossible to go back.
Example:
[Axis 1 + 3 Dead 1 Speed 500] loads Axis 1 and 3 to the current playback
with a speed of 500 and assigns the targets
for Dead 1
[+ Axis 2 Dead 2 speed 200} Adds Axis 2 to the current playback with a speed of
200 and a target of Dead 2
[Axis 3 Speed 400] Amends the speed of Axis 3 to 300
If we now use:
[Undo] This function will now undo the speed amendment

on Axis 3 and it will revert to a speed of 500
And again:
[Undo] This will undo the additional of Axis 2
We can now:
[Redo] (Push and hold Undo) to re-instate the previous changes in the same manner as Undo.

Appendix
4.12.2 Preview
The Preview command allows eChameleon to be placed in an instant offline (virtual) state, such that
all functionality is available, but no real axis will be affected.
[Preview]
Once preview mode is engaged, the coloured border of the main screen will appear as a hashed line,
rather than a solid line. Preview has 2 modes, set within the eChameleon menu.
NB For further information on Preview please refer to the Preview section in

Functionality and also the menu option sections of this manual
To disable Preview mode and return to normal operation press [Preview] again
8.14 Quick View commands
Quick view commands allow instant access to the various Query and Tab functions of eChameleon.
All of the following functions and views maybe accessed via the mouse or touch-screen or directly
from the command line:
[Control] Opens the Control Graph section of the Tabs
[Control] push and hold Opens the Devices section of the Tabs
[View] push and hold Opens the Views section of the Tabs
[Query] Opens the Query section of the Tabs
Repeating these commands will close the relevant views

Appendix
5 Appendix
5.1 Keypad functions chart
PLAYBACK KEYS:
PB Clear: [PB Clear} Primary operation (1st press) – clears

down selected playback
[PB Clear] push and hold Push and hold – clears all playbacks, new
state
PB Mode: [PB Mode] Primary operation – changes PB from

speed to Joystick mode (if available)
[PB Mode] push and hold Push and hold – sets the axis in playback
control to reverse mode
RESOURCE KEYS: (Keys that select the resource to be

modified)
Axis: [Axis] number Primary operation – enters “Axis” into

command line
Group [Group] number Primary operation – enters “Group” into

the command line
[Group] push and hold Push and hold – sets Safe on Demand or
Locked on Demand
Action: [Action] number Primary operation – enters “Action” into

the command line
[Sculptor action] number Toggle (2nd press) enters “Sculptor

action” into the command line
State/Role: [State] number Primary operation – enters “State” into

the command line
[Role] number Toggle (2nd Press) enters “Role” into the

command line
Macro: [Macro] number Primary operation enters “Macro” into

the command line

Appendix
(Keys that modify the parameters

PARAMETER KEYS:
assigned to the resources)
[Accel] number Primary operation – enters

Accel/Accel time “Acceleration” into the command line
[Accel time] number Toggle (2nd Press) enters “Acceleration

Time” into the command line
[Decel] number Primary operation – enters

Decel/Decel time “Deceleration” into the command line
[Decel time] number Toggle (2nd Press) enters “Deceleration

Time” into the command line
[Target] number Primary operation – enters a “Target”

Move/target into the command line
[Move] number Toggle (2nd Press) - Enters Move

Relative (to current position) into the
command line.
[Dead] number Primary operation - Enters “Dead” into

Dead/M-Target the command line
[Target number] number Toggle (2nd Press) - Enters Target

number into the command line
[Insert target number] Toggle (3rd Press) – Enters Insert Target

number number into the command line
[Dead] Push and hold Push and hold – opens the multi-
target/trigger editor
[Text “”] name Primary operation - Enters “Text””” into

the command line, allowing the
Text user to write text labels to any relevant
objects or parameters
[Text “axis 1 target 2000”] Push and hold – object/state number

followed by push and hold – recalls
the current text label for editing
[Speed] number Primary operation - Enters “Speed” into

Speed/Trig the command line
[Speed] push and hold Push and hold - opens the multi-
target/trigger editor

Appendix
[Time] number Primary operation - Enters “Time” into

Time/Delay the command line
[Delay] number Toggle (2nd Press) enters “Delay” into

the command line
ACTION KEYS: (Keys that execute and terminate the command line)
Enter Enters the command line (Terminates the command line)
Record Records the parameters within the command line
(Terminates the command line)
Delete Deletes the parameters within the command line
(Terminates the command line)
QUICK VIEW KEYS: (Keys that enable quick access to

information displays)
Control/Devices Primary operation - Opens the Control

graph section of the info-view
Toggle (2nd Press) - Closes the Control

Graph section of the info-view
Push and hold – Opens the General

Devices section of the info-view
View/Camera [View] number Primary operation – Enters “View” into

the command line
[Camera] number Toggle (2nd Press) – Enters “Camera”

into the command line
Push and hold – Opens the Views

section of the info-view

Appendix
Preview Primary operation – sets the software

into preview mode. Preview mode is an
instant offline mode allowing cues to be
run in virtual mode without
moving any real axis. This is particularly
useful for programming and
production periods, also for 3D pre-
visualisation.
Preview mode has 2 user definable

options – firstly the axis positions are
corrected as a state is loaded such that
the axis is in the correct position to run
the current cue. Secondly, the real axis
positions are held. All real axis positions
are corrected once preview mode is
turned off.
A second press (toggle) on preview will

return the software to live mode.
Query Primary operation – Opens the Query

tab
Toggle (2nd Press) closes the Query tab
ARROW KEYS:
Up and down Cycle through the command line history, in order that the user may edit
and/or re-issue
Left and right: Acrobat∙G6: These keys move a cursor through the command line for
editing.
Nomad/Illusionist: These keys move a cursor through the command line
for editing in edit mode.
(Left and right arrows act as “Next” and “Last” (advance and
Retard through state list in “Show mode”.)
Next: Advances within the State list (permanent keys on Acrobat∙G6)
Last: Retards within the State list (permanent
OTHER KEYS:
Refresh Primary operation - refreshes changes

made to the database

Appendix
Undo/Redo Primary operation – UN-does the last

command
Push and hold – Re-does the previous Undo
Macro [Macro] number Primary operation – Enters “Macro” in the

command line
… (Shortcuts) Primary operation - Opens the shortcut

panel mimic screen
Push and hold – opens the shortcut editor
Tab Primary operation – Tabs selection to the

next available
Backspace Primary operation – deletes the previous

character from the command
line or numerical entry
Push and hold deletes the entire current

command line
+ [+]number Primary operation – Enters “+” into the

command line
[Thru] number Toggle – Enters “Thru” into the command

line
- [-]number Primary operation – Enters “-“into the

command line
[Rev] number Push and hold - enters “rev” (revolution for

rotary axis)
. (dot) [.] Primary operation – Enters “.” Into the

command line
[feet][inches][millimetres] Toggle – Enters “feet”, “Inches” or

“millimetres” into the command line,
following a numerical entry.

Appendix
5.2 Database Backups and Archiving
eChameleon allows for a high level of scheduled and immediate archiving and restoration of
databases. As part of the commissioning process a set of scheduled archive plans will be established,
such that there should always be a current database, the most recent archive and a selection of pre-
dated archives.
The user also has simple controls (through the eChameleon Launcher) to prompt immediate archives
and restorations.
eChameleon archives are accessed

via the safe icon within the launcher
The basic archiving options presented to the user will be determined by the system configuration.
I.e. On an Acrobat (with 2 machines) the “Send to other machine” button is present etc

Appendix
The Advanced Archive option will display the list of archived databases available for restoration or
deletion.
Archive name, timestamp

and description
Icon used to Install/rollback

to selected database archive Icon used to delete
selected database
NB When an archive is selected for installation, eChameleon will firstly create a new archive of the
currently used database!
eChameleon standard database archive hierarchy:
• Current DB (DB and Log currently in use)
• Latest DB (Latest archive contain DB and Log – this can be scheduled or user generated)
• General archives
An eChameleon archive is held as a .ecar file (compressed).
eChameleon holds its DBs in a folder named “eChameleonData” – this is always located at the root of
the C drive.
eChameleon also holds archives of Events and Telemetry and can be scheduled or forced in the same
way as the DB.

Appendix
5.3 eChameleon Settings
eChameleon settings are accessed

via the “settings” button within the
Launcher
The user may now access several pages of system settings.
NB: The majority of these settings are self discovery and in most cases will not need to be
changed
Display offers monitor selections and options
Network shows current network settings and options
Options display Desk and server options
System displays defualt languages/time settings etc.
Information displays current system, software versions and

has options for software update, rollback and Log off

Appendix
5.3.1 System Options
The general system options allow for:
• Database
o Database selection
o Database creation/deletion
o Update local DB on Boot
• Desk
o Desk type (Acrobat, Nomad, Illusionist, running on PC)
o Acrobat A/B machine and machine names
• Server
o Server available/not available
o Server name
• User interface options
o Use dual displays
o Swap User interface
o Low resolution mode
The Advanced system options allow for:
• UCIP address (Internal control surface network)

• Network simulation address (Used with standalone simulator)
• Automation subnet address
• Soft Control point ID (Used if no hardware control point ID is found)
• PLC Comms (On or Offline default)

Appendix
5.3.2 Display Settings
The display settings again are self discovery and allow the User to identify, swap or select differing
attached displays.
5.3.3 Network Settings
The eChameleon network settings are once again self discovery and present as several pages of IP
addressing for the Internal and external networks.
It is usual for each desk to have a fixed external network address.

Appendix
5.3.4 System Settings
The eChameleon System settings are basic system options for:
• Device or desk name

• System and keyboard Language
• Time and date – if a server is present, then these should be synched with the server to
ensure accurate logging and time stamping.

Appendix
5.3.5 System Information
• The system information displays the current versions of system and eChameleon software
and firmware
• The rollback and Update options relate to releases of eChameleon suite.
• Log off provides the route for system administrators to access the windows desktop.

Appendix
5.4 Creating a New Database
• Select the “settings” icon within the launcher.
• Select the “options” button
• Press the “Create new” button in the database section
• Input a name for the new db and press “OK”

• The new DB and associated file structure will now be created and once complete the DB
current selection will default to your new DB allowing immediate access through
eChameleon or eChameleon manager.

Appendix
5.5 Sculptor
5.5.1 Introduction to Functionality
Sculptor is the name given to Stage Technologies suite of multi-dimensional programming
tools and functionality.
Each tool within the Sculptor suite results as a “Sculptor action” at desk level. It is therefore
a simple key-press selection to recall any series of complex motion, created in any of the
following formats onto any (playback) start button within Stage Technologies Chameleon
software. Once the Sculptor action has been loaded onto a playback, then the motion
maybe immediately executed or recorded into a state (Cue) or action list for later use.
5.5.2 Teach and Learn
• Primarily plotted using a single high grade USB joystick. The joystick has X, Y, Z (+ and -)
outputs, allowing 3 dimensional motion from a single joystick.
• Teach and learn records an objects vectors spatially (i.e. records the profile of the object
within the playing area, rather than simply recording strings of positions over time for each
winch)
• The joystick maybe simply configured to allow individual axis control based on each output
axis of the joystick. I.E. the forwards/backwards motion of the joystick may control a single
or group of axis, whilst the left/right output may control a differing selection of axis.
(N.B. See application example pg4)
5.5.3 Visual Creator

• The latest version of Stage Technologies’ 2D/3D offline graphical editor. Visual Creator
provides the programmer with a 3D virtual environment, within which an objects path may
be programmed/edited by simple manipulation of points within the 3D space.
• Visual creator records each path as a series of maps (one for each winch)

Appendix
• An object profile/path can be created and viewed offline before applying to the real world
axis
5.5.4 Object Orientated Plotting

• Object orientated plotting allows a programmer to plot the resultant move of a complex
system, rather than attempting to plot each element as a separate entity. I.E. a ceiling hung
from 4 points could be told to pitch and roll to a specified angle, rather than having to
program the axes individually

Appendix
5.5.5 Single Axis Motion Profiling

o The ability to run a single axis motion profile, rather than a point to point or multi-
target move.
5.5.6 Animation Importer

o Stage Technologies animation importation tool allows the output of winch co-
ordinates and parameters from real time renderings of 3D graphics built within 3D
Max animation packages.
o Stage Technologies have created a bolt on tool set for 3D max that allows the
animator to line up axis parameters with the real world axis and thus limit any
animation only to motion that can, in reality, be achieved. Any motion that is
created can then be output directly to Stage Technologies control software as a pre-
checked and approved sculptor path.

Appendix
5.5.7 Application Example:

A complex motion path may be programmed directly into the STL control desk using a
“teach and learn” joystick and the path may be quickly corrected if the winch positions
should change.
USB Joystick STL control desk Au Tour Control rack Winches
• The joystick axis are simply configured through the software interface to provide the most
intuitive user input.
In the case of a multi-axis object (i.e. 4 way bridal), the axis must be defined as a safe group and the
bridal geometry must be assigned – this is a once only procedure and should take only a few
minutes.
• Secondly, the winch rigging positions must be set; these are the physical positions of the
final divert for each winch. The positions are relative to any useful datum (usually X 0, Y 0, Z
0).

Appendix
• It is usual for the virtual world zero datum to be at the lowest point (i.e. deck level) in the
centre of the playing area, however for speed this can be allocated at any useful datum, for
example at the base of a divert tower.
• Finally, the winches require an offset to be input into the software – the offset is the
distance from their final pulley to the datum 0, 0, 0.
• The joystick may now be used to fly and record and path within the space.
• N.B. The software will generate safe borders of travel, based upon the inputted geometry
and will utilise all the standard axis limitations (soft limits, max speeds etc.) to ensure that
each move remains within safe parameters.
• Once a flight has been recorded it appears within the standard desk software as a Sculptor
action and maybe queried or actioned using a simple command string.
i.e. “Scupltor Action 1 enter” : will load the action onto a playback for immediate playback.
• If the geometry of the playing space should change then it is simply a case of adjusting the
winch rigging positions, as before, to match the changes.
• It is not necessary to re-record the motion path, as the path has been recorded spatially and
references the object vectors rather than the individual winch line lengths. Therefore, the
path will always remain the same no matter what happens to the rigging positions.
• The path can naturally be re-recorded and stored as often as necessary if it should transpire
that differing paths are required for differing venues.

Appendix
5.6 Further Setup

5.6.1 Windows Embedded
eChameleon is designed to be accessed solely through the eChameleon launcher however System
commissioning engineers and system administrators may access the windows desktop via a
password protected log in.
To access windows:
- Settings (Launcher icon)

- System information
- Administrator Log in (password supplied by STL)
To leave windows:
- Log off Administrator (standard windows operation)

- Log in to Operator (User)
NB: This may take a few seconds and will re-start the eChameleon Launcher.

Appendix
5.6.2 Example eChameleon Settings.xml

The eChameleon data folder holds an XML called eChameleon settings.
In normal cases this file need not be edited as it is written to from the eChameleon settings options
within the launcher (as above)
It is however worth understanding what it contains:
i.e.
<LocalSettings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<DeskType>Acrobat</DeskType>
<RunningOnPC>true</RunningOnPC> This should be False if running on a desk and
also False if running on a pc and using a USB wing.
<IsSecondMachine>false</IsSecondMachine> Only applicable to Acrobats
<AssociateAcrobatMachineName /> A or B machine
<ServerName>RENTALSERVER1</ServerName>
<SoftControlPointID>3</SoftControlPointID> Should be a unique number within the
system
<IsStandalone>true</IsStandalone>
<LastShowID>1</LastShowID>
<LastUserID>1</LastUserID>
<LastRoleID>1</LastRoleID>
<DefaultOffline>true</DefaultOffline>
<LogTelemetry>true</LogTelemetry>
<RefreshEventInterval>0</RefreshEventInterval>
<UICPNodeAddress>192.168.255.71</UICPNodeAddress> Internal comms
<AutomationSubnet>192.168.1.0</AutomationSubnet> External comms
<NetworkSimulation>false</NetworkSimulation> applicable only when using a separate net sim.
<SimulationIPAddress>192.168.1.1</SimulationIPAddress>
<Is24HourClock>true</Is24HourClock>
<SynchroniseWithTimeServer>false</SynchroniseWithTimeServer>
<LowResolution>false</LowResolution>
<FontSize>10</FontSize>
<KeyboardLanguage>en-GB</KeyboardLanguage>
<SystemLanguage>en-GB</SystemLanguage>
<NomadKeyboardBrightness>20</NomadKeyboardBrightness>
<UpdateLocalOnBoot>false</UpdateLocalOnBoot> Option to sync local DB with current
system DB on boot of eCham
<LoadMonitorOnSecondScreen>false</LoadMonitorOnSecondScreen>
<ReadOnlyMode>false</ReadOnlyMode>
<AutoLogin>false</AutoLogin>
<JobCode>PINK2010</JobCode> sets current DB folder
<UseSecondScreen>false</UseSecondScreen>
<SwapScreens>false</SwapScreens>
</LocalSettings>

Appendix
5.6.3 eChameleon File Structure

eChameleon holds its data folders within the “eChameleonData” folder C:\eChameleonData\job
name
The job name folder will always contain folders for:
• LocalDB (or system db i.e. server)
• EventsDB
• TelemetryDB
Each of these folders will contain the current DB and archives as above.
The eChameleon application files are stored at C:\Program Files\Stage Technologies\eChameleon
This location also contains content and axis folders for .iv graphic files used by Visual Creator.

Glossary
6 Glossary of Terms
• Action – a pre-recorded set of instructions for moving axes from one position to another. An
action, unlike a state, does not include playback information. An action contains instructions
only for a single playback and can be loaded onto any playback for execution.
• Automation - The technique of making an apparatus, a process, or a system operates

automatically by mechanical or electronic devices, replacing human labour.
• Axis – the general term used to refer to a motor and all of its associated hardware: Drive
Motor Winch, but could refer to any individual axis of motion.
• Commission – the act of setting up a control system for a customer and ensuring that all of
the components perform properly.
• Control Graph – a contextual representation of the axes under control. Includes: controlled
the axes, what playback they are loaded on, how they are loaded (as a group, or
individually), and the motion parameters for each axis.
• Counterweight system - Method of flying scenery that uses a cradle containing weights to
counterbalance the weight of the scenery being moved.
• Closed loop - Refers to a system which has reference sensors that provide constant feedback
to enable machinery etc. to automatically adjust and maintain performance (see also ‘Open
loop’).
• Commissioning - The process undertaken by a manufacturer to get automation equipment

operational in a venue’s specific environment. (This term is also sometimes used to refer to
‘acceptance testing’.)
• Control desk/control console - A piece of automation equipment which sends control signals
to the automation system and allows the operator to view system information.
• Cue – a change of state as called by the stage manager. See also “State”.
• Dead (also marks or trims (US)) - A designated height for a piece of scenery or bar; a label or
marker for a physical position or target. Manual flymen use a Dead on a rope as an
indication of the position of a scenic piece i.e. all the way in (in view) or out (out of view) or
at a mid point. For manual operation, this mark would traditionally be a cotton tape wound
through the strands of the rope but this has been replaced more recently with PVC tape or
similar. Automation operators label Deads with a number and/or colour system such as
‘Dead 1’.
• Deadman’s Handle – see DMH.
• Devices – in the context of this manual and the eChameleon software, a device is a
monitored input. The specific devices that are monitored via these inputs are site specific.
Any monitored input has only two states, normal and abnormal. When configured, device
status can be observed from the Query-View and / or the mini devices view.

Glossary
• DMH – Dead Man’s Handle – an integral safety switch which is a part of every Stage
Technologies control desk. In order to move an axis, the dead-man’s handle must be
pressed and held for the duration of the move.
• E-Belt – the speed control portion of a playback on Stage Technologies control desks.
• Encoder - A device which converts information from one format into another.
• Ethernet - Ethernet is the most widely-installed local area network (LAN) technology.
Ethernet was named by Robert Metcalfe, one of its developers, after the passive substance
called "luminiferous ether" that was once thought to pervade the universe, illustrating the
way that Ethernet cabling, also a passive medium, could similarly carry data everywhere
throughout the network.
• E-Stop – Emergency Stop – an electro-mechanical switch which when engaged cuts power to
the drives and brings all axes to a controlled but expedient stop E Stops are generally
“Global” (i.e. stop all motion within the system) although in some instances they can be
“local” (i.e. stop only axis relevant to their location)
• Flying bar (flybar, Barrel, Pipe) - The metal bars to which scenery and lanterns are attached
for flying above the stage.
• Flyman (flyperson) - The operator of the theatre's flying system.
• Flytower (also flys or fly loft (US)) - Upward extension of the stage walls to allow scenery to
be flown up until it is out of sight of the audience; it is also a structural support for the grid.
The ideal flytower should be more than twice the height of the proscenium arch, when it is
said to have 'full flying height'. The load on the grid is transferred to the ground via the walls
of the theatre.
• Free groups - Axes that move simultaneously but with each axis maintaining independence
from the others (see also ‘Locked groups’ and ‘Safe groups’).
• Gearbox - The metal casing enclosing a set of gears (in a motor).
• Grid - The support structure located near to the top of the flytower on which the pulleys of a
flying system are supported. The grid is usually constructed from metal or wooden beams.
Grid is short for ‘gridiron’.
• Group – a show specific collection of axes which can be loaded and programmed as a unit.
There are various types of groups ranging from simple plotting groups (Free Groups) with no
interdependence, to Safe groups (if one member see an error, then all members of the
group will stop and locked groups that map relative positions as slaves against a master.
• Hydraulic - Of, involving, moved by, or operated by a fluid, especially water, under pressure.
• Kabuki drop - a technique for dropping a drape or other lightweight fabric in a quick, single
motion from the ceiling to reveal the stage or performers. The system consists of a bar that
attaches to a standard flying bar and is able to spin around. The bar has prongs welded to it

Glossary
on which the curtain is hung. On cue, the pole is rotated so that the prongs point
downwards and the curtain consequently falls.
• I/O – the abbreviation for Input / Output. The non axis specific inputs are called General
Inputs and can be monitored via the Devices portion of the QueryView. See also Devices.
• Limits – all axes have at least two types of limits: software limits and hardware limits.
Software limits are set by the operator and / or commissioning engineer via the eChameleon
software. No axis will be allowed to go past a software limit when under program control.
Hardware limits are mechanical devices which are activated by the rotation of the motor or
winch drum. These are set to protect the hardware. In most cases two sets of limits are
used at each end of travel (initial and Ultimate). It is often the case that the Ultimate
(Overtravel) is set to protect the mechanics of the system and the initial set to protect the
object moved by the system, although this will depend upon the application.
• Locked groups - Axes that move simultaneously and are linked together to maintain their
relative position (see also ‘Free groups’ and ‘Safe groups’).
• Macro – a low level sequence of commands designed to perform a specific function. Macros
are site specific and are generally created by the commissioning engineer.
• Mutually-exclusive - Said of a multi-user operating system in which a safety feature prevents

the same axis from being accessed by more than one control desk at a time.
• Open loop - Refers to a system that does not have the capacity for feedback, meaning that
errors have to be manually corrected (see also ‘Closed loop’).
• Pneumatic - Of, involving, moved by, or operated by compressed air.
• Point hoist - A simple winch that provides a single suspension point that can be deployed at
any position in a grid.
• Playback – in order to move any axis, it must be loaded onto one of the control desk’s
playbacks. The playback is comprised of the following components:
• Rack and pinion - A device for the conversion of rotary and linear motion, consisting of a
pinion and a corresponding rack.
• Ram - The plunger or piston of a force pump or hydraulic press.
• Safe edge - (Astragal) A rubber rim that is used around the edge of a lift, to stop the lift in
case of an emergency, thereby protecting limbs that could get trapped.
• Safe groups - Axes that are linked to a single piece of scenery but may have differing speeds
or paths (see also ‘Free groups’ and ‘Locked groups’).
• Sprocket - A tooth like projection arranged on a wheel rim to engage the links of a chain.
• State - In automation terms, a pre-recorded action (also see ‘Cue).
• System server - A computer that provides central data storage facilities.

Glossary
• Safe On Demand – a function which allows the operator to temporarily treat the axes loaded
on a single playback as a Safe group.
• State – a pre-recorded set of instructions for moving one or more axes to a different
position. A state may be functionally equivalent to a called cue but very often is made up of
more than one called cue. A state, unlike an action, contains instructions that are specific to
the playbacks on which they were recorded.
• Torque - A turning or twisting force.
• Travelator - A motorised, horizontally-moving belt at stage level, the direction and speed of
which can be controlled. Travelators are used for moving scenery or actors onstage or
offstage.
• Trim – An American term meaning a pre-defined target position. See also Dead.
• User units – a term for the measurement units employed on a particular system . I.e. mm,
feet, second, minutes etc.
• VCA – Visual Creator Action – contains the definitional elements (resources) required to
move an object along a path, map, or profile.
• Visual Creator – an add-on package which allows the operator to easily define two and three
dimensional moves for an object being controlled by two or more axes.
• Visual Creator Action – see VCA

Index
7 Index
3D Display, 66 Grids, 64, 65, 66
Accel and Decel, 31, 32, 33 Groups, 13, 25, 36, 38, 43, 58, 69, 71, 118
Action, 13, 36, 45, 72, 77, 80, 96, 117, 120 History, 59
ACTION KEYS, 98 Information circles, 49
Archives, 18, 19 Information strip, 49
ARROW KEYS, 99 Joystick mode, 21, 88, 96
Button functions, 17 Keypad, 16
Command history, 55 Local, i
Control Graph, 14, 60, 98, 117 Locked, 25, 26, 71, 96, 118, 119
Control point, 73, 104 Locked Group, 25, 26
Control points, 14, 19, 69, 73 Locked on Demand, 26, 96
current network settings, 103 Login, 47
Database, 11, 101, 104, 108 Macro, 14, 62, 69, 73, 78, 96, 100, 119
Dead, 17, 29, 34, 37, 62, 70, 88, 97, 117, 118, Macros, 14, 45, 46, 62, 69, 73, 78, 119
120
Maintenance, 58
Default Cameras, 67
Manager, 18, 19, 32, 58, 70, 71
delay, 30, 33, 62
Menu, 50, 54
Delay, 33, 62, 98
Monitor, 18, 19, 57
Devices, 49, 58, 59, 60, 98, 117, 119
Move, 21, 29, 31, 33, 35, 62, 72, 97
Dynamic Grids, 63
Network, 11, 19, 103, 104, 105
Edit Mode, 52
Nodes, 11, 19, 58
Error stack, 57
Offline, 42, 49, 104
Exit, 53
On screen keyboard, 55
Flash Dynamic Grid Errors, 51
Online, 49
Free Group, 25
Orthographic, 67
Freeze, 69, 72

Index
PARAMETER KEYS, 97 Settings, 19
Perspective, 67 Shortcut, 18, 35
playback flashing, 52 Shortcuts, 18, 45, 46, 76, 100
Playback Mode toggle, 52 Show Last Command, 51
Playback Stealing, 23, 80 Show Sculptor Borders, 51
Powering up, 15 Soft desk, 49
preview, 42, 53, 99 Soft Desk, 49, 52
Preview, 42, 53, 99 software versions, 103
Query, 51, 54, 59, 60, 69, 70, 71, 72, 73, 93, Speed, 21, 30, 31, 33, 37, 62, 88, 97
99, 117
Speed mode, 21, 88
Query as you type, 51, 54
State, 14, 36, 38, 39, 41, 42, 50, 51, 53, 57, 72,
Query Home, 69 79, 88, 96, 99, 117, 119, 120
Query Tab, 69 State List, 72
QUICK VIEW KEYS, 98 State notes, 57
Ramps, 32, 33 system options, 104, 106
Redo, 42, 94, 100 Target, 29, 30, 33, 34, 35, 88, 97
Refresh, 43, 99 Time, 30, 31, 33, 62, 97, 98, 106
Repeat, 35, 62 Tracking, 41, 79
Resources, 80 Triggers, 37
Reverse, 22 Undo, 42, 94, 100
Role, 47, 49, 51, 72, 73, 88, 96 Visual Creator, 120
Safe Group, 25, 26
Safe on Demand, 26, 96
server, 11, 47, 49, 103, 106, 116, 119

Echameleon Manual V8-3

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Echameleon Manual V8-3

Caricato da

Copyright:

Formati disponibili

eChameleon Suite

Revision 0.8 August 2010

eChameleon Suite Reference Manual Revision 0.7 i.

eChameleon Suite Reference Manual Revision 0.7 ii.

2.5.3 Speed and Time ............................................................................................................... 30

eChameleon Suite Reference Manual Revision 0.7 iii.

3.7 Display Tab ............................................................................................................................ 61

eChameleon Suite Reference Manual Revision 0.7 iv.

4.8 Record, Delete and Enter Commands ................................................................................... 87

eChameleon Suite Reference Manual Revision 0.7 v.

1.1 The Manual

Command line examples:

[Target number Dead number Text “IN Dead” Record]

eChameleon Suite Reference Manual Revision 0.7 Page 6

1.2 eChameleon Features Overview

• Control of unlimited axes of automation

• Direct joystick (manual) control of individual or multiple axes

• Record free or safe groups of axes

• Record an unlimited number of states (cues) in any show

eChameleon Suite Reference Manual Revision 0.7 Page 7

• Roles to partition states between multiple consoles

• Instant preview for blind programming and simulation

• Freeze axes for maintenance lock-out

• Available in multiple languages

eChameleon Suite Reference Manual Revision 0.7 Page 8

1.3 System Overview

Control Server (optional)

eChameleon Suite Reference Manual Revision 0.7 Page 9

1.3.1 Control Desks

Stage Technologies Control desk range includes:

eChameleon Suite Reference Manual Revision 0.7 Page 10

Network options are:

• Safe: allows for safe groups across nodes

eChameleon Suite Reference Manual Revision 0.7 Page 11

• Sync: allows for locked groups across nodes

1.3.6 Control racks

1.3.7 Mechanics and power transmission

eChameleon Suite Reference Manual Revision 0.7 Page 12

1.4.2 Playback (PB)

Each playback is colour coded, for selection and recognition.

eChameleon Suite Reference Manual Revision 0.7 Page 13

Actions may be called to any of the shortcuts for immediate execution.

1.4.8 Control points

1.4.9 Control Graph

eChameleon Suite Reference Manual Revision 0.7 Page 14

1.5 The Control Desk

eChameleon Suite Reference Manual Revision 0.7 Page 15

NB: For a detailed description of eChameleon keypad functionality please refer to

• Resource keys – The object to be addressed such as axis, group etc

Primary Parameter Command Line

Push and Hold

eChameleon Suite Reference Manual Revision 0.7 Page 16

1.5.3 Button functions

The bottom text on each button represents the result of a Primary

In some cases the button may have 2 or 3 toggle functions. These

1.5.5 Dead Man’s Handle

eChameleon Suite Reference Manual Revision 0.7 Page 17

1.5.6 Shortcut Panel

NB: See Shortcuts below

1.5.7 eChameleon Launcher

eChameleon eChameleon eChameleon

eChameleon Suite Reference Manual Revision 0.7 Page 18

eChameleon Suite Reference Manual Revision 0.7 Page 19