File: fixturemonitor.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 (249 lines) | stat: -rw-r--r-- 7,278 bytes parent folder | download
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
<TITLE>Q Light Controller Plus - Fixture Monitor</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:/monitor.png" width=32> DMX Monitor</H1>
<P>
The DMX Monitor is a useful tool to track the values that are being sent to the
output universes. Only the information related to the required fixtures are
displayed. The monitor's display options have no effect on actual fixture
addressing, after all, it is just a <B>monitor</B>.<br>
The DMX monitor has two display modes: <B>DMX view</B> and <B>2D view</B>.
</P>

<H2>DMX view</H2>
<P>
The DMX view shows the all the fixtures of the project, representing each
channel with numbers and icons. It basically represents each channel in 3 rows:
<UL>
 <LI>The channel group icon</LI>
 <LI>The channel number</LI>
 <LI>The channel value</LI>
</UL>
</P>

<H3>Toolbar controls</H3>

<TABLE BORDER=1 class="qlcTable">
 <TR>
  <TD>
   <B>2D View</B>
  </TD>
  <TD>
   By clicking on this button, it is possible to switch to the 2D view mode.
  </TD>
 </TR>
 <TR>
  <TD>
   <IMG SRC="qrc:/fonts.png">
  </TD>
  <TD>
   Change the monitor font. To prevent the numbers from flickering and jumping,
   you should choose a proportional (i.e. fixed width) font; for example
   Monaco, Andale or Courier. The font property is global, meaning it will not be
   saved into your current project, but it will be stored in the QLC+ main
   configuration.
  </TD>
 </TR>
 <TR>
  <TD>
   <B>DMX Channels</B>
  </TD>
  <TD>
   Display fixtures' channel numbers as absolute DMX channels; channel numbers
   go from 1 to 512 as they are assigned to each fixture.
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Relative Channels</B>
  </TD>
  <TD>
   Display fixtures' channel numbers relative to fixtures i.e. every fixture's
   channel numbers always start from 1.
  </TD>
 </TR>
 <TR>
  <TD>
   <B>DMX Values</B>
  </TD>
  <TD>
   Display channel values as absolute DMX values (0-255).
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Percent Values</B>
  </TD>
  <TD>
   Display channel values as percentages of 255 (0-100%).
  </TD>
 </TR>
 <TR>
  <TD>
   <B>Universe</B>
  </TD>
  <TD>
   Select which universe to monitor. The first entry is always
   "All universes"
  </TD>
 </TR>
</TABLE>

<H2>2D view</H2>
<P>
The monitor 2D view is another way to represent the fixtures of your project
that, instead of numbers, uses a graphical preview trying to represent as much
as possible the real result of a light-emitting device.</P>
<P>Currently, monitor reflects:
<UL>
  <LI>Master Dimmer</LI>
  <LI>R/G/B</LI>
  <LI>C/M/Y</LI>
  <LI>Color wheels, if they contain RGB color value. Two-color values are not supported</LI>
  <LI>Shutter, which is open, unless the capability name contains "close" or "blackout" (example: "Shutter Close")</LI>
</UL></P>
<P>In 2D view mode it is possible to select which fixtures to display and their
position in a grid representing the dimensions of a real stage.<br>
The grid would like to reproduce the front view of a stage, but you can
use it as a generic space as you might like.<br>
Graphical items can be manually moved by dragging them over the grid, or,
when clicked, they can be configured with the Monitor Fixture Editor
panel that will be displayed on the right side of the window.
</P>

<H3>Toolbar controls</H3>

<TABLE BORDER=1 class="qlcTable">
 <TR>
  <TD>
   <B>DMX View</B>
  </TD>
  <TD>
   By clicking on this button, it is possible to switch to the DMX view mode.
  </TD>
 </TR>
 <TR>
  <TD><B>Grid dimensions</B></TD>
  <TD>
    Set the width and the height of the 2D view grid by
    changing the values displayed in the two spin boxes
  </TD>
 </TR>
 <TR>
  <TD><B>Grid units</B></TD>
  <TD>
    Set the 2D view grid measurement units by selecting
    the desired one from the drop down menu. Possible options
    are meters and feet.
  </TD>
 </TR>
 <TR>
  <TD><IMG SRC="qrc:/edit_add.png"></TD>
  <TD>
    Add a fixture to the 2D view grid. When clicking on this
    icon, the fixture selection dialog will be displayed.
    Fixtures already added to the view will be greyed as it
    isn't possible to add the same fixture twice
  </TD>
 </TR>
 <TR>
  <TD><IMG SRC="qrc:/edit_remove.png"></TD>
  <TD>
    Remove a fixture from the 2D view grid. Clicking on this
    icon will remove the currently selected fixture.
    A fixture is highlighted in yellow when selected.
  </TD>
 </TR>
 <TR>
  <TD><IMG SRC="qrc:/image.png"></TD>
  <TD>
    Open the Monitor background picture selection dialog.<br>
    Here it is possible to choose between 3 possible modes:<br>
    <UL>
     <LI><B>No background</B>: the Monitor 2D view won't have any background picture</LI>
     <LI><B>Common background</B>: the Monitor 2D view will display the chosen background picture</LI>
     <LI><B>Custom background list</B>: in this mode it is possible to select a background picture
      for a specific QLC+ Function. Just click on the <IMG SRC="qrc:/edit_add.png" ALIGN="absmiddle"></LI>
      and <IMG SRC="qrc:/edit_remove.png" ALIGN="absmiddle"> buttons to add/remove Functions and their
      associated background picture to the Monitor. When a Function in this list will start
      the Monitor 2D view background picture will change accordingly.</LI>
    </UL>
  </TD>
 </TR>
 <TR>
  <TD><IMG SRC="qrc:/label.png"></TD>
  <TD>
    Show/hide fixtures' names underneath their graphical
    representation
  </TD>
 </TR>
</TABLE>

<H3>Fixture Item Editor</H3>

<P>
When a fixture is clicked, it gets highlighted in yellow and
the Monitor Fixture Item Editor is displayed on the right side
of the window.<br>
Following, the possible parameters that it is possible to tune:
</P>

<TABLE BORDER=1 class="qlcTable">
 <TR>
  <TD><B>Horizontal position</B></TD>
  <TD>
   Set the position on the grid X axis using the grid measurement units
  </TD>
 </TR>
 <TR>
  <TD><B>Vertical position</B></TD>
  <TD>
   Set the position on the grid Y axis using the grid measurement units
  </TD>
 </TR>
 <TR>
  <TD><B>Rotation</B></TD>
  <TD>
   Set the rotation angle of the graphical item representing the
   selected fixture
  </TD>
 </TR>
 <TR>
  <TD><B>Color gel</B></TD>
  <TD>
   Set the color gel to be applied to the currently selected fixture item.
   This is useful for generic dimmers with a traditional light bulb, not
   emitting any color by itself. This function has no effect on RGB LED
   fixtures.
  </TD>
 </TR>
 <TR>
  <TD><IMG SRC="qrc:/fileclose.png"></TD>
  <TD>
    Reset a previously set color gel
  </TD>
 </TR>
</TABLE>

<H3>Pan/Tilt display</H3>

<P>
PAN/TILT display is schematically displayed using colored rings/arcs around fixture.
<span style="background-color: purple"><b>P</b>urple</span> arc shows <b>P</b>AN angle, and <span style="background-color: turquoise"><b>T</b>urquoise</span> arc shows <b>T</b>ILT angle.
Gray dots show PAN/TILT ranges. Zero (middle of the range) is at the bottom.
</P>

<P>
In the following picture PAN range is 660 degrees and tilt range is 300 degrees. Pan is at counter-clockwise end (-330 deg) and tilt is at -150 deg.
</P>

<IMG src="../images/pan-tilt.png" />

</BODY>
</HTML>