summaryrefslogtreecommitdiff
path: root/doc/dispwin.html
blob: 6036e76e5e0857c0e7ed91b5a529c52d4196f7d3 (plain)
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
<!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;">&nbsp;</span><a
        style="font-family: monospace;" href="#v">-v</a><span
        style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;
Verbose















        mode<br>
      </span></font><font size="-1"><span style="font-family:
        monospace;">&nbsp;</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;">&nbsp;<a href="#dnm">-d n[,m]</a>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        [<span style="font-weight: bold;">X11 only</span>] Choose the
        display from the following list (default 1),<br>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
and
optionally















        choose a different display m for Video LUT access.<br>
      </span></font><font size="-1"><span style="font-family:
        monospace;">&nbsp;<a href="#d">-d n</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
[Not
X11]















        Choose the display from the following list (default 1)<br>
      </span></font><span style="font-family: monospace;">&nbsp;<a
        href="#dweb">-dweb[:port]</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;













      Display via a web server at port (default 8080)</span><br>
    <span style="font-family: monospace;">&nbsp;<a
        href="dispwin.html#dmadvr">-dmadvr</a>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
      [MSWin] Display via MadVR Video Renderer</span><br>
    <tt>&nbsp;</tt><tt><a href="#dcc">-dcc[:n]</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;


    </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;">&nbsp;<a href="#P">-P
          ho,vo,ss[,vs]</a>&nbsp;&nbsp;&nbsp;&nbsp; Position test window
        and scale it</span><br style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
ss:
0.5















        = half, 1.0 = normal, 2.0 = double etc.<br>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;











        ss,vs: = optional horizontal, vertical scale.<br>
        &nbsp;</span></font><font size="-1"><span style="font-family:
        monospace;"><a href="#F">-F</a>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Fill
whole















        screen with black background</span></font><br>
    <font size="-1"><span style="font-family: monospace;">&nbsp;</span></font><font
      size="-1"><span style="font-family: monospace;"><a href="#E">-E</a>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;






      </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;">&nbsp;</span><a
        style="font-family: monospace;" href="#i">-i</a><span
        style="font-family: monospace;">
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        &nbsp;&nbsp;&nbsp;&nbsp; Run forever with random values<br>
        &nbsp;<a href="#G">-G <span style="font-style: italic;">filename</span></a>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Display RGB
        colors from CGATS file<br>
        &nbsp;</span></font><font size="-1"><a style="font-family:
        monospace;" href="#m">-m</a><span style="font-family:
        monospace;">
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        &nbsp;&nbsp;&nbsp;&nbsp; Manually step through colors</span></font><br>
    <font size="-1"><span style="font-family: monospace;">&nbsp;<a
          href="#r">-r</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Test
just















        video LUT loading &amp; Beeps<br>
      </span></font><font size="-1"><span style="font-family:
        monospace;">&nbsp;<a href="#n">-n</a>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Test
native















        display values (rather than through Video LUT&nbsp; and C.M.)<br>
        &nbsp;<a href="#s">-s <span style="font-style: italic;">filename.cal</span></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Save
the















        currently loaded Video LUT to 'filename'<br>
      </span></font><font size="-1"><span style="font-family:
        monospace;">&nbsp;<a href="#c">-c</a>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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;">&nbsp;<a href="#V">-V</a>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Verify
that















        calfile/profile cal. is currently loaded in LUT<br>
      </span></font><font size="-1"><span style="font-family:
        monospace;">&nbsp;<a href="#I">-I</a>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;















      </span></font><font size="-1"><span style="font-family:
        monospace;">Install profile for display and use it's calibration<br>
      </span></font><font size="-1"><span style="font-family:
        monospace;">&nbsp;<a href="#U">-U</a>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;















      </span></font><font size="-1"><span style="font-family:
        monospace;">Un-install profile for display<br>
        &nbsp;<a href="#S">-S d</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Specify
the















        install/uninstall scope for OS X [nlu] or Vista [lu]<br>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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;">&nbsp;<a href="#L">-L</a>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;















      </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;">&nbsp;<a href="#X">-<font size="-1">X</font></a>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;















        [<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;">&nbsp;</span><a style="font-family: monospace;"
        href="#D">-D [level]</a><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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>
        &nbsp;</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;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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>
    <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 you may have to start the video playback
    software and load a video clip in pause for this to work. MadVR
    rendering does not need or support VideoLUT access, but be aware
    that the state of the Graphics Card VideoLUTs may affect the results
    (check this using dispwin). Test patch colors <u>will</u> be
    processed by the MadVR 3dLut by default (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&nbsp; then brightening the screen by loading video
    LUT values, test the bell sounds, then restore the original values
    and exit.<br>
    <br>
    If the&nbsp;<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&nbsp;<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&nbsp;<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&nbsp;<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&nbsp;<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. For Linux X11 systems, the
    profile will be installed using the <a href="ucmm.html">ucmm</a>
    convention, and the X11 _ICC_PROFILE property 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 latter 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). 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.)&nbsp;
    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.&nbsp; 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>