Skip to content

Global Syntax

antoniondc edited this page Jul 1, 2025 · 1 revision

Applescript Utilities - Syntax

User Defined Variables

Many scripts also contain User Defined Variables. With these, when you call the script within Qlab, you can declare these variables globally and set them from within Qlab. This is particularly useful for using the same script for different purposes: e.g. you could have 2 versions of Fades/Create fade, one which creates a fade down and one a fade up. The syntax for this would be as follows:

global userLevel, userPrefix
set userLevel to 6
set userPrefix to "Fade up: "
global userLevel, userPrefix
set userLevel to -6
set userPrefix to "Fade down: "

Variables set within Qlab

Para a maioria dos scripts funcionarem dentro do seu projeto é preciso criar alguns variáveis via "Memo Cue" dentro do "Cue List" -> "Script Files" utilizando o nome e o campo de comentários

The total list of Qlab Note variables required for the entire script library is:

  • Output channel count [Quantidade usada de outputs, my default is 6]
  • Row count [Quantidade usada de input, default is 2]
  • Min audio level [?]
  • Output channel names [this should simply be a list separated by ", "]
  • Line Checks: output level [my default is -12]
  • Line Checks: sub level [my default is -12]

Many of these variables will stay the same for your template from show to show - some others depend on the design. These are set from within Qlab, as the notes of a cue.

Example

Using the example Levels/Bump level, the variables from Qlab are audioChannelCount and minAudioLevel.

To set these variables, you must set as a User Defined Variable variableCueListName. This is the cue list that you have stored your notes cues in. I recommend using Memo cues. In this instance, you would name one cue Output channel count and the other Min audio level. You do not need numbers for those cues.

Tags

  • @description Name of the script
  • @author Most recent author of the script
  • @link Link to the author's website
  • @source Where scripts are taken from another source, or adapted from one, that author is listed here
  • @version Version of the script
  • @testedmacos The most recent version of MacOS that the script has been tested on
  • @testedqlab The most recent version of Qlab that the script has been tested on
  • @about A description of the script
  • @separateprocess TRUE or FALSE, whether the script needs to run in a separate process within Qlab
  • @changelog Changes for this version of the script
Propiedades Tipo Valores

Table

Clone this wiki locally