summaryrefslogtreecommitdiff
path: root/doc/dispwin.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/dispwin.html')
-rw-r--r--doc/dispwin.html949
1 files changed, 530 insertions, 419 deletions
diff --git a/doc/dispwin.html b/doc/dispwin.html
index f1d75f5..6036e76 100644
--- a/doc/dispwin.html
+++ b/doc/dispwin.html
@@ -1,38 +1,38 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html>
- <head>
- <title>dispwin</title>
- <meta http-equiv="content-type" content="text/html;
- charset=ISO-8859-1">
- <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
+<!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
@@ -47,17 +47,21 @@ 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>
+
+
+
+
+ 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
@@ -72,8 +76,12 @@ optionally
- choose a different display m for Video LUT access.<br>
- </span></font><font size="-1"><span style="font-family:
+
+
+
+
+ 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]
@@ -88,8 +96,12 @@ X11]
- Choose the display from the following list (default 1)<br>
- </span></font><span style="font-family: monospace;">&nbsp;<a
+
+
+
+
+ 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;
@@ -100,16 +112,24 @@ X11]
- 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
- 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;">
+
+
+
+
+ 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
@@ -124,8 +144,12 @@ ho,vi:
- = left/top, 0.5 = center, 1.0 = right/bottom etc.</span><br
- style="font-family: monospace;">
+
+
+
+
+ = 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
@@ -140,7 +164,11 @@ ss:
- = half, 1.0 = normal, 2.0 = double etc.<br>
+
+
+
+
+ = 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;
@@ -149,9 +177,13 @@ ss:
- ss,vs: = optional horizontal, vertical scale.<br>
- &nbsp;</span></font><font size="-1"><span style="font-family:
- monospace;"><a href="#F">-F</a>
+
+
+
+
+ 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
@@ -166,30 +198,38 @@ 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>
+
+
+
+
+ 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
+
+
+
+
+ </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
@@ -204,9 +244,13 @@ just
- video LUT loading &amp; Beeps<br>
- </span></font><font size="-1"><span style="font-family:
- monospace;">&nbsp;<a href="#n">-n</a>
+
+
+
+
+ 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
@@ -221,7 +265,11 @@ native
- display values (rather than through Video LUT&nbsp; and C.M.)<br>
+
+
+
+
+ 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
@@ -236,9 +284,13 @@ the
- currently loaded Video LUT to 'filename'<br>
- </span></font><font size="-1"><span style="font-family:
- monospace;">&nbsp;<a href="#c">-c</a>
+
+
+
+
+ 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
@@ -253,10 +305,14 @@ 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>
+
+
+
+
+ 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
@@ -271,9 +327,13 @@ 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>
+
+
+
+
+ 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;
@@ -286,10 +346,14 @@ that
- </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>
+
+
+
+
+ </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;
@@ -302,8 +366,12 @@ that
- </span></font><font size="-1"><span style="font-family:
- monospace;">Un-install profile for display<br>
+
+
+
+
+ </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
@@ -318,7 +386,11 @@ the
- install/uninstall scope for OS X [nlu] or Vista [lu]<br>
+
+
+
+
+ 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
@@ -333,10 +405,14 @@ 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>
+
+
+
+
+ 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;
@@ -349,10 +425,14 @@ is
- </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>
+
+
+
+
+ </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;
@@ -365,10 +445,14 @@ is
- [<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;"
+
+
+
+
+ [<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
@@ -383,13 +467,17 @@ 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
+
+
+
+
+ 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
@@ -404,59 +492,63 @@ 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>
+
+
+
+
+ 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
@@ -471,242 +563,261 @@ 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:port</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.<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="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. 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>
+
+
+
+
+ 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>