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
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>dispwin</title>
<meta http-equiv="content-type" content="text/html;
charset=windows-1252">
<meta name="author" content="Graeme Gill">
</head>
<body>
<h2><b>spectro/dispwin</b></h2>
<h3>Summary</h3>
This tool has several different but related functions. When given as
a file argument an ICC profile containing vcgt "gamma" curves, or an
Argyll video calibration .cal file, it will load that calibration
into the chosen display. It can also install or uninstall a profile
in the system for the chosen display, or set the display calibration
to that in the currently installed system profile. By default it
displays a test window the same as that used by dispcal and
dispread, to test this functionality. It can also be used to test
the ability to load video card LUT curves to each display, and to
test how the console Bell will sound when used with some instruments
(ie. Eye-One Pro).<br>
<br>
[Note that in OS X 10.7 Lion, changes to the default system profile
permissions mean that you can't set a calibration persistently when
the default system profile is being used, unless you run as root
(ie. use sudo). Note that you do <span style="font-weight: bold;">not</span>
need to run as root to install a user profile (-Su, the default
install type.)]<br>
<h3>Usage</h3>
<font size="-1"><span style="font-family: monospace;">dispwin
[options] [<span style="font-style: italic;">calfile</span>]</span><br
style="font-family: monospace;">
<span style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#v">-v</a><span
style="font-family: monospace;">
Verbose
mode<br>
</span></font><font size="-1"><span style="font-family:
monospace;"> </span><a style="font-family: monospace;"
href="#display">-display displayname</a><span
style="font-family: monospace;"> [<span style="font-weight:
bold;">X11 only</span>] Choose X11 display name<br>
</span></font><font size="-1"><span style="font-family:
monospace;"> <a href="#dnm">-d n[,m]</a>
[<span style="font-weight: bold;">X11 only</span>] Choose the
display from the following list (default 1),<br>
and
optionally
choose a different display m for Video LUT access.<br>
</span></font><font size="-1"><span style="font-family:
monospace;"> <a href="#d">-d n</a>
[Not
X11]
Choose the display from the following list (default 1)<br>
</span></font><span style="font-family: monospace;"> <a
href="#dweb">-dweb[:port]</a>
Display via a web server at port (default 8080)</span><br>
<span style="font-family: monospace;"> <a
href="dispwin.html#dmadvr">-dmadvr</a>
[MSWin] Display via MadVR Video Renderer</span><br>
<tt> </tt><tt><a href="#dcc">-dcc[:n]</a>
</tt><tt></tt><tt>Display via n'th ChromeCast (default 1, ? for
list)</tt><br style="font-family: monospace;">
<font size="-1"><span style="font-family: monospace;"></span><span
style="font-family: monospace;"> <a href="#P">-P
ho,vo,ss[,vs]</a> Position test window
and scale it</span><br style="font-family: monospace;">
<span style="font-family: monospace;">
ho,vi:
0.0
= left/top, 0.5 = center, 1.0 = right/bottom etc.</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
ss:
0.5
= half, 1.0 = normal, 2.0 = double etc.<br>
ss,vs: = optional horizontal, vertical scale.<br>
</span></font><font size="-1"><span style="font-family:
monospace;"><a href="#F">-F</a>
Fill
whole
screen with black background</span></font><br>
<font size="-1"><span style="font-family: monospace;"> </span></font><font
size="-1"><span style="font-family: monospace;"><a href="#E">-E</a>
</span></font><small><span style="font-family: monospace;">Video
encode output as (16-235)/255 "TV" levels</span></small><br
style="font-family: monospace;">
<font size="-1"><span style="font-family: monospace;"></span><span
style="font-family: monospace;"> </span><a
style="font-family: monospace;" href="#i">-i</a><span
style="font-family: monospace;">
Run forever with random values<br>
<a href="#G">-G <span style="font-style: italic;">filename</span></a>
Display RGB
colors from CGATS file<br>
</span></font><font size="-1"><a style="font-family:
monospace;" href="#m">-m</a><span style="font-family:
monospace;">
Manually step through colors</span></font><br>
<font size="-1"><span style="font-family: monospace;"> <a
href="#r">-r</a>
Test
just
video LUT loading & Beeps<br>
</span></font><font size="-1"><span style="font-family:
monospace;"> <a href="#n">-n</a>
Test
native
display values (rather than through Video LUT and C.M.)<br>
<a href="#s">-s <span style="font-style: italic;">filename.cal</span></a>
Save
the
currently loaded Video LUT to 'filename'<br>
</span></font><font size="-1"><span style="font-family:
monospace;"> <a href="#c">-c</a>
Load
a
linear display calibration (clear calibration)</span></font><font
size="-1"><span style="font-family: monospace;"><br>
</span></font><font size="-1"><span style="font-family:
monospace;"> <a href="#V">-V</a>
Verify
that
calfile/profile cal. is currently loaded in LUT<br>
</span></font><font size="-1"><span style="font-family:
monospace;"> <a href="#I">-I</a>
</span></font><font size="-1"><span style="font-family:
monospace;">Install profile for display and use its calibration<br>
</span></font><font size="-1"><span style="font-family:
monospace;"> <a href="#U">-U</a>
</span></font><font size="-1"><span style="font-family:
monospace;">Un-install profile for display<br>
<a href="#S">-S d</a>
Specify
the
install/uninstall scope for OS X [nlu] or Vista [lu]<br>
d
is
one of: n = network, l = local system, u = user (default)<br>
</span></font><font size="-1"><span style="font-family:
monospace;"></span></font><font size="-1"><span
style="font-family: monospace;"> <a href="#L">-L</a>
</span></font><font size="-1"><span style="font-family:
monospace;">Load installed profiles cal. into Video LUT<br>
</span></font><font size="-1"><span style="font-family:
monospace;"> <a href="#X">-<font size="-1">X</font></a>
[<span style="font-weight: bold;">X11 only</span>] Run in daemon
loader mode for given X11 server <br>
</span></font><font size="-1"><span style="font-family:
monospace;"> </span><a style="font-family: monospace;"
href="#D">-D [level]</a><span style="font-family: monospace;">
Print
debug
diagnostics to stderr</span></font><font size="-1"><span
style="font-family: monospace;"></span></font><font size="-1"><span
style="font-family: monospace;"></span><span style="font-family:
monospace;"><br>
</span></font><a style="font-family: monospace;"
href="#p1"><font size="-1"><span style="font-family: monospace;"></span></font></a><font
size="-1"><a style="font-family: monospace;" href="#p1"><i>calfile</i></a><span
style="font-family: monospace;">
Load
display
calibration (<a href="cal_format.html">.cal</a> or .icm) into
LUT, and exit.</span><span style="font-family: monospace;"></span><span
style="font-family: monospace;"></span></font><br>
<br>
<h3>Comments<br>
</h3>
<a name="v"></a> The <b>-v</b> flag makes the program more
verbose..<br>
<br>
<a name="display"></a><span style="font-weight: bold;">display</span>:
When running on a UNIX based system that used the X11 Windowing
System, <b>dispwin</b> will by default use the $DISPLAY environment
variable to determine which display and screen to read from. This
can be overridden by supplying an X11 display name to the <span
style="font-weight: bold;">-display</span> option. Note that if
Xinerama is active, you can't select the screen using $DISPLAY or
-display, you have to select it using the <span style="font-weight:
bold;">-d</span> parameter.<br>
<br>
<a name="d"></a><span style="font-weight: bold;">-d</span>: By
default the location of the test window will be the main display. If
the system has more than one display or screen, an alternate
display/screen can be selected with the <span style="font-weight:
bold;">-d</span> parameter. If you invoke <span
style="font-weight: bold;">dispwin</span> so as to display the
usage information (i.e. "dispcal -?" or "dispcal --"), then the
discovered displays/screens will be listed. Multiple displays may
not be listed if they appear as a single display to the operating
system (ie. the multi-display support is hidden in the video card
driver). On UNIX based system that used the X11 Windowing System,
the <span style="font-weight: bold;">-d</span> parameter will
override the screen specified by the $DISPLAY or <span
style="font-weight: bold;">-display</span> parameter.<br>
<span style="font-weight: bold;"></span><br>
<span style="font-weight: bold;">Note</span> that if VideoLUTs for a
display are not accessible (i.e. no hardware calibration
capability), <span style="font-weight: bold;">dispwin</span> will
will issue a warning or fail when it attempts to access them.<br>
<br>
On X11 the inability to access VideoLUTs could be because you are
trying to access a remote display, and the remote display doesn't
support the XF86VidMode extension, or perhaps you are running
multiple monitors using NVidia TwinView, or MergedFB, and trying to
access anything other than the primary monitor. TwinView and
MergedFB don't properly support the XF86VidMode extension for
multiple displays. You can use <a href="dispwin.html#r">dispwin -r</a>
to test whether the VideoLUTs are accessible for a particular
display. See also below, on how to select a different display for
VideoLUT access. Also note that dispcal will fail if the Visual
depth doesn't match the VideoLUT depth. Typically the VideoLUTs have
256 entries per color component, so the Visual generally needs to be
24 bits, 8 bits per color component.<br>
<br>
More modern X11 systems support the XRANDR extension, which handles
multiple displays much more gracefully, but note that there are
limitations in profiling and calibrating Mirrored or Cloned
Displays. Mirrored displays share the same frame buffer space
(Separate CRTC's with overlapping pixel locations) but can have
different calibration curves, while Cloned displays share both frame
buffer space and calibration curves (A single CRTC feeding multiple
Outputs). <b>dispwin</b> will show different display selections for
each output, but calibration or application of color management may
only be correct for the last set display (i.e. if frame buffer space
overlaps, or there is only a single CRTC to hold calibration curves,
and a single _ICC_PROFILE_xxx root atom holding the profile, if the
application is using the Xinerama convention for obtaining a
profile, rather than the Xrandr per Output property _ICC_PROFILE
convention.) <br>
<br>
<a name="dnm"></a><span style="font-weight: bold;">-d n[,m]</span>Because
of
the
difficulty cause by TwinView and MergedFB in X11 based systems, you
can optionally specify a separate display number after the display
that is going to be used to present test patches, for accessing the
VideoLUT hardware. This must be specified as a single string, e.g. <span
style="font-weight: bold;">-d 1,2</span> . Some experimentation
may be needed on such systems, to discover what screen has access to
the VideoLUT hardware, and which screens the test patches appear on.
You may be able to calibrate one screen, and then share the
calibration with another screen. Profiling can be done independently
to calibration.<br>
<br>
<a name="dweb"></a><span style="font-weight: bold;">-dweb</span> or
<span style="font-weight: bold;">-dweb:<i>port</i></span> starts a
standalone web server on your machine, which then allows a local or
remote web browser to display the the color test patches. By default
port <span style="font-weight: bold;">8080</span> is used, but this
can be overridden by appending a <span style="font-weight: bold;">:</span>
and the port number i.e. <span style="font-weight: bold;">-dweb:8001</span>.
The URL will be <span style="font-weight: bold;">http://</span>
then name of the machine or its I.P. address followed by a colon and
the port number - e.g something like <span style="font-weight:
bold;">http://192.168.0.1:8080</span>. If you use the verbose
option (<span style="font-weight: bold;">-v</span>) then a likely
URL will be printed once the server is started, or you could run <span
style="font-weight: bold;">ipconfig</span> (MSWin) or <span
style="font-weight: bold;">/sbin/ifconfig</span> (Linux or OS X)
and identify an internet address for your machine that way. <b>JavaScript</b>
needs to be enabled in your web browser for this to work. You may
have to modify any firewall to permit port 8080 to be accessed on
your machine.<br>
<br>
Note that if you use this method of accessing a display, that there
is no access to the display Video Lookup tables, and that any
operation that depends on accessing the VideoLUTs will either
generate a warning or fail.<br>
<br>
<a name="dmadvr"></a><span style="font-weight: bold;">-dmadvr</span>
[MSWin only] causes test patches to be displayed using the MadVR
video renderer. Note that will have to start <b>MadTPG</b> before
running dispread, and that while you can adjust the "Test Pattern
Configuration" controls, you should <u>not</u> normally alter the
"Existing Calibration" controls, as dispread will set these
appropriately. See <a href="#n">-n</a> flag.<br>
<br>
<a name="dcc"></a><span style="font-weight: bold;">-dcc</span> or <b>-dcc:<i>no</i></b>
causes test patches to be displayed using and available <a
href="http://en.wikipedia.org/wiki/Chromecast">ChromeCast</a> to
your TV. Use <b>-dcc:?</b> to display a list of ChromeCasts on your
local network. Note that the ChromeCast as a test patch source is
probably the<b> least accurate</b> of your choices, since it
up-samples the test patch and transforms from RGB to YCC and back,
but should be accurate within ± 1 bit. You may have to modify any
firewall to permit port 8081 to be accessed on your machine if it
falls back to the Default receiver (see <a href="Installing.html">installation
instructions</a> for your platform).<br>
<br>
<a name="P"></a> The <span style="font-weight: bold;">-P</span>
parameter allows you to position and size the test patch window. By
default it is places in the center of the screen, and sized
appropriately for the type of instrument, or 10% of the width of the
display if the display size is unknown.. The <span
style="font-weight: bold;">ho</span> and <span
style="font-weight: bold;">vo</span> values govern the horizontal
and vertical offset respectively. A value of 0.0 positions the
window to the far left or top of the screen, a value of 0.5
positions it in the center of the screen (the default), and 1.0
positions it to the far right or bottom of the screen. If three
parameters are provided, then the <span style="font-weight: bold;">ss</span>
parameter is a scale factor for the test window size. A value of 0.5
for instance, would produce a half sized window. A value of 2.0 will
produce a double size window. If four parameters are provided, then
the last two set independent horizontal and vertical scaling
factors. Note that the ho,vo,ss or ho,vo,hs,vs numbers must be
specified as a single string (no space between the numbers and the
comma). For example, to create a double sized test window at the top
right of the screen, use <span style="font-weight: bold;">-P 1,0,2</span>
. To create a window twice as wide as high: <span
style="font-weight: bold;">-P 1,0,2,1</span>.<br>
<br>
<a name="F"></a> The <span style="font-weight: bold;">-F</span>
flag causes the while screen behind the test window to be masked
with black. This can aid black accuracy when measuring CRT displays
or projectors.<br>
<br>
<a name="E"></a> The <span style="font-weight: bold;">-E</span>
flag causes the test values to be scaled to the Video RGB encoding
range of 16/255 to 235/255. Note that this is not applicable if the
MadVR render is being used to display patches, as MadVR should be
configured for Video encoding instead.<br>
<br>
By default <span style="font-weight: bold;">dispwin</span> will put
a test window on the selected display, and display some test colors,
before darkening then brightening the screen by loading video
LUT values, test the bell sounds, then restore the original values
and exit.<br>
<br>
If the <a name="i"></a><span style="font-weight: bold;">-i</span>
flag is set, then <span style="font-weight: bold;">dispwin</span>
will display the preset sequence, then random test colors forever.<br>
<br>
If the <a name="G"></a><span style="font-weight: bold;">-G</span>
parameter is set, then <span style="font-weight: bold;">dispwin</span>
will display the sequence of RGB color in the supplied CGATS file,
e.g. a .ti1 file. Typically this might the used with the <span
style="font-weight: bold;">-m</span> option to manually measure a
set of test patches.<br>
<br>
If the <a name="m"></a><span style="font-weight: bold;">-m</span>
flag is set, then <span style="font-weight: bold;">dispwin</span>
will display the preset sequence then exits, but advances manually
after each return key.<br>
<br>
If the <a name="r"></a><span style="font-weight: bold;">-r</span>
flag is set, then <span style="font-weight: bold;">dispwin</span>
will test just the loading of video LUT values by first darkening,
then lightening the screen, before exiting.<br>
<br>
If the <a name="n"></a><span style="font-weight: bold;">-n</span>
flag is set, then <span style="font-weight: bold;">dispwin</span>
will display the colors directly on the display, rather than having
the color values translated through the currently loaded Video LUTs.
In the case of using the MadVR renderer to display the patches, any
3dLut will also be disabled.<br>
<br>
<a name="s"></a> If a <span style="font-weight: bold;">-s <span
style="font-style: italic;">filename.cal</span></span> option is
used, then rather than displaying a test window, <span
style="font-weight: bold;">dispwin</span> will save the currently
loaded calibration curves to the given calibration file. Note that
other functions such as clearing or loading a calibration can be
performed after this action.<br>
<br>
<a name="c"></a> If a <span style="font-weight: bold;">-c</span>
flag is used, then rather than displaying a test window, <span
style="font-weight: bold;">dispwin</span> will load the selected
display with a linear set of Video LUT curves, effectively clearing
the calibration, and will then exit. Note that other functions such
as loading a calibration can be performed after this action.<span
style="font-style: italic;"></span><br>
<br>
<a name="V"></a> If a <span style="font-weight: bold;">-V</span>
flag is used, then rather than loading the calibration specified as
the final argument, the currently loaded calibration will be
verified as being the same as the given calibration file. If this is
combined with the <span style="font-weight: bold;"><span
style="font-weight: bold;">-L</span></span> flag, the currently
loaded calibration will be verified as being the same as the
installed system profile for the display.<br>
<br>
<a name="I"></a><span style="font-weight: bold;">-I</span>: The ICC
profile specified as the final argument will be installed as the
default operating system profile for the chosen display, and the
display calibration will be set to the calibration tag ('vcgt' tag,
if any) in that profile. On MSWindows and OS X this means that the
profile will be copied to the appropriate color profile directory
and registered with the operating system. <br>
<br>
For Linux X11 systems, the profile will be installed using <span style="white-space: pre;"> using </span>the
<a href="ucmm.html">ucmm</a> convention by default, and this
associates the display hardware identification (EDID) of the
selected display, with the profile. The X11 _ICC_PROFILE property
will be set in the root window, and also the the XrandR 1.2 X11
_ICC_PROFILE output property on systems that are running XrandR 1.2
or later. The use of atoms is following this <a
href="http://www.burtonini.com/computing/x-icc-profiles-spec-0.2.html">convention</a>
for allowing applications to locate the display profile for a
particular X11 display, and expands it to accomodate XrandR 1.2.
Note that for X11 systems, the properties are not persistent, and
will need to be loaded each time the X11 server is started (see the
<a href="#L">-L</a> flag).<br>
<br>
If the <b>ARGYLL_USE_COLORD</b> environment variable is set (ie.
set it to "yes"), then on Gnome systems running <b>colord</b><span style="white-space: pre;">, dispwin will attempt to store and retrieve display ICC profiles using<br>colord.<br><br></span>
To make sure that the profile calbration 'vcgt' tag gets loaded into
the Graphics Card at system start, please read the guide <a href="dispprofloc.html">here</a>.<br>
<br>
<a name="U"></a><span style="font-weight: bold;">-U</span>: The ICC
profile specified as the final argument will be un-installed as the
default operating system profile for the chosen display. The display
calibration will remain unchanged.<br>
<br>
<a name="S"></a><span style="font-weight: bold;">-S</span> d: Some
systems have more than one profile scope that an installed profile
will apply to, and this parameter allows overriding the default user
scope. On OS X, there is a choice of three scopes: <span style="font-weight: bold;">n</span>: for network scope, if people
are sharing profiles over a network, <span style="font-weight:
bold;">l</span>: local system scope, which installs the profile
for all users of a system, and the default <span style="font-weight: bold;">u</span>, which covers just the user
installing the profile. On Linux or Microsoft Vista, just the local
system <span style="font-weight: bold;">l</span> and user <span style="font-weight: bold;">u</span> scope are available. Note that
you may need to run dispwin with elevated privileges(sudo) to be
able to successfully use network or local system scope. This option
also applies to uninstalling a profile. Note that to install a user
profile for the root account, you will have to login as root (sudo
will not achieve this).<br>
<br>
<a name="L"></a> <span style="font-weight: bold;">-L</span>: This
option fetches the current installed system profile for the chosen
display, and sets the display to the calibration tag ('vcgt' tag, if
any) in the profile. This is a convenient way of initializing the
display on system startup from the installed display profile, if the
system doesn't not do this automatically .<br>
<br>
<a name="X"></a> <span style="font-weight: bold;">-X</span>: Daemon
mode (experimental). When running on a UNIX based system that used
the X11 Windowing System, this option runs dispwin in a "daemon"
mode where it monitors the given X11 server, waiting for any changes
in monitors that may require loading a matching ICC profile (ie.
such as re-configuring, plugging in a different monitor etc.)
This only works if XRandR 1.2 is available on the server. By default
dispwin runs silently, and will not terminate. If the <span style="font-weight: bold;">-v</span> option is given, it will emit
messages to stdout to show what it is doing. When it is first
invoked, it will load the installed profiles of all the screens of
the given X11 server.<br>
<br>
<a name="D"></a>The <b>-D</b> flag causes diagnostics to be printed
to stdout. A level can be set between 1 .. 9, that may give
progressively more verbose information. This can be useful in
tracking down why an operation fails.<br>
<br>
<a name="p1"></a> The final optional parameter on the command line
is the name of an ICC profile that contains a Video LUT <span style="font-weight: bold;">vcgt</span> tag, or an Argyll <a href="cal_format.html">.cal</a> format display calibration. If
this parameter is provided, then the selected display will be loaded
with the given calibration. If the <span style="font-weight: bold;">-V</span>
flag was given, then it is verified that this calibration is the
currently loaded one. This may be useful in initializing a
system to the current calibration on system startup, although a
better way may be to install the profile (<span style="font-weight:
bold;">-I</span> option), and then just use <span style="font-weight: bold;">-L</span>. Note that the vcgt tag
interpretation within Argyll is consistent with that of the
originators of the tag. Other ICC profile vcgt implementations may
not be so consistent.<br>
<br>
<span style="font-weight: bold;">NOTE</span> that on an X11 system,
if the environment variable <span style="font-weight: bold;">ARGYLL_IGNORE_XRANDR1_2</span>
is set (ie. set it to "yes"), then the presence of the XRandR 1.2
extension will be ignored, and other extensions such as Xinerama and
XF86VidMode extension will be used. This may be a way to work around
buggy XRandR 1.2 implementations.<br>
<span style="font-weight: bold;"><br>
NOTE</span> on MSWin systems that you will have to disable any
other calibration installer program if you want to be able to
control calibration using dispwin. Note also that there are other
programs that will interfere with calibration loading, such as
igfxpers.exe that gets installed with nVidia "Optimus" technology.<br>
<br>
<br>
<br>
<br>
</body></html>
|
