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 they’re

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 Figure53’s

website:

http://figure53.com/qlab/documentation/

Developer information for QLab’s 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 it’s 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 EditingN Edit Cue Number ‡

Q Edit Cue Name ‡

T Edit Target ‡

E Edit Pre-Wait Time ‡

D Edit Duration/Action Time ‡

W Edit Post-Wait Time ‡

C Cycle Continue Mode ‡Cycles continue mode from Do Not Continue to Auto-

Continue to Auto-Follow

⌘A Select All

⌘D Delete Selected Cue Numbers

⌘F Find

⌘G Find Next

⇧ ⌘G Find Previous

⌘R Renumber Selected Cues

⌘ ⌫ Delete CueDelete 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

⌘L View/Hide Cue Lists & Active Cues

⌘I View/Hide Inspector

⌘K View/Hide Toolbox

⇧⌘L Open Cue List/Active Cues pane.

⌘ , View/Hide Workspace Settings

⇧⌘F Enter Fullscreen

Cue Editing⌘X Cut

⌘C Copy

⌘V 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

⇧⌘C Copy Levels * or Geometry †Context changes depending on the type of cue

selected

⇧⌘V Paste Levels * or Geometry †Context changes depending on the type of cue

selected

⇧⌘T Set Levels from Target *

⇧⌘A Show/Hide Audition Window

V Preview Cue ‡

Transport CommandsSpace GO for next Cue ‡

L Load Selected Cue ‡

⌘T Load to Time

⌘J 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 ‡

P Pause/Unpause Selected Cue ‡

] Resume All Paused Cues ‡

S 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

⌘H Hide QLab

⌥ ⌘H Hide Others

⌘N New Workspace

⌘O Open Workspace

⌘Q Quit QLab

⌘S Save

⇧ ⌘S Save As

⌥ ⌘T Special Characters

⌘Z Undo

⌘W 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 SettingsWorkspace Settings can be changed with the Workspace

Settings Button in the lower right of the Cue List Window

GeneralStart Cue Number

When set, QLab will automatically start executing cues from the specified number

Time Between Each Go

Helps prevent accidental execution from excess 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

Set an amount of time for executing cues to fade out gracefully when Stop All is used. Default is 1.5 seconds.

Display Size Changes the Current Cue List font to one of 3 sizes.

Key MapThis section allows for custom definition of some

keyboard shortcuts. Click on the X next to a text box to

clear the keystroke.

OSC ControlsAllows 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 ControlsOperation to allow control of QLab remotely from other

MIDI based devices.

Use MIDI Show Control

Enable/Disable control with MSC commands.

Use Device ID

Sets the Device ID for this workspace 1 through 126.

Use “Musical” MIDI Controls

Enable//Disable MIDI Voice Messages. Allow custom 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 SettingsAudio 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 for new Audio

Cues

Sets the default levels for input and output and Crosspoints of newly created Audio cues. Buttons 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 SettingsAssigns 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 for new Mic

Cues

Sets the default levels for input and output and Crosspoints of newly created Mic cues. Buttons 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 Apple’s utility to manipulate Audio and MIDI connections.

Video Cue SettingsSets 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 SettingsPop-up menus to assign a Camera Patch (1 through 8) to a

video camera attached to the Mac.

Fade Cue SettingsSet the default behaviors for Face cues

Default Fade Duration

Sets a default time in seconds for new Fade cues

Default Curve Shape

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

OSC Cue SettingsAssigns 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 SettingsPop-up menus to assign available MIDI output devices to

Patches (1 through 8).

MIDI File Cue SettingsPop-up menus to assign available MIDI output devices to

Patches (1 through 8).

Timecode Cue SettingsPop-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 SettingsSet the default mode for new group cues.

Wait Cue PreferencesSet the default duration for all new Wait cues.

Script Cue PreferencesSets an initial script for new Script cues.Contents

Basics Inspector TabGeneral 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 cue’s 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 DescriptionsContents

Arm Cue InspectorEnables a cue to be executed.

There are no settings to the Arm cue besides Basics.

BasicsCue DescriptionsContents

Audio Cue InspectorPlays sound files. Supports WAV, AIFF, MP3 and more

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

Basics

Time and Loops TabDetails 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 Number of times to play through the clip. Separate radio button will set an infinite loop

Add Slice 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

Delete All Removes all Slice markers.

Media Timeline 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.

Fade Envelope Button

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 Plays the cue without changing the show playback context. Pauses when clicked during playback.

Rate Adjust the rate of playback. 1 is normal rate. Less that 1 is slower.

Pitch Shift 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.

Hold At End For Video Cues, holds the final image once the cue plays out. Not available for Audio cues.

Magnifiers Zooms in or out of the display. A scroll function on a mouse or trackpad will have the same effect.

Device and Levels TabOutput 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 InspectorGo 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 Sets all channels and crosspoints to -∞Assign Gangs 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.

Visible Channels 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 TabAllows 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 InspectorGo 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 TabAllows 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 InspectorGo to Mic Inspector

Add effect... Menu Select an effect to add. Adding an effect will automatically bring up a Settings dialogue for the effect.

Effects List 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 SettingsCue DescriptionsContents

Camera Cue InspectorAccepts 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 & GeometryMost options are identical to the Display & Geometry tab in the Video cue. Click to view.

Camera Sets source from cameras attached to the Mac

Camera SettingsCue DescriptionsContents

Devamp Cue InspectorCauses 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 TabStart next cue when target reaches the end of the current sliceAllows for the next cue to be launched when the target cue reaches the next slice marker and continues.

Stop target when the target’s loop endsInstead of finishing out the rest of the sound file, stop the target cue immediately. Only available if Start Next Cue is selected.

Cue DescriptionsContents

Disarm Cue InspectorDisables a cue so it cannot be executed.

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

Basics

Disarm has no other settingsCue DescriptionsContents

Fade Cue InspectorAffects 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 TabAllows setting a custom curve for the action of the cue.

Curve Type Select either a fixed ‘S-Curve’ or Custom curve.

Duration The amount of time in seconds the cue will take to execute.

Stop Target When Done

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 TabChanges 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 it’s value.

To set a level to be unaffected, click on the handle without

changing it.

Fade type 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.

Stop target when done

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 Set Master and Outputs to -INF

Master Control the master output volume.

Outputs Individual controls for output channel valumes. The number of visible channels is determined by the target cue.

Inputs Master input level for each channel of the file. Only the number of channels in the file is displayed, up to 24.

Crosspoints Controls how much of each input channel is routed to each output. The number of available crosspoints will adjust to the target’s number of input and output channels.

Audio Effects TabAllows 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 TabAllows 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

Halts the cue and clears it from memory when duration time has elapsed.

Set Geometry from Target

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 SettingsCue DescriptionsContents

Goto Cue InspectorSets 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 settingsCue DescriptionsContents

Group Cue InspectorGroups 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 TabFire first child and enter into the groupExecutes 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 cueExecutes the first cue of the group (and it’s continues) and repositions the playback to the next cue after the group.Border is a Blue rectangle.

Fire all children simultaneouslyExecutes 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 cueExecutes a random cue from the group (and it’s continue) and repositions the playback to the next cue after the group.Border is a Purple rectangle

Group PreferencesCue DescriptionsContents

Load Cue InspectorReadies 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 TabAllows 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 durationCue DescriptionsContents

Memo Cue InspectorCreates a comment in the cue list.

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

Basics

Memo has no other settingsCue DescriptionsContents

Mic Cue InspectorAllow 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 TabMic SettingsCue DescriptionsContents

MIDI Cue InspectorSends 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 TabMIDI 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 Selects the particular MIDI command for this message; Note On/Off, Program/Control Change, Key/Channel Pressure or Pitch Bend

Channel Selects the MIDI Channel from 1 to 16

Command Values 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 PreferencesCue DescriptionsContents

MIDI File Cue InspectorPlays 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 TabDisplays 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 SettingsCue DescriptionsContents

OSC Cue InspectorSends an Open Sound Control message to a specified

destination.

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

Basics

Settings TabOSC 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 SettingsCue DescriptionsContents

Pause Cue InspectorCauses 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 settingsCue DescriptionsContents

Reset Cue InspectorResets a target cue to it’s initial state.

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

Basics

Reset has no other settingsCue DescriptionsContents

Script Cue InspectorRuns an Applescript.

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

Basics

AppleScript TabThis 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 HooksContents

Start Cue InspectorExecutes a target cue.

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

Basics

Start has no other settingsCue DescriptionsContents

Stop Cue InspectorStops a target executing cue.

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

Basics

Stop has no other settingsCue DescriptionsContents

Target Cue InspectorRetargets a GoTo cue.

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

Basics

Cue Number TabEnter the number of the cue to retarget the Goto.

Alphanumerics are allowed.Cue DescriptionsContents

Timecode Cue InspectorSend 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 TabType Select either MIDI Time Code (MTC) or Linear

Time Code (LTC)

MIDI Destination Selects the MIDI Output device from those connected to the Mac. MIDI Patch is not referenced.

Frame Rate Select various frame rates from a pop-up menu.

Start Time Select the start time in seconds

Channel Set the source channel. LTC only.

Timecode SettingsCue DescriptionsContents

Video Cue InspectorPlays 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 TabSelect 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 image’s 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 TabAssign 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 SettingsCamera CueCue DescriptionsContents

Wait Cue InspectorPauses execution for a specified number of seconds.

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

Basics

Wait has no other settingsWait PreferencesCue DescriptionsContents

AppleScript Hooks

For more information about QLab’s 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 SuiteNounsitem: A scriptable object.

application: An application's top level scripting object.

color: A color.

document: A document.

window: A window.

Verbsopen: 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 SuiteNounsworkspace: 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.

Verbsmake “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 CueContents