QLabSubtitles
One of the most labor-intensive tasks in QLab is creating a cue list for a lot of very similar cues, which vary only in their content. If you are doing a show in which you want to add subtitles (or supertitles or captions) to other video content using the same displays, you may have to program thousands of cues. Wouldn’t it be great to just have all the subtitles in a text file, hit one button, and before you have time to make a cup of coffee, have a performance-ready workspace automatically generated?
In this example, you need a plain text document with each of your titles on its own line. Open the example QLab workspace and your text file, press ⌃S (control-S), and the process begins.
Here is a screen recording of a solution in action. Best viewed full screen.
How It Works
Note: QLab 4’s Text cue was called the Titles cue in QLab 3. These examples were created using QLab 3, and so refers to Titles cues. The examples work just as well in QLab 4, though, so just replace “Titles cue” with “Text cue” and you’ll be all set.
The workspace uses three Script cues in a Group cue. The Script cues are contained in a separate cue list in the workspace.
The cue called “TITLES” imports the paragraphs of the text document into QLab Titles cues, using the font style set in Workspace Settings. The script counts the number of paragraphs in the text document and then creates one Titles cue for each paragraph, setting the text and the cue name each cue to the imported text.
tell application "TextEdit"
set thetext to the text of the front document
set thecount to the number of paragraphs in thetext
end tell
tell application id "com.figure53.qlab.3" to tell front workspace
repeat with i from 1 to thecount
make type "Titles"
set selectedCues to selected as list
set newCue to last item of (selected as list)
set thecuenumber to q number of newCue
set thetitle to paragraph i of thetext
set q name of newCue to thetitle
set the text of newCue to thetitle
end repeat
end tellThe cue called “MAKE” generates a Group cue that fades the old title and starts the new title and fades it in. Rich Walsh contributed several improvements to the first version of this.
At the top of the script are some variables you can edit to set the timing of the cues.
set userUpTime to 2 -- Time for images to fade up in
set userDownTime to 1 -- Time for images to fade down in
set userHoldTime to 0.5 -- Time to wait between starting fade down and starting fade up
-- Declarations
set notFirstCue to false
-- Main routine
tell application id "com.figure53.qlab.3" to tell front workspace
set selectedCues to every cue as list
repeat with eachCue in selectedCues
if q type of eachCue is "Titles" then -- Any other selected cues will be ignored; the sequence will end up after them
-- Make a fade out cue (not for the first cue)
if notFirstCue then
make type "Fade" -- Cue numbers and names not altered from QLab defaults
set fadeOutCue to last item of (selected as list)
set cue target of fadeOutCue to previousCue
set duration of fadeOutCue to userDownTime
set do opacity of fadeOutCue to true
set opacity of fadeOutCue to 0
set stop target when done of fadeOutCue to true
end if
-- Make a fade in cue
make type "Fade" -- Cue numbers and names not altered from QLab defaults
set fadeInCue to last item of (selected as list)
set opacity of eachCue to 0
set cue target of fadeInCue to eachCue
set pre wait of fadeInCue to userHoldTime
set duration of fadeInCue to userUpTime
set do opacity of fadeInCue to true
-- Make a Group Cue (have to do this here to get round QLab's auto-grouping of selections ≥ 2 cues)
make type "Group" -- Cue numbers not altered from QLab defaults
set groupCue to last item of (selected as list)
set mode of groupCue to fire_all
set q name of groupCue to "Crossfade to " & q list name of eachCue
-- Move cues into right place
move cue id (uniqueID of eachCue) of parent of eachCue to end of groupCue
if notFirstCue then move cue id (uniqueID of fadeOutCue) of parent of fadeOutCue to end of groupCue
move cue id (uniqueID of fadeInCue) of parent of fadeInCue to end of groupCue
-- Setup variables for next pass
set previousCue to eachCue
set notFirstCue to true
end if
end repeat
end tellThe cue called “NUMB” cleans up the numbering, numbering all the generated group cues sequentially.
tell application id "com.figure53.qlab.3" to tell front workspace
set thecuelist to current cue list
set selectedCues to every cue
repeat with eachCue in selectedCues
if q type of eachCue is in {"Group", "Titles", "Fade"} then
set the q number of eachCue to ""
end if
end repeat
set thecuenumber to 1
set selectedCues to every cue in front cue list whose q type is "Group"
repeat with eachCue in selectedCues
set the q number of eachCue to thecuenumber
set thecuenumber to thecuenumber \+ 1
end repeat
end tellMulti-line Subtitles
If you want to be able to have more than one line per title, you are in luck! A very small alteration to the TITLES script cue makes this possible.
tell application "TextEdit"
set thetext to the text of the front document
set thecount to the number of paragraphs in thetext
end tell
tell application id "com.figure53.qlab.3" to tell front workspace
repeat with i from 1 to thecount
make type "Titles"
set selectedCues to selected as list
set newCue to last item of (selected as list)
set thecuenumber to q number of newCue
set thetitle to paragraph i of thetext
set oldDelims to AppleScript's text item delimiters
set AppleScript's text item delimiters to {"/"}
set theparagraph to ""
set theItemCount to number of text items in thetitle
repeat with i from 1 to theItemCount
set theparagraph to theparagraph & (text item i of thetitle) & return
set q name of newCue to thetitle
set the text of newCue to theparagraph
end repeat
set AppleScript's text item delimiters to oldDelims
end repeat
end tellWhen each paragraph of your text file is read in, it is examined to see if it contains any forward slash ( / ) symbols. If it finds any, it adds a return before the next item of text. It does this by setting the text delimiters to the forward slash temporarily. Using this method, if your text file contains:
Subtitle 1/Subtitle2/Subtitle3/subtitle4
that will be rendered in a Titles cue as:
