Set Level.applescript

---

description: Sets levels for cue(s) in QLab. Supports multiple columns and rows, absolute or relative dB. Prompt for delta optional. author: Antonio Nunes version: "1.3" source: testedqlab: "4.7" testedmacos: 10.15.7 separateprocess: "true"

Change Log

Version	Date	Author	Description
1.1
1.0	yyyy-mm-dd	YourName	Initial version

Overview

Utility for setting output/input levels for cues. Supports relative dB adjustment and user prompt for delta.

---

Usage

How to Run

1. Script Library:
   Add this script to ~/Library/Script Libraries/QLab and call it from QLab as:

set theScript to load script "/QLab/path/to/Script Name.scpt"
run theScript

Sempre use o path completo! paths repativos (~) não são aceitos dentro do qlab

2. Script Cue:
   Paste the script contents into a Script Cue in your QLab project.

---

Parameters / User Variables

Variable	Type	Default	Description
LEVEL_MATRIX_LIST	matriz	{{1, 1}, {2, 2}}	Define a posição onde o level deve atuar, coluna e linha. output 1 e 2
LEVEL_DB	number	0	volume do fade
LEVEL_RELATIVE	boleano	false	Soma o valor atual ou set um valor fixo
LEVEL_PROMPT_DELTA	boleano	false	exibe uma caixa de dialogo para colocar configurar o LEVEL_DB

• Where and how to set these (via Memo Cues, global variable, etc).

---

Example

Show a short code example (or screenshot if relevant) demonstrating how to use the script, including any required variables.

---

What It Does

• List out the steps the script takes or the operations performed.

• Point out any QLab features used (e.g., "Modifies all selected cues", "Creates a fade cue with specified parameters", etc).

• Mention any limitations or known issues.

---

Required QLab / macOS Version

• QLab: 4.0+ (or specify version)

• macOS: (list if relevant)

---

Related Scripts

• Add Fade.applescript

• Route cues to template.applescript

---

Credits

If adapted, credit the source/original author here.

getLevel v

getLevel [cue](applewebdata://0B0999A4-6301-4851-88A7-0870458477A7#QLab-Suite.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.

→ real : The value in decibels of the level at the specified location in the matrix.

setLevel v

setLevel [cue](applewebdata://0B0999A4-6301-4851-88A7-0870458477A7#QLab-Suite.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.

getGang v

getGang [cue](applewebdata://0B0999A4-6301-4851-88A7-0870458477A7#QLab-Suite.cue) : The cue for which you want to get 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.

→ text : The value of the gang at the specified location in the matrix.

setGang v

setGang [cue](applewebdata://0B0999A4-6301-4851-88A7-0870458477A7#QLab-Suite.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.

expand v : Expand the group cue in the cue list.

expand [group cue](applewebdata://0B0999A4-6301-4851-88A7-0870458477A7#QLab-Suite.group-cue) : The group that will expand in the cue list.

collapse v : Collapse the group cue in the cue list.

collapse [group cue](applewebdata://0B0999A4-6301-4851-88A7-0870458477A7#QLab-Suite.group-cue) : The group that will collapse in the cue list.