File: vcmatrix.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 (182 lines) | stat: -rw-r--r-- 6,809 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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Q Light Controller Plus - Virtual Console Animation</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:/animation.png" ALIGN="absmiddle"> Virtual Console Animation</H1>

<P>An Animation widget is a complete tool to operate with the
<A HREF="concept.html#Function">RGB Matrices</A> of your project.<br>
It displays several graphical elements to fully control a matrix during live shows.<br>
Most importantly, it allows you to define a number of so called "custom controls"
to quickly recall presets, colors and properties and apply them immediately to a
running matrix.
</P>

<H2>Introduction</H2>

When clicking on the <img src="qrc:/animation.png"> icon, an Animation widget will be
added to your Virtual Console.<br>
By default, the widget will display 4 elements:

<UL>
 <LI>On the leftmost side, a slider to control the playback and the intensity of a RGB Matrix.<br>
     The slider movement can be associated to an external controller input line.<br>
     It behaves exactly like a <A HREF="vcslider.html">Virtual Console Slider</A> in playback mode.
 </LI>
 <LI>On the top right side, two <A HREF="concept.html#ClickAndGo">Click &amp; Go</A> buttons
     to set the matrix start and end color. When clicking on them during the
     <A HREF="concept.html#Modes">Operate Mode</A>, a color picker menu will be displayed.
 </LI>
 <LI>Below the two buttons, a drop down menu to select the desired Matrix animation or preset.
 </LI>
</UL>

The space below the animation menu, is reserved for Custom Controls. They can be defined in the
widget configuration window and each of them will be displayed as a single button.<br>
Each custom control can be associated to a key combination or an external controller input line.
</P>

<H2>Configuration</H2>

<P>
An Animation widget can be configured with the properties
<IMG SRC="qrc:/edit.png" ALIGN="bottom"> button found in the Virtual Console toolbar or
by double clicking the widget itself.
</P>

<H3>General Page</H3>

<TABLE BORDER=1 class="qlcTable">
 <TR>
  <TD>
   <B>Widget name</B>
  </TD>
  <TD>
   Set the friendly name of the widget, displayed above the two Click &amp; Go buttons
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Matrix Function</B>
  </TD>
  <TD>
   Shows you the name of the <A HREF="concept.html#RGBMatrix">RGB Matrix</A> Function that
   is currently assigned to the widget.
   <P>
    <IMG SRC="qrc:/attach.png" ALIGN="absmiddle"> Attach a RGB Matrix Function to the widget<BR>
    <IMG SRC="qrc:/detach.png" ALIGN="absmiddle"> Detach the current function from the widget
   </P>
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Apply color and preset changes immediately</B>
  </TD>
  <TD>Select whether the changes to the Matrix must be applied immediately or at the next Matrix loop
  </TD>
 </TR>
 <TR>
  <TD><B>External input</B></TD>
  <TD>
   You can attach an external input channel from an input device (like a slider
   board) to the widget slider so that you don't always have to use the mouse or touch screen
   to control the Matrix playback or intensity.
   <UL>
    <LI>Input universe: The input universe from which you wish to get input data for
    the slider.</LI>
    <LI>Input channel: The individual input channel within the selected input
    universe that you wish to use for controlling the slider.</LI>
    <LI>Auto Detect: When toggled, you can just move/press a button/slider/knob
    on your external input hardware and it will be automatically assigned to the
    slider. The latest combination is shown on the text boxes when QLC+ receives
    input data. If you don't see anything in the boxes, your input connection
    might have a problem that you need to fix first.</LI>
    <LI>Choose...: Shows the <A HREF="selectinputchannel.html">Select Input Channel</A>
    dialog that you can use to select an input channel manually.</LI>
   </UL>
  </TD>
 </TR>
</TABLE>

<H3>Custom Controls Page</H3>

<P>
A custom control is a "shortcut" to a functionality of a RGB Matrix.<br>
Basically you can control all the options that are normally used in the
<A HREF="rgbmatrixeditor.html">RGB Matrix Editor</A> during the design
phase of a show. The only option you can't control is the Fixture group
used by a RGB Matrix Function.<br>
In this configuration page the user can define any number of custom controls
depending on the needs during a live performance.<br>
Each custom control is represented as a button in the Animation widget layout
and can be either clicked with the mouse or pressed on a touchscreen, or
associated to a key combination or an external controller input line.
</P>

<TABLE BORDER=1 class="qlcTable">
 <TR>
  <TD>
   <B><img src="qrc:/color.png" ALIGN="absmiddle"> Add start color</B>
  </TD>
  <TD>Add a Matrix start color control. When clicking this button,
   a color selection tool will be displayed.<br>
   The button displayed in the widget's layout will have a background color
   representing the one selected and the letter <B>S</B>.
  </TD>
 </TR>
 <TR>
  <TD>
   <B><img src="qrc:/color.png" ALIGN="absmiddle"> Add end color</B>
  </TD>
  <TD>Add a Matrix end color control. When clicking this button,
   a color selection tool will be displayed.<br>
   The button displayed in the widget's layout will have a background color
   representing the one selected and the letter <B>E</B>.
  </TD>
 </TR>
 <TR>
  <TD>
   <B><img src="qrc:/fileclose.png" ALIGN="absmiddle"> Add end color reset</B>
  </TD>
  <TD>Add a Matrix end color reset control.<br>
   The button displayed in the widget's layout will have a gray background color
   and when pressed, it will reset the current matrix end color (if previously set)
  </TD>
 </TR>
 <TR>
  <TD>
   <B><img src="qrc:/script.png" ALIGN="absmiddle"> Add preset</B>
  </TD>
  <TD>Add a Matrix preset control. When clicking this button,
   a dialog will be displayed for the preset selection.<br>
   The button displayed in the widget's layout will have a gray background color
   and a label corresponding to the preset's name.
  </TD>
 </TR>
 <TR>
  <TD>
   <B><img src="qrc:/fonts.png" ALIGN="absmiddle"> Add text</B>
  </TD>
  <TD>Add a Matrix text animation control. When clicking this button,
   a dialog will be displayed requiring to enter the desired text to be
   animated on the Matrix.<br>
   The button displayed in the widget's layout will have a gray background color
   and a label corresponding to the chosen text.
  </TD>
 </TR>
 <TR>
  <TD>
   <B><img src="qrc:/edit_remove.png" ALIGN="absmiddle"> Remove</B>
  </TD>
  <TD>Remove the currently selected control from the controls list.
  </TD>
 </TR>
</TABLE>

</BODY>
</HTML>