File: efxeditor.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 (265 lines) | stat: -rw-r--r-- 8,248 bytes parent folder | download | duplicates (3)
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
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Q Light Controller Plus - EFX Editor</TITLE>
<SCRIPT SRC="utility.js" TYPE="text/javascript"></SCRIPT>
<link href="style.css" rel="stylesheet" type="text/css" />
</HEAD>
<BODY onLoad="replaceqrc()">

<H1>EFX Editor</H1>
<P>
The EFX editor, as its name suggests, is used to edit
<IMG SRC="qrc:/efx.png" align="absmiddle"> <A HREF="concept.html#EFX">EFX</A> functions.
The view is split into two tabs:
</P>
<UL>
 <LI><B>General</B> tab is for selecting <A HREF="concept.html#Fixtures">Fixtures</A>, speed and fixture order.</LI>
 <LI><B>Movement</B> tab is for selecting details on how the fixtures should move their beams.</LI>
</UL>

<H3 id="general-tab">General Tab Controls</H3>

<P>
<IMG SRC="../images/efx-general.png" />
</P>

<TABLE BORDER=1 class="qlcTable">
 <TR>
  <TD>
   <img src="qrc:/speed.png" />
  </TD>
  <TD>
    Adjust the EFX speed settings:
    <P>
      <LI><B>Fade In:</B> Not used currently</LI>
      <LI><B>Fade Out:</B> Not used currently</LI>
      <LI><B>Duration:</B> The duration of one full round using the selected pattern</LI>
    </P>
  </TD>
 </TR>
 <TR>
  <TD>
   <img src="qrc:/player_play.png" />
  </TD>
  <TD>
   Enable the output and run the EFX to test how it looks like
  </TD>
 </TR>
 <TR>
  <TD>
   <B>EFX name</B>
  </TD>
  <TD>
   Change the name of the EFX.
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Fixture list</B>
  </TD>
  <TD>
   <UL>
    <LI>Step: Shows the order in which the fixtures start their movement in serial/asymmetric order</LI>
    <LI>Fixture: The name of each fixture that has been added to the EFX</LI>
    <LI>Mode: The channels the EFX should control. They can be <b>Position</b>, <B>Dimmer</B> or <B>RGB</B><BR>
        Note: when selecting RGB, you might want to enable the "Color Background" described below.
    </LI>
    <LI>Reverse: When checked, the fixture reverses its movement as opposed to non-reversed fixtures. The "normal" direction
        is set by direction in the "Movement" page.</LI>
    <LI>Start Offset: Value in degrees, where on the movement path this fixture should start</LI>
   </UL>
  </TD>
 </TR>
 <TR>
  <TD>
   <IMG SRC="qrc:/edit_add.png">
  </TD>
  <TD>
   Add a <A HREF="concept.html#Fixtures">Fixture</A> to the EFX, after the
   currently selected position. Since EFX is used for moving the head or mirror
   of an intelligent fixture, only fixtures with <B>pan and tilt</B> capability
   (8bit or 16bit) can be added to an EFX.
  </TD>
 </TR>
 <TR>
  <TD>
   <IMG SRC="qrc:/edit_remove.png">
  </TD>
  <TD>
   Remove the selected fixtures from the EFX.
  </TD>
 </TR>
 <TR>
  <TD>
   <IMG SRC="qrc:/up.png">
  </TD>
  <TD>
   Raise the selected fixture upwards (earlier) in serial order.
  </TD>
 </TR>
 <TR>
  <TD>
   <IMG SRC="qrc:/down.png">
  </TD>
  <TD>
   Lower the selected fixture downwards (later) in serial order.
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Fixture order</B>
  </TD>
  <TD>
   Change the EFX's fixture order&mdash;see below.
  </TD>
 </TR>
</TABLE>

<H3 id="movement-tab">Movement Tab Controls</H3>

<P>
<IMG SRC="../images/efx-movement.png" />
</P>

<TABLE BORDER=1 class="qlcTable">
 <TR>
  <TD>
   <B>Pattern area</B>
  </TD>
  <TD>
   <P>Shows a 2D-projection of the fixtures' head/mirror movement. Every time you
   change a parameter, one small dot for each fixture travels the complete path in its selected direction
   from its start offset.</P>
   <P>The speed of the movement reflects selected speed settings.</P>
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Direction</B>
  </TD>
  <TD>
   Default direction of the fixtures (can be altered individually for each fixture by the checkbox in the <B>Reverse</B> column)
   <UL>
    <LI>Forward: The fixtures move forwards along the pattern path</LI>
    <LI>Backward: The fixtures move backwards along the pattern path</LI>
   </UL>
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Run order</B>
  </TD>
  <TD>
   <UL>
    <LI>Loop: Run thru the steps over and over again.</LI>
    <LI>Single Shot: Run thru the steps once and then stop.</LI>
    <LI>Ping Pong: Run thru the steps over and over again, reversing direction at both ends.</LI>
   </UL>
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Pattern</B>
  </TD>
  <TD>
   Select the movement pattern algorithm.
   <UL>
    <LI>Circle</LI>
    <LI>Eight</LI>
    <LI>Line: goes from one end to the other and back; faster in the middle, slower at the ends</LI>
    <LI>Line2: goes in one direction only; speed is always the same</LI>
    <LI>Diamond</LI>
    <LI>Square</LI>
    <LI>SquareChoppy</LI>
    <LI>Leaf</LI>
    <LI>Lissajous</LI>
   </UL>
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Parameters</B>
  </TD>
  <TD>
   <UL>
    <LI>Width: Choose the pan width (0-255)</LI>
    <LI>Height: Choose the tilt height (0-255)</LI>
    <LI>X Offset: Move the pattern's horizontal (pan) centerpoint (0-255)</LI>
    <LI>Y Offset: Move the pattern's vertical (tilt) centerpoint (0-255)</LI>
    <LI>Rotation: Rotate the pattern along its axis (0-360 degrees)</LI>
    <LI>Start Offset: Where along the path the movement should start (0-360 degrees)</LI>
    <LI>X Frequency: Change the <B>Lissajous</B> pattern's X (horizontal) frequency (0-32)</LI>
    <LI>Y Frequency: Change the <B>Lissajous</B> pattern's Y (vertical) frequency (0-32)</LI>
    <LI>X Phase: Change the <B>Lissajous</B> pattern's X (horizontal) phase (0-360 degrees)</LI>
    <LI>Y Phase: Change the <B>Lissajous</B> pattern's Y (vertical) phase (0-360 degrees)</LI>
   </UL>
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Color Bacground</B>
  </TD>
  <TD>When enabled, the EFX preview background will display a RGB palette, to show what the EFX does
      when controlling RGB channels
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Relative</B>
  </TD>
  <TD>
   See below.
  </TD>
 </TR>
</TABLE>

<H3 id="fixture-order">Fixture Order</H3>

<P>
Fixtures taking part in an EFX function can be set to follow the algorithm in certain order:
</P>
<LI><B>Parallel:</B> all fixtures follow the same pattern synchronously</LI>
<LI><B>Serial:</B> fixtures start following the pattern one after the other, with a
little delay between each of them.</LI>
<LI><B>Asymmetric:</B> all fixtures start moving simultaneously, but with similar offset as
in the Serial mode.</LI>
</P>

<H3 id="direction">Direction</H3>

<P>
EFX functions' direction can be reversed for all fixtures at once or on a
per-fixture basis. The function can also be set to do an infinite loop, an
infinite ping-pong-loop (direction is reversed after each pass) or it can run
through just once, in a single-shot mode, after which it terminates by itself.
If the function is set to do an infinite loop, it must be stopped manually.
</P>

<H3 id="relative-mode">Relative Mode</H3>

<P>EFX position is absolute by default-in other words, the selected EFX will exclusively control the X/Y position
of the specified heads. When the Relative Mode checkbox is enabled, the EFX position acts as a layer on top of any
position that has already been set (e.g. by a scene or even another EFX). In other words, the EFX is relative to
current fixture position.
</P>

<P>In absolute mode. the EFX can be set to run at specific head position (e. g. do circle downstage center, stage left, etc.)

<P>In relative mode, the center of the preview window (offset x=127, offset y=127) will be applied to current head position.</P>

<P>It is useful to reduce number of EFX presets: let's say we want to have 3 types of EFX (pan saw, tilt saw, circle) at 4 places
(e.g. 4 stage corners). In absolute mode that means 3x4 = 12 presets. If we want to change something, we have to edit many functions.
We most probably need also one VC button for each. In relative mode, we create one EFX preset for each EFX type (pan saw, tilt saw, circle),
and we set offset to neutral (x=127, y=127). Then, we create scenes with PAN & TILT channels for each position. Now we have only 3+4 presets
(and 3+4 VC buttons, preferably in 2 solo frames).
</P>

<P><B>Tips&amp;Tricks</B></P>

<P>In relative mode, it is also possible to fade between positions (set fade time in scenes) while the EFX is running.</P>

<P>Using XYPad and relative mode, it is possible to move EFX to any place during the show.</P>

</BODY>
</HTML>