diff options
Diffstat (limited to 'doc/dispwin.html')
-rw-r--r-- | doc/dispwin.html | 949 |
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;"> </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;"> </span><a
+ style="font-family: monospace;" href="#v">-v</a><span
style="font-family: monospace;"> Verbose @@ -47,17 +47,21 @@ 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> + + + +
+ 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 @@ -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;"> <a href="#d">-d n</a> [Not X11] @@ -88,8 +96,12 @@ X11] - Choose the display from the following list (default 1)<br> - </span></font><span style="font-family: monospace;"> <a + + + +
+ Choose the display from the following list (default 1)<br>
+ </span></font><span style="font-family: monospace;"> <a
href="#dweb">-dweb[:port]</a> @@ -100,16 +112,24 @@ X11] - 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 - 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;"> + + + +
+ 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 @@ -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;"> 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>
@@ -149,9 +177,13 @@ ss: - ss,vs: = optional horizontal, vertical scale.<br> - </span></font><font size="-1"><span style="font-family: - monospace;"><a href="#F">-F</a> + + + +
+ ss,vs: = optional horizontal, vertical scale.<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"><a href="#F">-F</a>
Fill whole @@ -166,30 +198,38 @@ 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> + + + +
+ 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 + + + +
+ </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 @@ -204,9 +244,13 @@ just - video LUT loading & Beeps<br> - </span></font><font size="-1"><span style="font-family: - monospace;"> <a href="#n">-n</a> + + + +
+ video LUT loading & Beeps<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"> <a href="#n">-n</a>
Test native @@ -221,7 +265,11 @@ native - display values (rather than through Video LUT and C.M.)<br> + + + +
+ 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 @@ -236,9 +284,13 @@ the - currently loaded Video LUT to 'filename'<br> - </span></font><font size="-1"><span style="font-family: - monospace;"> <a href="#c">-c</a> + + + +
+ currently loaded Video LUT to 'filename'<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"> <a href="#c">-c</a>
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;"> <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;"> <a href="#V">-V</a>
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;"> <a href="#I">-I</a> + + + +
+ calfile/profile cal. is currently loaded in LUT<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"> <a href="#I">-I</a>
@@ -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;"> <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;"> <a href="#U">-U</a>
@@ -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>
<a href="#S">-S d</a> 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>
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;"> <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;"> <a href="#L">-L</a>
@@ -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;"> <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;"> <a href="#X">-<font size="-1">X</font></a>
@@ -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;"> </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;"> </span><a style="font-family: monospace;"
href="#D">-D [level]</a><span style="font-family: monospace;"> 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> - </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>
+ </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 @@ -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 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. 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.) - 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> + + + +
+ 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 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. 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.)
+ 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>
|