The list of commands, functions, properties, and so on that AppleScript can use to interact with an application is called that application’s dictionary. You can find QLab’s AppleScript dictionary here, or view it within the Script Editor application, which is found in /Applications/Utilities.

In Script Editor, choose Open Dictionary… from the File menu, and choose QLab from the list of applications.

AppleScript dictionaries are grouped by “suite”; all applications that use AppleScript must include the Standard Suite, and then any application-specific commands or properties are generally grouped together into another suite named after the application.

This documentation only describes the commands, classes, enumerations, and records from the QLab Suite. Items from the Standard Suite can also be used in QLab, such as the save command, which saves a specified workspace.

Readers are enthusiastically encouraged to use the navigation sidebar on this page, as AppleScript dictionaries are exceedingly verbose. Readers of the PDF version of this manual are encouraged to brace themselves accordingly.

Commands

audition go

(verb): make a workspace Audition GO.

Syntax

audition go {workspace}

Parameters

Classes

The following classes respond to the audition go command:

• workspace

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  audition go
end tell

tell application id "com.figure53.QLab.5"
  audition go workspace "hamlet.qlab5"
end tell

audition preview

(verb): Audition preview one or more cues. Previewing a cue starts the action of that cue, skipping pre-waits and ignoring auto-follows and auto-continues.

Syntax

  preview {cue}

Parameters

Classes

The following classes respond to the audition preview command:

• any type of cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  audition preview cue "1"
end tell

(verb): Set the cue’s timecode trigger to the current incoming timecode received by its parent cue list.

capture timecode

Syntax

  capture timecode {cue}

Parameters

Classes

The following classes respond to the capture timecode command:

• any type of cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  capture timecode cue "1"
end tell

clear

(verb): clear the levels in the Light Dashboard.

Syntax

clear {light dashboard}

Parameters

Classes

The following classes respond to the clear command:

• light dashboard

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  tell theDashboard to clear
end tell

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  clear theDashboard
end tell

collapse

(verb): collapse a Group cue or cue list.

Syntax

collapse {group cue}

Parameters

Classes

The following classes respond to the collapse command:

• group cue
• cue list

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  collapse cue "1"
end tell

collateAndStart

(verb): collate and start a Light cue.

Syntax

collateAndStart {light cue}

Parameters

Classes

The following classes respond to the collateAndStart command:

• light cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  collateAndStart cue "1"
end tell

compile

(verb): verify and prepare the script for use.

Syntax

compile {script cue}

Parameters

Classes

The following classes respond to the compile command:

• script cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  compile cue "1"
end tell

expand

(verb): expand a Group cue or cue list.

Syntax

expand {group cue}

Parameters

Classes

The following classes respond to the expand command:

• group cue
• cue list

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  expand cue "1"
end tell

getGang

(verb): get the gang for a specified location in the cue’s matrix.

Syntax

set theResult to getGang {cue} row {row_number} column {column_number}

Result

text: the value of the gang at the specified location in the cue’s matrix.

Parameters

Classes

The following classes respond to the getGang command:

• audio cue
• mic cue
• video cue
• fade cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theGang to getGang 1 row 0 column 1
  display dialog "The gang for row 0, column 1 is: " & theGang
end tell

getInputChannelName

(verb): get the input name for a specified input channel.

Syntax

set theResult to getInputChannelName {cue} row {row_number}

Result

text: the name for the input channel.

Parameters

Classes

The following classes respond to the getGang command:

• audio cue
• mic cue
• video cue
• camera cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theName to getInputChannelName 1 row 2
  display dialog "The input name for input 2 of cue 1 is: " & theName
end tell

getLevel

(verb): get the level for a specified location in the cue’s matrix.

Syntax

set theResult to getLevel {cue} row {row_number} column {column_number}

Result

real number: the level in decibels of the specified location in the cue’s matrix.

Parameters

Classes

The following classes respond to the getLevel command:

• audio cue
• mic cue
• video cue
• fade cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theLevel to getLevel 1 row 0 column 1
  display dialog "The level for row 0, column 1 of cue 1 is: " & theLevel
end tell

go

(verb): make a workspace GO.

Syntax

go {workspace}

Parameters

Classes

The following classes respond to the go command:

• workspace

Examples

tell application id "com.figure53.QLab.5"
  go front workspace
end tell

tell application id "com.figure53.QLab.5"
  go workspace "hamlet.qlab5"
end tell

hardStop

(verb): hardStop one or more cues or workspaces.

Syntax

hardStop {reference}

Parameters

Classes

The following classes respond to the hardStop command:

• workspace
• cue list
• any type of cue

Examples

tell application id "com.figure53.QLab.5"
  hardStop cue "1"
end tell

tell application id "com.figure53.QLab.5"
  hardStop front workspace
end tell

load

(verb): load one or more cues or workspaces to a given time. A negative value loads that many seconds back from the end of the cue.

Syntax

load {reference} time {real number}

Parameters

Note: Because “load” is both a noun and a verb in QLab (load vs. Load cue), you need to place the reference within parentheses; see examples below.

Classes

The following classes respond to the load command:

• workspace
• cue list
• any type of cue

Examples

tell application id "com.figure53.QLab.5"
  -- load the cue whose cue number is "1"
  load (cue "1")
end tell

tell application id "com.figure53.QLab.5"
  -- load the cue whose cue number is "2" to 15 seconds
  load (cue "2") time 15
end tell

tell application id "com.figure53.QLab.5"
  -- load the cue whose cue number is "3" to 20 seconds before the end of the cue
  load (cue "3") time -20
end tell

tell application id "com.figure53.QLab.5"
  -- load the cue whose cue id is 4
  load (cue 4)
end tell

tell application id "com.figure53.QLab.5"
  -- this does not work!
  -- AppleScript thinks you're talking about a Load cue whose cue number is "5"
  load cue "5"
end tell

make

(verb): make a new cue in a workspace. The cue will be created below the currently selected cue.

Syntax

make {workspace} type {text}

Parameters

Classes

The following classes respond to the make command:

• workspace

Examples

tell application id "com.figure53.QLab.5"
  make front workspace type "audio"
end tell

tell application id "com.figure53.QLab.5"
  make front workspace type "cue list"
end tell

tell application id "com.figure53.QLab.5"
  make workspace "hamlet.qlab5" type "midi"
end tell

movePlayheadDown

(verb): move the playhead to the next cue.

Syntax

movePlayheadDown {specifier}

Parameters

Classes

The following classes respond to the movePlayheadDown command:

• workspace
• cue list

Examples

-- move the playhead to the next cue in the active cue list of the front workspace
tell application id "com.figure53.QLab.5" to tell front workspace
  movePlayheadDown
end tell

-- move the playhead to the next cue in the active cue list of a specific workspace
tell application id "com.figure53.QLab.5"
  movePlayheadDown workspace "hamlet.qlab5"
end tell

-- move the playhead to the next cue in a cue list numbered "101" in the front workspace
tell application id "com.figure53.QLab.5" to tell front workspace
  movePlayheadDown cue "101"
end tell

-- move the playhead to the next cue in a cue list numbered "101" in a specific workspace
tell application id "com.figure53.QLab.5" to tell cue "101" of workspace "ophelia"
  movePlayheadDown
end tell

movePlayheadDownASequence

(verb): move the playhead to the top of the next cue sequence.

Syntax

movePlayheadDownASequence {workspace}

Parameters

Classes

The following classes respond to the movePlayheadDownASequence command:

• workspace

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  movePlayheadDownASequence
end tell

tell application id "com.figure53.QLab.5"
  movePlayheadDownASequence workspace "hamlet.qlab5"
end tell

movePlayheadUp

(verb): move the playhead to the previous cue.

Syntax

movePlayheadUp {specifier}

Parameters

Classes

The following classes respond to the movePlayheadUp command:

• workspace

Examples

-- move the playhead to the next cue in the active cue list of the front workspace
tell application id "com.figure53.QLab.5" to tell front workspace
  movePlayheadUp
end tell

-- move the playhead to the next cue in the active cue list of a specific workspace
tell application id "com.figure53.QLab.5"
  movePlayheadUp workspace "hamlet.qlab5"
end tell

-- move the playhead to the next cue in a cue list numbered "101" in the front workspace
tell application id "com.figure53.QLab.5" to tell front workspace
  movePlayheadUp cue "101"
end tell

-- move the playhead to the next cue in a cue list numbered "101" in a specific workspace
tell application id "com.figure53.QLab.5" to tell cue "101" of workspace "ophelia"
  movePlayheadUp
end tell

movePlayheadUpASequence

(verb): move the playhead to the top of the previous cue sequence.

Syntax

movePlayheadUpASequence {workspace}

Parameters

Classes

The following classes respond to the movePlayheadUpASequence command:

• workspace

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  movePlayheadUpASequence
end tell

tell application id "com.figure53.QLab.5"
  movePlayheadUpASequence workspace "hamlet.qlab5"
end tell

moveSelectionDown

(verb): select the next cue.

Syntax

moveSelectionDown {workspace}

Parameters

Classes

The following classes respond to the moveSelectionDown command:

• workspace

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  moveSelectionDown
end tell

tell application id "com.figure53.QLab.5"
  moveSelectionDown workspace "hamlet.qlab5"
end tell

moveSelectionUp

(verb): select the previous cue.

Syntax

moveSelectionUp {workspace}

Parameters

Classes

The following classes respond to the moveSelectionUp command:

• workspace

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  moveSelectionUp
end tell

tell application id "com.figure53.QLab.5"
  moveSelectionUp workspace "hamlet.qlab5"
end tell

newCueWithAll

(verb): create a new Light cue containing levels for all parameters of all instruments.

Syntax

newCueWithAll {light dashboard}

Parameters

Classes

The following classes respond to the newCueWithAll command:

• workspace

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  newCueWithAll theDashboard
end tell

newCueWithChanges

(verb): create a new Light cue containing levels for all manually adjusted parameters in the Light Dashboard.

Syntax

newCueWithChanges {light dashboard}

Parameters

Classes

The following classes respond to the newCueWithChanges command:

• workspace

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  newCueWithChanges theDashboard
end tell

panic

(verb): panic one or more cues or workspaces.

Syntax

  panic {reference}

Parameters

Classes

The following classes respond to the panic command:

• workspace
• any type of cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  panic
end tell

tell application id "com.figure53.QLab.5"
  panic front workspace
end tell

tell application id "com.figure53.QLab.5" to tell front workspace
  panic cue "1"
end tell

pause

(verb): pause one or more cues or workspaces.

Syntax

  pause {reference}

Parameters

Classes

The following classes respond to the pause command:

• workspace
• any type of cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  pause
end tell

tell application id "com.figure53.QLab.5"
  pause front workspace
end tell

tell application id "com.figure53.QLab.5" to tell front workspace
  pause cue "1"
end tell

preview

(verb): preview one or more cues. Previewing a cue starts the action of that cue, skipping pre-waits and ignoring auto-follows and auto-continues.

Syntax

  preview {cue}

Parameters

Classes

The following classes respond to the preview command:

• any type of cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  preview cue "1"
end tell

prune

(verb): remove light commands that have no effect from a Light cue.

Syntax

  prune {light cue}

Parameters

Classes

The following classes respond to the prune command:

• light cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  prune cue "1"
end tell

recordAllToLatest

(verb): record all levels for all parameters of all instruments into the latest run Light cue.

Syntax

  recordAllToLatest {light dashboard}

Parameters

Classes

The following classes respond to the recordAllToLatest command:

• light dashboard

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  recordAllToLatest theDashboard
end tell

recordAllToSelected

(verb): record all levels for all parameters of all instruments into the selected Light cue(s).

Syntax

  recordAllToSelected {light dashboard}

Parameters

Classes

The following classes respond to the recordAllToSelected command:

• light dashboard

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  recordAllToSelected theDashboard
end tell

redo

(verb): redo the last undone action.

Syntax

  redo {reference}

Parameters

Classes

The following classes respond to the redo command:

• workspace
• light dashboard

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  redo
end tell

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  redo theDashboard
end tell

removeLightCommandsMatching

(verb): remove existing light commands in the specified cue matching the command provided.

Syntax

  removeLightCommandsMatching {cue} command {text}

Parameters

Classes

The following classes respond to the removeLightCommandsMatching command:

• light cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  removeLightCommandsMatching cue "1" command "myLight.intensity = 100"
end tell

replaceLightCommand

(verb): replace a specified light command in the specified cue with a new light command.

Syntax

  replaceLightCommand {cue} oldCommandText {text} newCommandText {text}

Parameters

Classes

The following classes respond to the replaceLightCommand command:

• light cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  replaceLightCommand cue "1" oldCommandText "myLight.intensity = 100" newCommandText "myLight.intensity = 80"
end tell

reset

(verb): reset one or more cues or workspaces.

Syntax

  reset {reference}

Parameters

Classes

The following classes respond to the reset command:

• workspace
• any type of cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  reset cue "1"
end tell

tell application id "com.figure53.QLab.5" to tell front workspace
  reset
end tell

tell application id "com.figure53.QLab.5"
  reset workspace "hamlet.qlab5"
end tell

revert

(verb): revert changes in the specified Light Dashboard.

Syntax

  revert {light dashboard}

Parameters

Classes

The following classes respond to the revert command:

• light dashboard

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  revert theDashboard
end tell

save

(verb): save the last undone action.

Syntax

  save {reference}

Parameters

Classes

The following classes respond to the save command:

• workspace
• light dashboard

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  save
end tell

setGang

(verb): set the gang for a specified location in the cue’s matrix.

Syntax

setGang {cue} row {row_number} column {column_number} gang {text}

Parameters

Classes

The following classes respond to the setGang command:

• audio cue
• mic cue
• video cue
• fade cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set cue "1" row 0 column 1 gang "a"
end tell

setInputChannelName

(verb): set the input name for a specified row of a cue.

Syntax

setInputChannelName {cue} row {row_number} name {text}

Parameters

Classes

The following classes respond to the setInputChannelName command:

• audio cue
• mic cue
• video cue
• camera cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set cue "1" row 0 input "vocals"
end tell

setLevel

(verb): set the level in decibels for a specified location in the cue’s matrix.

Syntax

setLevel {cue} row {row_number} column {column_number} db {real number}

Parameters

Classes

The following classes respond to the setLevel command:

• audio cue
• mic cue
• video cue
• fade cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  setLevel cue "1" row 0 column 1 db "-6"
end tell

setLight

(verb): add a light command to the specified cue or to the Light Dashboard.

Syntax

setLight {reference} selector {text} value {real number or text}

Parameters

Classes

The following classes respond to the setLight command:

• light dashboard
• light cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  setLight cue "1" selector "myLight"
end tell

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  setLight theDashboard selector "myLight.red" value "50"
end tell

shuffle

(verb): shuffle the order of child cues in a Group cue.

Syntax

shuffle {group cue}

Parameters

Classes

The following classes respond to the start command:

• group cue
• cue list

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  start
end tell

start

(verb): start one or more cues or workspaces.

Syntax

start {reference}

Parameters

Classes

The following classes respond to the start command:

• workspace
• any type of cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  start
end tell

tell application id "com.figure53.QLab.5" to tell front workspace
  start cue "1"
end tell

stop

(verb): stop one or more cues or workspaces.

Syntax

stop {reference}

Parameters

Classes

The following classes respond to the stop command:

• workspace
• any type of cue

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  stop
end tell

tell application id "com.figure53.QLab.5" to tell front workspace
  stop cue "1"
end tell

undo

(verb): undo the last action.

Syntax

undo {reference}

Parameters

Classes

The following classes respond to the undo command:

• workspace
• light dashboard

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  undo
end tell

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  undo theDashboard
end tell

updateLatestCue

(verb): copy all manually adjusted levels into the latest run Light cue.

Syntax

  updateLatestCue {light dashboard}

Parameters

Classes

The following classes respond to the updateLatestCue command:

• light dashboard

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  updateLatestCue theDashboard
end tell

updateOriginatingCues

(verb): copy all manually adjusted levels into their originating Light cue(s).

Syntax

  updateOriginatingCues {light dashboard}

Parameters

Classes

The following classes respond to the updateOriginatingCues command:

• light dashboard

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  updateOriginatingCues theDashboard
end tell

updateSelectedCues

(verb): copy all manually adjusted levels into the selected Light cue(s).

Syntax

  updateSelectedCues {light dashboard}

Parameters

Classes

The following classes respond to the updateSelectedCues command:

• light dashboard

Examples

tell application id "com.figure53.QLab.5" to tell front workspace
  set theDashboard to current light dashboard
  updateSelectedCues theDashboard
end tell

Classes

application

(noun): the top-level scripting object of QLab.

Properties

Elements

Commands

The application class responds to the following commands:

audio cue

(noun), pl. audio cues

Properties

In addition to the properties listed here, audio cue inherits properties from cue.

Elements

Commands

The audio cue class responds to the following commands:

Superclass

The audio cue class inherits elements and properties from the cue class.

camera cue

(noun), pl. camera cues

Properties

In addition to the properties listed here, camera cue inherits properties from cue.

Elements

Commands

The camera cue class responds to the following commands:

Superclass

The camera cue class inherits elements and properties from the cue class.

cue

(noun), pl. cues

Properties

All cues have properties from this list, but not every type of cue has every property. For example, only cue type which accept a file target (Audio, Video, and MIDI file) have the file target property.

Elements

Commands

The cue class responds to the following commands:

Subclasses

All cue classes inherit the elements and properties of the cue class.

Where Used

The cue class is used in the following ways:

• direct parameter to the getLevel command.
• direct parameter to the setLevel command.
• direct parameter to the getGang command.
• direct parameter to the setGang command.
• direct parameter to the replaceLightCommand command.
• direct parameter to the removeLightCommandsMatching command.
• element of workspace class.
• active cues property of the workspace class.
• cue target property of the cue class.
• parent property of the cue class.
• parent list property of the cue class.
• playback position property of the cue list class.
• playhead property of the cue list class.
• selected property of the workspace class.

cue list

(noun), pl. cue lists

Properties

In addition to the properties listed here, cue list inherits properties from cue and from group cue.

Elements

Commands

The cue list class responds to the following commands:

Superclass

The cue list class inherits elements and properties from the group cue class.

Where Used

The cue list class is used in the following ways:

• element of the workspace class.
• current cue list property of the workspace class.

devamp cue

(noun), pl. devamp cues

Properties

In addition to the properties listed here, devamp cue inherits properties from cue.

Elements

Commands

The devamp cue class responds to the following commands:

Superclass

The devamp cue class inherits elements and properties from the cue class.

fade cue

(noun), pl. fade cues

Properties

In addition to the properties listed here, fade cue inherits properties from cue.

Elements

Commands

The fade cue class responds to the following commands:

Superclass

The fade cue class inherits elements and properties from the cue class.

group cue

(noun), pl. group cues

Properties

In addition to the properties listed here, group cue inherits properties from cue.

Elements

Commands

The fade cue class responds to the following commands:

Superclass

The group cue class inherits elements and properties from the cue class.

Subclasses

The cue list class inherits elements and properties from the group cue class.

Where Used

The group cue class is used in the following ways:

• direct parameter to the collapse command.
• direct parameter to the expand command.

light cue

(noun), pl. light cues

Properties

In addition to the properties listed here, light cue inherits properties from cue.

Elements

Commands

The light cue class responds to the following commands:

Superclass

The light cue class inherits elements and properties from the cue class.

Where Used

The light cue class is used in the following ways:

• direct parameter to the prune command.
• direct parameter to the collateAndStart command.

light dashboard

(noun)

Commands

The light dashboard class responds to the following commands:

Where Used

The light dashboard class is used in the following ways:

• direct parameter to the clear command.
• direct parameter to the updateLatestCue command.
• direct parameter to the updateOriginatingCues command.
• direct parameter to the updateSelectedCues command.
• direct parameter to the newCueWithAll command.
• direct parameter to the newCueWithChanges command.
• direct parameter to the recordAllToLatest command.
• direct parameter to the recordAllToSelected command.
• direct parameter to the revert command.
• current light dashboard property of the workspace class.

load cue

(noun), pl. load cues

Properties

In addition to the properties listed here, load cue inherits properties from cue.

Elements

Commands

The load cue class responds to the following commands:

Superclass

The load cue class inherits elements and properties from the cue class.

mic cue

(noun), pl. mic cues

Properties

In addition to the properties listed here, mic cue inherits properties from cue.

Elements

Commands

The mic cue class responds to the following commands:

Superclass

The mic cue class inherits elements and properties from the cue class.

midi cue

(noun), pl. midi cues

Properties

In addition to the properties listed here, midi cue inherits properties from cue.

Elements

Commands

The midi cue class responds to the following commands:

Superclass

The midi cue class inherits elements and properties from the cue class.

midi file cue

(noun), pl. midi file cues

Properties

In addition to the properties listed here, midi file cue inherits properties from cue.

Elements

Commands

The midi file cue class responds to the following commands:

Superclass

The midi file cue class inherits elements and properties from the cue class.

network cue

(noun), pl. network cues

Properties

In addition to the properties listed here, network cue inherits properties from cue.

Elements

Commands

The network cue class responds to the following commands:

Superclass

The network cue class inherits elements and properties from the cue class.

override controller

(noun)

Properties

Where Used

The override controller class is used in the following ways:

• overrides property of the application class.

Examples

-- override MIDI output (i.e. "don't output any MIDI")
tell application id "com.figure53.QLab.5"
  tell overrides to set midi output enabled to false
end tell

-- open the override controls window
tell application "QLab" to tell overrides to set overrides visibility to true

preferences controller

(noun)

Properties

Where Used

The preferences controller class is used in the following ways:

• preferences property of the application class.

Example

-- turn on live fade preview
tell application id "com.figure53.QLab.5"
  tell preferences to set live fade preview to true
end tell

script cue

(noun), pl. script cues

Properties

In addition to the properties listed here, script cue inherits properties from cue.

Elements

Commands

The script cue class responds to the following commands:

Superclass

The script cue class inherits elements and properties from the cue class.

Where Used

The script cue class is used in the following ways:

• direct parameter to the compile command.

target cue

(noun), pl. target cues

Properties

In addition to the properties listed here, target cue inherits properties from cue.

Elements

Commands

The target cue class responds to the following commands:

Superclass

The target cue class inherits elements and properties from the cue class.

text cue

(noun), pl. text cues

Properties

In addition to the properties listed here, text cue inherits properties from cue.

Elements

Commands

The text cue class responds to the following commands:

Superclass

The text cue class inherits elements and properties from the cue class.

timecode cue

(noun), pl. timecode cues

Properties

In addition to the properties listed here, timecode cue inherits properties from cue.

Elements

Commands

The timecode cue class responds to the following commands:

Superclass

The timecode cue class inherits elements and properties from the cue class.

video cue

(noun), pl. video cues

Properties

In addition to the properties listed here, video cue inherits properties from cue.

Elements

Commands

The video cue class responds to the following commands:

Superclass

The video cue class inherits elements and properties from the cue class.

workspace

(noun), pl. workspaces

Properties

Elements

Commands

The workspace class responds to the following commands:

Where Used

The workspace class is used in the following ways:

• element of application class.
• direct parameter to the make command.

Enumerations

absolute relative

Constants

Where Used

The absolute relative enumeration is used in the following ways:

• audio fade mode property of the fade cue class.
• video fade mode property of the fade cue class.

clock types

Constants

Where Used

The clock types enumeration is used in the following ways:

• clock type property of the video cue class.

continue modes

Constants

Where Used

The continue modes enumeration is used in the following ways:

• continue mode property of the cue class.

enabled disabled

Constants

Where Used

The enabled disabled enumeration is used in the following ways:

• fade property of the midi cue class.
• hotkey trigger property of the cue class.
• integrated fade property of the audio cue class.
• integrated fade property of the video cue class.
• lock fade to cue property of the audio cue class.
• lock fade to cue property of the video cue class.
• midi trigger property of the cue class.
• preserve pitch property of the audio cue class.
• preserve pitch property of the video cue class.
• sync to timecode property of the cue list class.
• timecode trigger property of the cue class.
• wall clock trigger property of the cue class.

fill styles

Constants

Where Used

The fill styles enumeration is used in the following ways:

• fill style property of the video cue class.
• fill style property of the text cue class.
• fill style property of the camera cue class.

group modes

Constants

Where Used

The group modes enumeration is used in the following ways:

• mode property of the group cue class.

light dashboard view mode

Constants

Where Used

The light dashboard view mode enumeration is used in the following ways:

• dashboard mode property of the light dashboard class.

midi command

Constants

Where Used

The midi command enumeration is used in the following ways:

• command property of the midi cue class.
• midi command property of the cue class.

midi type

Constants

Where Used

The midi type enumeration is used in the following ways:

• message type property of the midi cue class.

mtc ltc

Constants

Where Used

The mtc ltc enumeration is used in the following ways:

• sync mode property of the cue list class.

smpte format

Constants

Where Used

The smpte format enumeration is used in the following ways:

• smpte format property of the cue list class.
• smpte format property of the midi list class.
• smpte format property of the timecode list class.

timecode start

Constants

Where Used

The timecode start enumeration is used in the following ways:

• timecode start behavior property of the cue list class.

timecode stop

Constants

Where Used

The timecode stop enumeration is used in the following ways:

• timecode stop behavior property of the cue list class.

Records

range record

A 2-item record representing the offset and length of a substring.

Properties

Where Used

The range record is used in the following ways:

• range property of the text format record.

rgba color record

A 4-item record representing red, green, blue, and alpha percentage values of a color.

Properties

Where Used

The rgba color record record is used in the following ways:

• backgroundRgbaColor property of the text format record.
• rgbaColor property of the text format record.
• strikethroughRgbaColor property of the text format record.
• underlineRgbaColor property of the text format record.

Examples

This script will set the color of all the text in cue 2 to a nice purple-y color:

tell application id "com.figure53.QLab.5" to tell front workspace
  set aNiceColor to {rgbaColor:{red:0.5, green:0.2, blue:0.6, alpha:1}}
  set text format of cue "2" to aNiceColor
end tell

This script will set the color of the underline of all the text in cue 2 to primary blue:

tell application id "com.figure53.QLab.5" to tell front workspace
  set aNiceColor to {underlineRgbaColor:{red:0, green:0, blue:1, alpha:1}}
  set text format of cue "2" to aNiceColor
end tell

row column record

A 2-item record representing a position defined by a numeric row and column value.

Properties

Where Used

The row column record is used in the following ways:

• cart position property of the cue class.

slice marker record

A 2-item record representing the play count and end time of a slice.

Properties

Where Used

The slice marker record record is used in the following ways:

• slice markers property of the audio cue class.
• slice markers property of the video cue class.

text format record

A record representing the formatting aspects of a text string.

Properties

Where Used

The text format record record is used in the following ways:

• live text format property of the text cue class.
• text format property of the text cue class.