Table of Contents > Cues
QLab Documentation
This page last modified: 21 Apr 2010 01:09:01 PM.

Cues

Cues are the fundamental building block of QLab. Each kind of cue performs a different kind of action. For example, an Audio Cue will play an audio file, a Pause Cue will pause other cues, and a MIDI Cue will send a MIDI message.
You can copy and paste cues within a workspace, or between different workspaces. You can also drag and drop cues or entire cue lists between two workspaces.
When you copy a cue, QLab also stores a basic text summary of the cue on the clipboard. This means you can paste basic information about the cue directly into spreadsheets or text documents.
Several basic properties are shared by most cues. These include the following:
Number
The number you assign to a cue may be any unique string, or may be empty. Examples of valid cue numbers include: "1", "100", "10.5", "A", "BB", and "My long, drawn-out cue number". Cue Numbers are always unique in a workspace.
Name
The name you assign to a cue may be any string, or may be empty.
Target
The target of a cue, if it exists, describes what resource the cue acts upon. (A target may be a file or another cue.)
Target Number
The target number of a cue, if it exists, is the number of the targeted cue.
Pre Wait
The pre wait of a cue determines how long the playback of the cue sequence is blocked before the cue is fired.
Action Duration
The action duration of a cue describes how long it takes for the cue to complete. Some cues are instantaneous, and so do not display a duration.
Post Wait
The post wait of a cue determines how long the playback of the cue sequence is blocked after a cue is fired.
Continue Mode
The continue mode of a cue determines if playback continues automatically after a cue is fired and the post wait is complete. The continue mode is described in detail here.
Firing a cue generally causes four things to happen, in this order:
  1. If a pre wait duration is specified for the cue, the pre wait is performed.
  2. The action of the cue is begun. (e.g. sound begins to play, another cue is given the "start" command, etc.)
  3. If a post wait duration is specified for the cue, the post wait is performed.
  4. If the cue is set to auto-continue or auto-follow, the next cue in the sequence is fired. (i.e. QLab starts again at step 1 for the next cue.)
Firing a running cue has no effect on the cue; it continues to run until it is stopped or completes running on its own.
Cue Subtopics:
© 2010 Figure 53, LLC. All rights reserved.