Sunteți pe pagina 1din 49

A Quick Reference for QLab version 3

MDPostdesign is Mike Post, a professional lighting designer based in the


Southeast. He has no affiliation with Figure53 other than he thinks theyre
neat people who write very cool software.
http://mdpostdesign.com

QLab is software providing Show Control for Live Theatre from Figure53.
A Baltimore based company, Figure53 holds title to several very useful
programs for Macintosh OSX. For more information, check them out at:
http://figure53.com
Documentation and Tutorial videos for QLab are available Figure53s
website:
http://figure53.com/qlab/documentation/
Developer information for QLabs Open Sound Control API can be found
at:
http://figure53.com/qlab/documentation/osc-api/

Cue Descriptions
Arm Cue!
Enables a cue to be executed.
Target: Any Cue

Audio Cue!
Plays sound files. Supports WAV, AIFF, MP3 and more
Target: Audio File

Camera Cue!
Accepts a video stream from a Firewire camera
Target: None

Devamp Cue!
Causes a target Audio cue to continue past the end of a
looped slice to play the rest of the sound clip. Also will
either launch the next cue or stop the target at the end of
the current slice.
Target: Audio or Video Cue

Disarm Cue!
Disables a cue so it cannot be executed.
Target: Any Cue

Fade Cue!
Affects the volumes for faders and crosspoints as well as
adjust effects for Audio and the Geometry for Video
Target: Audio Cue, Video Cue

Goto Cue!
Sets the next cue to be executed. This allows for jumping
to another part of the cue sequence.
Target: Any cue.

Group Cue!
Groups cues together for organization and playback.
Stopping a Group cue stops all cues in the group. Box
around the group shows the group mode.
Target: None

Load Cue!
Readies a target cue for execution. Anything the cue
needs to run is loaded into memory.
Target: Any Cue

Memo Cue!
Creates a comment in the cue list.
Target: None

Mic Cue!
Allow capture from an external audio source to be routed
to any output device.
Target: None

MIDI Cue!
Sends a MIDI Voice, Show Control or SysEx message to a
specified output. Not available in the Free version.
Target: None

MIDI File Cue!


Plays back a MIDI File to a specified MIDI output device.
Not available in the Free version.
Target: Type 0 or type 1 MIDI file

OSC Cue!
Sends an Open Sound Control message to a specified
destination.
Target: None

Pause Cue!
Causes an executing cue to pause until restarted. Pre-Wait,
Post-Wait and Duration countdowns will all be
suspended.
Target: Any Cue

Reset Cue!
Resets a target cue to its initial state.
Target: Any cue

Script Cue!
Runs an Applescript.
Target: None

Start Cue!
Executes a target cue.
Target: Any Cue

Stop Cue!
Stops a target executing cue.
Target: Any Cue.

Target Cue!
Retargets a GoTo cue.
Target: GoTo Cue

Timecode Cue!
Send either a MIDI Time Code (MTC) or a Linear Time
Code to a specified device.
Target: None

Video Cue!
Plays a Video file. Supports any Apple AVFoundation
media format including PhotoJPEG, H.264, ProRes 4444,
JPEG, and PNG. Only available with a Basic or Pro Video
license.
Target: Video File

Wait Cue!
Pauses execution for a specified number of seconds.
Target: None
Contents

Keyboard Shortcuts
1-9 and 0
First 10 Cue Descriptions!
First 10 Toolbox Cues are taken in order from 1 to 9 and 0 as the 10th

Cue List Editing


N

Edit Cue Number

Edit Cue Name

Edit Target

Edit Pre-Wait Time

Edit Duration/Action Time

Edit Post-Wait Time

Cycle Continue Mode


Cycles continue mode from Do Not Continue to AutoContinue to Auto-Follow

Select All

Delete Selected Cue Numbers

Find

Find Next

G Find Previous
R

Renumber Selected Cues

Delete Cue
Delete key operates normally when entering text but
to delete a cue you must hold down Command and hit
Delete

Display Commands
B

View/Hide Broken Cue Listing

>

Open All Groups

<

Close All Group Cues

View/Hide Cue Lists & Active Cues

View/Hide Inspector

View/Hide Toolbox

Open Cue List/Active Cues pane.

View/Hide Workspace Settings

Enter Fullscreen

Cue Editing
X

Cut

Copy

Paste

Next Cue

Previous Cue
Arrow keys will move between cues only
when in the Current Cue List. When in
the inspector, use the Command Key

Next Inspector Tab

Previous Inspector Tab

Copy Levels * or Geometry


Context changes depending on the type of cue
selected

Paste Levels * or Geometry


Context changes depending on the type of cue
selected

Set Levels from Target *

Show/Hide Audition Window

Preview Cue

Transport Commands
Space

GO for next Cue

Load Selected Cue

Load to Time

Jump to Cue

Jump to Next Cue Sequence

Jump to Previous Cue Sequence

Next Cue

Previous Cue
Arrow keys will move between cues
only when in the Current Cue List.
When in the inspector, use the
Command Key

Pause All Active Cues

Pause/Unpause Selected Cue

Resume All Paused Cues

Panic Selected Cue

ESC

Panic All cues

ESC 2X

Hard Stop all cues (Escape Twice)


A single Escape will Panic the activ
cues, stop executing them by fading out
according to the Panic Duration defined
in Settings; default 1.5 seconds. A
double escape will abort all executing
cues immediately.

General Commands
M

Minimize Window

Hide QLab

Hide Others

New Workspace

Open Workspace

Quit QLab

Save

S Save As
T

Special Characters

Undo

Close Workspace

Contents

Reference Guide Symbols


! Command Key

! Shift Key
! Option Key
! Delete Key
*!

Audio License needed

Video License needed

Keyboard shortcut defined in Settings

Contents

Workspace Settings
Workspace Settings can be changed with the Workspace
Settings Button in the lower right of the Cue List Window

General
Start Cue
Number

When set, QLab will automatically start executing cues


from the specified number

Time Between Helps prevent accidental execution from excess


Each Go
adrenaline or faulty keys. Establishes a minimum time
between GO commands and allows setting a required
key up event to prevent cue autorepeating.
Auto
Numbering

Allows setting a standard increment for automatically


numbering cues.

Lock
Playback to
Selection

Sets the selected cue as the next to be executed on


receiving a GO command. Without this option
unchecked, it is possible to work on cues without
disturbing the regular sequence of playback.

Panic
Duration
Display Size

Set an amount of time for executing cues to fade out


gracefully when Stop All is used. Default is 1.5 seconds.
Changes the Current Cue List font to one of 3 sizes.

Key Map
This section allows for custom definition of some
keyboard shortcuts. Click on the X next to a text box to
clear the keystroke.

OSC Controls
Allows QLab to respond to Open Sound Control
messages.

Use
Passcode

Set a passcode for clients to acces this workspace.

Command
Strings

Optional alternate command strings for various


commands. Can be set by direct entry or by capturing
values from the client.

MIDI Controls
Operation to allow control of QLab remotely from other
MIDI based devices.
Use MIDI
Enable/Disable control with MSC commands.
Show Control
Use Device
ID

Sets the Device ID for this workspace 1 through 126.

Use Musical Enable//Disable MIDI Voice Messages. Allow custom


MIDI Controls messages to be defined for various operations. Set the
MIDI ID to listen for messages 1 through 16. Commands
may be entered directly or captured from a MIDI
controller.

Audio Cue Settings


Audio Patch
Assignments

Pop-up menus that allow each Audio Patch (1 through 8)


to be set to a particular output device.

Edit Patch
buttons

Allows setting custom routing of signals to the output


device, changing the channel assignments, and applying
effects to channels and device outputs.

Volume Limits Set a maximum and minimum volume limit for an output
fader.

Guaranteed
Sync

Enable Guaranteed Synchronization by default. Allows


for all audio cues to be synchronized to individual
samples.

Default Levels Sets the default levels for input and output and
for new Audio Crosspoints of newly created Audio cues. Buttons
Cues
available to set all to a Default level or Silent. Also allows
ganging output faders. Faders with the same name will
operate together.

Mic Cue Settings


Assigns a patch and default values for new Mic cues
Mic Patch

Pop-up menus that allow assigning an Audio Input


connected to the Mac to a patch (1 through 8)

Default Levels Sets the default levels for input and output and
for new Mic Crosspoints of newly created Mic cues. Buttons
Cues
available to set all to a Default level or Silent. Also allows
ganging output faders. Faders with the same name will
operate together.
Audio MIDI
Setup

Launches Apples utility to manipulate Audio and MIDI


connections.

Video Cue Settings

Sets defaults and allows for the creation of new Video Surfaces.
Default surfaces are created for each available video device.
Default Mode Allows either Full Screen or Custom Geometry to be set
as a default for all new Video cues.
Default
Surface

Sets the default surface for all new Video cues

Available
Surfaces

Displays all current available surfaces. For a new


Workspace, the initial Surfaces are defined per video
output. Surfaces can be modified using the Edit button to
change the basic shape, set an edge blend Gamma
value, projector origin and orientation. Custom surfaces
may be removed by clicking on the X.

Plus Button

Allows creation of custom Surfaces which can be


mapped over multiple projectors.

Duplicate
Button

Creates a copy of a selected surface that can be


modified for a different view.

Camera Cue Settings


Pop-up menus to assign a Camera Patch (1 through 8) to a
video camera attached to the Mac.

Fade Cue Settings


Set the default behaviors for Face cues
Default Fade
Duration

Sets a default time in seconds for new Fade cues

Default Curve Sets a default curve for all fades to either an S-Curve or
Shape
a Custom curve. With Custom, any curve can be defined
by clicking on the yellow line and dragging a new shape.

OSC Cue Settings


Assigns Open Sound Control network nodes to Patches (1
through 16). Enter the IP address of the node and the Port

to sent the data to. If a passcode is needed for accessing


another QLab device, it may be entered here.

MIDI Cue Settings


Pop-up menus to assign available MIDI output devices to
Patches (1 through 8).

MIDI File Cue Settings


Pop-up menus to assign available MIDI output devices to
Patches (1 through 8).

Timecode Cue Settings


Pop-up menus to assign a default Frame Rate and radio
buttons to select the default type of cue, MIDI Time Code
or Linear.

Group Cue Settings


Set the default mode for new group cues.

Wait Cue Preferences


Set the default duration for all new Wait cues.

Script Cue Preferences


Sets an initial script for new Script cues.
Contents

Basics Inspector Tab


General information and settings about a cue. All Cue Descriptions
have the same options on the Basics tab of the inspector.
Number

The Cue number. Can be any combination of letters/


numbers but must be unique in the workspace.

Color

Change the color of the Cue row. Click the X to reset

Name

Cue name. May be any combination of letters, numbers


or symbols.

Target

Displays the cues target. The arrow button to the right


will jump to the target. IN the case of a file, the target file
will be revealed in the finder. For a cue target, QLab will
jump to that cue.

Pre-Wait

Amount of time in seconds before the group cue


executes

Post-Wait

Amount of time in seconds before launching the next cue


if Autocontinue is set.

Continue

Automatically execute the next cue. Options:


!
Do not continue
!
Auto-continue: Wait until Post-Wait time has
elapsed
!
Auto-follow: Wait until current cue is completed

Armed

Enable or disable the cue

MIDI Trigger

Assign a specific MIDI message that will trigger this cue.


Can be Note On, Note Off, Program Change, Control
Change, Key Pressure, Channel Pressure. Click
Capture to set by a signal from a controller.

Hotkey
Trigger

Assign a key that will call up this cue whenever pressed.


Click X to clear

Wall Clock
Time

Execute cue when a specific day and time is reached


according to System time. Can be in 24 Hour time, AM
or PM. Button to the right allows selecting specific days
of the week to launch the cue.

Timecode
Trigger

Tells QLab to launch this cue according to a Timecode


from either MIDI Time Code or a Liner time code from an
external source.

Cue Descriptions
Contents

Arm Cue Inspector


Enables a cue to be executed.
There are no settings to the Arm cue besides Basics.
Basics
Cue Descriptions
Contents

Audio Cue Inspector


Plays sound files. Supports WAV, AIFF, MP3 and more
Basics tab options are the same for each cue. Click to view.
Basics

Time and Loops Tab

Details about an audio clip. Also available for the audio portion of a
Video cue.
Go to Video Inspector

Start Time

Beginning time marker for the clip in seconds.

End Time

End time marker for the clip in seconds.

Play Count
Add Slice

Delete All
Media Timeline

Fade Envelope
Button

Number of times to play through the clip.


Separate radio button will set an infinite loop
Button to place a Slice marker in the Media
Timeline. Click and drag the slice marker to
change the position. Click and drag off the
Timeline to delete it
Removes all Slice markers.
Display for the media clip over time. Beginning
and ending markers are displayed as yellow lines.
Slice Markers displayed as green lines with an
editable repeat count for each slice displayed at
the bottom of the Timeline. Click on the repeat
count to change the number. Enter INF for an
infinite loop.
Toggles display of an editable fade curve in
yellow over the duration of the clip. Handles may
be added and adjusted by clicking on the fade
curve. Handles may be removed by clicking on
them and hitting the Delete key.

Preview Button

Rate
Pitch Shift

Hold At End
Magnifiers

Plays the cue without changing the show


playback context. Pauses when clicked during
playback.

Adjust the rate of playback. 1 is normal rate.


Less that 1 is slower.
Determines whether the change in rate affects the
pitch of the sound. With it selected, the pitch will
be shifted in relation to the rate.
For Video Cues, holds the final image once the
cue plays out. Not available for Audio cues.
Zooms in or out of the display. A scroll function
on a mouse or trackpad will have the same effect.

Device and Levels Tab


Output device and volume levels for audio. In Audio cues, it is called
Device and Levels. Also available for the audio portion of a Video cue
as the Audio Levels tab.
Go to Video Inspector
Go to Mic Inspector
Audio Output Patch

Selects the output device from the list of installed


devices.

Edit Device

Click Ellipsis button [...] to edit the patch for the


selected device. Changes here will affect all audio
cues assigned to this device.

Default Levels

Sets all channels and crosspoints to default levels


defined in the Audio Settings for that output.

Set All Silent


Assign Gangs

Visible Channels

Sets all channels and crosspoints to

Allows channels and crosspoints to be ganged.


Enter a label in each channel or crosspoint to be
ganged. Those with the same label will operate
together.
Number of channels displayed for this cue.
Maximum is 48.

Master Fadet

Control the master output volume.

Output Faders

Individual controls for output channels. Level


meter will display in these when the cue is
executing.

Inputs

Master input level for each channel of the file.

Crosspoints

Controls how much of each input channel is routed


to each output. Click to enter manually or click and
drag up or down to adjust with a mouse or
trackpad.

Trim/Audio Trim Tab


Allows for control of overall output levels for this audio cue. Settings
here are not affected by fade cues so this can be used to change the
overall relative volume for any fades that take place. Also available
for the audio portion of a Video cue.
Go to Video Inspector
Go to Mic Inspector
Master

Control the master output volume. Last step in the


signal path for this cue.

Outputs

Individual controls for output channels. Level


meter will display in these when the cue is
executing. The number of faders will adjust
according to the Visible Channels in the Levels tab.

Audio Effects Tab

Allows adding effects to audio. Each affect is applied before any


volume adjustments. Also available for the audio portion of a Video
cue.
Go to Video Inspector
Go to Mic Inspector

Add effect... Menu

Effects List

Select an effect to add. Adding an effect will


automatically bring up a Settings dialogue for the
effect.
Each effect added is listed. Click and drag effects
to change the order in which they are applied from
top down. Effects may be disabled using the
check box and removed using the X on the far
right. Setting for the effect may be accessed with
the Edit button.

Audio Settings
Cue Descriptions
Contents

Camera Cue Inspector


Accepts a video stream from a Firewire camera
Basics tab options are the same for each cue. Video Effects
are the same as in the Video cue. Click to view.
Basics
Video Effects

Display & Geometry

Most options are identical to the Display & Geometry tab in the Video
cue. Click to view.
Camera

Camera Settings
Cue Descriptions
Contents

Sets source from cameras attached to the Mac

Devamp Cue Inspector


Causes a target Audio cue to continue past the end of a
looped slice to play the rest of the sound clip. Also will
either launch the next cue or stop the target at the end of
the current slice.
Basics tab options are the same for each cue. Click to view.
Basics

Settings Tab
Start next cue when target reaches the end of the current slice
Allows for the next cue to be launched when the target cue reaches
the next slice marker and continues.
Stop target when the targets loop ends
Instead of finishing out the rest of the sound file, stop the target cue
immediately. Only available if Start Next Cue is selected.

Cue Descriptions
Contents

Disarm Cue Inspector


Disables a cue so it cannot be executed.
Basics tab options are the same for each cue. Click to view.
Basics
Disarm has no other settings
Cue Descriptions
Contents

Fade Cue Inspector


Affects the volumes for faders and crosspoints as well as
adjust effects for Audio and the Geometry for Video
Basics tab options are the same for each cue. Click to view.
Basics

Curve Shape Tab

Allows setting a custom curve for the action of the cue.


Curve Type
Duration
Stop Target When
Done

Select either a fixed S-Curve or Custom curve.


The amount of time in seconds the cue will take to
execute.
Halts the cue and clears it from memory when
duration time has elapsed.

Fade Curve

Allows for changing the nature of the fade over


time when Custom Curve is selected. The left half
affects levels that fade up, the right for levels that
fade down. Handles to change the curve can be
added by clicking on the line. Selected handles will
be solid dots which can be manipulated with the
pointer and can be deleted with the Delete key

.
Levels Tab

Changes in Audio levels for the target. Handles for


naffected levels will be greyed. Levels that change will
have yellow handles. To affect a level, change its value.
To set a level to be unaffected, click on the handle without
changing it.
Fade type

Stop target when


done

Selects whether this will be an Absolute or a


Relative fade. Absolute fades take a level TO a
value. Relative fades adjust a level BY a value.
Halts the cue and clears it from memory when
duration time has elapsed.

Gangs

Allows for output channels to be ganged making


them operate together. Channels with the same
name will operate as one.

Set from Target

Resets Master, Faders, Inputs and Crosspoints to


the levels from the Target. All controls are set to
Unaffected.

Set All Silent


Master

Set Master and Outputs to -INF


Control the master output volume.

Outputs

Inputs

Crosspoints

Individual controls for output channel valumes.


The number of visible channels is determined by
the target cue.
Master input level for each channel of the file.
Only the number of channels in the file is
displayed, up to 24.
Controls how much of each input channel is routed
to each output. The number of available
crosspoints will adjust to the targets number of
input and output channels.

Audio Effects Tab


Allows fading effect parameters. All effect fades are Absolute.
Stop target when
done

Halts the cue and clears it from memory when


duration time has elapsed.

Set Audio Effects


from Target

Resets changed effect parameters to those defined


in the target.

Effects List

Lists all audio effects assigned to a cue. The


parameters for each effect can be changed using
the Edit button for the effect. Changes to the effect
may be enabled or disabled with the chech box on
the left.

Geometry Tab

Allows changing video parameters. Only available when Target is a


Video cue.
Fade Type

Select Absolute or Relative fade. Absolute fades


change parameters TO a value. Relative fades
change parameters BY a value.

Stop target when


done
Set Geometry from
Target

Halts the cue and clears it from memory when


duration time has elapsed.
Resets changed effect parameters to those defined
in the target.

Opacity

Selects a change in the opacity. Adjust values by


clicking and entering a number or by clicking and
dragging to set a new value.

Translation

Change the position within the surface. The left


box is the horizontal position, the right box is the
verticle. Adjust values by clicking and entering a
number or by clicking and dragging to set a new
value.

Scale

Adjusts the scale of the image. 1 is full size. The


left box is the horizontal scale and the right is the
vertical. The lock between then will keep the
scales relative to each other. Adjust values by
clicking and entering a number or by clicking and
dragging to set a new value.

Rotation

Allows changing the rotation along the X, Y or Z


axes. Click on a button to change the rotation. X
will rotate from top to bottom, Y will rotate from left
to right, and Z will rotate around the center point.
Reset will return the image to the original
orientation.

Orientation

Allows full control over all axes (3D Orientation) or


limiting to just one axix, Z, Y or Z. When in 3d
Orientation, a Reset is available to clear all
parameters.

Surface Display

Allows for dynamic positioning of the image on the


surface. Click and drag the image to move or use
arrow keys to nudge,.

Fade Settings
Cue Descriptions
Contents

Goto Cue Inspector


Sets the next cue to be executed. This allows for jumping
to another part of the cue sequence. Basics tab options are
the same for each cue. Click to view.
Basics
Goto has no other settings
Cue Descriptions
Contents

Group Cue Inspector


Groups cues together for organization and playback.
Stopping a Group cue stops all cues in the group. Box
around the group shows the group mode.
Basics tab options are the same for each cue. Click to view.
Basics

Mode Tab
Fire first child and enter into the group
Executes the first cue and then repositions playback to the next cue
in that group.
Border is a rounded rectangle
Fire first child and go to next cue
Executes the first cue of the group (and its continues) and
repositions the playback to the next cue after the group.
Border is a Blue rectangle.

Fire all children simultaneously


Executes all cues within the group and positions the playback for
the next cue after the group.
Border is a Green rectangle.
Fire a random child and go to next cue
Executes a random cue from the group (and its continue) and
repositions the playback to the next cue after the group.
Border is a Purple rectangle

Group Preferences
Cue Descriptions
Contents

Load Cue Inspector


Readies a target cue for execution. Anything the cue
needs to run is loaded into memory.
Basics tab options are the same for each cue. Click to view.
Basics

Load Time Tab


Allows a cue to be loaded at a set time. 00:00.000 is the
start of the cue. Cues can be loaded to any time within
their duration
Cue Descriptions
Contents

Memo Cue Inspector


Creates a comment in the cue list.
Basics tab options are the same for each cue. Click to view.
Basics
Memo has no other settings
Cue Descriptions
Contents

Mic Cue Inspector


Allow capture from an external audio source to be routed
to any output device.
Basics tab options are the same for each cue. The Device &
Levels and Trim tabs are the same as in the Audio cue.
Click on one to view.
Basics
Device and Levels Tab
Trim Tab
Effects Tab
Mic Settings
Cue Descriptions
Contents

MIDI Cue Inspector


Sends a MIDI Voice, Show Control or SysEx message to a
specified output. Not available in the Free version.
Basics tab options are the same for each cue. Click to view.
Basics

Settings Tab
MIDI Destination

Selects the MIDI Output device from those patched


in Workspace Setting

Message Type

Selected the type of MIDI message to send, MIDI


Voice, MIDI Show Control (MSC) or MIDI SysEx

Send Message

Sends the currently define message to the


selected output.

MIDI Voice Message


Command

Channel
Command Values

Selects the particular MIDI command for this


message; Note On/Off, Program/Control Change,
Key/Channel Pressure or Pitch Bend
Selects the MIDI Channel from 1 to 16
Specifies what values to set for the particular
command. Options will change depending which
command is selected.

MIDI Show Control Message (MSC)


Command Format

Selects the command group for this MSC


command e. g. Lighting General, Lasers, et. al.

Command

Selects the specific command for the message.

Device ID

Sets the destination device ID number for the


command from 1 to 127.

Command Values

Specifies what values to set for the particular


command. Options will change depending which
command is selected.

MIDI SysEx Message


Allows the raw SysEx command message to be entered in
hexadecimal codes. The leading F0 and trailing F7 codes
are not needed. QLab will add those automatically.
MIDI Preferences
Cue Descriptions
Contents

MIDI File Cue Inspector


Plays back a MIDI File to a specified MIDI output device.
Not available in the Free version.
Basics tab options are the same for each cue. Click to view.
Basics

Settings Tab
Displays the MIDI file voices and the progress of the cue.
MIDI Destination

Selects the MIDI Output device from those patched


in Preferences

Playback Rate

Changes the rate at which MIDI messages are


sent to the output device. 1 is normal speed 100%.

Track Display

Displays a track listing with a playback head when


the cue is executing.

MIDI File Settings


Cue Descriptions
Contents

OSC Cue Inspector


Sends an Open Sound Control message to a specified
destination.
Basics tab options are the same for each cue. Click to view.
Basics

Settings Tab
OSC Destination

Select a destination as defined in the OSC Cue


Settings.

Message Type

Select either a QLab specific message, or a Raw


message.

Cue Number

Enter the cue number to affect. QLab messages


only.

Command

Select the specific command from the pop-up


menu. QLab messages only.
Settings commands will display a Parameter field
to enter a new value. Most are direct values with
the following exceptions:
continueMode:
0 - None
1 - Autocontinue
2 - Autofollow
flagged
0 - Not flagged
1 - Flagged
armed
0 - Disarmed
1 - Armed
colorname
red, orange, green, blue, purple
any numbers are ignored
any alpha characters other than the named
set the color to grey

Message Box

Text box to enter raw OSC messages. Raw


messages only.

OSC Settings
Cue Descriptions
Contents

Pause Cue Inspector


Causes an executing cue to pause until restarted. Pre-Wait,
Post-Wait and Duration countdowns will all be
suspended.

Basics tab options are the same for each cue. Click to view.
Basics
Pause has no other settings
Cue Descriptions
Contents

Reset Cue Inspector


Resets a target cue to its initial state.
Basics tab options are the same for each cue. Click to view.
Basics
Reset has no other settings
Cue Descriptions
Contents

Script Cue Inspector


Runs an Applescript.
Basics tab options are the same for each cue. Click to view.
Basics

AppleScript Tab
This is a place to enter the text of an AppleScript. If QLab
can compile the script, it will be displayed with keywords
colorized. If it cannot, the text of the script will be black
and an error will be displayed below.
Cue Descriptions

Applescript Hooks
Contents

Start Cue Inspector


Executes a target cue.
Basics tab options are the same for each cue. Click to view.
Basics
Start has no other settings
Cue Descriptions
Contents

Stop Cue Inspector


Stops a target executing cue.
Basics tab options are the same for each cue. Click to view.
Basics
Stop has no other settings
Cue Descriptions
Contents

Target Cue Inspector


Retargets a GoTo cue.
Basics tab options are the same for each cue. Click to view.
Basics

Cue Number Tab


Enter the number of the cue to retarget the Goto.
Alphanumerics are allowed.
Cue Descriptions
Contents

Timecode Cue Inspector


Send either a MIDI Time Code (MTC) or a Linear Time
Code to a specified device.
Basics tab options are the same for each cue. Click to view.
Info

Settings Tab
Type
MIDI Destination

Frame Rate
Start Time
Channel

Timecode Settings
Cue Descriptions
Contents

Select either MIDI Time Code (MTC) or Linear


Time Code (LTC)
Selects the MIDI Output device from those
connected to the Mac. MIDI Patch is not
referenced.
Select various frame rates from a pop-up menu.
Select the start time in seconds
Set the source channel. LTC only.

Video Cue Inspector


Plays a Video file. Supports any Apple AVFoundation
media format including PhotoJPEG, H.264, ProRes 4444,
JPEG, and PNG. Only available with a Basic or Pro Video
license.
Basics tab options are the same for each cue. Time &
Loops, Audio Levels, Audio Trim and Audio Effects are
the same tabs as used in the Audio Cue (Names may vary
slightly). Click each to view.
Basics
Time & Loops
Audio Levels
Audio Trim
Audio Effects

Display & Geometry Tab


Select the output Surface, base Geometry, and other parameters.
Video Surface

Select the output surface. Surfaces are defined in


Video Settings. By default, each installed video
output will have a dedicated surface.

Edit Surface

Click Ellipsis button [...] to adjust the settings for


the selected surface. Changes here will affect all
video cues assigned to this surface.

Mode

Sets either Full Screen (fit to entire surface) or


Custom Geometry. Geometry controls will only be
displayed when set to Custom Geometry.

Preserve Aspect
Ratio

Visible when Full Screen is selected. Select


whether Full Screen will distort the image to fit the
surface or merely expand until the edges are met
according to the images aspect ratio.

Layer

Which video layer this input is on. A lower value


will be composited under a higher one. Value from
0 to 1000 (Top)

Opacity

The solidity of the video or image. Adjustable by


either entering a percentage in the box next to it or
by clicking in that box and dragging up or down to
set a value..

Translation

Adjusts the placement of the image within the


surface relative to the origin. The left box is the
horizontal position and the right is the vertical.
Adjust values by clicking and entering a number or
by clicking and dragging to set a new value.

Scale

Adjusts the scale of the image. 1 is full size. The


left box is the horizontal scale and the right is the
vertical. The lock between then will keep the
scales relative to each other. Adjust values by
clicking and entering a number or by clicking and
dragging to set a new value.

Rotation

Allows changing the rotation along the X, Y or Z


axes. Click on a button to change the rotation. X
will rotate from top to bottom, Y will rotate from left
to right, and Z will rotate around the center point.
Reset will return the image to the original
orientation.

End Time

End time of the cue. Where in the file to stop


playing. Reset to the start of the file by clicking on
the arrow icon next to the box.

Auto-stop at end

Halt execution and clear the cue from memory.


When left unchecked, the final frame of the video
file is held indefinitely

Surface Display

Allows for dynamic positioning of the image on the


surface. Click and drag the image or use the arrow
keys to nudge it.

Video Effects Tab

Assign a video effect to this cue. Only one effect may be assigned
per cue.
Apply Effects

Check box to enable a video effect. Effects are


selected using the pop-up menu.

Effect Inputs

Custom controls for the selected effect are


displayed in this box.

Video Settings
Camera Cue
Cue Descriptions
Contents

Wait Cue Inspector


Pauses execution for a specified number of seconds.
Basics tab options are the same for each cue. Click to view.
Basics
Wait has no other settings
Wait Preferences
Cue Descriptions
Contents

AppleScript Hooks
For more information about QLabs AppleScript hooks,
open the Applescript Editor in the Utilities folder. Under
the Window menu, select Library. If you see QLab in
there, doule click on it. If not, click the Plus sign + and
browse for QLab to add it to the Library.

Standard Suite
Nouns
item: A scriptable object.
application: An application's top level scripting object.
color: A color.
document: A document.
window: A window.

Verbs
open: Open an object.
print: Print an object.
quit: Quit an application.
close: Close an object.

count: Return the number of elements of a particular class


within an object.
delete: Delete an object.
exists : Verify if an object exists.
get : Get the data for an object.
move: Move object(s) to a new location.
save : Save an object.
set: Set an object's data.

QLab Suite
Nouns
workspace: A QLab workspace.
cue: A cue.
group cue: A Group Cue.
cue list : A cue list.
audio cue : An Audio Cue.
mic cue: A Mic Cue
video cue : A Video Cue.
camera cue: A Camera Cue.
fade cue : A Fade Cue.
midi cue,msc cues : A MIDI Cue.

timecode cue: A Timecode Cue for MTC or LTC.


devamp : A Devamp Cue.
load cue: A Load Cue.
target cue : A Target Cue.

Verbs
make type: Makes a cue of type
load: Load a cue or workspace to a given time.
go: Make a workspace GO.
preview: Preview one or more cues
start : Start one or more cues or workspaces.
pause: Pause one or more cues or workspaces.
stop : Stop one or more cues or workspaces.
hardStop: Hard stop one or more cues or workspaces.
panic: Panic one or more cues or workspaces.
reset : Reset one or more cues or workspaces.
moveSelectionUp : Select the previous cue.
moveSelectionDown : Select the next cue.
setLevel cue, row, column, db: Sets the specified matrix
position to db

getLevel cue, row, column: Returns the specified matrix


position level.
Script Cue
Contents