Skip to content
Disguise User Guide

StringProjectorControl Device

The StringProjectorControl Device is intended for controlling external devices while optionally simulating their behaviour inside the visualiser.The is intended for controlling external devices while optionally simulating their behaviour inside the visualiser.

Overview

Projector control can be simulated as well as output to real projectors. The intention is to be able to recall presets for the projectors that contain pan/tilt, zoom, focus, lens shift, intensity and projector configuration objects (for recalling different calibration states).

Configure the StringProjectorControl Device

Device setup

  1. Create a StringProjectorControl Device.
  2. Associate the device with a projector.
  3. Create a control device if using the string control version.
  4. Assign the simulation configuration to the selected projector config.
  5. Create presets either via the ProjectorControl Editor or the layer preset editor. The former is the preferred workflow, as it allows for multi-edit.

Timeline keyframing

  1. Create a projector control layer.
  2. Create a mapping (group of projectors to control).
  3. Create presets for the projectors to recall as the timeline plays.

Configure the device

  1. Define which projector is controlled by the device.
  2. Choose whether simulation configuration is enabled or disabled. This controls whether the projector will move in the stage or not.
    • In the case of the StringProjectorControl device, define a control device and create a corresponding serial, telnet or UDP device to send the data out of Designer.
  3. Configure any Default, Startup and Shutdown commands, as appropriate.

Configure presets

ProjectorControlPresets can be created either through the ProjectorControl layer or through the StringProjectorControl Device Editor. Performing this functionality through the editor is a better choice as this editor fully supports multi-edit functionality, as well as converting hard values to presets for more time saving functionality.

  1. Open the StringProjectorControl Device Editor from the Device manager.
  2. Select each projector and apply the desired values. Either individually or by using the multi-edit functionality.
  3. Select multiple rows and use the Convert Selected Rows to Preset function, to store the contents of the selected rows into a preset that can be recalled later. For example - Home position, Position 1, Position 2 and so on. Projector control presets

Control the projector

See ProjectorControl layer for more information.

Properties

Projector

  • The virtual projector object in the visualiser

Values

  • Pan/Tilt, Focus, Zoom, Lens Shift (V/H), Intensity: the current values being sent to the external device. Modifying these values will cause the device to send out commands to the external device.

Simulation

  • Simulation configuration - the projector configuration that the device modifies to simulate the behaviour of the external device. Always use a dedicated projector configuration for this as its settings will be overwritten by the simulation

  • Home rotation- the starting rotation when the device’s pan/tilt are at zero

  • Rotation speed - the animation speed of rotation between different pan/tilt values

  • Pan axis the axis controlled by the pan value

  • Tilt axis the axis controlled by the tilt value

Default recall

  • Recall -the default order of the commands sent to the device. This allows delays between starting the pan/tilt, focus, zoom and other actions.

For example, you may want to delay intensity moves for a set period of time to allow zoom, focus and position to be set before the projector is visible. The delay value is expressed in seconds.

The editor is capable of multi-edit functionality, so does not behave in the same way as a normal editor. See multi-edit for more information. Projector control recall preset

Device

  • Control device the network device (Serial, Telnet, UDP) that commands are sent over

Commands

  • Default commands - String commands sent to the network device before any specific actions’ DMX commands

  • Startup commands - String commands sent to the network device when the projector control device is started or added from the device manager

  • Shutdown commands -String commands sent to the network device when the projector control device is stopped or removed from the device manager

Common properties

Control strings for each of these projector control actions can be created. The range will be used to scale the current value before exposing it as a binary (%) or decimal ($) number.

Zoom

Focus

Lens Shift

Intensity