File: vccuelist.html

package info (click to toggle)
qlcplus 4.14.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 58,644 kB
  • sloc: cpp: 182,867; javascript: 7,764; xml: 2,453; ansic: 2,120; sh: 1,716; python: 634; ruby: 606; makefile: 23
file content (241 lines) | stat: -rw-r--r-- 10,313 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Q Light Controller Plus - Virtual Console Cue List</TITLE>
<SCRIPT SRC="utility.js" TYPE="text/javascript"></SCRIPT>
<link href="style.css" rel="stylesheet" type="text/css" />
</HEAD>
<BODY onLoad="replaceqrc()">

<H1><IMG SRC="qrc:/cuelist.png" ALIGN="absmiddle"> Virtual Console Cue List</H1>

<P>
A Cue List provides a list of <A HREF="concept.html#Functions">Functions</A> that
you can step through with a single keyboard key. The Cue List is designed for
theatrical performances where the lighting operator needs only to follow the script
and toggle the next cue as the performance goes on.
</P>

<P>
The first column on the Cue List displays the cue number that runs from 1 to
infinity and beyond<A HREF="https://en.wikipedia.org/wiki/Buzz_Lightyear">*</A>.
The second column shows the individual <A HREF="concept.html#Functions">Function</A>
name that has been assigned to that particular cue.
</P>

<P>
<b>Please note</b> that only <A HREF="concept.html#Chaser">Chasers</A>
can be assigned to a Cue List, for the simple reason that the Chaser
is the only function with a duration. Since any other Function can be added
as a step to a Chaser with the <A HREF="chasereditor.html">Chaser Editor</A>,
it is simple to create the desired Cues by mixing <A HREF="concept.html#Scene">Scenes</A>,
<A HREF="concept.html#Collection">Collections</A>, and so on...
</P>

<H3>Configuration</H3>

<P>
Cue Lists can be configured with the object properties button
<IMG SRC="qrc:/edit.png" ALIGN="bottom"> found in the toolbar or
by double clicking on the Cue List widget.<br>
</P>

<TABLE BORDER=1 class="qlcTable">
 <TR>
  <TD>
   <B>Cue list name</B>
  </TD>
  <TD>
   Set the friendly name of the Cue List. The name appears as the Cue List's
   second column title.
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Cue list</B>
  </TD>
  <TD>
   <b>Chaser</b>: Select the <A HREF="concept.html#Chaser">Chaser</A>
   to associate with the Cue List.<br>
   <IMG SRC="qrc:/attach.png"> Associate a <A HREF="concept.html#Chaser">Chaser</A> with the Cue List using
   the <A HREF="selectfunction.html">Select Function</A> dialog.<br>
   <IMG SRC="qrc:/detach.png"> Detach the selected Chaser from the Cue List.<br><br>
   <b>Playback buttons layout</b>: Select how the playback can be controlled with the two available buttons.<br><br>
   <b>Behavior of the Next/Previous buttons when the chaser is not active</b>: Select the behaviour
   of the Next and Previous buttons when the Chaser is not running. Basically this option determines
   the action that should be taken when the Chaser is started for the first time or when the Chaser
   is stopped at any cue in the list.<br>
   The possible choices are:
   <UL>
    <LI>Run chaser from first/last cue (default): This is the default behaviour and it will run the Chaser
    with its original running order (Normal or Reverse)</LI>
    <LI>Run chaser from next/previous cue: Start the Chaser from the cue where it has been interrupted</LI>
    <LI>Select next/previous cue: This performs only a selection of a cue, without running the Chaser</LI>
    <LI>Do nothing: No action is taken in this case. This is useful when working only with the Play/Stop button</LI>
   </UL>
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Playback</B>
  </TD>
  <TD>
   You can select the key that you want to use to start/stop the selected cue in the Cue List
   with this option. The key combination is shown in the text field; if the
   field is empty, there is no key combination currently attached to the Cue List.
  </TD>
 <TR>
  <TD>
   <B>Next cue</B>
  </TD>
  <TD>
   You can select the key that you want to use to skip to the next cue in the Cue List
   with this option. The key combination is shown on the text field; if the
   field is empty, there is no key combination currently attached to the Cue List.
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Previous cue</B>
  </TD>
  <TD>
   You can select the key that you want to use to skip to the previous cue in the Cue List
   with this option. The key combination is shown on the text field; if the
   field is empty, there is no key combination currently attached to the Cue List.
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Side Fader</B>
  </TD>
  <TD>
   <B>Behaviour</B>: Select the behaviour of the side fader. 
   <UL>
    <LI>If "Crossfade" is selected, a fader will be displayed on the left side of the panel, 
     implementing the crossfade functionality between cues.</LI>
	<LI>If "Steps" is selected, a fader will be displayed on the left side of the panel,
     and its value will determine which cue of the Cue List to run.</LI>
   </UL>
  </TD>
 </TR>
</TABLE>

<br>
<H3>Operate mode</H3>

<P>
When switching QLC+ to <A HREF="concept.html#Modes">Operate Mode</A>, the Cue List will
become active, allowing the selection of the desired cues included in the associated Chaser.<br><br>
Pressing the ENTER key will start the selected cue.<br><br>
The following items are displayed at the bottom of the Cue List widget:<br><br>

<TABLE BORDER=1 class="qlcTable">
 <TR>
  <TD>
   <B>Cue progress bar</B>
  </TD>
  <TD>
   A progress bar showing the current running cue status.<br>
   When a fade in speed is set and is not set to "default" the bar will
   be colored in <span style="background-color:#63C10B">green</span>.<br>
   During the hold time the bar will be colored in <span style="background-color:#0F9BEC">blue</span>.
   The text displayed on the bar is the time remaining for the cue to end.<br>
   If the cue duration is set to infinite (&infin;), the bar will just display the fade in progress
   in <span style="background-color:#63C10B">green</span>.
  </TD>
 </TR>
 <TR>
  <TD><IMG src="qrc:/slider.png"></TD>
  <TD>When clicked, this button will open/close a side panel showing a fader to control 
   crossfade or step selection.<BR>
   (See next chapter for Crossfade details)
  </TD>
 </TR>
 <TR>
  <TD>
    <IMG src="qrc:/player_play.png"><BR>
    <IMG src="qrc:/player_pause.png"><BR>
    <IMG src="qrc:/player_stop.png">
  </TD>
  <TD>
    There are 3 playback states that a Cue list can assume: <b>running</b>, <b>paused</b> and <b>stopped</b>.<br>
    The layout of the playback control buttons can be decided in the configuration dialog, and the playback
    rules applied are always as follows:<br>

    <IMG src="qrc:/player_play.png"><br>
    When clicked from a stopped state, the playback starts from the currently selected cue. If no cue is
    selected, the playback starts from the first cue according to the associated Chaser running order.<br>
    Once clicked, the button icon changes depending on the chosen buttons layout, which could be "pause" or "stop".<br>
    When clicked from a paused state, the playback will be resumed from where it was left.<br><br>

    <IMG src="qrc:/player_pause.png"><br>
    When clicked, the playback of the currently running cues is paused, freezing everything that was running
    to the current state (lights will stay on, motors will stop moving, etc).<br>
    The button background will turn into a light blue, to indicate that clicking it again will resume
    the cue playback from where it was left.<br>
    <b>Note:</b> It is possible to pause fade in and hold phases, but not a fade out.<br><br>

    <IMG src="qrc:/player_stop.png"><br>
    When clicked, the currently running cue will be stopped, and the cue selection
    will stay on the last played cue. Any paused state will be reset and lights will be shut down.<br>
    If the buttons layout is "Play/Pause + Stop", pressing this button for the second time, will bring back
    the selected cue to the first cue of the Chaser (or the last if the running order is reversed)
  </TD>
 </TR>
 <TR>
  <TD><IMG src="qrc:/back.png"></TD>
  <TD>Go back to the previous cue in the Cue List, which will then be reproduced.
  When the top is reached, the previous cue will be the last cue of the Cue List</TD>
 </TR>
 <TR>
  <TD><IMG src="qrc:/forward.png"></TD>
  <TD>Go to the next cue in the Cue List, which will then be reproduced.
  When reaching the bottom, the next cue will be the first of the Cue List</TD>
 </TR>
</TABLE>

</P>

<br>
<H3>Crossfade</H3>

<P>
  The side fader can be used to manually control crossfade between two consecutive cues.<br>
  <br>
  The numbers at the top and bottom of the fader show the "current cue" and "next cue".<br>
  The label for the current cue has a <span style="background-color:#4E8DDE">blue label</span>.
  This will be at 100% when the playback of the Cue List is started.<br>
  The label for the next cue has an <span style="background-color:orange">orange label</span> and will be
  at 0% when the playback of the Cue List is started.<br>
  <br>
  When the Cue list is running, the crossfade fader controls the intensity of the associated cues,
  overriding their Fade In and Fade Out speeds and so allowing manual control of the transition.<br>
  <br>
  After the fader has been moved to the opposite end of its travel, the following changes take place:<br>
  <UL>
   <LI>The orange <span style="background-color:orange">next cue</span> label changes to
    <span style="background-color:#4E8DDE">blue</span>. This indicates that the old next cue
    has become the new current cue.</LI>
   <LI>The blue <span style="background-color:#4E8DDE">current cue</span> label changes to
    <span style="background-color:orange">orange</span> and the number of the cue is increased by 2.
    So this fader now controls the cue which comes after the old next cue.</LI>
  </UL>
</P>

<br>
<H3>Hint</H3>

<P>
When a cue is added to a Chaser using the <A HREF="chasereditor.html">Chaser Editor</A>, the default
duration is set to 0.<br>
To avoid the cues in the Cue List looping frantically without any result, set the duration
of your cues, either by double clicking on the duration field or by using the
Speed Dial widget<IMG src="qrc:/speed.png"><br>
Note that if you need scenes that you're going to crossfade manually with the
Cue List widget, you probably will want to set the duration of the cues to "infinite" (&infin;) using
the <a href="vcspeeddial.html">Speed Dial widget</a>. This can be enabled in the Chaser Editor by
clicking on the <IMG src="qrc:/speed.png"> button.
</P>

</BODY>
</HTML>