QLab's AppleScript Dictionary

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.

The dictionary is 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.

Commands

clear

v

clear light dashboard : The Light Dashboard you want to clear.

Example use

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

Example use, alternate syntax

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

collapse

v : Collapse the Group cue in the cue list.

collapse Group cue : the Group cue that will collapse in the cue list.


collateAndStart

v

collateAndStart light cue : The Light cue you want to collate and start.


compile

v

compile script cue : The Script cue whose source you want to recompile.


expand

v : Expand the Group cue in the cue list.

expand Group cue : the Group cue that will expand in the cue list.


getGang

v

getGang cue : The cue for which you want to adjust the gang.
row integer : The row of the level matrix. Row 0 = the master and output levels.
column integer : The column of the level matrix. Column 0 = the master and input levels.
returns text : The value of the gang at the specified location in the matrix.


getLevel

v

getLevel cue : The cue for which you want to get the volume level.
row integer : The row of the level matrix. Row 0 = the master and output levels.
column integer : The column of the level matrix. Column 0 = the master and input levels.
returns real : The value in decibels of the level at the specified location in the matrix.


go

v : Make a workspace GO.

go specifier : The workspace to GO.


hardStop

v : Hard stop one or more cues or workspaces.

hardStop specifier : The cue(s) or workspace(s) to stop.


load

v : Load a cue or workspace to a given time.

load specifier : The cue(s) or workspace(s) to load. Because “load” is both a noun and a verb in QLab (load vs. Load cue), you need to place the specifier within parentheses.
[time real] : Load time.

Example uses:

  • load (cue "2") - loads the cue with cue number 2.
  • load (cue 2) - loads cue with cue ID 2.
  • load cue 2 - does not work! AppleScript interprets this as a reference to a Load cue with an extraneous, and thus error-causing, “2” hanging around.
  • load (cue "2") time 10 - loads cue number 2 to ten seconds from the beginning. If cue number 2 has no duration, then the time 10 part is ignored.

make

v

make workspace
type text : Name of the kind of cue you want to make. (Audio, Video, Camera, MIDI, etc.) Pass “cue list” to make a new cue list, or “cue cart” to make a new cue cart.


movePlayheadDown

v : Move the playhead to the next cue.

movePlayheadDown specifier : The workspace whose playhead will change.


movePlayheadDownASequence

v : Move the playhead to the top of the next cue sequence.

movePlayheadDownASequence specifier : The workspace whose playhead will change.


movePlayheadUp

v : Move the playhead to the previous cue.

movePlayheadUp specifier : The workspace whose playhead will change.


movePlayheadUpASequence

v : Move the playhead to the top of the previous cue sequence.

movePlayheadUpASequence specifier : The workspace whose playhead will change.


moveSelectionDown

v : Select the next cue.

moveSelectionDown specifier : The workspace whose selection will change.


moveSelectionUp

v : Select the previous cue.

moveSelectionUp specifier : The workspace whose selection will change.


newCueWithAll

v

newCueWithAll light dashboard : The Light Dashboard to which you want to add a new cue.


newCueWithChanges

v

newCueWithChanges light dashboard : The Light Dashboard to which you want to add a new cue.


panic

v : Panic one or more cues or workspaces.

panic specifier : The cue(s) or workspace(s) to panic.


pause

v : Pause one or more cues or workspaces.

pause specifier : The cue(s) or workspace(s) to pause.


preview

v : Preview one or more cues.

Previewing starts only the action of the cue, skipping any pre-wait and not continuing to other cues.
preview specifier : The cue(s) to preview.


prune

v

prune light cue : The Light cue whose command text you want to prune.


recordAllToLatest

v

recordAllToLatest light dashboard : The Light Dashboard to which you want to add a new cue.


recordAllToSelected

v

recordAllToSelected light dashboard : The Light Dashboard to which you want to add a new cue.


redo

v

redo specifier.


removeLightCommandsMatching

v : Remove existing light commands in the specified cue matching the command provided.

removeLightCommandsMatching cue : The cue for which you want to remove light level commands.
command text : The full text of the light level command you want to remove.


replaceLightCommand

v : Replace the provided light command text in the specified cue with new command text.

updateLightCommand cue : The old light level command text that will be replaced.
oldCommandText text : The instrument or group name (left side) of the light level command.
newCommandText text : The new light level command text that will replace the old one.


reset

v : Reset one or more cues or workspaces.

reset specifier : The cue(s) or workspace(s) to reset.


revert

v

revert light dashboard : The Light Dashboard in which you want to revert changes.


setGang

v

setGang cue : The cue for which you want to adjust the gang.
row integer : The row of the level matrix. Row 0 = the master and output levels.
column integer : The column of the level matrix. Column 0 = the master and input levels.
gang text : The gang value to set.


setLevel

v

setLevel cue : The cue for which you want to adjust the volume level.
row integer : The row of the level matrix. Row 0 = the master and output levels.
column integer : The column of the level matrix. Column 0 = the master and input levels.
db real : The decibel value for the volume level.


setLight

v : Add a light command to the specified cue or Light Dashboard in the form ‘selector’ = ‘value’. Selector can be the name of an instrument or group, with or without a value parameter.

setLight specifier : The cue or Light Dashboard for which you want to add a light level command.
selector text : The instrument or group name (left side) of the light level command.
value real or text : Optional parameter value (right side) of the light level command.

Example use

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

  -- set instrument "1" to 10% in the dashboard
  setLight theDashboard selector "1" value 10

  -- set instrument "backlight" to 50% over 5.3 seconds in the dashboard
  -- note: fade time always resets back to 0 after calling setLight
  set theFadeTime to 5.3
  set dashboard fade time of theDashboard to theFadeTime
  setLight theDashboard selector "backlight" value 50

  -- set instrument "5" to 25% in cue "30"
  setLight cue "30" selector "5" value "25"

end tell

start

v : Start one or more cues or workspaces.

start specifier : The cue(s) or workspace(s) to start. For a workspace, “start” means to unpause all paused cues.


stop

v : Stop one or more cues or workspaces.

stop specifier : The cue(s) or workspace(s) to stop.


undo

v

undo specifier.


updateLatestCue

v

updateLatestCue light dashboard : The Light Dashboard you want to update.


updateLightCommand

v : Update an existing light command in the specified cue. If the specified cue does not contain a selector for the instrument or group provided, then add the command.

NOTE: starting with QLab 4.4, use replaceLightCommand instead of updateLightCommand. updateLightCommand is deprecated and will be removed in a future version of QLab.

updateLightCommand cue : The cue for which you want to update a light level command.
selector text : The instrument or group name (left side) of the light level command.
value real : Optional parameter value (right side) of the light level command.


updateOriginatingCues

v

updateOriginatingCues light dashboard : The Light Dashboard you want to update.


updateSelectedCues

v

updateSelectedCues light dashboard : The Light Dashboard you want to update.

Classes

audio cue

n [inherits from cue] : An Audio Cue.

Properties

  • patch (integer) : Audio device patch number.
  • start time (real) : Time in the file where playback begins.
  • end time (real) : Time in the file where playback ends.
  • play count (integer) : Number of times the audio between the start and end times plays. Always >= 1.
  • infinite loop (boolean) : Does the cue loop infinitely?
  • rate (real) : Playback rate of the audio cue.
  • integrated fade (enabled|disabled) : State of the integrated fade - enabled or disabled.
  • lock fade to cue (enabled|disabled) : Whether the integrated fade should lock to the start/end times of the cue (enabled or disabled).
  • audio input channels (integer, r/o) : The number of audio input channels for the cue. (i.e. The number of distinct channels in the file.)
  • pitch shift (enabled|disabled) : Whether pitch shifting is enabled or disabled.
  • slice markers (list of slice marker record) : List of slice marker records.
  • last slice play count (integer) : Number of times the final slice plays. Always >= 1.
  • last slice infinite loop (boolean) : Does the last slice loop infinitely?

Responds to

  • getLevel, setLevel, getGang, setGang.

camera cue

n [inherits from cue] : A Camera Cue.

Properties

  • camera patch (integer) : Camera patch number.
  • layer (integer) : Display layer of the video.
  • full screen (boolean) : Is the cue displaying in full surface mode?
  • full surface (boolean) : Is the cue displaying in full surface mode?
  • preserve aspect ratio (boolean) : Does the cue preserve aspect ratio?
  • opacity (real) : Video opacity.
  • translation x (real) : Translation along the x axis.
  • translation y (real) : Translation along the y axis.
  • scale x (real) : Scale along the x axis.
  • scale y (real) : Scale along the y axis.
  • do video effect (boolean) : Apply a video effect?
  • custom quartz file (file) : The custom Quartz Composer file used to render this cue.

cue

n : A cue.

Elements

  • contains cues; contained by workspaces, cues.

Properties

  • uniqueID (text, r/o) : The unique ID of the cue.
  • parent (cue, r/o) : The parent cue of this cue.
  • parent list (cue, r/o) : The parent cue list (or cue cart) that contains this cue.
  • q type (text, r/o) : The name of this kind of cue, e.g. “Audio”, “Video”, “MIDI”, etc.
  • q number (text) : The number of the cue. Unique if present.
  • q name (text) : The name of the cue. Not unique.
  • q list name (text, r/o) : The name of the cue as displayed in the cue list. (i.e. Might be a default name.)
  • q display name (text, r/o) : The name of the cue as displayed in the standby view. (i.e. Never empty.)
  • q default name (text, r/o) : The name QLab would give the cue by default, if any.
  • q color (text) : The name of the cue color, or ‘none’ if not set.
  • notes (text) : The notes for this cue.
  • cue target (cue) : The cue this cue targets, if any.
  • file target (file) : The file this cue targets, if any.
  • pre wait (real) : The time in seconds before the action is triggered.
  • duration (real) : The duration of the cue’s action in seconds. Not editable for all cue types.
  • temp duration (real) : The temporary duration of the cue’s action in seconds. Not all cues allow editing the duration. Setting the temporary duration does not mark the document as edited. Reset the cue to go back to the original duration.
  • current duration (real, r/o) : The current active duration of the cue’s action in seconds. This property reflects the temporary duration, if it has been set. Otherwise it returns the cue’s duration.
  • post wait (real) : The time in seconds until continuing on to the next cue.
  • continue mode (do_not_continue, auto_continue, auto_follow) : Continue mode of the cue.
  • flagged (boolean) : Is this cue flagged?
  • autoload (boolean) : Does this cue auto load?
  • armed (boolean) : Is this cue armed?
  • hotkey trigger (enabled|disabled) : State of the HotKey trigger.
  • midi trigger (enabled|disabled) : State of the MIDI trigger.
  • midi command (note_on, note_off, program_change, control_change, key_pressure, channel_pressure, pitch_bend) : Type of MIDI command that will trigger the cue. (NOTE: pitch_bend messages are NOT accepted as remote MIDI triggers.)
  • midi byte one (integer) : Byte 1 of the MIDI trigger.
  • midi byte two (integer) : Byte 2 of the MIDI trigger.
  • midi byte one string (text) : Display String of Byte 1 of the MIDI trigger.
  • midi byte two string (text) : Display String of Byte 2 of the MIDI trigger.
  • timecode trigger (enabled|disabled) : State of the timecode trigger.
  • timecode show as timecode (boolean) : True if timecode trigger is shown as Timecode, false if shown as Real Time.
  • timecode hours (integer) : Hours field of the timecode trigger.
  • timecode minutes (integer) : Minutes field of the timecode trigger.
  • timecode seconds (integer) : Seconds field of the timecode trigger.
  • timecode frames (integer) : Frames field of the timecode trigger.
  • timecode bits (integer) : Bits field of the timecode trigger.
  • wall clock trigger (enabled|disabled) : State of the wall clock trigger.
  • wall clock hours (integer) : Hours field of the wall clock trigger.
  • wall clock minutes (integer) : Minutes field of the wall clock trigger.
  • wall clock seconds (integer) : Seconds field of the wall clock trigger.
  • loaded (boolean, r/o) : Is this cue loaded?
  • running (boolean, r/o) : Is this cue running?
  • paused (boolean, r/o) : Is this cue paused?
  • broken (boolean, r/o) : Is this cue broken?
  • pre wait elapsed (real, r/o) : The time in seconds that have elapsed on the pre wait.
  • action elapsed (real, r/o) : The time in seconds that have elapsed in the action of the cue.
  • post wait elapsed (real, r/o) : The time in seconds that have elapsed on the post wait.
  • percent pre wait elapsed (real, r/o) : The percent of the pre wait that has elapsed.
  • percent action elapsed (real, r/o) : The percent of the cue’s action that has elapsed.
  • percent post wait elapsed (real, r/o) : The percent of the post wait that has elapsed.

Responds to

  • load, preview, start, pause, stop, hardStop, reset, panic.

cue list

n [inherits from group cue > cue] : A cue list.

Elements

  • contained by workspaces.

Properties

  • playback position (cue) : The playback position (playhead) of this cue list is the cue that will start at the next GO.
  • playback position (cue) : The playhead (playback position) of this cue list is the cue that will start at the next GO.
  • sync to timecode (enabled|disabled) : Sync the cues in this cue list to incoming timecode.
  • sync mode (mtc, ltc) : Which kind of incoming timecode this cue list listens for.
  • smpte format (fps_24, fps_25, fps_30_drop, fps_30_non_drop) : SMPTE format of the incoming timecode.
  • mtc sync source name (text) : Name of the MIDI device which feeds us MTC timecode.
  • ltc sync channel (integer) : Audio channel that carries the LTC signal.

devamp cue

n [inherits from cue] : A Devamp Cue.

Properties

  • fire next cue when slice ends (boolean) : start the next cue at the moment the target slice ends?
  • stop target when slice ends (boolean) : Stop the target at the moment the target slice ends?

fade cue

n [inherits from cue] : A Fade Cue.

Properties

  • fade mode (absolute, relative) : Absolute or relative mode.
  • audio fade mode (absolute/‌relative) : Audio Levels absolute or relative mode.
  • video fade mode (absolute/‌relative) : Video Geometry absolute or relative mode.
  • stop target when done (boolean) : Stop the target when this cue completes?
  • opacity (real) : Video opacity.
  • translation x (real) : Translation along the x axis.
  • translation y (real) : Translation along the y axis.
  • scale x (real) : Scale along the x axis.
  • scale y (real) : Scale along the y axis.
  • preserve aspect ratio (boolean) : Does the cue preserve aspect ratio?
  • rotation type (integer) : 3D orientation (0), x-axis (1), y-axis (2), or z-axis (3).
  • rotation (real) : Rotation in degrees when the cue ‘rotation type’ is set to a single-axis value (1, 2, or 3). Returns 0.0 when ‘rotation type’ is 3D orientation (0).
  • do opacity (boolean) : Does the cue animate opacity?
  • do translation (boolean) : Does the cue animate translation?
  • do scale (boolean) : Does the cue animate scale?
  • do rotation (boolean) : Does the cue animate rotation?

Responds to

  • getLevel, setLevel, getGang, setGang.

group cue

n [inherits from cue] : A Group Cue.

Properties

  • mode (cue_list, timeline, fire_first_enter_group, fire_first_go_to_next_cue, fire_random) : The start style of this group.

light cue

n [inherits from cue] : A Light Cue.

Properties

  • command text (text) : The light cue command text.
  • always collate (boolean) : Flag for whether this cue should always collate the effects of previous light cues in the same list when it runs.

Responds to

  • flatten, prune, safeSort, collateAndStart, setLight, replaceLightCommand, updateLightCommand, removeLightCommandsMatching.

light dashboard

n [inherits from item]

Properties

  • dashboard visibility (boolean) : Whether the Light Dashboard is currently visible.
  • dashboard mode (sliders/‌tiles) : The view mode of the Light Dashboard.
  • dashboard fade time (real) : The duration in seconds over which the next light command entered will fade from current to new level(s). Resets to 0.0 after each light command.

Responds to

  • setLight, clear, updateLatestCue, updateOriginatingCues, updateSelectedCues, newCueWithAll, newCueWithChanges, recordAllToLatest, recordAllToSelected, revert, redo, undo.

Example use

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

  -- change display mode
  set theMode to dashboard mode of theDashboard
  set dashboard mode of theDashboard to sliders
  set dashboard mode of theDashboard to tiles

  -- toggle visibility
  set theVisibility to dashboard visibility of theDashboard
  set dashboard visibility of theDashboard to not theVisibility

end tell

load cue

n [inherits from cue] : A Load Cue.

Properties

  • load time (real) : Load target cue to this time.

mic cue

n [inherits from cue] : A Microphone Cue.

Properties

  • patch (integer) : Audio device patch number.
  • audio input channels (integer, r/o) : The number of audio input channels for the cue.

Responds to

  • getLevel, setLevel, getGang, setGang.

midi cue

n [inherits from cue] : A MIDI Cue.

Properties

  • patch (integer) : MIDI device patch number.
  • message type (voice, msc, sysex) : The type of MIDI message.
  • command (note_on, note_off, program_change, control_change, key_pressure, channel_pressure, pitch_bend) : The MIDI command.
  • channel (integer) : MIDI channel number.
  • byte one (integer) : First byte of the message.
  • byte two (integer or string) : Second byte of the message. Since QLab accepts greater-than and less-than expressions, and “any”, as acceptable values for the second byte of some MIDI messages, this property can be sent as a string. If the current value of the property is a string, you must use a string in AppleScript to set the value.
  • byte combo (integer) : Value when first and second bytes are interpreted as parts of one number. Used for pitch bend messages.
  • start value (integer, r, o) : The start value for the MIDI fade.
  • end value (integer) : The end value for the MIDI fade.
  • fade (enabled|disabled) : State of the MIDI fade.
  • deviceID (integer) : MIDI Show Control device ID.
  • command format (integer) : MIDI Show Control command format.
  • command number (integer) : MIDI Show Control command.
  • q_number (text) : Q Number message parameter.
  • q_list (text) : Q List message parameter.
  • q_path (text) : Q Path message parameter.
  • macro (integer) : MSC macro.
  • control number (integer) : MSC control number.
  • control value (integer) : MSC control value.
  • hours (integer) : MSC hours parameter.
  • minutes (integer) : MSC minutes parameter.
  • seconds (integer) : MSC seconds parameter.
  • frames (integer) : MSC frames parameter.
  • subframes (integer) : MSC subframes parameter.
  • smpte format (fps_24, fps_25, fps_30_drop, fps_30_non_drop) : SMPTE format of the timecode parameters.
  • send time with set (boolean) : Send the timecode parameters with the SET command?
  • sysex message (text) : The raw SysEx message. Use only hexadecimal characters and whitespace. Omit the starting F0 and the ending F7.

midi file cue

n [inherits from cue] : A MIDI File Cue.

Properties

  • patch (integer) : MIDI device patch number.
  • rate (real) : Playback rate of the MIDI File cue.

network cue

n [inherits from cue] : A Network Cue.

Properties

  • custom message (text) : The custom OSC message, for custom type messages.
  • osc message type (text) : The type of OSC message. Can be: qlab, custom, or udp.
  • patch (integer) : Network destination patch number.
  • q_command (number) : The QLab OSC command, for QLab type messages.
  • q_num (text) : The QLab cue number, for QLab type messages.
  • q_params (text) : The QLab command parameters, for QLab type messages. Not all messages have parameters.
  • udp message (text) : The raw UDP message, for udp type messages.

overrides

n [inherits from item]

Properties

  • overrides visibility (boolean) : Whether the Override Controls window is currently visible.
  • midi input enabled (boolean) : Allow musical MIDI input (default ON)
  • midi output enabled (boolean) : Allow musical MIDI output (default ON)
  • msc output enabled (boolean) : Allow MSC output (default ON)
  • msc input enabled (boolean) : Allow MSC input (default ON)
  • sysex input enabled (boolean) : Allow SysEx (other than MSC and MTC) input (default ON)
  • sysex output enabled (boolean) : Allow SysEx (other than MSC and MTC) output (default ON)
  • osc input enabled (boolean) : Allow OSC input (default ON)
  • osc output enabled (boolean) : Allow OSC output (default ON)
  • timecode input enabled (boolean) : Allow timecode input (default ON)
  • timecode output enabled (boolean) : Allow timecode output (default ON)
  • artnet enabled (boolean) : Allow Art-Net input and output (default ON)

Example use

tell application id "com.figure53.QLab.4"
    set midi input enabled of overrides to false
end tell

preferences

n [inherits from item]

Properties

  • live fade preview (boolean) : Live Fade Preview

Example use

tell application id "com.figure53.QLab.4"
    set live fade preview of preferences to true
end tell

script cue

n [inherits from cue] : A Script Cue.

Properties

  • script source (text) : AppleScript source for the cue. The script will be recompiled when set.

Responds to

  • compile.

target cue

n [inherits from cue] : A Target Cue.

Properties

  • assigned number (text) : Number of cue to assign. The cue with this number will be assigned as the new target.

text cue

n [inherits from video cue > cue] : A Text Cue.

Properties

  • text (text) : Text of the Text cue.
  • live text (text) : Live text of the Text cue. Setting this does not mark the workspace as edited.
  • text format (list of text format record) : The list of text formats in the text.
  • live text format (list of text format record) : The list of text formats in the live text. Setting this does not mark the workspace as edited.
  • text alignment (text) : Text alignment of the text cue. Possible values are “left”, “center”, “right”, and “justify”.
  • live text alignment (text) : Text alignment of the live text of the text cue. Possible values are “left”, “center”, “right”, and “justify”. Setting this does not mark the workspace as edited.
  • layer (integer) : Display layer of the video.
  • full screen (boolean) : Is the cue displaying in full surface mode?
  • full surface (boolean) : Is the cue displaying in full surface mode?
  • preserve aspect ratio (boolean) : Does the cue preserve aspect ratio?
  • opacity (real) : Video opacity.
  • translation x (real) : Translation along the x axis.
  • translation y (real) : Translation along the y axis.
  • scale x (real) : Scale along the x axis.
  • scale y (real) : Scale along the y axis.
  • do video effect (boolean) : Apply a video effect?
  • custom quartz file (file) : The custom Quartz Composer file used to render this cue.
  • fixed width (number) : Fixed width of the text cue. Setting this to 0 specifies ‘auto’ width.
  • text output size (list of number, r/o) : A 2-item list representing the width and height of the text of the text cue.
  • live text output size (list of number, r/o) : A 2-item list representing the width and height of the live text of the text cue.

timecode cue

n [inherits from cue] : A Timecode Cue to generate MTC or LTC timecode.

Properties

  • patch (integer) : MIDI destination patch number.
  • smpte format (fps_24, fps_25, fps_30_drop, fps_30_non_drop) : SMPTE format of the outgoing timecode.
  • start time offset (real) : Time in seconds where the MTC clock begins counting.

video cue

n [inherits from cue] : A Video Cue.

Properties

  • patch (integer) : Audio device patch number.
  • start time (real) : Time in the file where playback begins.
  • end time (real) : Time in the file where playback ends.
  • infinite loop (boolean) : Does the cue loop infinitely?
  • rate (real) : Playback rate of the video cue.
  • layer (integer) : Display layer of the video.
  • full screen (boolean) : Is the cue displaying in full screen mode?
  • preserve aspect ratio (boolean) : Does the cue preserve aspect ratio?
  • opacity (real) : Video opacity.
  • translation x (real) : Translation along the x axis.
  • translation y (real) : Translation along the y axis.
  • scale x (real) : Scale along the x axis.
  • scale y (real) : Scale along the y axis.
  • do video effect (boolean) : Apply a video effect?
  • custom quartz file (file) : The custom Quartz Composer file used to render this cue.
  • audio input channels (integer, r/o) : The number of audio input channels for the cue. (i.e. The number of distinct channels in the file.)
  • integrated fade (enabled|‌disabled) : State of the integrated fade (enabled or disabled).
  • lock fade to cue (enabled|‌disabled) : Whether the integrated fade should lock to the start/end times of the cue (enabled or disabled).
  • pitch shift (enabled|disabled) : Whether pitch shifting is enabled or disabled.
  • hold at end (boolean) : Should the final frame of the video be left visible when playback reaches the end of the file?
  • slice markers (list of slice marker record) : List of slice marker records.
  • last slice play count (integer) : Number of times the final slice plays. Always >= 1.
  • last slice infinite loop (boolean) : Does the last slice loop infinitely?

Responds to

  • getLevel, setLevel, getGang, setGang.

workspace

n [inherits from document] : A QLab workspace.

Elements

  • contains cue lists, cues.

Properties

  • unique id (text, r/o) : The unique ID of the workspace.
  • current cue list (cue list) : The currently visible cue list for the workspace.
  • selected (list of cue) : The currently selected cue(s) in the currently visible cue list.
  • active cues (list of cue, r/o) : The list of active cues (running or paused) in this workspace.
  • edit mode (boolean) : Is the workspace currently in edit mode?
  • show mode (boolean) : Is the workspace currently in show mode?

Responds to

  • make, load, go, start, pause, stop, hardStop, reset, panic, moveSelectionUp, moveSelectionDown.

Enumerations

absolute relative

enum : The fade mode of a Fade cue or the audio or video component of a Fade cue.

  • absolute : absolute fade mode
  • relative : relative fade mode

continue modes

enum : The continue mode of a cue.

  • do_not_continue : Do not automatically continue to the next cue.
  • auto_continue : Automatically continue to the next cue after completing the post wait.
  • auto_follow : Automatically continue to the next cue after completing the action of the cue.

enabled disabled

enum : Any of several cue properties.

  • enabled : Enable the property/check the checkbox.
  • disabled : Disable the property/uncheck the checkbox.

group modes

enum : The mode of a Group cue.

  • cue_list : The group is a cue list.
  • fire_first_enter_group : start first child and enter into group.
  • fire_first_go_to_next_cue : start first child and go to next cue.
  • fire_random : start a random child cue and then go to the next cue.
  • timeline : Timeline - start all children simultaneously.

light dashboard view mode

enum

  • sliders : Slider view.
  • tiles : Tile view.

midi command

enum

  • note_on : Note on.
  • note_off : Note off.
  • program_change : Program change.
  • control_change : Control change.
  • key_pressure : Key pressure (aftertouch).
  • channel_pressure : Channel pressure.
  • pitch_bend : Pitch bend (pitch wheel).

midi type

enum

  • voice : MIDI Voice message (“Musical MIDI”).
  • msc : MIDI Show Control message.
  • sysex : MIDI Sysex message.

mtc ltc

enum

  • mtc : MIDI Timecode
  • ltc : Linear / Logitudinal Timecode

smpte format

enum : SMPTE timecode format.

  • fps_24 : 24 frames per second
  • fps_25 : 25 frames per second
  • fps_30_drop : 30 frames per second (drop frame)
  • fps_30_non_drop : 30 frames per second (non-drop)

Records

range record

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

Properties

  • rangeOffset (integer or text) : The 1-indexed location of the starting character of a substring range.
  • rangeLength (integer or text) : The length of the substring range.

rgba color record

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

Properties

  • red (real)
  • green (real)
  • blue (real)
  • alpha (real)

slice marker record

n

Properties

  • time (real) : The slice marker time (which is also the end time of a slice).
  • playCount (integer) : The number of times a slice will play. Play count -1 = infinite loop.

text format record

n

Properties

  • fontFamily (text) : The font family for this format. (e.g. “Helvetica”, “Courier New”)
  • fontStyle (text) : The font style (face) for this format. (e.g. “Regular”, “Light Oblique”)
  • fontName (text) : The font name for this format. (e.g. “CourierNewPS-BoldItalicMT”)
  • fontSize (real) : The font size for this format.
  • lineSpacing (real) : The line spacing for this format.
  • rgbaColor (rgba color record) : An RGBA color record representing the percentage values for the red, green, blue, and alpha components of the text color of this format.
  • backgroundRgbaColor (rgba color record) : An RGBA color record representing the percentage values for the red, green, blue, and alpha components of the background color of this format.
  • strikethroughStyle (text) : The strikethrough style of this format. Possible values are “none”, “single”, and “double”.
  • strikethroughRgbaColor (rgba color record) : An RGBA color record representing the percentage values for the red, green, blue, and alpha components of the strikethrough color of this format.
  • underlineStyle (text) : The underline style of this format. Possible values are “none”, “single”, and “double”.
  • underlineRgbaColor (rgba color record) : An RGBA color record representing the percentage values for the red, green, blue, and alpha components of the underline color of this format.
  • range (range record) : A range record representing the index and length for the substring that has this format.
  • wordIndex (integer) : An optional 1-indexed word number to which this format should be applied. When used, the “range” property will be ignored. (setting only)

Still have a question?

Our support team is always happy to help.

Business Hours
M-F 9am-7pm (ET)
Current time at our headquarters