Documentation
  • VYV Documentation
  • ❗What's New in V11
    • What's New in V11.3?
    • PHOTON - V11.1 Release Note
    • XENON - V11.1 Release Note
    • TACHYON - V11.1 Release Note
  • 📍Get To Know PHOTON
    • Get Started - A Quick Start Guide
    • UI Basics
    • PHOTON Shortcuts
  • User Guide
    • 1. Prerequisites
      • 1. Before Starting PHOTON
      • 2. Fundamentals of PHOTON and its User Interface
    • 2. Setting-Up a Show
      • 1. Settings
      • 2. 3D Scene
        • Hierarchy Rendering
    • 3. Importing Content
      • 1. File Manager
      • 2. Imports
      • 3. Conversions
      • 4. Files Management and Display
      • 5. Playlists
      • 6. File Versioning
    • 4. Programming a Show
      • 1. Cue Editor
      • 2. Timeline
      • 3. Shared Clip Properties
      • 4. Color Correction
  • Modules Overview
    • Settings
    • 3D Scene
    • Timeline
    • Keyframe Editor
    • Color Correction
    • Preview
    • File Manager
    • FX Graph
    • I/O Manager
    • Cue Editor
    • Mapping Manager
    • Network Monitor
    • Output Control
    • Timecode
    • Rendering
    • Shadow
  • Step-by-Step Tutorials
    • Navigation & UI
      • Drag and Drop in PHOTON
      • Find in...
      • Frame and Reset View in PHOTON
    • ALBION
      • ALBION & Lighting consoles integration (guide)
        • PHOTON | grandMA Project Link
          • 1. Create and Define the ALBION Preset Type and its Attributes in the grandMA
          • 2. DMX Universes Merge
          • 3. Export Fixture Types and GrandMA Patch
          • 4. Import Fixture Type and grandMA Patch into PHOTON
          • 5. Light Fixture Calibration
          • 6. Interactive Lighting Fixture Control
          • 7. ALBION Attributes Descriptions
      • ALBION & Lighting consoles integration (video)
    • Programming
      • Create Regions and Jump Between them with a Cue
    • 3D Scene
      • Projection Study Guide
      • Camera Calibration Based on 3D Plane
      • Make a Fly Through of the 3D Scene
      • Automatic Calibration and Real Time Alignment Guide
      • Primitives Tracking
      • Create a 3D Animation Curve
    • File Managment
      • File Manager: Playlists
      • File Manger: Manage Files
      • File Manager: Display Files
      • File Manager: Import and Convert
      • File Manager: Advanced Topics
      • Audio Multichannel Export
      • Export Multichannel Audio from DaVinci Resolve
    • I/O
      • Midi
        • Map a MIDI Slider in Photon
      • Projector Control
        • Control Projectors with Cues
      • Network Messages & External Control
        • Connect PHOTON and QLab Through UDP
        • External TCP/UDP Control Specifications
    • FX
      • Notch Integration
      • Use A Graph Asset to Create a FX
      • Controlling an addressable LED strip using the Art-Net Mapping node
      • Interactive Floor with One OptiTrack Camera
    • Rendering
      • 2D Video Rendering
      • 3D Video Rendering
    • Timecode
      • Use Timecode in PHOTON
    • Legacy
      • Updating a System’s Baseline
      • External TCP/UDP Control Specifications (legacy)
  • Older versions
    • What’s New in PXTAC 10.5 ?
    • What's New in PHOTON 10.5
    • Download Documentation - Version 1.2, Product version 9
    • V8.1 Release Note
    • V7.9 Release Note
Powered by GitBook
On this page
  • 1.1 Cue Editor View Modes
  • 1.1.1 Open the Cue Editor
  • 1.1.2 Toggle Full View or List View
  • 1.2 Cue Recording
  • 1.2.1 Create a New Cue
  • 1.2.2 Record Actions in a Cue
  • 1.3 Editing the Cue Actions List
  • 1.3.1 Reorder Actions in a Cue
  • 1.3.2 Delete, Duplicate or Rename Actions in a Cue
  • 1.4 Modifying Cues
  • 1.4.1 Delay
  • 1.4.2 Offset and Multiple Delays
  • 1.4.3 Timing
  • 1.4.4 Target Values
  • 1.4.5 Easing
  • 1.5 Rename, Duplicate or Delete Cues from the Cue List
  • 1.5.1 Rename a Cue
  • 1.5.2 Duplicate a Cue
  • 1.5.3 Delete a Cue
  • 1.6 Nested Cues
  • 1.6.1 Nesting a Cue
  • 1.7 Cue Playlists
  • 1.7.1 Create a Cue Playlist
  • 1.7.2 Add a Cue to a Cue Playlist
  • 1.7.3 Remove a Cue from a Cue Playlist
  • 1.8 Triggering a Cue
  • 1.8.1 Manual Trigger
  • 1.8.2 Timeline Trigger
  • 1.8.3 Midi Trigger
  • 1.8.4 UDP Trigger

Was this helpful?

  1. User Guide
  2. 4. Programming a Show

1. Cue Editor

Previous4. Programming a ShowNext2. Timeline

Last updated 5 years ago

Was this helpful?

The Cue Editor module facilitates the creation of cues.

Cues are pre-recorded series of actions and parameter modifications set in a specific order of execution. This sequence of actions can be affected by variables such as delays, timings and target values. In other words, any parameter, slider, toggle, or dropdown menu found in PHOTON’s UI can be affected by a cue.

Cues can be recalled in various ways and function like programmable macros found in other types of systems (). Cues can even execute complex technical procedures such as seamless live backup switching.

Since cues are recalled states of parameters, no change will occur in the software if the targeted parameters are already set at the state specified in the cue. For example, if a pre-programmed cue containing an event that would set the Master Contrast slider to the value of 100 is triggered while the Master Contrast slider is already at 100, nothing will happen.

Since cues can recall parameter changes, it might be tempting to use them to create animations. Do not do this. Cues are not the proper tool to create animations through interpolations between values. They should only be used to push predefined states during the linear unraveling of a show. If you wish to create animations please refer to the Keyframe Editor module (see Section 8 Keyframe Editor in Chapter 4 Programming a Show).

1.1 Cue Editor View Modes

1.1.1 Open the Cue Editor

  • Open the Cue Editor by selecting {Show > Cue Editor} or by pressing [Alt+Q].

If the Cue Editor appears as a small column, it is set in View List mode, which is the small-scale representation of cues designed for operation. The View List mode is meant to show pre-programmed cues that are to be recalled. It is not used for creating new cues.

If you wish to create new cues, you will need to switch the module to View Full mode.

1.1.2 Toggle Full View or List View

  • To expand or reduce the Cue Editor select {View > View Full} or {View > View List} or press [V] on the keyboard to toggle between the two view modes.

In View Full mode, the module’s window will expand to the right in order to reveal the Edit cue window section. This is where you can adjust all the timings, delays, actions order, etc. for newly recorded cues. At the bottom right of the module’s window you will find the Progress view window section, which is where you will be able to follow the progress of cues being executed.

1.2 Cue Recording

1.2.1 Create a New Cue

  • To create a new cue, press the [+] button at the bottom left part of the module. The new cue will appear at the bottom of the Cue list.

1.2.2 Record Actions in a Cue

  • To record actions in a new cue, press the [Record] button at the top right of the Edit Cue window section.

If the Cue Recording mode is activated, the entire UI will turn red and you will see the words “Cue Recording” at the bottom right of the screen.

  • Press on the [Record] button again to stop cue recording.

1.3 Editing the Cue Actions List

Once you have recorded all of the actions needed for a new cue, you can edit the cue’s Actions list.

Actions within a cue can be reordered by dragging and dropping their names in the list.

1.3.1 Reorder Actions in a Cue

Actions can also be reordered by clicking on the [Delay] button at the top of the Delays column in the Edit Cue window section. A sort will be performed on the Actions list to arrange them based on their delay time (from the lowest delay time to highest).

1.3.2 Delete, Duplicate or Rename Actions in a Cue

  • Right-click on the name of any action within a cue to open a contextual menu to delete, duplicate or rename the action.

You don’t have to be in Cue Recording mode to edit a cue.

1.4 Modifying Cues

There are 5 parameters that can be used to modify cues: Delay, Offset and Multiple Delays, Timing, Target Values and Easing.

1.4.1 Delay

Delays are absolute time values that can be understood as a “wait time” before an action is executed.

To delay the execution of an action, use the Delay slider beside it to set a time. You can also double-click on the Delay slider and enter a specific duration in a text field.

Keep in mind that even if the actions inside the cue are organized as a sequence, individual delay times for actions are not cumulative. For example, Action #1 has a delay time of 4 seconds and Action #2 has a delay time of 2 seconds. Even if Action #1 is the first in the list, it will be executed after Action #2 since its delay time is higher. In this example, Action #2’s delay time is definitely 2 seconds not a cumulative 6 seconds.

1.4.2 Offset and Multiple Delays

The time slider and the [Apply Offset] button at the top of the Actions list allow you to automatically offset the delay value for all of the actions selected for a cue. Follow these steps to apply an offset to multiple actions:

  1. set a value in the time slider;

  2. select the actions you want to be affected by the offset by pressing [Shift+right-click] on the first and the last actions that you want in the list, or press [Ctrl+right-click] to select actions that aren’t listed consecutively;

  3. press the [Apply Offset] button.

All the selected actions will be offset by the value set in the time slider from top to bottom.

1.4.3 Timing

Parameter changes can be interpolated over time. Timings are values that will determine how much time the change will take. Some actions, like a true/false toggle, will not allow the use of timings because they are restricted to parameters linked to sliders.

  • To set a timing for an action, use the time slider beside it to set a time. You can also double-click on the time slider and enter a specific time in a text field.

1.4.4 Target Values

When created, some actions specify a target value to be reached on the execution of the cue. You can change this value after the cue has been recorded if you want to make adjustments.

  • To change the target value of a specific action click on the Target Value cells that you want to modify.

Depending on the type of data represented, you might have access to a simple toggle or a slider. For a slider, double-clicking on the Target Value cell will open a text field where you will be able to enter the desired value using your keyboard.

1.4.5 Easing

Interpolation created through the use of the timing variable is expressed in a linear way. Under certain circumstances (to smooth a transition, create an expressive transformation, etc.), it might be appropriate to ease in and out of the linear progression from the initial value to the target value.

  • To ease in or ease out of an action, click and drag the Ease in or Ease out sliders to select a value, or double-click on the sliders to set values through a text field.

1.5 Rename, Duplicate or Delete Cues from the Cue List

Cues can be renamed, duplicated or deleted from the Cue list.

1.5.1 Rename a Cue

  • Right-Click on the cue to open a contextual menu from which you will select {Rename}.

1.5.2 Duplicate a Cue

  • Right-Click on the cue to open a contextual menu from which you will select {Duplicate}.

1.5.3 Delete a Cue

  • Right-Click on the cue to open a contextual menu from which you will select {Delete}.

  • You can also delete the cue by selecting it and pressing [delete] on your keyboard.

1.6 Nested Cues

Nesting allows the incorporation of autonomous structures into other structures. For example, video editing software facilitates the integration of pre-edited sequences into other sequences.

PHOTON allows the nesting of cues into other cues. This means that cues, which are already sequences of actions, can in turn be placed and recalled within larger sequences. This makes it possible to construct complex cues that trigger multiple actions and, with a combined use of delays, the automation of tedious tasks and interventions.

1.6.1 Nesting a Cue

  • To nest a cue within a cue, recall the cue you want to nest while Cue Recording is enabled for the “meta-cue.”

A safety mechanism is in place to prevent the creation of infinite loops in nested cues.

1.7 Cue Playlists

The Cue Editor facilitates the creation of Cue playlists, which are specially arranged collections of cues that make programming a show much easier.

1.7.1 Create a Cue Playlist

  • Press the [+] button in the top left part of the Cue Editor to create a Cue playlist.

1.7.2 Add a Cue to a Cue Playlist

  • Drag and drop the cue from the bottom left to the top left in the desired playlist.

1.7.3 Remove a Cue from a Cue Playlist

  • Right-click on the cue to open a contextual menu from which you will select {Remove}.

1.8 Triggering a Cue

Cues can be triggered using the following methods:

1.8.1 Manual Trigger

  • Click on the [GO] button next to a cue in the Cue playlist.

1.8.2 Timeline Trigger

1.8.3 Midi Trigger

  • Create a mapping between the [GO] button in front of the cue and a button located on a midi board by using the Mapping Manager module. The cue can then be recalled through interaction with the external MIDI device.

1.8.4 UDP Trigger

  • Use the Project’s Show Control port found in {Settings > Network} to send a UDP command from a third-party software.

The top part of the of the left column shows Cue playlists (), while the bottom part shows the available pre-programmed cues organized into the Cue list. The search field located at the top of the column lets you filter the list of cues by entering characters.

If the Cue Recording mode is activated, every time you click on a slider, toggle, list, parameter, etc., they will appear as actions in the Edit Cue window section ().

Create a Cue Clip type on the Timeline () and assign the desired cue to it. As soon as the playhead intersects with the clip, the cue will be triggered.

see Section 1.7 Cue Playlists in Chapter 4 Programming a Show
see Section 1.1 Cue Editor View Modes in Chapter 4 Programming a Show
see Section 1.8 Triggering a Cue in Chapter 4 Programming a Show1. Cue Editor
see Section 2.2 Clip Type in Chapter 4 Programming a Show