1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<title>dispread</title>
5
<meta http-equiv="content-type"
6
content="text/html; charset=ISO-8859-1">
7
<meta name="author" content="Graeme Gill">
10
<h2><b>spectro/dispread</b> </h2>
12
Display test patches on a monitor, read the colorimetric value result
13
with the colorimeter, and create the chart readings file. The type of
14
instrument is determined by the communication port
15
selected. Emission and display measurement instruments are supported.<br>
17
If you want to read a display manually rather than automatically, see <a
18
href="chartread.html">chartread</a> and the <a href="chartread.html#d">-d</a>
21
<small style="font-family: monospace;">dispread [-options]<i> inoutfile</i><br>
22
<a href="#v">-v</a>
23
26
</small><font size="-1"><a style="font-family: monospace;"
27
href="#display">-display displayname</a><span
28
style="font-family: monospace;"> [X11 only] Choose X11 display name<br>
29
</span></font><font size="-1"><span style="font-family: monospace;"> <a
30
href="#dnm">-d n[,m]</a>
31
[X11
32
only]Choose the display from the following list (default 1),<br>
33
4
<title>dispread</title>
5
<meta http-equiv="content-type" content="text/html;
7
<meta name="author" content="Graeme Gill">
10
<h2><b>spectro/dispread</b> </h2>
12
Display test patches on a monitor, read the colorimetric value
13
result with the colorimeter, and create the chart readings file. The
14
type of instrument is determined by the communication port selected.
15
Emission and display measurement instruments are supported.<br>
17
If you want to read a display manually rather than automatically,
18
see <a href="chartread.html">chartread</a> and the <a
19
href="chartread.html#d">-d</a> option.<br>
21
<small style="font-family: monospace;">dispread [-options]<i>
23
<a href="#v">-v</a>
26
Verbose mode<br>
27
</small><font size="-1"><a style="font-family: monospace;"
28
href="#display">-display displayname</a><span
29
style="font-family: monospace;"> [X11 only] Choose X11 display
31
</span></font><font size="-1"><span style="font-family:
32
monospace;"> <a href="#dnm">-d n[,m]</a>
33
34
[X11 only]Choose the display from the following list (default
36
37
a different display m for VideoLUT access.</span></font><br>
38
<font size="-1"><span style="font-family: monospace;"> <a href="#d">-d
39
n</a>
46
for VideoLUT access.</span></font><br>
47
<font size="-1"><span style="font-family: monospace;"> <a
48
href="#d">-d n</a>
43
from the following list (default 1)</span></font><small
44
style="font-family: monospace;"><br>
45
<span style="font-family: monospace;"> </span><a
46
style="font-family: monospace;" href="#c">-c listno</a><span
47
style="font-family: monospace;">
48
Set
49
communication port from the following list (default 1)<br>
50
</span></small><font size="-1"><span style="font-family: monospace;"> <a
51
href="#p">-p</a>
55
(if available)</span></font><br>
56
<small style="font-family: monospace;"></small><font size="-1"><span
57
style="font-family: monospace;"> <a href="#y">-y c|l</a>
58
(default 1)</span></font><small style="font-family: monospace;"><br>
59
</small><span style="font-family: monospace;"> <a href="#dweb">-dweb[:port]</a>
64
Display via a web server at port (default 8080)</span><br>
65
<small style="font-family: monospace;"> <span style="font-family:
66
monospace;"> </span><a style="font-family: monospace;"
67
href="#c">-c listno</a><span style="font-family: monospace;">
68
Set
69
communication port from the following list (default 1)<br>
70
</span></small><font size="-1"><span style="font-family:
71
monospace;"> <a href="#p">-p</a>
74
Use projector mode (if available)</span></font><br>
75
<font size="-1"><span style="font-family: monospace;"><a
77
61
= CRT, l = LCD</span></font><br>
62
<small style="font-family: monospace;"> <span
63
style="text-decoration: underline;">-</span><a href="#k">k
64
file.cal</a> Load
65
calibration file into display while reading<br>
66
</small><small style="font-family: monospace;"> <span
67
style="text-decoration: underline;">-</span><a href="#K">K
68
file.cal</a>
69
Apply calibration file to test values while reading</small><br>
70
<small style="font-family: monospace;"> <a href="#s">-s</a>
71
74
information (default don't save)<br>
75
</small><font style="font-family: monospace;" size="-1"> <a
76
href="#P">-P ho,vo,ss</a>
82
82
type - instrument specific list to choose from.</span></font><br>
83
<small style="font-family: monospace;"> <span
84
style="text-decoration: underline;">-</span><a href="#k">k
85
file.cal</a>
88
Load calibration file into display while reading<br>
89
</small><small style="font-family: monospace;"> <span
90
style="text-decoration: underline;">-</span><a href="#K">K
91
file.cal</a>
95
calibration file to test values while reading</small><br>
96
<small style="font-family: monospace;"> <a href="#s">-s</a>
99
Save spectral information (default don't
101
</small><font style="font-family: monospace;" size="-1"> <a
102
href="#P">-P ho,vo,ss</a>
105
Position test window and scale it<br>
106
86
left/top, 0.5 = center, 1.0 = right/bottom etc.<br>
87
116
1.0 = right/bottom etc.<br>
117
91
half, 1.0 = normal, 2.0 = double etc.<br>
92
</font><font size="-1"><span style="font-family: monospace;"><a
94
98
with black background</span></font><br style="font-family: monospace;">
99
<small style="font-family: monospace;"> <span
100
style="text-decoration: underline;"></span><a href="#n">-n</a>
127
2.0 = double etc.<br>
128
</font><font size="-1"><span style="font-family: monospace;"><a
130
133
Fill whole screen with black background</span></font><br
134
style="font-family: monospace;">
135
<small style="font-family: monospace;"> <span
136
style="text-decoration: underline;"></span><a href="#n">-n</a>
101
137
104
Don't set override redirect on test
106
</small><small style="font-family: monospace;"> <a href="#J">-J</a>
107
108
112
<font size="-1"><span style="font-family: monospace;"> <a href="#N">-N</a>
117
</span></font><font size="-1"><span style="font-family: monospace;"> </span><a
118
style="font-family: monospace;" href="#H">-H</a><span
119
style="font-family: monospace;">
120
121
124
resolution spectrum mode (if
126
</span></font><font size="-1"><span style="font-family: monospace;"> </span><a
127
style="font-family: monospace;" href="#V">-V</a><span
128
style="font-family: monospace;">
129
130
133
measurement mode (if available)<br>
134
<a href="#w">-w</a>
135
147
</small><small style="font-family: monospace;"> <a href="#J">-J</a>
148
151
Run calibration first</small><br>
152
<font size="-1"><span style="font-family: monospace;"> <a
153
href="#N">-N</a>
156
Disable auto calibration of instrument<br>
157
</span></font><font size="-1"><span style="font-family:
158
monospace;"> </span><a style="font-family: monospace;"
159
href="#H">-H</a><span style="font-family: monospace;">
160
161
Use high resolution spectrum mode (if
163
</span></font><font size="-1"><span style="font-family:
164
monospace;"> </span><a style="font-family: monospace;"
165
href="#V">-V</a><span style="font-family: monospace;">
166
167
Use adaptive measurement mode (if
169
<a href="#w">-w</a>
170
139
white to Y = 100</span></font><small><span
140
style="font-family: monospace;"></span></small><br>
141
<font size="-1"><span style="font-family: monospace;"> <a
142
href="dispcal.html#X">-X</a><a href="#X"> file.ccmx</a>
180
100</span></font><small><span style="font-family: monospace;"></span></small><br>
181
<font size="-1"><span style="font-family: monospace;"><a
182
href="#X1">-X file.ccmx</a>
185
Apply Colorimeter Correction Matrix</span></font><br>
186
<span style="font-family: monospace;"> <a href="#X2">-X
187
file.ccss</a>
147
</span></font><small><span style="font-family: monospace;"> <a
148
href="dispread.html#I">-I b|w</a>
193
Spectral Samples for calibration</span><br style="font-family:
195
<span style="font-family: monospace;"> <a href="#X3">-X N</a>
201
description)</span><br style="font-family: monospace;">
202
<span style="font-family: monospace;">
205
1: etc.</span><font size="-1"><span style="font-family:
207
</span></font><small><span style="font-family: monospace;"> </span><a
208
style="font-family: monospace;" href="#Q">-Q <i>observ</i></a><span
209
style="font-family: monospace;">
210
Choose CIE Observer for spectrometer or CCSS
211
colorimeter data:</span><br style="font-family: monospace;">
212
<span style="font-family: monospace;">
215
1931_2 </span></small><small><span
216
style="font-family: monospace;">(def.)</span></small><small><span
217
style="font-family: monospace;">, 1964_10, S&B 1955_2, shaw,
218
J&V 1978_2, 1964_10c</span></small><br>
219
<small><span style="font-family: monospace;"> <a
220
href="dispread.html#I">-I b|w</a>
152
-Ib, White: -Iw, Both: -Ibw</span></small><br>
153
<font size="-1"><span style="font-family: monospace;"> </span><a
154
style="font-family: monospace;" href="#C">-C "command"</a><span
155
style="font-family: monospace;">
156
Invoke shell "command" each
157
time a color is set<br>
158
</span></font><font size="-1"><span style="font-family: monospace;"> </span><a
159
style="font-family: monospace;" href="#M">-M "command"</a><span
160
style="font-family: monospace;">
161
Invoke shell "command" each
162
time a color is measured</span></font><br>
163
<font size="-1"><span style="font-family: monospace;"> <a href="#W">-W
164
n|h|x</a>
230
-Ibw</span></small><br>
231
<font size="-1"><span style="font-family: monospace;"> </span><a
232
style="font-family: monospace;" href="#C">-C "command"</a><span
233
style="font-family: monospace;">
234
Invoke shell
235
"command" each time a color is set<br>
236
</span></font><font size="-1"><span style="font-family:
237
monospace;"> </span><a style="font-family: monospace;"
238
href="#M">-M "command"</a><span style="font-family: monospace;">
239
Invoke shell
240
"command" each time a color is measured</span></font><br>
241
<font size="-1"><span style="font-family: monospace;"> <a
242
href="#W">-W n|h|x</a>
168
flow control: n = none, h = HW, x = Xon/Xoff</span></font><br>
169
<small style="font-family: monospace;"> <a href="#D">-D [level]</a>
170
Print debug
171
diagnostics to stderr</small><br>
172
<small style="font-family: monospace;"> <a href="#p1"><i>inoutfile</i></a>
176
input[<a href="File_Formats.html#.ti1">.ti1</a>]/output[<a
177
href="File_Formats.html#.ti3">.ti3</a>] file.<br>
182
dispread -c1 -i92 mycrt<br>
185
This is the tool for exercising a display, in order to measure its
186
color characteristics. The device test colors are defined by the
187
outfile.ti1 file, while the resulting device+colorimetric and optional
188
spectral readings are stored in the outfile.ti3 file. Display
189
calibration curves can be applied during the measurements, and the
190
curves included in the resulting .ti3 data file using the <span
191
style="font-weight: bold;">-k</span>flag. See <a href="dispcal.html">dispcal</a>
192
for information on how to calibrate the display before profiling
193
it. For best results, you should run this
194
against a neutral grey desktop background, and avoid having any bright
195
images or windows on the screen at the time you run it.<br>
197
<a name="v"></a> The <b>-v</b> flag reports progress information.<br>
199
<a name="display"></a><span style="font-weight: bold;">-display</span>:
200
When running on a UNIX based system that used the
203
System, <b>dispread</b>
204
will by default use the $DISPLAY environment variable to determine
205
which display and screen to read from. This can be overridden by
206
supplying an X11 display name to the <span style="font-weight: bold;">-display</span>
207
option. Note that if Xinerama is active, you can't select the screen
208
using $DISPLAY or -display, you have to select it using the <span
209
style="font-weight: bold;">-d</span> parameter.<br>
211
<a name="d"></a> <span style="font-weight: bold;">-d</span>: By
212
default the main display will be the location of
213
the test window. If the system has more than
214
one display or screen, an alternate display/screen can be selected with
215
the <span style="font-weight: bold;">-d</span> parameter. If you
216
invoke <span style="font-weight: bold;">dispread</span>
217
so as to display the usage
218
information (i.e. "dispcal -?" or "dispcal --"), then the discovered
219
displays/screens will be listed. Multiple displays may not be listed,
220
if they appear as a single display to the operating system (ie. the
221
multi-display support is hidden in the video card driver). On UNIX
222
based system that used the X11
224
System, the <span style="font-weight: bold;">-d</span> parameter will
225
override the screen specified by the $DISPLAY or <span
226
style="font-weight: bold;">-display</span> parameter.<br>
228
<span style="font-weight: bold;">Note</span> that if a calibration file
229
is provided using the <span style="font-weight: bold;">-k</span>
230
option, and the VideoLUTs for a display are not accessible, <span
231
style="font-weight: bold;">dispread</span>
232
will issue a warning , but will continue to run without initialising
233
the VideoLUTs . This could be because you are trying to access
234
a remote display, and the remote display doesn't support the
235
XF86VidMode extension, or perhaps you are running multiple monitors
236
using NVidia TwinView, or MergedFB, and trying to access anything other
237
than the primary monitor. TwinView and MergedFB don't properly support
238
the XF86VidMode extension for multiple displays. Xinerama does properly
239
support calibration of multiple displays. You can use <a
240
href="dispwin.html#r">dispwin -r</a> to test whether the VideoLUTs are
241
accessible for a particular display. See also below, on how to select a
242
different display for VideoLUT access.<br>
244
<a name="dnm"></a>Because of the difficulty cause by TwinView and
245
MergedFB in X11 based systems, you can optionally specify a separate
246
display number after the display that is going to be used to present
247
test patches, for accessing the VideoLUT hardware. This must be
248
specified as a single string, e.g. <span style="font-weight: bold;">-d
250
. Some experimentation may be needed using <a href="dispwin.html">dispwin</a>
251
on such systems, to discover what
252
screen has access to the VideoLUT hardware, and which screens the test
253
patches appear on. You may be able to calibrate one screen, and then
254
share the calibration with another screen. Profiling can be done
255
independently to calibration.<br>
257
<a name="c"></a> <span style="font-weight: bold;">-c</span>: The
258
instrument is assumed to communicate through a
259
USB or serial communication port, and the port can be selected with the
262
if the instrument is not connected to the first port. If you invoke <span
263
style="font-weight: bold;">dispread</span>
264
so as to display the usage
265
information (i.e. "dispread -?" or "dispread --"), then the discovered
266
USB and serial ports will be listed. On
267
UNIX/Linux, a list of all possible serial ports are shown, but not all
269
actually be present on your system.<br>
271
<a name="p"></a>The <span style="font-weight: bold;">-p</span> flag
273
in projector mode, using
277
<a name="y"></a> <span style="font-weight: bold;">-y</span>:
278
Display type. Colorimeters can
279
do a more accurate job if they know what type of display technology
280
they are measuring. Use <span style="font-weight: bold;">-yc</span> if
282
calibrating a CRT (Cathode Ray Tube) type monitor or Plasma type
283
display, and use <span style="font-weight: bold;">-yl</span> if you
284
are calibrating an LCD
285
(Liquid Crystal Display).<br>
287
<a name="s"></a><span style="font-weight: bold;">-s</span>: By default
288
only the colorimetric information (XYZ
290
will be saved, but for instruments that support spectral readings (such
292
the Gretag Spectrolino), the <b>-s</b> option will save the spectral
294
to the .ti3 file as well.<br>
296
<a name="k"></a> <span style="font-weight: bold;">-k: </span>If a
297
display video lookup table calibration <a href="File_Formats.html#.cal">.cal</a>
298
file is provided, it will be
299
loaded into the display <span style="font-weight: bold;">ViedoLUTs</span>
300
while the measurements are being taken, thereby being applied to the
301
measurement values, and the calibration will also
302
included in the resulting .ti3 data file, so that <a
303
href="colprof.html">colprof</a> can include it as a <span
304
style="font-weight: bold;">vcgt</span> tag in the resulting
305
profile. This is the <span style="font-weight: bold;">normal</span>
306
way to profile a calibrated display. The calibration file has usually
307
been created using <a href="dispcal.html">dispcal</a>. If a
308
calibration file is not created,
309
then the display will be read in whatever calibration state it is in. <span
310
style="font-weight: bold;">NOTE</span> that the calibration is loaded
311
into the display hardware just before the instrument starts
312
measurement, after the test window first appears.<br>
314
<a name="K"></a> <span style="font-weight: bold;">-K: </span>If a
315
display video lookup table calibration <a href="File_Formats.html#.cal">.cal</a>
316
file is provided, it will be
317
applied to the test values for each measurement, and also
318
included in the resulting .ti3 data file, so that <a
319
href="colprof.html">colprof</a> can include it as a <span
320
style="font-weight: bold;">vcgt</span> tag in the resulting
321
profile. This is <span style="font-weight: bold;">NOT</span> normally
322
the best way to profile a calibrated display, since the frame buffer
323
may have lower precision than the VideoLUTs output values.<br>
325
<a name="P"></a> The <span style="font-weight: bold;">-P</span>
326
parameter allows you to position and size the test patch window. By
327
default it is places in the center of the screen, and sized
328
appropriately for the type of instrument. The <span
329
style="font-weight: bold;">ho</span> and <span
330
style="font-weight: bold;">vo</span>
331
values govern the horizontal and vertical offset respectively. A value
332
of 0.0 positions the window to the far left or top of the screen, a
333
value of 0.5 positions it in the center of the screen (the default),
334
and 1.0 positions it to the far right or bottom of the screen. The <span
335
style="font-weight: bold;">ss</span>
336
parameter is a scale factor for the test window size. A value of 0.5
337
for instance, would produce a half sized window. A value of 2.0 will
338
produce a double size window. Note that the ho,vo,ss numbers must be
339
specified as a single string (no space between the numbers and the
340
comma). For example, to create a double sized test window at the top
341
right of the screen, use <span style="font-weight: bold;">-P 1,0,2</span>
344
<a name="F"></a> The <span style="font-weight: bold;">-F</span>
345
flag causes the while screen behind the test window to be masked with
346
black. This can aid black accuracy when measuring CRT displays or
349
<a name="n"></a><span style="font-weight: bold;">-n</span>: When
350
running on a UNIX based system that used the X11
352
System, <b>dispread</b> normally selects the override redirect so that
354
test window will appear above any other windows on the display. On some
356
this can interfere with window manager operation, and the <b>-n</b>
358
turns this behaviour off.<br>
360
<a name="J"></a> The -<span style="font-weight: bold;">J</span> option
361
runs through the black and sensor
363
calibration routines for the Xrite DTP92 and DTP94 instrument, the
364
black level calibration for the Eye-One Display 1, and a CRT frequency
365
calibration for the Eye-One Display 2. For the
366
black calibration the instrument should be placed on an opaque, black
367
surface, and any stray light should be avoided by placing something
368
opaque over the instrument. If a
370
is being used, then a white and black calibration will always be
372
the instrument can be placed on the display, unless the <a href="#N">-N</a>
373
flag is used. Generally it is not necessary to do a calibration every
374
time an instrument is used, just now and again. There is no point in
375
doing a CRT frequency calibration, as this will be done
377
at the commencement of patch reading.<br>
379
<a name="N"></a>The <b>-N</b> flag disables any automatic instrument
380
calibration (used for the Gretag Spectrolino for instance). This would
381
be used when the instrument is being used for a series of measurements,
382
and it is inconvenient to place it on it's calibration tile between
383
measurements. The instrument should be calibrated at least once for
384
each measurement session though.<br>
386
<a name="H"></a> The -<span style="font-weight: bold;">H</span> option
387
turns on high resolution spectral mode, if the instrument supports it.
388
See <a href="instruments.html">Operation of particular instruments</a>
389
for more details. This may give better accuracy for display
392
<a name="V"></a> The -<span style="font-weight: bold;">V</span> option
394
emission measurement mode, if the instrument supports it,
395
such as the Eye-One Pro. This may give better accuracy for low level
396
measurements, but may be more inconsistent overall due to the varying
397
integration times. Overall measurement time will probably be longer.<br>
399
<a name="w"></a>The <b>-w</b> flag disables the normalisation of the
400
white patch value to 100.0, resulting in values that are in cd/m^2.
401
This is mainly for diagnostic purposes.<br>
403
<a name="X"></a> The -<span style="font-weight: bold;">X <span
404
style="font-style: italic;">file.ccmx</span></span> option reads a <a
405
href="File_Formats.html#.ccmx">Colorimeter Correction Matrix</a>
406
from the given file, and applies it to the colorimeter instruments
407
readings. This can improve a colorimeters accuracy for a particular
408
type of display. A list of contributed <span style="font-weight: bold;">ccmx</span>
409
files is <a href="ccmxs.html">here</a>.<br>
411
<a name="I"></a> The -<span style="font-weight: bold;">I <span
412
style="font-style: italic;">b|w</span></span>
413
options invoke instrument black level, and display white level
414
compensation (respectively). Instrument black level drift compensation
415
attempts to combat instrument black calibration drift by using a
416
display black test patch as a reference. If an instrument is not
417
acclimatised sufficiently to the measurement conditions, changes in
418
temperature can affect the black readings. Display white level drift
419
compensation attempts to combat changes in display brightness as it
420
warms up by measuring a white patch every so often, and using it to
421
normalise all the other readings. If just instrument black drift
422
compensation is needed, use <span style="font-weight: bold;">-Ib</span>.
426
white level compensation is needed, use <span
427
style="font-weight: bold;">-Iw</span>. If both are needed, use <span
428
style="font-weight: bold;">-Ibw</span> or <span
429
style="font-weight: bold;">-Iwb</span>.<span style="font-weight: bold;">
432
</span><a name="C"></a> The -<span style="font-weight: bold;">C</span> <span
433
style="font-weight: bold;">"command" </span>option
434
allows a method of relaying each test value to some other display than
435
that on the system running dispread (for instance, a photo frame, PDA
436
screen etc.), by causing the given command to be invoked to the shell,
437
with six arguments. The first three arguments are the RGB test color as
438
integers in the range 0 to 255, the second three parameters are the RGB
439
test color as floating point numbers in the range 0.0 to 1.0. The
440
script or tool should relay the given color to the screen in some
441
manner (e.g. by generating a raster file of the given color and sending
442
it to the display being profiled), before returning. Note that a test
443
window will also be created on the system running dispread.<br>
445
<a name="M"></a> The -<span style="font-weight: bold;">M</span> <span
446
style="font-weight: bold;">"command" </span>option
447
allows a method of gathering each test value from some external source,
448
such as an instrument that is not directly supported by Argyll. The
449
given command is involked to the shell,
450
with six arguments. The first three arguments are the RGB test color as
451
integers in the range 0 to 255, the second three parameters are the RGB
452
test color as floating point numbers in the range 0.0 to 1.0. The
453
script or tool should create a file called <span
454
style="font-weight: bold;">"command.meas</span>" that contains the XYZ
455
values for the given RGB (or measured from the test window) in cd/m^2
456
as three numbers separated by spaces, before returning. If the command
457
returns a non-zero return value,
458
dispread will abort. Note that a test
459
window will also be created on the system running dispread.<br>
461
<a name="W"></a>The <b>-W</b> <span style="font-weight: bold;">n|h|x</span>
462
parameter overrides the default serial communications
463
flow control setting. The value <span style="font-weight: bold;">n</span>
464
turns all flow control off, <span style="font-weight: bold;">h</span>
465
sets hardware handshaking, and <span style="font-weight: bold;">x</span>
466
sets Xon/Xoff handshaking. This commend may be useful in workaround
467
serial communications issues with some systems and cables. <br>
469
<a name="D"></a>The <b>-D</b> flag causes communications
470
and other instrument diagnostics to be printed to stdout. A level can
471
be set between 1 .. 9, that may give progressively more verbose
472
information, depending on the instrument. This can be useful in
474
down why an instrument can't connect.<br>
476
<a name="p1"></a> The final parameter on the command line is the base
477
filename for the <a href="File_Formats.html#.ti1">.ti1</a>
478
input file, and the <a href="File_Formats.html#.ti3">.ti3</a> output
479
file. <b>dispread</b> will add the .ti1 and .ti3 extensions
482
<span style="font-weight: bold;">NOTE</span> that on an X11 system, if
483
the environment variable <span style="font-weight: bold;">ARGYLL_IGNORE_XRANDR1_2</span>
484
is set (ie. set it to "yes"), then the presence of the XRandR 1.2
485
extension will be ignored, and other extensions such as Xinerama and
486
XF86VidMode extension will be used. This may be a way to work around
487
buggy XRandR 1.2 implementations.<br>
489
<hr style="width: 100%; height: 2px;"><br>
490
If a large number of patches is being read, the screensaver on many
491
systems can interfere with the operation of dispread. It is therefore
493
in these cases to manually turn off the screensaver before commencing
497
If communications break down with a USB connected instrument, you may
498
have to unplug it, and plug it in again to recover.<br>
500
Some systems (Apple OSX in particular) have a special set of user
501
interface controls ("Universal Access") that allows altering the
502
display in ways designed to assist visually impaired users, by
503
increasing contrast etc. This will interfere badly with any attempts to
504
calibrate or profile such a system, and must be turned off in order to
505
do so. Note that certain magic
506
keyboard sequences can turn this on by accident.<br>
252
none, h = HW, x = Xon/Xoff</span></font><br>
253
<small style="font-family: monospace;"> <a href="#D">-D [level]</a>
254
Print debug
255
diagnostics to stderr</small><br>
256
<small style="font-family: monospace;"> <a href="#p1"><i>inoutfile</i></a>
259
Base name for input[<a href="File_Formats.html#.ti1">.ti1</a>]/output[<a
260
href="File_Formats.html#.ti3">.ti3</a>] file.<br>
264
dispread -c1 -i92 mycrt<br>
267
This is the tool for exercising a display, in order to measure its
268
color characteristics. The device test colors are defined by the
269
outfile.ti1 file, while the resulting device+colorimetric and
270
optional spectral readings are stored in the outfile.ti3 file.
271
Display calibration curves can be applied during the measurements,
272
and the curves included in the resulting .ti3 data file using the <span
273
style="font-weight: bold;">-k</span>flag. See <a
274
href="dispcal.html">dispcal</a> for information on how to
275
calibrate the display before profiling it. For best results, you
276
should run this against a neutral grey desktop background, and avoid
277
having any bright images or windows on the screen at the time you
280
<a name="v"></a> The <b>-v</b> flag reports progress information.<br>
282
<a name="display"></a><span style="font-weight: bold;">-display</span>:
283
When running on a UNIX based system that used the X11 Windowing
284
System, <b>dispread</b> will by default use the $DISPLAY
285
environment variable to determine which display and screen to read
286
from. This can be overridden by supplying an X11 display name to the
287
<span style="font-weight: bold;">-display</span> option. Note that
288
if Xinerama is active, you can't select the screen using $DISPLAY or
289
-display, you have to select it using the <span style="font-weight:
290
bold;">-d</span> parameter.<br>
292
<a name="d"></a> <span style="font-weight: bold;">-d</span>: By
293
default the main display will be the location of the test window. If
294
the system has more than one display or screen, an alternate
295
display/screen can be selected with the <span style="font-weight:
296
bold;">-d</span> parameter. If you invoke <span
297
style="font-weight: bold;">dispread</span> so as to display the
298
usage information (i.e. "dispread -?" or "dispread --"), then the
299
discovered displays/screens will be listed. Multiple displays may
300
not be listed, if they appear as a single display to the operating
301
system (ie. the multi-display support is hidden in the video card
302
driver). On UNIX based system that used the X11 Windowing System,
303
the <span style="font-weight: bold;">-d</span> parameter will
304
override the screen specified by the $DISPLAY or <span
305
style="font-weight: bold;">-display</span> parameter.<br>
307
On X11 the inability to access VideoLUTs could be because you are
308
trying to access a remote display, and the remote display doesn't
309
support the XF86VidMode extension, or perhaps you are running
310
multiple monitors using NVidia TwinView, or MergedFB, and trying to
311
access anything other than the primary monitor. TwinView and
312
MergedFB don't properly support the XF86VidMode extension for
313
multiple displays. You can use <a href="dispwin.html#r">dispwin -r</a>
314
to test whether the VideoLUTs are accessible for a particular
315
display. See also below, on how to select a different display for
316
VideoLUT access. Also note that dispcal will fail if the Visual
317
depth doesn't match the VideoLUT depth. Typically the VideoLUTs have
318
256 entries per color component, so the Visual generally needs to be
319
24 bits, 8 bits per color component.<br>
321
<a name="dnm"></a>Because of the difficulty cause by TwinView and
322
MergedFB in X11 based systems, you can optionally specify a separate
323
display number after the display that is going to be used to present
324
test patches, for accessing the VideoLUT hardware. This must be
325
specified as a single string, e.g. <span style="font-weight: bold;">-d
328
1,2</span> . Some experimentation may be needed using <a
329
href="dispwin.html">dispwin</a> on such systems, to discover what
330
screen has access to the VideoLUT hardware, and which screens the
331
test patches appear on. You may be able to calibrate one screen, and
332
then share the calibration with another screen. Profiling can be
333
done independently to calibration.<br>
335
<a name="dweb"></a><span style="font-weight: bold;">-dweb</span> or
336
<span style="font-weight: bold;">-dweb:port</span> starts a
337
standalone web server on your machine, which then allows a local or
338
remote web browser to display the the color test patches. By default
339
port <span style="font-weight: bold;">8080</span> is used, but this
340
can be overridden by appending a <span style="font-weight: bold;">:</span>
341
and the port number i.e. <span style="font-weight: bold;">-dweb:8001</span>.
342
The URL will be <span style="font-weight: bold;">http://</span>
343
then name of the machine or its I.P. address followed by a colon and
344
the port number - e.g something like <span style="font-weight:
345
bold;">http://192.168.0.1:8080</span>. If you use the verbose
346
option (<span style="font-weight: bold;">-v</span>) then a likely
347
URL will be printed once the server is started, or you could run <span
348
style="font-weight: bold;">ipconfig</span> (MSWin) or <span
349
style="font-weight: bold;">/sbin/ifconfig</span> (Linux or OS X)
350
and identify an internet address for your machine that way.<br>
352
Note that if you use this method of displaying test patches, that
353
there is no access to the display VideoLUTs and that the colors will
354
be displayed with 8 bit per component precision, and any
355
screen-saver or power-saver will not be disabled. You will also be
356
at the mercy of any color management applied by the web browser, and
357
may have to carefully review and configure such color management.
358
See the <a href="dispcal.html#o">-o</a> flag for an explanation of
359
the implications of having no access to the VideoLUTs.<br>
361
<a name="c"></a> <span style="font-weight: bold;">-c</span>: The
362
instrument is assumed to communicate through a USB or serial
363
communication port, and the port can be selected with the <b>-c</b>
364
option, if the instrument is not connected to the first port. If you
365
invoke <span style="font-weight: bold;">dispread</span> so as to
366
display the usage information (i.e. "dispread -?" or "dispread --"),
367
then the discovered USB and serial ports will be listed. On
368
UNIX/Linux, a list of all possible serial ports are shown, but not
369
all of them may actually be present on your system.<br>
371
<a name="p"></a>The <span style="font-weight: bold;">-p</span> flag
372
allows measuring in projector mode, using instruments that support
375
<a name="y"></a>The <span style="font-weight: bold;">-y</span> flag
376
allows setting the Display Type. Most colorimeters need this
377
parameter set to operate correctly. The selection typically
378
determines two aspects of of the instrument operation: <span
379
style="font-weight: bold;">1)</span> It may set the measuring mode
381
href="http://en.wikipedia.org/wiki/Comparison_of_display_technology"><span
382
style="font-weight: bold;">refresh</span> or <span
383
style="font-weight: bold;">non-refresh</span> displays</a>.
384
Typically only LCD (Liquid Crystal) displays have a non-refresh
385
nature. <span style="font-weight: bold;">2)</span> It may select an
386
instrument calibration matrix suitable for a particular display
387
type. The selections available depends on the type and model of
388
instrument, and a list of the options for the discovered instruments
389
will be shown in the <a href="ArgyllDoc.html#CmdLine">usage</a>
390
information. For more details on what particular instruments support
391
and how this works, see <a href="instruments.html">Operation of
392
particular instruments</a>.<br>
394
<a name="s"></a><span style="font-weight: bold;">-s</span>: By
395
default only the colorimetric information (XYZ value) will be saved,
396
but for instruments that support spectral readings (such as the
397
Gretag Spectrolino), the <b>-s</b> option will save the spectral
398
readings to the .ti3 file as well.<br>
400
<a name="k"></a> <span style="font-weight: bold;">-k: </span>If a
401
display video lookup table calibration <a
402
href="File_Formats.html#.cal">.cal</a> file is provided, it will
403
be loaded into the display <span style="font-weight: bold;">ViedoLUTs</span>
404
while the measurements are being taken, thereby being applied to the
405
measurement values, and the calibration will also included in the
406
resulting .ti3 data file, so that <a href="colprof.html">colprof</a>
407
can include it as a <span style="font-weight: bold;">vcgt</span>
408
tag in the resulting profile. This is the <span style="font-weight:
409
bold;">normal</span> way to profile a calibrated display. The
410
calibration file has usually been created using <a
411
href="dispcal.html">dispcal</a>. If a calibration file is not
412
created, then the display will be read in whatever calibration state
413
it is in. If the calibration file indicates that the displays
414
VideoLUTs are not accessible, or if they prove not to be accessible,
415
then dispread will switch to <span style="font-weight: bold;">-K</span>
416
mode (see below). <span style="font-weight: bold;">NOTE</span> that
417
the calibration is loaded into the display hardware just before the
418
instrument starts measurement, after the test window first appears.<br>
420
<a name="K"></a> <span style="font-weight: bold;">-K: </span>If a
421
display video lookup table calibration <a
422
href="File_Formats.html#.cal">.cal</a> file is provided, it will
423
be applied to the test values for each measurement, and also
424
included in the resulting .ti3 data file, so that <a
425
href="colprof.html">colprof</a> can include it as a <span
426
style="font-weight: bold;">vcgt</span> tag in the resulting
427
profile. This is <span style="font-weight: bold;">NOT</span>
428
normally the best way to profile a calibrated display, since the
429
frame buffer may have lower precision than the VideoLUTs output
432
<a name="P"></a> The <span style="font-weight: bold;">-P</span>
433
parameter allows you to position and size the test patch window. By
434
default it is places in the center of the screen, and sized
435
appropriately for the type of instrument. The <span
436
style="font-weight: bold;">ho</span> and <span
437
style="font-weight: bold;">vo</span> values govern the horizontal
438
and vertical offset respectively. A value of 0.0 positions the
439
window to the far left or top of the screen, a value of 0.5
440
positions it in the center of the screen (the default), and 1.0
441
positions it to the far right or bottom of the screen. The <span
442
style="font-weight: bold;">ss</span> parameter is a scale factor
443
for the test window size. A value of 0.5 for instance, would produce
444
a half sized window. A value of 2.0 will produce a double size
445
window. Note that the ho,vo,ss numbers must be specified as a single
446
string (no space between the numbers and the comma). For example, to
447
create a double sized test window at the top right of the screen,
448
use <span style="font-weight: bold;">-P 1,0,2</span> .<br>
450
<a name="F"></a> The <span style="font-weight: bold;">-F</span>
451
flag causes the while screen behind the test window to be masked
452
with black. This can aid black accuracy when measuring CRT displays
455
<a name="n"></a><span style="font-weight: bold;">-n</span>: When
456
running on a UNIX based system that used the X11 Windowing System, <b>dispread</b>
457
normally selects the override redirect so that the test window will
458
appear above any other windows on the display. On some systems this
459
can interfere with window manager operation, and the <b>-n</b>
460
option turns this behaviour off.<br>
462
<a name="J"></a> The -<span style="font-weight: bold;">J</span>
463
option runs through the black and sensor relative calibration
464
routines for the Xrite DTP92 and DTP94 instrument, the black level
465
calibration for the Eye-One Display 1, and a CRT frequency
466
calibration for the Eye-One Display 2. For the black calibration the
467
instrument should be placed on an opaque, black surface, and any
468
stray light should be avoided by placing something opaque over the
469
instrument. If a Spectrolino is being used, then a white and black
470
calibration will always be performed before the instrument can be
471
placed on the display, unless the <a href="#N">-N</a> flag is used.
472
Generally it is not necessary to do a calibration every time an
473
instrument is used, just now and again. There is no point in
474
doing a CRT frequency calibration, as this will be done
475
automatically at the commencement of patch reading.<br>
477
<a name="N"></a>The <b>-N</b> flag disables any automatic
478
instrument calibration (used for the Gretag Spectrolino for
479
instance). This would be used when the instrument is being used for
480
a series of measurements, and it is inconvenient to place it on it's
481
calibration tile between measurements. The instrument should be
482
calibrated at least once for each measurement session though.<br>
484
<a name="H"></a> The -<span style="font-weight: bold;">H</span>
485
option turns on high resolution spectral mode, if the instrument
486
supports it. See <a href="instruments.html">Operation of particular
487
instruments</a> for more details. This may give better accuracy
488
for display measurements.<br>
490
<a name="V"></a> The -<span style="font-weight: bold;">V</span>
491
option uses adaptive emission measurement mode, if the instrument
492
supports it, such as the Eye-One Pro. This may give better accuracy
493
for low level measurements, but may be more inconsistent overall due
494
to the varying integration times. Overall measurement time will
495
probably be longer.<br>
497
<a name="w"></a>The <b>-w</b> flag disables the normalisation of
498
the white patch value to 100.0, resulting in values that are in
499
cd/m^2. This is mainly for diagnostic purposes.<br>
501
<a name="X1"></a> The -<span style="font-weight: bold;">X <span
502
style="font-style: italic;">file.ccmx</span></span> option reads
503
a <a href="File_Formats.html#.ccmx">Colorimeter Correction Matrix</a>
504
from the given file, and applies it to the colorimeter instruments
505
readings. This can improve a colorimeters accuracy for a particular
506
type of display. A list of contributed <span style="font-weight:
507
bold;">ccmx</span> files is <a href="ccmxs.html">here</a>.<br>
509
<a name="X2"></a> The -<span style="font-weight: bold;">X <span
510
style="font-style: italic;">file.ccss</span></span> option reads
511
a <a href="File_Formats.html#.ccss">Colorimeter Calibration
512
Spectral Sample</a> from the given file, and uses it to set the
513
colorimeter instruments calibration. This will only work with
514
colorimeters that rely on sensor spectral sensitivity calibration
515
information (ie. the X-Rite <span style="font-weight: bold;">i1d3</span>,
516
or the DataColor <span style="font-weight: bold;">Spyder4</span>).This
522
colorimeters accuracy for a particular type of display.<br>
524
<a name="X3"></a> The -<span style="font-weight: bold;">X <span
525
style="font-style: italic;">N</span></span> option selects a <a
526
href="File_Formats.html#.ccss">Colorimeter Calibration Spectral
527
Sample</a> from the list of installed ccss files, rather than
528
specifying a specific ccss files as in the above usage. The CCSS
529
file that came with the i1d3 colorimeters can be installed using <a
530
href="i1d3ccss.html">i1d3ccss</a>, or one can be created and
531
installed using <a href="ccxxmake.html">ccxxmake</a>.<br>
533
<a name="Q"></a> The <b>-Q</b> flag allows specifying a tristimulus
534
observer, and is used to compute PCS (Profile Connection Space)
535
tristimulus values from spectral readings or using a colorimeter
536
that has CCSS capability. The following choices are available:<br>
537
<b> 1931_2</b> selects the standard CIE 1931 2 degree
538
observer. The default.<br>
539
<b>1964_10</b> selects the standard CIE 1964 10 degree
541
<b>1955_2</b> selects the Stiles and Birch 1955 2 degree
543
<b>1978_2 </b>selects the Judd and Voss 1978 2 degree
545
<b>shaw</b> selects the Shaw and Fairchild 1997 2 degree
547
<b>1964_10c</b> selects a version of the CIE 1964 10 degree
548
observer that has been adjusted using a 3x3 matrix to better agree
549
with the 1931 2 degree observer.<br>
551
<span style="font-weight: bold;">NOTE</span> that if you select
552
anything other than the default 1931 2 degree observer, that the Y
553
values will not be cd/m^2, due to the Y curve not being the CIE 1924
554
photopic V(λ) luminosity function.<br>
556
<a name="I"></a> The -<span style="font-weight: bold;">I <span
557
style="font-style: italic;">b|w</span></span> options invoke
558
instrument black level, and display white level compensation
559
(respectively). Instrument black level drift compensation attempts
560
to combat instrument black calibration drift by using a display
561
black test patch as a reference. If an instrument is not
562
acclimatised sufficiently to the measurement conditions, changes in
563
temperature can affect the black readings. Display white level drift
564
compensation attempts to combat changes in display brightness as it
565
warms up by measuring a white patch every so often, and using it to
566
normalise all the other readings. If just instrument black drift
567
compensation is needed, use <span style="font-weight: bold;">-Ib</span>.
568
If just display white level compensation is needed, use <span
569
style="font-weight: bold;">-Iw</span>. If both are needed, use <span
570
style="font-weight: bold;">-Ibw</span> or <span
571
style="font-weight: bold;">-Iwb</span>.<span style="font-weight:
574
</span><a name="C"></a> The -<span style="font-weight: bold;">C</span>
575
<span style="font-weight: bold;">"command" </span>option allows a
576
method of relaying each test value to some other display than that
577
on the system running dispread (for instance, a photo frame, PDA
578
screen etc.), by causing the given command to be invoked to the
579
shell, with six arguments. The first three arguments are the RGB
580
test color as integers in the range 0 to 255, the second three
581
parameters are the RGB test color as floating point numbers in the
582
range 0.0 to 1.0. The script or tool should relay the given color to
583
the screen in some manner (e.g. by generating a raster file of the
584
given color and sending it to the display being profiled), before
585
returning. Note that a test window will also be created on the
586
system running dispread.<br>
588
<a name="M"></a> The -<span style="font-weight: bold;">M</span> <span
589
style="font-weight: bold;">"command" </span>option allows a
590
method of gathering each test value from some external source, such
591
as an instrument that is not directly supported by Argyll. The given
592
command is involked to the shell, with six arguments. The first
593
three arguments are the RGB test color as integers in the range 0 to
594
255, the second three parameters are the RGB test color as floating
595
point numbers in the range 0.0 to 1.0. The script or tool should
596
create a file called <span style="font-weight: bold;">"command.meas</span>"
597
that contains the XYZ values for the given RGB (or measured from the
598
test window) in cd/m^2 as three numbers separated by spaces, before
599
returning. If the command returns a non-zero return value, dispread
600
will abort. Note that a test window will also be created on the
601
system running dispread.<br>
603
<a name="W"></a>The <b>-W</b> <span style="font-weight: bold;">n|h|x</span>
604
parameter overrides the default serial communications flow control
605
setting. The value <span style="font-weight: bold;">n</span> turns
606
all flow control off, <span style="font-weight: bold;">h</span>
607
sets hardware handshaking, and <span style="font-weight: bold;">x</span>
608
sets Xon/Xoff handshaking. This commend may be useful in workaround
609
serial communications issues with some systems and cables. <br>
611
<a name="D"></a>The <b>-D</b> flag causes communications and other
612
instrument diagnostics to be printed to stdout. A level can be set
613
between 1 .. 9, that may give progressively more verbose
614
information, depending on the instrument. This can be useful in
615
tracking down why an instrument can't connect.<br>
617
<a name="p1"></a> The final parameter on the command line is the
618
base filename for the <a href="File_Formats.html#.ti1">.ti1</a>
619
input file, and the <a href="File_Formats.html#.ti3">.ti3</a>
620
output file. <b>dispread</b> will add the .ti1 and .ti3 extensions
623
<span style="font-weight: bold;">NOTE</span> that on an X11 system,
624
if the environment variable <span style="font-weight: bold;">ARGYLL_IGNORE_XRANDR1_2</span>
625
is set (ie. set it to "yes"), then the presence of the XRandR 1.2
626
extension will be ignored, and other extensions such as Xinerama and
627
XF86VidMode extension will be used. This may be a way to work around
628
buggy XRandR 1.2 implementations.<br>
630
<hr style="width: 100%; height: 2px;"><br>
631
If a large number of patches is being read, the screensaver on many
632
systems can interfere with the operation of dispread. It is
633
therefore advisable in these cases to manually turn off the
634
screensaver before commencing the measurements.<br>
636
If communications break down with a USB connected instrument, you
637
may have to unplug it, and plug it in again to recover.<br>
639
Some systems (Apple OSX in particular) have a special set of user
640
interface controls ("Universal Access") that allows altering the
641
display in ways designed to assist visually impaired users, by
642
increasing contrast etc. This will interfere badly with any attempts
643
to calibrate or profile such a system, and must be turned off in
644
order to do so. Note that certain magic keyboard sequences can turn
645
this on by accident.<br>