diff options
Diffstat (limited to 'doc/dispcal.html')
| -rw-r--r-- | doc/dispcal.html | 2836 |
1 files changed, 1418 insertions, 1418 deletions
diff --git a/doc/dispcal.html b/doc/dispcal.html index d66caf5..ff96ff2 100644 --- a/doc/dispcal.html +++ b/doc/dispcal.html @@ -1,28 +1,28 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<html> - <head> - <title>dispcal</title> - <meta http-equiv="content-type" content="text/html; - charset=windows-1252"> - <meta name="author" content="Graeme Gill"> - </head> - <body> - <h2><b>spectro/dispcal</b></h2> - <h3>Summary</h3> - Given calibration target information [white point, maximum - brightness, and response curve ("gamma")], display a series of test - patches on the display, and using the colorimetric values read, - create a calibration lookup tables that make the display meet the - desired target. The type of instrument is determined by the - communication port selected. Emission and display measurement - instruments are supported.<br> - <h3>Usage</h3> - <font size="-1"><span style="font-family: monospace;">dispcal - [-options]</span><i style="font-family: monospace;"> inoutfile</i><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#v">-v [n]</a><span - style="font-family: monospace;"> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+ <head>
+ <title>dispcal</title>
+ <meta http-equiv="content-type" content="text/html;
+ charset=windows-1252">
+ <meta name="author" content="Graeme Gill">
+ </head>
+ <body>
+ <h2><b>spectro/dispcal</b></h2>
+ <h3>Summary</h3>
+ Given calibration target information [white point, maximum
+ brightness, and response curve ("gamma")], display a series of test
+ patches on the display, and using the colorimetric values read,
+ create a calibration lookup tables that make the display meet the
+ desired target. The type of instrument is determined by the
+ communication port selected. Emission and display measurement
+ instruments are supported.<br>
+ <h3>Usage</h3>
+ <font size="-1"><span style="font-family: monospace;">dispcal
+ [-options]</span><i style="font-family: monospace;"> inoutfile</i><br
+ style="font-family: monospace;">
+ <span style="font-family: monospace;"> </span><a
+ style="font-family: monospace;" href="#v">-v [n]</a><span
+ style="font-family: monospace;">
@@ -70,18 +70,18 @@ - - 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;"> [X11 only] Choose X11 display - name<br> - </span></font><font size="-1"><span style="font-family: - monospace;"> <a href="#dnm">-d n[,m]</a> - - [X11 only]Choose the display from the following list (default - 1),<br> +
+ 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;"> [X11 only] Choose X11 display
+ name<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"> <a href="#dnm">-d n[,m]</a>
+
+ [X11 only]Choose the display from the following list (default
+ 1),<br>
and optionally @@ -137,9 +137,9 @@ for - - VideoLUT access.</span></font><br> - <font size="-1"><span style="font-family: monospace;"> <a +
+ VideoLUT access.</span></font><br>
+ <font size="-1"><span style="font-family: monospace;"> <a
href="#d">-d n</a> Choose the @@ -195,8 +195,8 @@ list - - 1)</span></font><br> +
+ 1)</span></font><br>
<span style="font-family: monospace;"> <a href="#dweb">-dweb[:port]</a> @@ -243,9 +243,9 @@ list - - Display via a web server at port (default 8080)</span><br> - <span style="font-family: monospace;"> <a href="#dmadvr">-dmadvr</a> +
+ Display via a web server at port (default 8080)</span><br>
+ <span style="font-family: monospace;"> <a href="#dmadvr">-dmadvr</a>
@@ -276,8 +276,8 @@ list - - [MSWin] Display via MadVR Video Renderer</span><br> +
+ [MSWin] Display via MadVR Video Renderer</span><br>
<tt> </tt><tt><a href="#dcc">-dcc[:n]</a> @@ -288,13 +288,13 @@ list - - </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;"></span><span style="font-family: - monospace;"></span> <span style="font-family: monospace;"></span></font><small - style="font-family: monospace;"><span style="font-family: +
+ </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;"></span><span style="font-family:
+ monospace;"></span> <span style="font-family: monospace;"></span></font><small
+ style="font-family: monospace;"><span style="font-family:
monospace;"></span><a style="font-family: monospace;" href="#c">-c @@ -342,37 +342,37 @@ list - - listno</a><span style="font-family: monospace;"> - Set communication port from - the following list (default 1)<br> - </span></small><font size="-1"><span style="font-family: - monospace;"> </span><a style="font-family: monospace;" - href="#r">-r</a><span style="font-family: monospace;"> - - Report on the calibrated display then - exit</span></font><font size="-1"><span style="font-family: - monospace;"></span><span style="font-family: monospace;"></span><span - style="font-family: monospace;"></span><span style="font-family: - monospace;"><br> - </span></font><font size="-1"><span style="font-family: - monospace;"> </span><a style="font-family: monospace;" - href="#R">-R</a><span style="font-family: monospace;"> - - Report on the uncalibrated display then - exit</span></font><font size="-1"><span style="font-family: - monospace;"></span></font><br> - <font size="-1"><span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#m">-m</a><span - style="font-family: monospace;"> - - </span></font><font size="-1"><span - style="font-family: monospace;">Skip</span><span - style="font-family: monospace;"> adjustment of the monitor - controls</span></font><br> - <font size="-1"><span style="font-family: monospace;"><a - href="#o">-o [profile.icm]</a> Create - fast matrix/shaper profile [different filename to outfile.icm]<br> +
+ listno</a><span style="font-family: monospace;">
+ Set communication port from
+ the following list (default 1)<br>
+ </span></small><font size="-1"><span style="font-family:
+ monospace;"> </span><a style="font-family: monospace;"
+ href="#r">-r</a><span style="font-family: monospace;">
+
+ Report on the calibrated display then
+ exit</span></font><font size="-1"><span style="font-family:
+ monospace;"></span><span style="font-family: monospace;"></span><span
+ style="font-family: monospace;"></span><span style="font-family:
+ monospace;"><br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"> </span><a style="font-family: monospace;"
+ href="#R">-R</a><span style="font-family: monospace;">
+
+ Report on the uncalibrated display then
+ exit</span></font><font size="-1"><span style="font-family:
+ monospace;"></span></font><br>
+ <font size="-1"><span style="font-family: monospace;"> </span><a
+ style="font-family: monospace;" href="#m">-m</a><span
+ style="font-family: monospace;">
+
+ </span></font><font size="-1"><span
+ style="font-family: monospace;">Skip</span><span
+ style="font-family: monospace;"> adjustment of the monitor
+ controls</span></font><br>
+ <font size="-1"><span style="font-family: monospace;"><a
+ href="#o">-o [profile.icm]</a> Create
+ fast matrix/shaper profile [different filename to outfile.icm]<br>
<a href="#O">-O description</a> @@ -420,8 +420,8 @@ list - - Fast ICC Profile Description string (Default "outfile")<br> +
+ Fast ICC Profile Description string (Default "outfile")<br>
<a href="#u">-u</a> Update previous @@ -477,12 +477,12 @@ ICC - - profile VideoLUTs</span><span style="font-family: monospace;"></span><span - style="font-family: monospace;"></span><br style="font-family: - monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#q">-q [lmh]</a><span +
+ profile VideoLUTs</span><span style="font-family: monospace;"></span><span
+ style="font-family: monospace;"></span><br style="font-family:
+ monospace;">
+ <span style="font-family: monospace;"> </span><a
+ style="font-family: monospace;" href="#q">-q [lmh]</a><span
style="font-family: monospace;"> @@ -530,8 +530,8 @@ ICC - - Quality - Low, Medium (def), High<br> +
+ Quality - Low, Medium (def), High<br>
<a href="#p">-p</a> @@ -568,10 +568,10 @@ ICC - - Use telephoto mode (ie. for a projector) (if available)<br> - </span></font><font size="-1"><span style="font-family: - monospace;"><a href="#y">-y X</a> +
+ Use telephoto mode (ie. for a projector) (if available)<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"><a href="#y">-y X</a>
@@ -619,12 +619,12 @@ ICC - - Display type - instrument specific list to choose from.</span></font><font - size="-1"><span style="font-family: monospace;"><br - style="font-family: monospace;"> - </span><span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#t">-t [temp]</a><span +
+ Display type - instrument specific list to choose from.</span></font><font
+ size="-1"><span style="font-family: monospace;"><br
+ style="font-family: monospace;">
+ </span><span style="font-family: monospace;"> </span><a
+ style="font-family: monospace;" href="#t">-t [temp]</a><span
style="font-family: monospace;"> White Daylight @@ -680,10 +680,10 @@ in - - deg. K (deflt.)<br> - </span></font><font size="-1"><span style="font-family: - monospace;"> </span><a style="font-family: monospace;" +
+ deg. K (deflt.)<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"> </span><a style="font-family: monospace;"
href="#T">-T [temp]</a><span style="font-family: monospace;"> White Black @@ -739,11 +739,11 @@ temperaturee - - in deg. K</span></font><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="#w">-w x,y</a><span +
+ in deg. K</span></font><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="#w">-w x,y</a><span
style="font-family: monospace;"> @@ -791,11 +791,11 @@ temperaturee - - Set the target white point as chromaticity coordinates</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#b">-b bright</a><span +
+ Set the target white point as chromaticity coordinates</span><br
+ style="font-family: monospace;">
+ <span style="font-family: monospace;"> </span><a
+ style="font-family: monospace;" href="#b">-b bright</a><span
style="font-family: monospace;"> @@ -843,11 +843,11 @@ temperaturee - - Set the target white brightness in cd/m^2</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#g">-g gamma</a><span +
+ Set the target white brightness in cd/m^2</span><br
+ style="font-family: monospace;">
+ <span style="font-family: monospace;"> </span><a
+ style="font-family: monospace;" href="#g">-g gamma</a><span
style="font-family: monospace;"> @@ -895,9 +895,9 @@ temperaturee - - Set the target response curve gamma (Def. 2.4)</span><br - style="font-family: monospace;"> +
+ Set the target response curve gamma (Def. 2.4)</span><br
+ style="font-family: monospace;">
<span style="font-family: monospace;"> @@ -945,9 +945,9 @@ temperaturee - - Use "-gl" for L*a*b* curve</span><br style="font-family: - monospace;"> +
+ Use "-gl" for L*a*b* curve</span><br style="font-family:
+ monospace;">
<span style="font-family: monospace;"> @@ -995,8 +995,8 @@ temperaturee - - Use "-gs" for sRGB curve<br> +
+ Use "-gs" for sRGB curve<br>
Use "-g709" @@ -1052,8 +1052,8 @@ use - - -a as well!)<br> +
+ -a as well!)<br>
@@ -1101,9 +1101,9 @@ use - - Use "-g240" for SMPTE 240M curve </span></font><font size="-1"><span - style="font-family: monospace;">(should use -a as well!)</span></font><br> +
+ Use "-g240" for SMPTE 240M curve </span></font><font size="-1"><span
+ style="font-family: monospace;">(should use -a as well!)</span></font><br>
<font size="-1"><span style="font-family: monospace;"> @@ -1151,7 +1151,7 @@ use - +
Use "-G2.4 -f0" for BT.1886</span></font> @@ -1192,13 +1192,13 @@ use - - <br> - <font size="-1"><span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#G">-G gamma</a><span - style="font-family: monospace;"> - - Set the target response curve actual technical gamma<br> +
+ <br>
+ <font size="-1"><span style="font-family: monospace;"> </span><a
+ style="font-family: monospace;" href="#G">-G gamma</a><span
+ style="font-family: monospace;">
+
+ Set the target response curve actual technical gamma<br>
<a href="#f">-f [degree]</a> Amount of @@ -1254,8 +1254,8 @@ output - - offset (default all output offset)<br> +
+ offset (default all output offset)<br>
<a href="#a">-a ambient</a> @@ -1303,17 +1303,17 @@ output - - Use viewing condition adjustment for ambient in Lux<br> - </span></font><font size="-1"><span style="font-family: - monospace;"> <a href="#k">-k factor</a> - - Amount to try and correct black point hue. Default 1.0, LCD - default 0.0<br> - </span></font><font size="-1"><span style="font-family: - monospace;"> <a href="#A">-A rate</a> - - Rate of blending from neutral to black point. Default 4.0<br> +
+ Use viewing condition adjustment for ambient in Lux<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"> <a href="#k">-k factor</a>
+
+ Amount to try and correct black point hue. Default 1.0, LCD
+ default 0.0<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"> <a href="#A">-A rate</a>
+
+ Rate of blending from neutral to black point. Default 4.0<br>
<a href="#bhack">-b</a> @@ -1322,10 +1322,10 @@ output - - Use forced black point hack<br> - </span></font> <font size="-1"><span style="font-family: - monospace;"> </span><a style="font-family: monospace;" +
+ Use forced black point hack<br>
+ </span></font> <font size="-1"><span style="font-family:
+ monospace;"> </span><a style="font-family: monospace;"
href="#B">-B bkbright</a><span style="font-family: monospace;"> @@ -1373,12 +1373,12 @@ output - - Set the target black brightness in cd/m^2</span></font><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="#e">-e [n]</a><span +
+ Set the target black brightness in cd/m^2</span></font><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="#e">-e [n]</a><span
style="font-family: monospace;"> @@ -1426,12 +1426,12 @@ output - - Run n verify passes on final curves<br> - </span></font><font size="-1"><span style="font-family: - monospace;"> </span><a style="font-family: monospace;" - href="#z">-<font size="-1">z</font></a><span style="font-family: - monospace;"> +
+ Run n verify passes on final curves<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"> </span><a style="font-family: monospace;"
+ href="#z">-<font size="-1">z</font></a><span style="font-family:
+ monospace;">
@@ -1479,13 +1479,13 @@ output - - Run only verify pass on installed calibration curves</span></font><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;"> +
+ Run only verify pass on installed calibration curves</span></font><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 @@ -1541,8 +1541,8 @@ center, - - = right/bottom etc.</span><br style="font-family: monospace;"> +
+ = right/bottom etc.</span><br style="font-family: monospace;">
<span style="font-family: monospace;"> ss: 0.5 @@ -1598,9 +1598,9 @@ normal, - - = double etc.<br> - </span></font><font size="-1"><span style="font-family: +
+ = double etc.<br>
+ </span></font><font size="-1"><span style="font-family:
monospace;"> @@ -1635,10 +1635,10 @@ normal, - - ss,vs: = optional horizontal, vertical scale.</span></font><br> - <font size="-1"><span style="font-family: monospace;"> <a - href="#F">-F</a> +
+ ss,vs: = optional horizontal, vertical scale.</span></font><br>
+ <font size="-1"><span style="font-family: monospace;"> <a
+ href="#F">-F</a>
@@ -1686,11 +1686,11 @@ normal, - - Fill whole screen with black background</span></font><font - size="-1"><span style="font-family: monospace;"></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> +
+ Fill whole screen with black background</span></font><font
+ size="-1"><span style="font-family: monospace;"></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>
@@ -1717,13 +1717,13 @@ normal, - - </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="#n">-n</a><span +
+ </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="#n">-n</a><span
style="font-family: monospace;"> [X11 @@ -1779,14 +1779,14 @@ on - - test window<br> - </span></font><font size="-1"><span style="font-family: - monospace;"> </span><a style="font-family: monospace;" - href="#J">-J</a><span style="font-family: monospace;"> - - Run instrument calibration first<br> - </span></font><font size="-1"><span style="font-family: +
+ test window<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"> </span><a style="font-family: monospace;"
+ href="#J">-J</a><span style="font-family: monospace;">
+
+ Run instrument calibration first<br>
+ </span></font><font size="-1"><span style="font-family:
monospace;"> <a href="#N">-N</a> @@ -1834,18 +1834,18 @@ on - - Disable initial calibration of instrument if possible</span></font><br> - <font size="-1"><span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#H">-H</a><span - style="font-family: monospace;"> - - Use high resolution spectrum mode (if - available)<br> - </span></font><font size="-1"><span style="font-family: - monospace;"></span><span style="font-family: monospace;"><br> - </span></font><font size="-1"><span style="font-family: - monospace;"><span style="text-decoration: underline;"></span><a +
+ Disable initial calibration of instrument if possible</span></font><br>
+ <font size="-1"><span style="font-family: monospace;"> </span><a
+ style="font-family: monospace;" href="#H">-H</a><span
+ style="font-family: monospace;">
+
+ Use high resolution spectrum mode (if
+ available)<br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"></span><span style="font-family: monospace;"><br>
+ </span></font><font size="-1"><span style="font-family:
+ monospace;"><span style="text-decoration: underline;"></span><a
href="#X1">-X file.ccmx</a> @@ -1893,9 +1893,9 @@ on - - Apply Colorimeter Correction Matrix</span></font><br> - <span style="font-family: monospace;"> <a href="#X2">-X +
+ Apply Colorimeter Correction Matrix</span></font><br>
+ <span style="font-family: monospace;"> <a href="#X2">-X
file.ccss</a> Use Colorimeter @@ -1946,14 +1946,14 @@ Calibration - - Spectral Samples for calibration</span><font size="-1"><span - style="font-family: monospace;"><br> - </span></font><small><span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#Q">-Q <i>observ</i></a><span - style="font-family: monospace;"> - Choose CIE Observer for spectrometer or CCSS - colorimeter data:</span><br style="font-family: monospace;"> +
+ Spectral Samples for calibration</span><font size="-1"><span
+ style="font-family: monospace;"><br>
+ </span></font><small><span style="font-family: monospace;"> </span><a
+ style="font-family: monospace;" href="#Q">-Q <i>observ</i></a><span
+ style="font-family: monospace;">
+ Choose CIE Observer for spectrometer or CCSS
+ colorimeter data:</span><br style="font-family: monospace;">
<span style="font-family: monospace;"> @@ -2001,11 +2001,11 @@ Calibration - - 1931_2 </span></small><small><span - style="font-family: monospace;">(def.)</span></small><small><span - style="font-family: monospace;">, 1964_10, S&B 1955_2, shaw, - J&V 1978_2, 1964_10c<br> +
+ 1931_2 </span></small><small><span
+ style="font-family: monospace;">(def.)</span></small><small><span
+ style="font-family: monospace;">, 1964_10, S&B 1955_2, shaw,
+ J&V 1978_2, 1964_10c<br>
<a href="#I">-I b|w</a> @@ -2053,8 +2053,8 @@ Calibration - - Drift compensation, Black: -Ib, White: -Iw, Both: -Ibw</span></small><br> +
+ Drift compensation, Black: -Ib, White: -Iw, Both: -Ibw</span></small><br>
<small><span style="font-family: monospace;"><tt> <a href="#YR">-Y @@ -2071,7 +2071,7 @@ Calibration - +
R:<i>rate</i></a> @@ -2088,36 +2088,36 @@ Calibration - - Override measured refresh rate with rate Hz<br> - </tt> </span></small><font size="-1"><span - style="font-family: monospace;"></span><a style=" font-family: - monospace;" href="#YA">-<font size="-1">Y</font> A</a><span - style="font-family: monospace;"> - - Use non-adaptive integration time mode (if - available).</span></font><br> - <font size="-1"><span style="font-family: monospace;"> </span><a - style=" font-family: monospace;" href="#Yp">-<font size="-1">Y</font> - <font size="-1">p</font></a><span style="font-family: - monospace;"> - - Don't wait for the instrument to be placed on - the display</span></font><br> - <small><span style="font-family: monospace;"> </span></small><font - size="-1"><span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#C">-C "command"</a><span - style="font-family: monospace;"> - Invoke shell - "command" each time a color is set</span></font><br> - <font size="-1"><span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#M">-M "command"</a><span - style="font-family: monospace;"> - Invoke shell - "command" each time a color is measured</span></font><font - size="-1"><span style="font-family: monospace;"></span><span - style="font-family: monospace;"></span></font><br> - <font size="-1"><span style="font-family: monospace;"> <a +
+ Override measured refresh rate with rate Hz<br>
+ </tt> </span></small><font size="-1"><span
+ style="font-family: monospace;"></span><a style=" font-family:
+ monospace;" href="#YA">-<font size="-1">Y</font> A</a><span
+ style="font-family: monospace;">
+
+ Use non-adaptive integration time mode (if
+ available).</span></font><br>
+ <font size="-1"><span style="font-family: monospace;"> </span><a
+ style=" font-family: monospace;" href="#Yp">-<font size="-1">Y</font>
+ <font size="-1">p</font></a><span style="font-family:
+ monospace;">
+
+ Don't wait for the instrument to be placed on
+ the display</span></font><br>
+ <small><span style="font-family: monospace;"> </span></small><font
+ size="-1"><span style="font-family: monospace;"> </span><a
+ style="font-family: monospace;" href="#C">-C "command"</a><span
+ style="font-family: monospace;">
+ Invoke shell
+ "command" each time a color is set</span></font><br>
+ <font size="-1"><span style="font-family: monospace;"> </span><a
+ style="font-family: monospace;" href="#M">-M "command"</a><span
+ style="font-family: monospace;">
+ Invoke shell
+ "command" each time a color is measured</span></font><font
+ size="-1"><span style="font-family: monospace;"></span><span
+ style="font-family: monospace;"></span></font><br>
+ <font size="-1"><span style="font-family: monospace;"> <a
href="#W">-W n|h|x</a> Override serial @@ -2173,12 +2173,12 @@ none, - - h = HW, x = Xon/Xoff</span></font><font size="-1"><span - style="font-family: monospace;"></span></font><br> - <font size="-1"><span style="font-family: monospace;"> </span></font><font - size="-1"><span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#D">-D [level]</a><span +
+ h = HW, x = Xon/Xoff</span></font><font size="-1"><span
+ style="font-family: monospace;"></span></font><br>
+ <font size="-1"><span style="font-family: monospace;"> </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;"> @@ -2226,12 +2226,12 @@ none, - - Print debug diagnostics to stderr</span></font><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="#p1"><i>inoutfile</i></a><span +
+ Print debug diagnostics to stderr</span></font><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="#p1"><i>inoutfile</i></a><span
style="font-family: monospace;"> @@ -2279,79 +2279,79 @@ none, - - </span><span style="font-family: monospace;">Base name for created - or updated </span></font><font size="-1"><a style="font-family: - monospace;" href="cal_format.html">.cal</a><span - style="font-family: monospace;"></span></font><font size="-1"><span - style="font-family: monospace;"> and <a - href="File_Formats.html#ICC">.icm</a> output files</span></font><br> - <br> - <h3>Comments<br> - </h3> - This is the tool is used for adjusting and calibrating a display to - reach specified target behaviour, and optionally profiling it. - For best results on a CRT, you should run this against a neutral - grey desktop background, and avoid having any bright images or - windows on the screen at the time you run dispcal. You could also - use the <span style="font-weight: bold;">-B</span> option to black - the whole screen out, although this will make it impossible to - control dispcal unless you have more than one display.<br> - <br> - <a name="v"></a> The <b>-v</b> flag reports progress information, - as well as other statistics about the progress of calibration. A - numerical argument greater than 1 gives greater verbosity. 2 will - give per step adjustment and repeat information, while 3 will give - even greater technical detail.<br> - <br> - <a name="display"></a>When running on a UNIX based system that used - the X11 Windowing System, <b>dispcal</b> will by default use the - $DISPLAY environment variable to determine which local or remote - 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> By default the main display will be the location of - the test window. 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;">dispcal</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 parameter.<br> - <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;">dispcal</span> will - will issue a warning, but continue creating a calibration based on - the display "as-is" rather than its native response. See the <a - href="dispcal.html#o">-o</a> flag for an explanation of the - implications of having no access to the VideoLUTs.<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>Because of the difficulty cause by TwinView and - MergedFB in X11 based systems, you can optionally specify a separate - display number after the display that is going to be used to present - test patches, for accessing the VideoLUT hardware. This must be +
+ </span><span style="font-family: monospace;">Base name for created
+ or updated </span></font><font size="-1"><a style="font-family:
+ monospace;" href="cal_format.html">.cal</a><span
+ style="font-family: monospace;"></span></font><font size="-1"><span
+ style="font-family: monospace;"> and <a
+ href="File_Formats.html#ICC">.icm</a> output files</span></font><br>
+ <br>
+ <h3>Comments<br>
+ </h3>
+ This is the tool is used for adjusting and calibrating a display to
+ reach specified target behaviour, and optionally profiling it.
+ For best results on a CRT, you should run this against a neutral
+ grey desktop background, and avoid having any bright images or
+ windows on the screen at the time you run dispcal. You could also
+ use the <span style="font-weight: bold;">-B</span> option to black
+ the whole screen out, although this will make it impossible to
+ control dispcal unless you have more than one display.<br>
+ <br>
+ <a name="v"></a> The <b>-v</b> flag reports progress information,
+ as well as other statistics about the progress of calibration. A
+ numerical argument greater than 1 gives greater verbosity. 2 will
+ give per step adjustment and repeat information, while 3 will give
+ even greater technical detail.<br>
+ <br>
+ <a name="display"></a>When running on a UNIX based system that used
+ the X11 Windowing System, <b>dispcal</b> will by default use the
+ $DISPLAY environment variable to determine which local or remote
+ 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> By default the main display will be the location of
+ the test window. 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;">dispcal</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 parameter.<br>
+ <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;">dispcal</span> will
+ will issue a warning, but continue creating a calibration based on
+ the display "as-is" rather than its native response. See the <a
+ href="dispcal.html#o">-o</a> flag for an explanation of the
+ implications of having no access to the VideoLUTs.<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>Because of the difficulty cause by TwinView and
+ MergedFB in X11 based systems, you can optionally specify a separate
+ display number after the display that is going to be used to present
+ test patches, for accessing the VideoLUT hardware. This must be
specified as a single string, e.g. <span style="font-weight: bold;">-d @@ -2399,273 +2399,273 @@ none, - - 1,2</span> . Some experimentation may be needed using <a - href="dispwin.html">dispwin</a> 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 on each screen.<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. 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 displaying test patches, that - there is no access to the display VideoLUTs and that the colors will - be displayed with 8 bit per component precision, and any - screen-saver or power-saver will not be disabled. You will also be - at the mercy of any color management applied by the web browser, and - may have to carefully review and configure such color management. - See the <a href="#o">-o</a> flag for an explanation of the - implications of having no access to the VideoLUTs.<br> - <br> - <a name="dmadvr"></a><span style="font-weight: bold;">-dmadvr</span> - [MSWin only] causes test patches to be displayed using the MadVR - video renderer. Note that will have to start <b>MadTPG</b> before - running dispcal, and that while you can adjust the "Test Pattern - Configuration" controls, you should <u>not</u> normally alter the - "Existing Calibration" controls, as dispcal will set these - appropriately. <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 +
+ 1,2</span> . Some experimentation may be needed using <a
+ href="dispwin.html">dispwin</a> 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 on each screen.<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. 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 displaying test patches, that
+ there is no access to the display VideoLUTs and that the colors will
+ be displayed with 8 bit per component precision, and any
+ screen-saver or power-saver will not be disabled. You will also be
+ at the mercy of any color management applied by the web browser, and
+ may have to carefully review and configure such color management.
+ See the <a href="#o">-o</a> flag for an explanation of the
+ implications of having no access to the VideoLUTs.<br>
+ <br>
+ <a name="dmadvr"></a><span style="font-weight: bold;">-dmadvr</span>
+ [MSWin only] causes test patches to be displayed using the MadVR
+ video renderer. Note that will have to start <b>MadTPG</b> before
+ running dispcal, and that while you can adjust the "Test Pattern
+ Configuration" controls, you should <u>not</u> normally alter the
+ "Existing Calibration" controls, as dispcal will set these
+ appropriately. <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="c"></a> <span style="font-weight: bold;">-c</span> The - instrument is assumed to communicate through a USB or serial - communication port, and the port can be selected with the <b>-c</b> - option, if the instrument is not connected to the first port. If you - invoke <span style="font-weight: bold;">dispcal</span> so as to - display the usage information (i.e. "dispcal -?" or "dispcal --"), - then the discovered USB and serial ports will be listed. On - UNIX/Linux, a list of all possible serial ports are shown, but not - all of them may actually be present on your system.<br> - <br> - <a name="r"></a> The -<span style="font-weight: bold;">r</span> and - <span style="font-weight: bold;"><a name="R"></a>-R </span>flags - perform a quick measurement of current display behaviour, reports - and then exits. If the <span style="font-weight: bold;">-r</span> - flag is used the measurement are taken using the currently loaded - calibration (Video LUT) curves, and in the case of MadVR renderer - test patch display the Color Management 3dLut. If <span - style="font-weight: bold;">-R</span> is use, then the uncalibrated - ("raw" or "native") behaviour is measured (ie. no VideoLut or CM). - Reported are: <br> - <br> - Black Brightness in cd/m^2<br> - White Brightness in cd/m^2<br> - The approximate Gamma<br> - The white point x,y chromaticity co-ordinates<br> - The correlated color temperature in Kelvin, and - the CIEDE200 to the Black Body locus.<br> - The correlated Daylight temperature in Kelvin, - and the CIEDE200 to the Daylight locus.<br> - The visual color temperature in Kelvin, and the - CIEDE200 to the Black Body locus.<br> - The visual Daylight temperature in Kelvin, and - the CIEDE200 to the Daylight locus.<br> - The visual color temperature in Kelvin<br> - (for <span style="font-weight: bold;">-R </span>"raw":)<br> - The apparent VideoLUT entry number of significant - bits.<br> - <br> - Note that the correlated color temperature is the temperature of a - black body radiator that has the closest color to the white point - measured using the traditional CIE 1960 UCS space color difference - formula. The correlated daylight temperature is a similar thing, - except the CIE daylight locus is used. The visual color temperature - values are calculated similarly to the correlated color - temperatures, but using the modern CIEDE2000 color difference - formula to calculate a better visual approximation to the closest - temperature to the displays white point. There will be no difference - between the UCS and CIEDE2000 temperatures if the display white - point actually lies on the particular locus.<br> - <br> - <a name="m"></a> The -<span style="font-weight: bold;">m</span> - option skips the usual process of adjusting the display monitor - contrast, brightness and white point controls, and skips straight to - calibration.<br> - <br> - <a name="o"></a><span style="font-weight: bold;">-o [</span><span - style="font-style: italic;">profile.icm</span><span - style="font-weight: bold;">]</span> Normally <span - style="font-weight: bold;">dispcal</span> creates just a - calibration file, which can then be used for subsequent - characterization using <a href="dispread.html">dispread</a> and - profiling using <a href="colprof.html">colprof</a>. If the <span - style="font-weight: bold;">-o</span> flag is used, <span - style="font-weight: bold;">dispcal</span> will also create a - shaper/matrix profile. By default it will create a profile named <span - style="font-weight: bold;">inoutfile.icm</span>, but a differently - named file can be created or updated by specifying the name after - the <span style="font-weight: bold;">-o</span> flag. If the <span - style="font-weight: bold;">-u</span> flag is used with <span - style="font-weight: bold;">-o</span>, then the ICC profile <span - style="font-weight: bold;">vcgt</span> calibration curves will be - updated.<br> - <br> - Note that if VideoLUT access is not possible for the display, that - hardware calibration is not possible. dispcal will create - calibration curves anyway with a warning, and if a profile is - created, it will not contain a 'vcgt' tag, but instead will have the - calibration curves incorporated into the profile itself. If - calibration parameters are chosen that change the displays white - point or brightness, then this will result in a slightly unusual - profile that has a white point that does not correspond with - R=G=B=1.0. Some systems may not cope properly with this type of - profile. See the <a href="Scenarios.html#PM7">tutorial</a> for a - further explanation.<br> - <br> - <a name="O"></a>The <b>-O</b> parameter allows setting of the - shaper/matrix profile description tag. The parameter should be a - string that describes the device and profile. With most command line - shells, it will be necessary to enclose the parameter with double - quotes, so that spaces and other special characters are included in - the parameter, and not mistaken for the start of another flag, or as - a final command line parameter. Many programs that deal with ICC - profiles use the description tag to identify a profile, rather than - the profile filename, so using a descriptive string is important in - being able to find a profile. By default, the profile file name will - be used as the description.<br> - <br> - <a name="u"></a><span style="font-weight: bold;">-u</span> Normally - <span style="font-weight: bold;">dispcal</span> creates a new - calibration file and optional profile, based on the requested - targets and the response of the display. This can take a fair amount - of time, particularly if a high quality level has been selected, so - to speed up the process of keeping a display in calibration the <span - style="font-weight: bold;">-u</span> flag can be used. This uses - the same calibration targets as the previous calibration but does a - smaller number of refinement passes, enough to improve the accuracy - of the calibration to account for drift in the device. If the <span - style="font-weight: bold;">-o</span> flag is used as well, then - the ICC profile <span style="font-weight: bold;"></span>will have - its vcgt tag updated with the new calibration. This keeps the - profile up to date with the display. Normally <span - style="font-weight: bold;">dispcal -u</span> will use the same - quality level that was specified in the previous calibration, but - this can be overridden using the <span style="font-weight: bold;">-q</span> - flag. Any options that attempt to change the calibration target (ie. - white point, brightness, gamma etc.) will be ignored. Adjustment of - the display monitor controls is skipped. A profile cannot be updated - if the display does not support hardware calibration (no VideoLUT - access).<br> - <br> - <a name="q"></a> Quality - Low, Medium (def), High. The <span - style="font-weight: bold;">-q</span> flag determines how much time - and effort to go to in calibrating the display. The higher the - quality, the more test readings will be done, the more refinement - passes will be done, the tighter will be the accuracy tolerance, and - the more detailed will be the calibration of the display. The result - will ultimately be limited by the accuracy of the instrument, the - repeatability of the display and instrument, and the resolution of - the Video Lookup table entries and Digital or Analogue output - (RAMDAC).<br> - <br> - <a name="p"></a>The <span style="font-weight: bold;">-p</span> flag - allows measuring in telephoto mode, using instruments that support - this mode, e.g. the ColorMunki. Telephoto mode is one for taking - emissive measurements from a distance (ie. telespectometer, - tele-colorimeter) mode, and typically would be used for measuring - projector type displays. If a device does not support a specific - telephoto mode, then the normal emissive mode may be suitable for - measuring projectors.<br> - <br> - <a name="y"></a> The <span style="font-weight: bold;">-y</span> - flag allows setting the Display Type. The selection typically - determines two aspects of of the instrument operation: <span - style="font-weight: bold;">1)</span> It may set the measuring mode - to suite <a - href="http://en.wikipedia.org/wiki/Comparison_of_display_technology"><span - style="font-weight: bold;">refresh</span> or <span - style="font-weight: bold;">non-refresh</span> displays</a>. - Typically only LCD (Liquid Crystal) displays have a non-refresh - nature. <span style="font-weight: bold;">2)</span> It may select an - instrument calibration matrix suitable for a particular display - type. The selections available depends on the type and model of - instrument, and a list of the options for the discovered instruments - will be shown in the <a href="ArgyllDoc.html#CmdLine">usage</a> - information. For more details on what particular instruments support - and how this works, see <a href="instruments.html">Operation of - particular instruments</a>. <b>3)</b> Any installed CCSS files - (if applicable), or CCMX files. These files are typically created - using <a href="ccxxmake.html">ccxxmake</a>, and installed using <a - href="oeminst.html">oeminst</a>. The default and Base Calibration - types will be indicated in the usage.<br> - <br> - <a name="t"></a><span style="text-decoration: underline;"></span> <span - style="font-weight: bold;">-t</span> Set the target white point - locus to the equivalent of a Daylight spectrum of the given - temperature in degrees Kelvin. By default the white point target - will be the native white of the display, and it's color temperature - and delta E to the daylight spectrum locus will be shown during - monitor adjustment, and adjustments will be recommended to put the - display white point directly on the Daylight locus. If a Daylight - color temperature is given as an argument to <span - style="font-weight: bold;">-t</span>, then this will become the - target of the adjustment, and the recommended adjustments will be - those needed to make the monitor white point meet the target. - Typical values might be 5000 for matching printed output, or - 6500, which gives a brighter, bluer look. A white point temperature - different to that native to the display may limit the maximum - brightness possible.<br> - <br> - <a name="T"></a><span style="text-decoration: underline;"></span> <span - style="font-weight: bold;">-T</span> Same functionality as - the <span style="font-weight: bold;">-t</span> option, except the - white point locus will be the Black Body, or Planckian locus, rather - than the Daylight locus. While these two white point loci are quite - close, they are subtly different. If a temperature is given as an - argument, this will become the Black Body target temperature during - adjustment.<br> - <br> - <a name="w"></a><span style="font-weight: bold;">-w</span> An - alternative to specifying a white point target in Daylight or - Black Body degrees Kevin, is to specify it in chromaticity - co-ordinates. This allows the white point to be a color other than - one on the Daylight or Black Body. Note that the x,y numbers must be - specified as a single string (no space between the numbers and the - comma).<br> - <br> - <a name="b"></a><span style="font-weight: bold;">-b</span> Set - the target brightness of white in cd/m^2. If this number cannot be - reached, the brightest output possible is chosen, consistent with - matching the white point target. Note that many of the instruments - are not particularly accurate when assessing the absolute display - brightness in cd/m^2. <span style="font-weight: bold;">NOTE</span> - that some LCD screens behave a little strangely near their absolute - white point, and may therefore exhibit odd behavior at values just - below white. It may be advisable in such cases to set a brightness - slightly less than the maximum such a display is capable of.<br> - <br> +
+ instructions</a> for your platform).<br>
+ <br>
+ <a name="c"></a> <span style="font-weight: bold;">-c</span> The
+ instrument is assumed to communicate through a USB or serial
+ communication port, and the port can be selected with the <b>-c</b>
+ option, if the instrument is not connected to the first port. If you
+ invoke <span style="font-weight: bold;">dispcal</span> so as to
+ display the usage information (i.e. "dispcal -?" or "dispcal --"),
+ then the discovered USB and serial ports will be listed. On
+ UNIX/Linux, a list of all possible serial ports are shown, but not
+ all of them may actually be present on your system.<br>
+ <br>
+ <a name="r"></a> The -<span style="font-weight: bold;">r</span> and
+ <span style="font-weight: bold;"><a name="R"></a>-R </span>flags
+ perform a quick measurement of current display behaviour, reports
+ and then exits. If the <span style="font-weight: bold;">-r</span>
+ flag is used the measurement are taken using the currently loaded
+ calibration (Video LUT) curves, and in the case of MadVR renderer
+ test patch display the Color Management 3dLut. If <span
+ style="font-weight: bold;">-R</span> is use, then the uncalibrated
+ ("raw" or "native") behaviour is measured (ie. no VideoLut or CM).
+ Reported are: <br>
+ <br>
+ Black Brightness in cd/m^2<br>
+ White Brightness in cd/m^2<br>
+ The approximate Gamma<br>
+ The white point x,y chromaticity co-ordinates<br>
+ The correlated color temperature in Kelvin, and
+ the CIEDE200 to the Black Body locus.<br>
+ The correlated Daylight temperature in Kelvin,
+ and the CIEDE200 to the Daylight locus.<br>
+ The visual color temperature in Kelvin, and the
+ CIEDE200 to the Black Body locus.<br>
+ The visual Daylight temperature in Kelvin, and
+ the CIEDE200 to the Daylight locus.<br>
+ The visual color temperature in Kelvin<br>
+ (for <span style="font-weight: bold;">-R </span>"raw":)<br>
+ The apparent VideoLUT entry number of significant
+ bits.<br>
+ <br>
+ Note that the correlated color temperature is the temperature of a
+ black body radiator that has the closest color to the white point
+ measured using the traditional CIE 1960 UCS space color difference
+ formula. The correlated daylight temperature is a similar thing,
+ except the CIE daylight locus is used. The visual color temperature
+ values are calculated similarly to the correlated color
+ temperatures, but using the modern CIEDE2000 color difference
+ formula to calculate a better visual approximation to the closest
+ temperature to the displays white point. There will be no difference
+ between the UCS and CIEDE2000 temperatures if the display white
+ point actually lies on the particular locus.<br>
+ <br>
+ <a name="m"></a> The -<span style="font-weight: bold;">m</span>
+ option skips the usual process of adjusting the display monitor
+ contrast, brightness and white point controls, and skips straight to
+ calibration.<br>
+ <br>
+ <a name="o"></a><span style="font-weight: bold;">-o [</span><span
+ style="font-style: italic;">profile.icm</span><span
+ style="font-weight: bold;">]</span> Normally <span
+ style="font-weight: bold;">dispcal</span> creates just a
+ calibration file, which can then be used for subsequent
+ characterization using <a href="dispread.html">dispread</a> and
+ profiling using <a href="colprof.html">colprof</a>. If the <span
+ style="font-weight: bold;">-o</span> flag is used, <span
+ style="font-weight: bold;">dispcal</span> will also create a
+ shaper/matrix profile. By default it will create a profile named <span
+ style="font-weight: bold;">inoutfile.icm</span>, but a differently
+ named file can be created or updated by specifying the name after
+ the <span style="font-weight: bold;">-o</span> flag. If the <span
+ style="font-weight: bold;">-u</span> flag is used with <span
+ style="font-weight: bold;">-o</span>, then the ICC profile <span
+ style="font-weight: bold;">vcgt</span> calibration curves will be
+ updated.<br>
+ <br>
+ Note that if VideoLUT access is not possible for the display, that
+ hardware calibration is not possible. dispcal will create
+ calibration curves anyway with a warning, and if a profile is
+ created, it will not contain a 'vcgt' tag, but instead will have the
+ calibration curves incorporated into the profile itself. If
+ calibration parameters are chosen that change the displays white
+ point or brightness, then this will result in a slightly unusual
+ profile that has a white point that does not correspond with
+ R=G=B=1.0. Some systems may not cope properly with this type of
+ profile. See the <a href="Scenarios.html#PM7">tutorial</a> for a
+ further explanation.<br>
+ <br>
+ <a name="O"></a>The <b>-O</b> parameter allows setting of the
+ shaper/matrix profile description tag. The parameter should be a
+ string that describes the device and profile. With most command line
+ shells, it will be necessary to enclose the parameter with double
+ quotes, so that spaces and other special characters are included in
+ the parameter, and not mistaken for the start of another flag, or as
+ a final command line parameter. Many programs that deal with ICC
+ profiles use the description tag to identify a profile, rather than
+ the profile filename, so using a descriptive string is important in
+ being able to find a profile. By default, the profile file name will
+ be used as the description.<br>
+ <br>
+ <a name="u"></a><span style="font-weight: bold;">-u</span> Normally
+ <span style="font-weight: bold;">dispcal</span> creates a new
+ calibration file and optional profile, based on the requested
+ targets and the response of the display. This can take a fair amount
+ of time, particularly if a high quality level has been selected, so
+ to speed up the process of keeping a display in calibration the <span
+ style="font-weight: bold;">-u</span> flag can be used. This uses
+ the same calibration targets as the previous calibration but does a
+ smaller number of refinement passes, enough to improve the accuracy
+ of the calibration to account for drift in the device. If the <span
+ style="font-weight: bold;">-o</span> flag is used as well, then
+ the ICC profile <span style="font-weight: bold;"></span>will have
+ its vcgt tag updated with the new calibration. This keeps the
+ profile up to date with the display. Normally <span
+ style="font-weight: bold;">dispcal -u</span> will use the same
+ quality level that was specified in the previous calibration, but
+ this can be overridden using the <span style="font-weight: bold;">-q</span>
+ flag. Any options that attempt to change the calibration target (ie.
+ white point, brightness, gamma etc.) will be ignored. Adjustment of
+ the display monitor controls is skipped. A profile cannot be updated
+ if the display does not support hardware calibration (no VideoLUT
+ access).<br>
+ <br>
+ <a name="q"></a> Quality - Low, Medium (def), High. The <span
+ style="font-weight: bold;">-q</span> flag determines how much time
+ and effort to go to in calibrating the display. The higher the
+ quality, the more test readings will be done, the more refinement
+ passes will be done, the tighter will be the accuracy tolerance, and
+ the more detailed will be the calibration of the display. The result
+ will ultimately be limited by the accuracy of the instrument, the
+ repeatability of the display and instrument, and the resolution of
+ the Video Lookup table entries and Digital or Analogue output
+ (RAMDAC).<br>
+ <br>
+ <a name="p"></a>The <span style="font-weight: bold;">-p</span> flag
+ allows measuring in telephoto mode, using instruments that support
+ this mode, e.g. the ColorMunki. Telephoto mode is one for taking
+ emissive measurements from a distance (ie. telespectometer,
+ tele-colorimeter) mode, and typically would be used for measuring
+ projector type displays. If a device does not support a specific
+ telephoto mode, then the normal emissive mode may be suitable for
+ measuring projectors.<br>
+ <br>
+ <a name="y"></a> The <span style="font-weight: bold;">-y</span>
+ flag allows setting the Display Type. The selection typically
+ determines two aspects of of the instrument operation: <span
+ style="font-weight: bold;">1)</span> It may set the measuring mode
+ to suite <a
+ href="http://en.wikipedia.org/wiki/Comparison_of_display_technology"><span
+ style="font-weight: bold;">refresh</span> or <span
+ style="font-weight: bold;">non-refresh</span> displays</a>.
+ Typically only LCD (Liquid Crystal) displays have a non-refresh
+ nature. <span style="font-weight: bold;">2)</span> It may select an
+ instrument calibration matrix suitable for a particular display
+ type. The selections available depends on the type and model of
+ instrument, and a list of the options for the discovered instruments
+ will be shown in the <a href="ArgyllDoc.html#CmdLine">usage</a>
+ information. For more details on what particular instruments support
+ and how this works, see <a href="instruments.html">Operation of
+ particular instruments</a>. <b>3)</b> Any installed CCSS files
+ (if applicable), or CCMX files. These files are typically created
+ using <a href="ccxxmake.html">ccxxmake</a>, and installed using <a
+ href="oeminst.html">oeminst</a>. The default and Base Calibration
+ types will be indicated in the usage.<br>
+ <br>
+ <a name="t"></a><span style="text-decoration: underline;"></span> <span
+ style="font-weight: bold;">-t</span> Set the target white point
+ locus to the equivalent of a Daylight spectrum of the given
+ temperature in degrees Kelvin. By default the white point target
+ will be the native white of the display, and it's color temperature
+ and delta E to the daylight spectrum locus will be shown during
+ monitor adjustment, and adjustments will be recommended to put the
+ display white point directly on the Daylight locus. If a Daylight
+ color temperature is given as an argument to <span
+ style="font-weight: bold;">-t</span>, then this will become the
+ target of the adjustment, and the recommended adjustments will be
+ those needed to make the monitor white point meet the target.
+ Typical values might be 5000 for matching printed output, or
+ 6500, which gives a brighter, bluer look. A white point temperature
+ different to that native to the display may limit the maximum
+ brightness possible.<br>
+ <br>
+ <a name="T"></a><span style="text-decoration: underline;"></span> <span
+ style="font-weight: bold;">-T</span> Same functionality as
+ the <span style="font-weight: bold;">-t</span> option, except the
+ white point locus will be the Black Body, or Planckian locus, rather
+ than the Daylight locus. While these two white point loci are quite
+ close, they are subtly different. If a temperature is given as an
+ argument, this will become the Black Body target temperature during
+ adjustment.<br>
+ <br>
+ <a name="w"></a><span style="font-weight: bold;">-w</span> An
+ alternative to specifying a white point target in Daylight or
+ Black Body degrees Kevin, is to specify it in chromaticity
+ co-ordinates. This allows the white point to be a color other than
+ one on the Daylight or Black Body. Note that the x,y numbers must be
+ specified as a single string (no space between the numbers and the
+ comma).<br>
+ <br>
+ <a name="b"></a><span style="font-weight: bold;">-b</span> Set
+ the target brightness of white in cd/m^2. If this number cannot be
+ reached, the brightest output possible is chosen, consistent with
+ matching the white point target. Note that many of the instruments
+ are not particularly accurate when assessing the absolute display
+ brightness in cd/m^2. <span style="font-weight: bold;">NOTE</span>
+ that some LCD screens behave a little strangely near their absolute
+ white point, and may therefore exhibit odd behavior at values just
+ below white. It may be advisable in such cases to set a brightness
+ slightly less than the maximum such a display is capable of.<br>
+ <br>
<a name="g"></a><span style="font-weight: bold;">-g gamma</span> Set @@ -2714,14 +2714,14 @@ Set - - the target response curve gamma. This is normally an exponential - curve (output = input ^gamma), and defaults to 2.4 on MSWindows and - Macintosh OS X 10.6 or latter and Linux/Unix (which is typical of a - CRT type displays real response), and 1.8 on a Macintosh (prior to - OS X 10.6). Four pre-defined curves can be used as well: the sRGB - colorspace response curve, which is an exponent curve with a - straight segment at the dark end and an overall response of +
+ the target response curve gamma. This is normally an exponential
+ curve (output = input ^gamma), and defaults to 2.4 on MSWindows and
+ Macintosh OS X 10.6 or latter and Linux/Unix (which is typical of a
+ CRT type displays real response), and 1.8 on a Macintosh (prior to
+ OS X 10.6). Four pre-defined curves can be used as well: the sRGB
+ colorspace response curve, which is an exponent curve with a
+ straight segment at the dark end and an overall response of
approximately gamma 2.2 (<span style="font-weight: bold;">-gs</span>), the @@ -2770,65 +2770,65 @@ the - - L* curve, which is the response of the CIE L*a*b* perceptual - colorspace (<span style="font-weight: bold;">-gl</span>). the REC - 709 video standard response curve (<span style="font-weight: bold;">-g709</span>) - and the SMPTE 240M video standard response curve (<span - style="font-weight: bold;">-g240</span>) <br> - <br> - <span style="font-weight: bold;">Note</span> that a real display - can't reproduce any of these ideal curves, since it will have a - non-zero black point, whereas all the ideal curves assume zero light - at zero input. In the case of a gamma curve target, dispcal uses an - actual technical power curve shape that aims for the same relative - output at 50% input as the ideal gamma power curve. To allow for the - non-zero black level of a real display, by default <span - style="font-weight: bold;">dispcal</span> will offset the target - curve values so that zero input gives the actual black level of the - display (output offset). This ensures that the target curve better - corresponds to the typical natural behavior of displays, but it may - not be the most visually even progression from display minimum, but - this behavior can be changed using the <span style="font-weight: - bold;">-f</span> option (see below).<br> - <br> - <span style="font-weight: bold;">Also note</span> that many color - spaces are encoded with, and labelled as having a gamma of - approximately<span style="font-weight: bold;"> 2.2</span> (ie. sRGB, - REC 709, SMPTE 240M, Macintosh OS X 10.6), but are actually intended - to be displayed on a display with a typical CRT gamma of <span - style="font-weight: bold;">2.4</span> viewed in a darkened - environment. This is because this <span style="font-weight: bold;">2.2</span> - gamma is a source gamma encoding in bright viewing conditions such - as a television studio, while typical display viewing conditions are - quite dark by comparison, and a contrast expansion of (approx.) - gamma 1.1 is desirable to make the images look as intended. So if - you are displaying images encoded to the sRGB standard, or - displaying video through the calibration, just setting the gamma - curve to sRGB or REC 709 (respectively) is probably <span - style="font-weight: bold;">not what you want!</span> What you - probably want to do, is to set the gamma curve to about gamma 2.4, - so that the contrast range is expanded appropriately, or <span - style="text-decoration: underline; font-weight: bold;">alternatively</span> - use sRGB or REC 709 or a gamm of 2.2 but <span style="font-weight: - bold;">also</span> use the <span style="font-weight: bold;">-a</span> - parameter to specify the actual ambient viewing conditions, so that - <span style="font-weight: bold;">dispcal</span> can make an - appropriate contrast enhancement. If your instrument is capable of - measuring ambient light levels, then you can do so during the - interactive display control adjustment. See - <http://www.color.org/sRGB.xalter> for details of how sRGB is - intended to be used.<br> - <br> - It is hard to know whether Apple Macintosh computers prior to OS X - 10.6 should also have such an adjustment, since it is not really - possible to know whether colors labelled as being in such a - colorspace are actually encoded in that gamma with the expectation - that they will be displayed on a display with that actual response, - or whether they are intended to be displayed on a display that - contrast expands by a power 1.1. Both situations might be the - case, depending on how source material is created!<br> - <br> +
+ L* curve, which is the response of the CIE L*a*b* perceptual
+ colorspace (<span style="font-weight: bold;">-gl</span>). the REC
+ 709 video standard response curve (<span style="font-weight: bold;">-g709</span>)
+ and the SMPTE 240M video standard response curve (<span
+ style="font-weight: bold;">-g240</span>) <br>
+ <br>
+ <span style="font-weight: bold;">Note</span> that a real display
+ can't reproduce any of these ideal curves, since it will have a
+ non-zero black point, whereas all the ideal curves assume zero light
+ at zero input. In the case of a gamma curve target, dispcal uses an
+ actual technical power curve shape that aims for the same relative
+ output at 50% input as the ideal gamma power curve. To allow for the
+ non-zero black level of a real display, by default <span
+ style="font-weight: bold;">dispcal</span> will offset the target
+ curve values so that zero input gives the actual black level of the
+ display (output offset). This ensures that the target curve better
+ corresponds to the typical natural behavior of displays, but it may
+ not be the most visually even progression from display minimum, but
+ this behavior can be changed using the <span style="font-weight:
+ bold;">-f</span> option (see below).<br>
+ <br>
+ <span style="font-weight: bold;">Also note</span> that many color
+ spaces are encoded with, and labelled as having a gamma of
+ approximately<span style="font-weight: bold;"> 2.2</span> (ie. sRGB,
+ REC 709, SMPTE 240M, Macintosh OS X 10.6), but are actually intended
+ to be displayed on a display with a typical CRT gamma of <span
+ style="font-weight: bold;">2.4</span> viewed in a darkened
+ environment. This is because this <span style="font-weight: bold;">2.2</span>
+ gamma is a source gamma encoding in bright viewing conditions such
+ as a television studio, while typical display viewing conditions are
+ quite dark by comparison, and a contrast expansion of (approx.)
+ gamma 1.1 is desirable to make the images look as intended. So if
+ you are displaying images encoded to the sRGB standard, or
+ displaying video through the calibration, just setting the gamma
+ curve to sRGB or REC 709 (respectively) is probably <span
+ style="font-weight: bold;">not what you want!</span> What you
+ probably want to do, is to set the gamma curve to about gamma 2.4,
+ so that the contrast range is expanded appropriately, or <span
+ style="text-decoration: underline; font-weight: bold;">alternatively</span>
+ use sRGB or REC 709 or a gamm of 2.2 but <span style="font-weight:
+ bold;">also</span> use the <span style="font-weight: bold;">-a</span>
+ parameter to specify the actual ambient viewing conditions, so that
+ <span style="font-weight: bold;">dispcal</span> can make an
+ appropriate contrast enhancement. If your instrument is capable of
+ measuring ambient light levels, then you can do so during the
+ interactive display control adjustment. See
+ <http://www.color.org/sRGB.xalter> for details of how sRGB is
+ intended to be used.<br>
+ <br>
+ It is hard to know whether Apple Macintosh computers prior to OS X
+ 10.6 should also have such an adjustment, since it is not really
+ possible to know whether colors labelled as being in such a
+ colorspace are actually encoded in that gamma with the expectation
+ that they will be displayed on a display with that actual response,
+ or whether they are intended to be displayed on a display that
+ contrast expands by a power 1.1. Both situations might be the
+ case, depending on how source material is created!<br>
+ <br>
<a name="G"></a><span style="font-weight: bold;">-G gamma</span> As @@ -2877,99 +2877,99 @@ As - - explained above, the gamma value provided to the <span - style="font-weight: bold;">-g</span> option is used to set and - actual response curve that makes an allowance for the non-zero black - of the actual display, and will have the same relative output at 50% - input as the ideal gamma power curve, and so best matches typical - expectations. The <span style="font-weight: bold;">-G</span> option - is an alternative that allows the <span style="font-weight: bold;">actual</span> - power to be specified instead, meaning that when combined with the - displays non-zero black value, the response at 50% input will - probably not match that of the ideal power curve with that gamma - value.<br> - <br> - <a name="f"></a><span style="font-weight: bold;">-f [degree]</span>: - As explained in for the <span style="font-weight: bold;">-g</span> - and <span style="font-weight: bold;">-G</span> options, real - displays do not have a zero black response, while all the target - response curves do, so this has to be allowed for in some way. The - default way of handling this (equivalent to -f 1.0) is to - allow for this at the output of the ideal response curve, by - offsetting and scaling the output values.<span style="font-weight: - bold;"></span> This defined a curve that will match the responses - that many other systems provide and may be a better match to the - natural response of the display, but will give a less visually even - response from black<span style="font-weight: bold;"></span>. The - other alternative is to offset and scale the input values into the - ideal response curve so that zero input gives the actual non-zero - display response. This ensures the most visually even progression - from display minimum, but might be hard to achieve since it is - different to the naturally response of a display. A subtlety is to - provide a split between how much of the offset is accounted for as - input to the ideal response curve, and how much is accounted for at - the output, and this can be done by providing a parameter <span - style="font-weight: bold;">-f degree</span>, where the degree is - 0.0 accounts for it all as input offset, and 1.0 accounts for all of - it as output offset. If <span style="font-weight: bold;">-f</span> - is used without a specified degree, a degree of 0.0 is assumed, the - opposite of the default. <span style="font-weight: bold;">Note</span> - that using all input offset (degree == 0.0) is equivalent to the use - of the <span style="font-weight: bold;">BT.1886</span> transfer - function.<br> - <br> - <a name="a"></a><span style="font-weight: bold;">-a ambient</span>: - As explained for the <span style="font-weight: bold;">-g</span> - parameter, often colors are encoded in a situation with viewing - conditions that are quite different to the viewing conditions of a - typical display, with the expectation that this difference in - viewing conditions will be allowed for in the way the display is - calibrated. The <span style="font-weight: bold;">-a</span> option - is a way of doing this. By default <span style="font-weight: bold;">dispcal</span> - will not make any allowances for viewing conditions, but will - calibrate to the specified response curve, but if the <span - style="font-weight: bold;">-a</span> option is used, or the - ambient level is measured during the interactive display controls - portion of the calibration, an appropriate viewing conditions - adjustment will be performed. For a gamma value or sRGB, the - original viewing conditions will be assumed to be that of the sRGB - standard viewing conditions, while for REC 709 and SMPTE 240M they - will be assumed to be television studio viewing conditions. By - specifying or measuring the ambient lighting for your display, a - viewing conditions adjustment based on the CIECAM02 color appearance - model will be made for the brightness of your display and the - contrast it makes with your ambient light levels. <br> - <br> - <a name="k"></a><span style="font-weight: bold;">-k factor</span>: - Normally this will be set automatically, based on the measured black - level of the display. A <span style="font-weight: bold;">-k</span> - factor of 1.0 will make all colors down the neutral axis (R=G=B) - have the same hue as the chosen white point. Near the black point, - red, green or blue can only be added, not subtracted from zero, so - the process of making the near black colors have the desired hue, - will <span style="font-weight: bold;">lighten</span> them to some - extent. For a device with a good contrast ratio or a black point - that has nearly the same hue as the white, this should not affect - the contrast ratio too severely. If the device contrast ratio is not - so good, and the native black hue is noticeably different to that of - the chosen white point (which is often the case for <span - style="font-weight: bold;">LCD</span> type displays, or <span - style="font-weight: bold;">CRT</span> type displays with one - channel which has a poor level of black), this could have a - noticeably detrimental effect on an already limited contrast ratio, - and result in a black that is not as good as it can be, and a lower - <span style="font-weight: bold;">-k</span> factor should be used. <span - style="font-weight: bold;">-k</span> values can range between 0.0 - (no correction of black) to 1.0 (full correction of black). If less - than full correction is chosen, then the resulting calibration - curves will have the target white point down most of the curve, but - will then blend over to the native or compromise black point that is - blacker, but not of the right hue. The rate of this blend can be - controlled with the <span style="font-weight: bold;">-A</span> - parameter (see below). For applications where maximum contrast ratio - is important (such as <b>Video</b>), use <b>-k0</b>. <br> - <br> +
+ explained above, the gamma value provided to the <span
+ style="font-weight: bold;">-g</span> option is used to set and
+ actual response curve that makes an allowance for the non-zero black
+ of the actual display, and will have the same relative output at 50%
+ input as the ideal gamma power curve, and so best matches typical
+ expectations. The <span style="font-weight: bold;">-G</span> option
+ is an alternative that allows the <span style="font-weight: bold;">actual</span>
+ power to be specified instead, meaning that when combined with the
+ displays non-zero black value, the response at 50% input will
+ probably not match that of the ideal power curve with that gamma
+ value.<br>
+ <br>
+ <a name="f"></a><span style="font-weight: bold;">-f [degree]</span>:
+ As explained in for the <span style="font-weight: bold;">-g</span>
+ and <span style="font-weight: bold;">-G</span> options, real
+ displays do not have a zero black response, while all the target
+ response curves do, so this has to be allowed for in some way. The
+ default way of handling this (equivalent to -f 1.0) is to
+ allow for this at the output of the ideal response curve, by
+ offsetting and scaling the output values.<span style="font-weight:
+ bold;"></span> This defined a curve that will match the responses
+ that many other systems provide and may be a better match to the
+ natural response of the display, but will give a less visually even
+ response from black<span style="font-weight: bold;"></span>. The
+ other alternative is to offset and scale the input values into the
+ ideal response curve so that zero input gives the actual non-zero
+ display response. This ensures the most visually even progression
+ from display minimum, but might be hard to achieve since it is
+ different to the naturally response of a display. A subtlety is to
+ provide a split between how much of the offset is accounted for as
+ input to the ideal response curve, and how much is accounted for at
+ the output, and this can be done by providing a parameter <span
+ style="font-weight: bold;">-f degree</span>, where the degree is
+ 0.0 accounts for it all as input offset, and 1.0 accounts for all of
+ it as output offset. If <span style="font-weight: bold;">-f</span>
+ is used without a specified degree, a degree of 0.0 is assumed, the
+ opposite of the default. <span style="font-weight: bold;">Note</span>
+ that using all input offset (degree == 0.0) is equivalent to the use
+ of the <span style="font-weight: bold;">BT.1886</span> transfer
+ function.<br>
+ <br>
+ <a name="a"></a><span style="font-weight: bold;">-a ambient</span>:
+ As explained for the <span style="font-weight: bold;">-g</span>
+ parameter, often colors are encoded in a situation with viewing
+ conditions that are quite different to the viewing conditions of a
+ typical display, with the expectation that this difference in
+ viewing conditions will be allowed for in the way the display is
+ calibrated. The <span style="font-weight: bold;">-a</span> option
+ is a way of doing this. By default <span style="font-weight: bold;">dispcal</span>
+ will not make any allowances for viewing conditions, but will
+ calibrate to the specified response curve, but if the <span
+ style="font-weight: bold;">-a</span> option is used, or the
+ ambient level is measured during the interactive display controls
+ portion of the calibration, an appropriate viewing conditions
+ adjustment will be performed. For a gamma value or sRGB, the
+ original viewing conditions will be assumed to be that of the sRGB
+ standard viewing conditions, while for REC 709 and SMPTE 240M they
+ will be assumed to be television studio viewing conditions. By
+ specifying or measuring the ambient lighting for your display, a
+ viewing conditions adjustment based on the CIECAM02 color appearance
+ model will be made for the brightness of your display and the
+ contrast it makes with your ambient light levels. <br>
+ <br>
+ <a name="k"></a><span style="font-weight: bold;">-k factor</span>:
+ Normally this will be set automatically, based on the measured black
+ level of the display. A <span style="font-weight: bold;">-k</span>
+ factor of 1.0 will make all colors down the neutral axis (R=G=B)
+ have the same hue as the chosen white point. Near the black point,
+ red, green or blue can only be added, not subtracted from zero, so
+ the process of making the near black colors have the desired hue,
+ will <span style="font-weight: bold;">lighten</span> them to some
+ extent. For a device with a good contrast ratio or a black point
+ that has nearly the same hue as the white, this should not affect
+ the contrast ratio too severely. If the device contrast ratio is not
+ so good, and the native black hue is noticeably different to that of
+ the chosen white point (which is often the case for <span
+ style="font-weight: bold;">LCD</span> type displays, or <span
+ style="font-weight: bold;">CRT</span> type displays with one
+ channel which has a poor level of black), this could have a
+ noticeably detrimental effect on an already limited contrast ratio,
+ and result in a black that is not as good as it can be, and a lower
+ <span style="font-weight: bold;">-k</span> factor should be used. <span
+ style="font-weight: bold;">-k</span> values can range between 0.0
+ (no correction of black) to 1.0 (full correction of black). If less
+ than full correction is chosen, then the resulting calibration
+ curves will have the target white point down most of the curve, but
+ will then blend over to the native or compromise black point that is
+ blacker, but not of the right hue. The rate of this blend can be
+ controlled with the <span style="font-weight: bold;">-A</span>
+ parameter (see below). For applications where maximum contrast ratio
+ is important (such as <b>Video</b>), use <b>-k0</b>. <br>
+ <br>
<a name="A"></a><span style="font-weight: bold;">-A rate</span>: If @@ -3018,641 +3018,641 @@ If - - the black point is not being set completely to the same hue as the - white point (ie. because the <span style="font-weight: bold;">-k</span> - factor is less than 1.0), then the resulting calibration curves will - have the target white point down most of the curve, but will then - blend over to the native or compromise black point that is blacker, - but not of the right hue. The rate of this blend can be controlled - with the <span style="font-weight: bold;">-A</span> parameter. The - default value 4.0, which results in a target that switches from the - white point target to the black, moderately close to the black - point. While this typically gives a good visual result with the - target neutral hue being maintained to the point where the crossover - to the black hue is not visible, it may be asking too much of some - displays (typically LCD type displays), and there may be some visual - effects due to inconsistent color with viewing angle. For this - situation a smaller value may give a better visual result (e.g. try - values of 3.0 or 2.0. A value of 1.0 will set a pure linear blend - from white point to black point). If there is too much coloration - near black, try a larger value, e.g. 6.0 or 8.0.<br> - <br> - <a name="bhack"></a>The <b>-b</b> flag forces source 0,0,0 to map - to destination 0,0,0. This may be useful with displays that have a - very dark black point, and with an instrument is unable to measure - it precisely, and where it is known in some other way that the - display is <u>very well behaved</u> from black (i.e. that it has no - "dead zone" above zero device input). Using this option with a - display that is <u>not</u> well behaved, may result in a loss of - shadow detail. This will override any <b>-k</b> factor.<br> - <br> - <a name="B"></a><span style="font-weight: bold;">-B</span> Set - the target brightness of black in cd/m^2 (i.e. the absolute Y - value). Setting too high a value may give strange results as it - interacts with trying to achieve the target "advertised" gamma curve - shape. You could try using -f 1 if this causes a problem.<br> - <br> - <a name="e"></a><span style="font-weight: bold;">-e [n]</span> Run <span - style="font-weight: bold;">n</span> verify passes on the final - curves. This is an extra set of instrument readings, that can be - used to estimate how well the device will match the targets with the - computed calibration curves. Note that the usefulness of the - verification is sometimes limited by the repeatability of the device - & instrument readings. This is often evident for CRT displays, - which (due to their refresh rate) flicker. More than one - verification pass can be done by providing the parameter <span - style="font-weight: bold;">n</span>, and by then comparing the - successive verifications, some idea of the repeatability can be - ascertained. The verification uses a fixed number of semi-random - test values to test the calibration.<br> - <br> - <a name="z"></a><span style="font-weight: bold;">-z</span> Run - verify pass on the display as it is currently setup (currently - installed LUT curves). This will use the usual input parameters to - establish the expected (target) characteristic. <span - style="font-weight: bold;">Note</span> that if the initial - calibration was modified due to it being out of gamut of the - display, verify will show the resulting discrepancy. You can use <a - href="dispwin.html">dispwin</a> to load a <span - style="font-weight: bold;">.cal</span> file into the display - before running dispcal <span style="font-weight: bold;">-z</span>. - Note that if you set an Ambient light level interactively during the - calibration, you need to enter the same number that was measured and - set using the <span style="font-weight: bold;">-a</span> parameter - for verify.<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 display test values to be scaled to the Video RGB - encoding range of (16-235)/255. This also modifies the resulting - calibration curve behavior downstream of dispcal. If a calibration - curve created using -E gets installed or converted to an ICC profile - 'vcgt' tag in the process of creating a profile in dispcal or - colprof, the incoming full range values will first have the - calibration curve applied and then be scaled to the Video encoding - range (16-235)/255.<br> - <br> - <a name="n"></a><span style="font-weight: bold;">-n</span> When - running on a UNIX based system that used the X11 Windowing System, <b>dispcal</b> - normally selects the override redirect so that the test window will - appear above any other windows on the display. On some systems this - can interfere with window manager operation, and the <b>-n</b> - option turns this behaviour off.<br> - <br> - <a name="J"></a> The -<span style="font-weight: bold;">J</span> - option runs through the black and sensor relative calibration - routines for the Xrite DTP92 and DTP94 instruments, the black level - calibration for the Eye-One Display 1, and a CRT frequency - calibration for the Eye-One Display 2. For the black calibration the - instrument should be placed on an opaque, black surface, and any - stray light should be avoided by placing something opaque over the - instrument. If a Spectrolino is being used, then a white and black - calibration will always be performed before the instrument can be - placed on the display, unless the <a href="dispcal.html#N">-N</a> - flag is used. Generally it is not necessary to do a calibration - every time an instrument is used, just now and again. There is also - no point in doing a CRT frequency calibration, as this will be - done automatically at the commencement of patch reading, and will be - lost between runs.<br> - <br> - <a name="N"></a> <span style="font-weight: bold;">-N</span> Any - instrument that requires regular calibration will ask for - calibration on initial start-up. Sometimes this can be awkward if - the instrument is being mounted in some sort of measuring jig, or - annoying if several sets of readings are being taken in quick - succession. The -<span style="font-weight: bold;">N</span> - suppresses this initial calibration if a valid and not timed out - previous calibration is recorded in the instrument or on the host - computer. It is advisable to only use this option on the second and - subsequent measurements in a single session.<br> - <br> - <a name="H"></a> The -<span style="font-weight: bold;">H</span> - option turns on high resolution spectral mode, if the instrument - supports it, such as the Eye-One Pro. See <a - href="instruments.html">Operation of particular instruments</a> - for more details. This may give better accuracy for display - measurements.<br> - <br> - <a name="X1"></a> The -<span style="font-weight: bold;">X <span - style="font-style: italic;">file.ccmx</span></span> option reads - a <a href="File_Formats.html#.ccmx">Colorimeter Correction Matrix</a> - from the given file, and applies it to the colorimeter instruments - readings. This can improve a colorimeters accuracy for a particular - type of display. A list of contributed <span style="font-weight: - bold;">ccmx</span> files is <a href="ccmxs.html">here</a>.<br> - <br> - <a name="X2"></a> The -<span style="font-weight: bold;">X <span - style="font-style: italic;">file.ccss</span></span> option reads - a <a href="File_Formats.html#.ccss">Colorimeter Calibration - Spectral Sample</a> from the given file, and uses it to set the - colorimeter instruments calibration. This will only work with - colorimeters that rely on sensor spectral sensitivity calibration - information (ie. the X-Rite <span style="font-weight: bold;">i1d3</span>, - or the DataColor <span style="font-weight: bold;">Spyder4 & - Spyder 5</span>).This can improve a colorimeters accuracy for a - particular type of display.<br> - <br> - <a name="Q"></a> The <b>-Q</b> flag allows specifying a tristimulus - observer, and is used to compute PCS (Profile Connection Space) - tristimulus values from spectral readings or using a colorimeter - that has CCSS capability. The following choices are available:<br> - <b> 1931_2</b> selects the standard CIE 1931 2 degree - observer. The default.<br> - <b>1964_10</b> selects the standard CIE 1964 10 degree - observer.<br> - <b>1955_2</b> selects the Stiles and Birch 1955 2 degree - observer<br> - <b>1978_2 </b>selects the Judd and Voss 1978 2 degree - observer<br> - <b>shaw</b> selects the Shaw and Fairchild 1997 2 degree - observer<br> - <b>1964_10c</b> selects a version of the CIE 1964 10 degree - observer that has been adjusted using a 3x3 matrix to better agree - with the 1931 2 degree observer.<br> - <br> - <span style="font-weight: bold;">NOTE</span> that if you select - anything other than the default 1931 2 degree observer, that the Y - values will not be cd/m^2, due to the Y curve not being the CIE 1924 - photopic V(λ) luminosity function.<br> - <br> - <a name="I"></a> The -<span style="font-weight: bold;">I <span - style="font-style: italic;">b|w</span></span> options invoke - instrument black level, and display white level compensation - (respectively). Instrument black level drift compensation attempts - to combat instrument black calibration drift by using a display - black test patch as a reference. If an instrument is not - acclimatised sufficiently to the measurement conditions, changes in - temperature can affect the black readings. Display white level drift - compensation attempts to combat changes in display brightness as it - warms up by measuring a white patch every so often, and using it to - normalise all the other readings. If just instrument black drift - compensation is needed, use <span style="font-weight: bold;">-Ib</span>. - If just display white level compensation is needed, use <span - style="font-weight: bold;">-Iw</span>. If both are needed, use <span - style="font-weight: bold;">-Ibw</span> or <span - style="font-weight: bold;">-Iwb</span>.<span style="font-weight: - bold;"> </span><br> - <br> - <a name="YR"></a> The -<span style="font-weight: bold;">Y R:<i>rate</i></span> - options overrides calibration of the instrument refresh rate. This - may be useful if the instrument supports this function and the - refresh rate cannot be accurately calibrated from the display - itself.<br> - <br> - <a name="YA"></a> The -<span style="font-weight: bold;">Y A</span> - option uses a non-adaptive integration time emission measurement - mode, if the instrument supports it, such as the Eye-One Pro, - ColorMunki, i1d3 and K10. By default an adaptive integration time - measurement mode will be used for emission measurements, but some - instruments support a fixed integration time mode that can be used - with display devices. This may give faster measurement times, but - may also give less accurate low level readings.<br> - <br> - <a name="Yp"></a> The -<span style="font-weight: bold;">Y p</span> - option skips asking the user to place the instrument on the display. - Normally a grey patch is displayed, and then the user is asked to - confirm that the instrument is in place, so that readings can - commence. This flag disables that check. This may be useful in - automating certain operations.<br> - <br> - <a name="C"></a> The -<span style="font-weight: bold;">C</span> <span - style="font-weight: bold;">"command" </span>option allows a - method of relaying each test value to some other display than that - on the system running dispcal (for instance, a photo frame, PDA - screen etc.), by causing the given command to be invoked to the - shell, with six arguments. The first three arguments are the RGB - test color as integers in the range 0 to 255, the second three - parameters are the RGB test color as floating point numbers in the - range 0.0 to 1.0. The script or tool should relay the given color to - the screen in some manner (e.g. by generating a raster file of the - given color and sending it to the display being profiled), before - returning. Note that a test window will also be created on the - system running dispread.<br> - <br> - <a name="M"></a> The -<span style="font-weight: bold;">M</span> <span - style="font-weight: bold;">"command" </span>option allows a - method of gathering each test value from some external source, such - as an instrument that is not directly supported by Argyll. The given - command is involked to the shell, with six arguments. The first - three arguments are the RGB test color as integers in the range 0 to - 255, the second three parameters are the RGB test color as floating - point numbers in the range 0.0 to 1.0. The script or tool should - create a file called <span style="font-weight: bold;">"command.meas</span>" - that contains the XYZ values for the given RGB (or measured from the - test window) in cd/m^2 as three numbers separated by spaces, before - returning. If the command returns a non-zero return value, dispcal - will abort. Note that a test window will also be created on the - system running dispcal.<br> - <br> - <a name="W"></a>The <b>-W</b> <span style="font-weight: bold;">n|h|x</span> - parameter overrides the default serial communications flow control - setting. The value <span style="font-weight: bold;">n</span> turns - all flow control off, <span style="font-weight: bold;">h</span> - sets hardware handshaking, and <span style="font-weight: bold;">x</span> - sets Xon/Xoff handshaking. This commend may be useful in workaround - serial communications issues with some systems and cables. <br> - <br> - <a name="D"></a>The <b>-D</b> flag causes communications and other - instrument diagnostics to be printed to stdout. A level can be set - between 1 .. 9, that may give progressively more verbose - information, depending on the instrument. This can be useful in - tracking down why an instrument can't connect.<br> - <br> - <a name="p1"></a><span style="font-weight: bold;">inoutfile</span> - The final parameter on the command line is the base filename for the - <a href="cal_format.html">.cal</a> file and the optional ICC - profile. Normally this will be created (or an existing file will be - overwritten). If the <span style="font-weight: bold;">-u</span> - flag is used, then these files will be updated. If a different ICC - profile name needs to be specified, do so as an argument to the <span - style="font-weight: bold;">-o</span> flag.<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> - <br> - <hr style="width: 100%; height: 2px;"> - <h2><a name="Adjustment"></a>Discussion and guide to display control - adjustment:</h2> - <br> - The adjustment of the display controls (brightness, contrast, R, G - & B channel controls etc.) is very dependent on the particular - monitor. Different types and brands of monitors will have different - controls, or controls that operate in different ways. Some displays - have almost no user controls, and so you may well be best skipping - display adjustment, and going straight to calibration.<br> - <br> - Almost all LCD displays lack a real <span style="font-weight: - bold;">contrast</span> control. Those that do present such a - control generally fake it by adjusting the video signal. For this - reason it is usually best to set an LCD's <span style="font-weight: - bold;">contrast</span> control at its neutral setting (ie. the - setting at which it doesn't change the video signal). Unfortunately, - it can be hard to know what this neutral setting is. On some - displays it is 50%, others 75%. If the LCD display has a "reset to - factory defaults" mode, then try using this first, as a way of - setting the <span style="font-weight: bold;">contrast</span> - control to neutral. The LCD <span style="font-weight: bold;">brightness</span> - control generally adjusts the level of backlighting the display - gets, which affects the maximum brightness, and also tends to raise - or lower the black level in proportion, without changing the - displays response curve shape or overall contrast ratio. If your LCD - display has a <span style="font-weight: bold;">backlight</span> - control as well as a <span style="font-weight: bold;">brightness</span> - control, then the brightness control is also probably being faked, - and you are probably better off setting it to it's neutral setting, - and using the <span style="font-weight: bold;">backlight</span> - control in place of <span style="font-weight: bold;">brightness</span> - in the following adjustments.<br> - <br> - Some high end displays have the ability to mimic various standard - colorspaces such as sRGB or AdobeRGB. You could choose to calibrate - and profile the display in such an emulation mode, although you - probably don't want to fight the emulations white point and gamma. - To get the best out of such a display you really want to choose it's - "Native Gamut" setting, whatever that is called. Note that some - people have reported bad experiences in trying to use "6-axis custom - controls" on displays such as the Dell U2410, so attempting to use - such a mode should be approached with caution. Ideally such a mode - should be used to give just the underlying native display response, - but the settings to achieve this may be very difficult to determine, - and/or it may not be possible, depending on how such a mode distorts - the RGB signals.<br> - <br> - On CRT based displays, the <span style="font-weight: bold;">brightness</span> - control generally adjusts the black level of the display (sometimes - called the <span style="font-weight: bold;">offset</span>), and as - a side effect, tends to change the maximum brightness too. A CRT <span - style="font-weight: bold;">contrast</span> control generally - adjusts the maximum brightness (sometimes called <span - style="font-weight: bold;">gain</span>) without affecting the - black level a great deal. On a CRT both the <span - style="font-weight: bold;">brightness</span> and <span - style="font-weight: bold;">contrast</span> controls will tend to - affect the shape or gamma of the display response curve.<br> - <br> - Many displays have some sort of color temperature adjustment. This - may be in the form of some pre-set color temperatures, or in the - form of individual Red, Green and Blue channel gain adjustments. - Some CRT displays also have R, G & B channel offset adjustments - that will affect the color temperatures near black, as well as - affect the individual channels curve shape. The color temperature - adjustment will generally affect the maximum brightness, and may - also affect the black level and the shape of the display response - curves.<br> - <br> - Some special (expensive) LCD displays may have a white point - adjustment that changes the color of the backlight. If you do not - have one of these types of LCD displays, then attempting to change - the white point of the display (even if it appears to have a "<span - style="font-weight: bold;">white point selection</span>" or <span - style="font-weight: bold;">R/G/B</span> "<span style="font-weight: - bold;">gain</span>" controls") may not be a good idea, as once - again these controls are probably being faked by manipulating the - signal levels. Even if you do manage to change the white point - significantly, it may do things like change the mid tone color too - dramatically, or create a display response that is hard to correct - with calibration, or results in side effects such as quantization - (banding) or other undesirable effects. You may have to try out - various controls (and your aim points for the display calibration), - to decide what is reasonable to attempt on an LCD display.<br> - <br> - Due to the variety of controls as well as the interaction between - them, it can be an iterative process to arrive at a good monitor - set-up, before proceeding on to calibrating and profiling a display. - For this reason, <span style="font-weight: bold;">dispcal</span> - offers a menu of adjustment modes, so that the user can - interactively and iteratively adjust the display controls to meet - the desired targets.<br> - <br> - 1) Black level (CRT: Brightness)<br> - 2) White point (Color temperature, R,G,B, Gain/Contrast)<br> - 3) White level (CRT: Gain/Contrast, LCD: - Brightness/Backlight)<br> - 4) Black point (R,G,B, Offset/Brightness)<br> - 5) Check all<br> - 6) Measure and set ambient for viewing condition adjustment<br> - 7) Continue on to calibration<br> - 8) Exit<br> - <br> - There are four basic adjustment modes. Normally one would proceed - through them in the order above, then perhaps repeat the first - adjustment, before checking the overall settings. The White point - and White level modes operate slightly differently, depending on - whether a white target point has been set using the <span - style="font-weight: bold;">-t -T</span> or <span - style="font-weight: bold;">-w</span> options, and on whether a - brightness target has been set using the <span style="font-weight: - bold;">-b</span> option.<br> - <br> - <br> - The first mode lets you adjust the black level of a CRT display. - Given the current white level, it calculates a value that should - produce a 1% display brightness if the black level is set correctly. - After doing some initial measurements, it will show the target - brightness value (in cd/m^2) on one line, and then underneath it - will show continuously updated readings from the display. The left - most character will switch from '\' to '/' or back again each time a - reading is updated. Some instruments can be quite slow in measuring - dark colors, and it's best to wait for a reading update before - changing the controls more than once. Underneath the target value is - displayed the current reading, and to the right of this is a '+', - '-' or '=' symbol, which gives a hint as to which way to adjust the - brightness control to improve the match to the target.<br> - <br> - <small style="font-weight: bold;"><span style="font-family: - monospace;"> Adjust CRT brightness to get target level. - Press space when done.</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> Target - 0.60</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> / Current 0.68 - -</span></small><br> - <br> - Once happy with the adjustment, press space to go back to the menu.<br> - <br> - <br> - The second mode lets you adjust the color of the white point of the - display. If a target white point has been set, it will show the - target brightness value (in cd/m^2) on one line, together with the - target chromaticity co-ordinates for the white point, and then - underneath it will show continuously updated readings from the - display. The left most character will switch from '\' to '/' or back - again each time a reading is updated. Underneath the target - brightness value is displayed the current reading, and then the - current chromaticity co-ordinate values. To the right of this is the - current delta E of the white point from the target, and further to - the right are hints '+', '-' or '=' as to which direction to - adjust the individual Red, Green and Blue gain settings to move the - white point in the direction of the target, and reduce the delta E. - If the symbol is doubled, then this channel will have the greatest - effect. If you do not have individual channel gain controls, then - try choosing amongst color temperature pre-sets, to find one with - the lowest delta E. Depending on the stability of the display, the - coarseness of the controls, and the repeatability of the instrument, - you may not be able to get a perfectly zero delta E.<br> - <br> - <small style="font-weight: bold;"><span - style="font-family: monospace;">Adjust R,G & B gain to get - target x,y. Press space when done.<br> - Target B 60.00, x 0.3451, y 0.3516<br> - / Current B 60.05, x 0.3426, y 0.3506 DE - 1.4 R+ G+ B--</span><span style="font-family: - monospace;"></span></small><br> - <br> - If you did not set a white point target, then the information shown - is a little different - it will show the initial white point value, - as well as the color temperature, and the CIEDE2000 of the white - point to either the Daylight or Black Body locus (depending on - whether the <span style="font-weight: bold;">-T</span> flag was - set). The constantly updated values show the same thing, and the - Red, Green and Blue control hints show the direction to adjust the - controls to place the white point on the locus. The control that - will have the most direct effect on the color temperature will be - the Blue, while the Green will most directly move the white point - towards or away from the locus, thereby reducing the delta E of the - white point to the locus (but there is interaction).<br> - <br> - <small style="font-weight: bold;"><span style="font-family: - monospace;">Adjust R,G & B gain to desired white point. - Press space when done.</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> Initial B 47.25, x - 0.3417, y 0.3456, CDT 5113 DE 6.9</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;">\ Current B 47.38, x 0.3420, - y 0.3460 CDT 5104 DE 6.7 R-- G+ B-</span></small><br> - <br> - The brightness value is just there as a guide to what effect - the adjustment is having on the overall brightness. Usually the - white level brightness is adjusted using the next adjustment mode. - Once happy with the adjustment, press space to go back to the menu.<br> - <br> - <br> - The third mode lets you adjust the brightness of white on the - display. If you set a target brightness using the <span - style="font-weight: bold;"><span style="font-weight: bold;">-b</span></span> - parameter, it will show the target brightness value (in cd/m^2) on - one line, and then underneath it will show continuously updated - readings from the display. The left most character will switch from - '\' to '/' or back again each time a reading is updated. Underneath - the target value is displayed the current reading, and to the right - of this is a '+', '-' or '=' symbol, which gives a hint as to which - way to adjust the CRT contrast or LCD brightness control to improve - the match to the target.<br> - <br> - <small style="font-weight: bold;"><span - style="font-family: monospace;">Adjust CRT Contrast or LCD - Brightness to get target level. Press space when done.<br> - Target 60.00<br> - / Current 59.96 +</span><span style="font-family: - monospace;"></span></small><br> - <br> - If you did not set a brightness target, it will show the initial - brightness as the target, and the current brightness, which you can - then set any way you want:<br> - <br> - <small style="font-weight: bold;"><span style="font-family: - monospace;">Adjust CRT Contrast or LCD Brightness to desired - level. Press space when done.</span><br style="font-family: - monospace;"> - <span style="font-family: monospace;"> Initial 47.32</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;">/ Current 47.54</span></small><br> - <br> - Once happy with the adjustment, press space to go back to the menu.<br> - <br> - <br> - The fourth mode lets you adjust the color of the black point of the - display, if the display has Red, Green and Blue channel offset - controls. It will show the target 1% brightness value (in cd/m^2) on - one line, together with the target chromaticity co-ordinates for the - black point, and then underneath it will show continuously updated - readings from the display. The left most character will switch from - '\' to '/' or back again each time a reading is updated. Underneath - the target brightness value is displayed the current reading, and - then the current chromaticity co-ordinate values. To the right of - this is the current delta E of the black point from the target, and - further to the right are hints '+', '-' or '=' as to which - direction to adjust the individual Red, Green and Blue offset - settings to move the black point in the right direction. If the - symbol is doubled, then this channel will have the greatest effect. - <br> - <br> - <span style="font-family: monospace;"><span style="font-weight: - bold;"> Adjust R,G & B offsets to get target x,y. - Press space when done.<br> - Target B 0.60, x 0.3451, y 0.3516<br> - \ Current B 0.62, x 0.2782, y 0.2331 DE - 10.3 R+ G++ B-</span></span><small - style="font-weight: bold;"><span style="font-family: monospace;"></span><span - style="font-family: monospace;"></span></small><br> - <br> - The 1% brightness value is just there as a guide to what - effect the adjustment is having on the 1% brightness level. The - combined channel offsets may have an effect on this in combination - with the CRT brightness control. Press space to go back to the menu.<br> - <br> - <br> - The fifth selection checks on the overall settings. If targets - have been set, it will be like:<br> - <br> - <small style="font-weight: bold;"><span style="font-family: - monospace;"> Target Brightness = 50.00, Current = 47.44, - error = -5.1%<br> - Target 50% Level = 10.32, Current = 8.10, - error = -4.4%<br> - Target Near Black = 0.47, Current = 0.68, - error = 0.4%<br> - Target white = x 0.3458, y 0.3586, Current = x 0.3420, y - 0.3454, error = 7.55 DE<br> - Target black = x 0.3458, y 0.3586, Current = x 0.2908, y - 0.2270, error = 29.69 DE</span><span style="font-family: - monospace;"></span></small><br> - <br> - or if no targets are set:<br> - <br> - <small style="font-weight: bold;"><span style="font-family: - monospace;"> Current Brightness = 46.28</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> Target 50% - Level = 10.07, Current = 7.52, error = -5.5%</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> Target Near Black - = 0.46, Current = 0.46, error = -0.0%</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> Current white = x - 0.3439, y 0.3466, VCT 5098K DE 3.0</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> Target black = x - 0.3439, y 0.3466, Current = x 0.3093, y 0.2165, error = 30.30 DE</span></small><br> - <br> - and will then go back to the menu.<br> - <br> - The sixth selection <span style="font-weight: bold;">6)</span> - allows the reading of you ambient lighting conditions if your - instrument supports such a mode. Doing so will enable the <span - style="font-weight: bold;">-a</span> option to compensate for your - viewing conditions in the subsequent calibration. See <a - href="dispcal.html#a">-a</a>.<br> - <br> - Once you're happy with the display set-up, you can either - proceed on to the rest of the calibration by selecting <span - style="font-weight: bold;">7)</span>, or exit and re-start by - selecting <span style="font-weight: bold;">8)</span>. You might - want to re-start if you want to change the calibration targets.<br> - <br> - <hr style="width: 100%; height: 2px;"> - <h2>Other caveats:</h2> - NOTE that some <span style="font-weight: bold;">LCD</span> screens - behave a little strangely near their absolute white point, and may - therefore exhibit odd behavior at values just below white. It may be - advisable in such cases to set a brightness slightly less than the - maximum such a display is capable of.<br> - <br> - The program attempts to stop any screensaver or powersaver from - interfering with the measurements, but this may not be effective on - some systems, so it may be necessary to manually disable the - screensaver and/or powersaver before commencing the calibration with - a large number of patches.<br> - <br> - The calibration tables produced maintain the maximum level of - precision available on a system. If the display has VideoLUTs - available (Video Lookup Tables that the frame buffer values pass - through on their way to the display) and thier outputs are better - than 8 bits per component, then the resulting curves can reflect - this, although few current operating systems and/or display cards - actually support better than 8 bit per component output.<br> - <br> - If calibration curves are created for a display in which VideoLUTs - are not available, then the resulting calibration file will be - marked to indicate this, and a subsequent profile created with the - calibration will not have the calibration converted to the 'vcgt' - tag, since such a tag can't be loaded into the displays VideoLUTs.<br> - <br> - If communications break down with a USB connected instrument, you - may have to unplug it, and plug it in again to recover operation.<br> - <br> - Some systems (Apple OS X in particular) have a special set of user - interface controls ("Universal Access") that allows altering the - display in ways designed to assist visually impaired users, by - increasing contrast etc. This will interfere badly with any attempts - to calibrate or profile such a system, and must be turned off in - order to do so. Note that certain magic keyboard sequences can turn - this on by accident.<br> - <br> - <br> - <br> - <br> - <br> - </body> -</html> +
+ the black point is not being set completely to the same hue as the
+ white point (ie. because the <span style="font-weight: bold;">-k</span>
+ factor is less than 1.0), then the resulting calibration curves will
+ have the target white point down most of the curve, but will then
+ blend over to the native or compromise black point that is blacker,
+ but not of the right hue. The rate of this blend can be controlled
+ with the <span style="font-weight: bold;">-A</span> parameter. The
+ default value 4.0, which results in a target that switches from the
+ white point target to the black, moderately close to the black
+ point. While this typically gives a good visual result with the
+ target neutral hue being maintained to the point where the crossover
+ to the black hue is not visible, it may be asking too much of some
+ displays (typically LCD type displays), and there may be some visual
+ effects due to inconsistent color with viewing angle. For this
+ situation a smaller value may give a better visual result (e.g. try
+ values of 3.0 or 2.0. A value of 1.0 will set a pure linear blend
+ from white point to black point). If there is too much coloration
+ near black, try a larger value, e.g. 6.0 or 8.0.<br>
+ <br>
+ <a name="bhack"></a>The <b>-b</b> flag forces source 0,0,0 to map
+ to destination 0,0,0. This may be useful with displays that have a
+ very dark black point, and with an instrument is unable to measure
+ it precisely, and where it is known in some other way that the
+ display is <u>very well behaved</u> from black (i.e. that it has no
+ "dead zone" above zero device input). Using this option with a
+ display that is <u>not</u> well behaved, may result in a loss of
+ shadow detail. This will override any <b>-k</b> factor.<br>
+ <br>
+ <a name="B"></a><span style="font-weight: bold;">-B</span> Set
+ the target brightness of black in cd/m^2 (i.e. the absolute Y
+ value). Setting too high a value may give strange results as it
+ interacts with trying to achieve the target "advertised" gamma curve
+ shape. You could try using -f 1 if this causes a problem.<br>
+ <br>
+ <a name="e"></a><span style="font-weight: bold;">-e [n]</span> Run <span
+ style="font-weight: bold;">n</span> verify passes on the final
+ curves. This is an extra set of instrument readings, that can be
+ used to estimate how well the device will match the targets with the
+ computed calibration curves. Note that the usefulness of the
+ verification is sometimes limited by the repeatability of the device
+ & instrument readings. This is often evident for CRT displays,
+ which (due to their refresh rate) flicker. More than one
+ verification pass can be done by providing the parameter <span
+ style="font-weight: bold;">n</span>, and by then comparing the
+ successive verifications, some idea of the repeatability can be
+ ascertained. The verification uses a fixed number of semi-random
+ test values to test the calibration.<br>
+ <br>
+ <a name="z"></a><span style="font-weight: bold;">-z</span> Run
+ verify pass on the display as it is currently setup (currently
+ installed LUT curves). This will use the usual input parameters to
+ establish the expected (target) characteristic. <span
+ style="font-weight: bold;">Note</span> that if the initial
+ calibration was modified due to it being out of gamut of the
+ display, verify will show the resulting discrepancy. You can use <a
+ href="dispwin.html">dispwin</a> to load a <span
+ style="font-weight: bold;">.cal</span> file into the display
+ before running dispcal <span style="font-weight: bold;">-z</span>.
+ Note that if you set an Ambient light level interactively during the
+ calibration, you need to enter the same number that was measured and
+ set using the <span style="font-weight: bold;">-a</span> parameter
+ for verify.<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 display test values to be scaled to the Video RGB
+ encoding range of (16-235)/255. This also modifies the resulting
+ calibration curve behavior downstream of dispcal. If a calibration
+ curve created using -E gets installed or converted to an ICC profile
+ 'vcgt' tag in the process of creating a profile in dispcal or
+ colprof, the incoming full range values will first have the
+ calibration curve applied and then be scaled to the Video encoding
+ range (16-235)/255.<br>
+ <br>
+ <a name="n"></a><span style="font-weight: bold;">-n</span> When
+ running on a UNIX based system that used the X11 Windowing System, <b>dispcal</b>
+ normally selects the override redirect so that the test window will
+ appear above any other windows on the display. On some systems this
+ can interfere with window manager operation, and the <b>-n</b>
+ option turns this behaviour off.<br>
+ <br>
+ <a name="J"></a> The -<span style="font-weight: bold;">J</span>
+ option runs through the black and sensor relative calibration
+ routines for the Xrite DTP92 and DTP94 instruments, the black level
+ calibration for the Eye-One Display 1, and a CRT frequency
+ calibration for the Eye-One Display 2. For the black calibration the
+ instrument should be placed on an opaque, black surface, and any
+ stray light should be avoided by placing something opaque over the
+ instrument. If a Spectrolino is being used, then a white and black
+ calibration will always be performed before the instrument can be
+ placed on the display, unless the <a href="dispcal.html#N">-N</a>
+ flag is used. Generally it is not necessary to do a calibration
+ every time an instrument is used, just now and again. There is also
+ no point in doing a CRT frequency calibration, as this will be
+ done automatically at the commencement of patch reading, and will be
+ lost between runs.<br>
+ <br>
+ <a name="N"></a> <span style="font-weight: bold;">-N</span> Any
+ instrument that requires regular calibration will ask for
+ calibration on initial start-up. Sometimes this can be awkward if
+ the instrument is being mounted in some sort of measuring jig, or
+ annoying if several sets of readings are being taken in quick
+ succession. The -<span style="font-weight: bold;">N</span>
+ suppresses this initial calibration if a valid and not timed out
+ previous calibration is recorded in the instrument or on the host
+ computer. It is advisable to only use this option on the second and
+ subsequent measurements in a single session.<br>
+ <br>
+ <a name="H"></a> The -<span style="font-weight: bold;">H</span>
+ option turns on high resolution spectral mode, if the instrument
+ supports it, such as the Eye-One Pro. See <a
+ href="instruments.html">Operation of particular instruments</a>
+ for more details. This may give better accuracy for display
+ measurements.<br>
+ <br>
+ <a name="X1"></a> The -<span style="font-weight: bold;">X <span
+ style="font-style: italic;">file.ccmx</span></span> option reads
+ a <a href="File_Formats.html#.ccmx">Colorimeter Correction Matrix</a>
+ from the given file, and applies it to the colorimeter instruments
+ readings. This can improve a colorimeters accuracy for a particular
+ type of display. A list of contributed <span style="font-weight:
+ bold;">ccmx</span> files is <a href="ccmxs.html">here</a>.<br>
+ <br>
+ <a name="X2"></a> The -<span style="font-weight: bold;">X <span
+ style="font-style: italic;">file.ccss</span></span> option reads
+ a <a href="File_Formats.html#.ccss">Colorimeter Calibration
+ Spectral Sample</a> from the given file, and uses it to set the
+ colorimeter instruments calibration. This will only work with
+ colorimeters that rely on sensor spectral sensitivity calibration
+ information (ie. the X-Rite <span style="font-weight: bold;">i1d3</span>,
+ or the DataColor <span style="font-weight: bold;">Spyder4 &
+ Spyder 5</span>).This can improve a colorimeters accuracy for a
+ particular type of display.<br>
+ <br>
+ <a name="Q"></a> The <b>-Q</b> flag allows specifying a tristimulus
+ observer, and is used to compute PCS (Profile Connection Space)
+ tristimulus values from spectral readings or using a colorimeter
+ that has CCSS capability. The following choices are available:<br>
+ <b> 1931_2</b> selects the standard CIE 1931 2 degree
+ observer. The default.<br>
+ <b>1964_10</b> selects the standard CIE 1964 10 degree
+ observer.<br>
+ <b>1955_2</b> selects the Stiles and Birch 1955 2 degree
+ observer<br>
+ <b>1978_2 </b>selects the Judd and Voss 1978 2 degree
+ observer<br>
+ <b>shaw</b> selects the Shaw and Fairchild 1997 2 degree
+ observer<br>
+ <b>1964_10c</b> selects a version of the CIE 1964 10 degree
+ observer that has been adjusted using a 3x3 matrix to better agree
+ with the 1931 2 degree observer.<br>
+ <br>
+ <span style="font-weight: bold;">NOTE</span> that if you select
+ anything other than the default 1931 2 degree observer, that the Y
+ values will not be cd/m^2, due to the Y curve not being the CIE 1924
+ photopic V(λ) luminosity function.<br>
+ <br>
+ <a name="I"></a> The -<span style="font-weight: bold;">I <span
+ style="font-style: italic;">b|w</span></span> options invoke
+ instrument black level, and display white level compensation
+ (respectively). Instrument black level drift compensation attempts
+ to combat instrument black calibration drift by using a display
+ black test patch as a reference. If an instrument is not
+ acclimatised sufficiently to the measurement conditions, changes in
+ temperature can affect the black readings. Display white level drift
+ compensation attempts to combat changes in display brightness as it
+ warms up by measuring a white patch every so often, and using it to
+ normalise all the other readings. If just instrument black drift
+ compensation is needed, use <span style="font-weight: bold;">-Ib</span>.
+ If just display white level compensation is needed, use <span
+ style="font-weight: bold;">-Iw</span>. If both are needed, use <span
+ style="font-weight: bold;">-Ibw</span> or <span
+ style="font-weight: bold;">-Iwb</span>.<span style="font-weight:
+ bold;"> </span><br>
+ <br>
+ <a name="YR"></a> The -<span style="font-weight: bold;">Y R:<i>rate</i></span>
+ options overrides calibration of the instrument refresh rate. This
+ may be useful if the instrument supports this function and the
+ refresh rate cannot be accurately calibrated from the display
+ itself.<br>
+ <br>
+ <a name="YA"></a> The -<span style="font-weight: bold;">Y A</span>
+ option uses a non-adaptive integration time emission measurement
+ mode, if the instrument supports it, such as the Eye-One Pro,
+ ColorMunki, i1d3 and K10. By default an adaptive integration time
+ measurement mode will be used for emission measurements, but some
+ instruments support a fixed integration time mode that can be used
+ with display devices. This may give faster measurement times, but
+ may also give less accurate low level readings.<br>
+ <br>
+ <a name="Yp"></a> The -<span style="font-weight: bold;">Y p</span>
+ option skips asking the user to place the instrument on the display.
+ Normally a grey patch is displayed, and then the user is asked to
+ confirm that the instrument is in place, so that readings can
+ commence. This flag disables that check. This may be useful in
+ automating certain operations.<br>
+ <br>
+ <a name="C"></a> The -<span style="font-weight: bold;">C</span> <span
+ style="font-weight: bold;">"command" </span>option allows a
+ method of relaying each test value to some other display than that
+ on the system running dispcal (for instance, a photo frame, PDA
+ screen etc.), by causing the given command to be invoked to the
+ shell, with six arguments. The first three arguments are the RGB
+ test color as integers in the range 0 to 255, the second three
+ parameters are the RGB test color as floating point numbers in the
+ range 0.0 to 1.0. The script or tool should relay the given color to
+ the screen in some manner (e.g. by generating a raster file of the
+ given color and sending it to the display being profiled), before
+ returning. Note that a test window will also be created on the
+ system running dispread.<br>
+ <br>
+ <a name="M"></a> The -<span style="font-weight: bold;">M</span> <span
+ style="font-weight: bold;">"command" </span>option allows a
+ method of gathering each test value from some external source, such
+ as an instrument that is not directly supported by Argyll. The given
+ command is involked to the shell, with six arguments. The first
+ three arguments are the RGB test color as integers in the range 0 to
+ 255, the second three parameters are the RGB test color as floating
+ point numbers in the range 0.0 to 1.0. The script or tool should
+ create a file called <span style="font-weight: bold;">"command.meas</span>"
+ that contains the XYZ values for the given RGB (or measured from the
+ test window) in cd/m^2 as three numbers separated by spaces, before
+ returning. If the command returns a non-zero return value, dispcal
+ will abort. Note that a test window will also be created on the
+ system running dispcal.<br>
+ <br>
+ <a name="W"></a>The <b>-W</b> <span style="font-weight: bold;">n|h|x</span>
+ parameter overrides the default serial communications flow control
+ setting. The value <span style="font-weight: bold;">n</span> turns
+ all flow control off, <span style="font-weight: bold;">h</span>
+ sets hardware handshaking, and <span style="font-weight: bold;">x</span>
+ sets Xon/Xoff handshaking. This commend may be useful in workaround
+ serial communications issues with some systems and cables. <br>
+ <br>
+ <a name="D"></a>The <b>-D</b> flag causes communications and other
+ instrument diagnostics to be printed to stdout. A level can be set
+ between 1 .. 9, that may give progressively more verbose
+ information, depending on the instrument. This can be useful in
+ tracking down why an instrument can't connect.<br>
+ <br>
+ <a name="p1"></a><span style="font-weight: bold;">inoutfile</span>
+ The final parameter on the command line is the base filename for the
+ <a href="cal_format.html">.cal</a> file and the optional ICC
+ profile. Normally this will be created (or an existing file will be
+ overwritten). If the <span style="font-weight: bold;">-u</span>
+ flag is used, then these files will be updated. If a different ICC
+ profile name needs to be specified, do so as an argument to the <span
+ style="font-weight: bold;">-o</span> flag.<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>
+ <br>
+ <hr style="width: 100%; height: 2px;">
+ <h2><a name="Adjustment"></a>Discussion and guide to display control
+ adjustment:</h2>
+ <br>
+ The adjustment of the display controls (brightness, contrast, R, G
+ & B channel controls etc.) is very dependent on the particular
+ monitor. Different types and brands of monitors will have different
+ controls, or controls that operate in different ways. Some displays
+ have almost no user controls, and so you may well be best skipping
+ display adjustment, and going straight to calibration.<br>
+ <br>
+ Almost all LCD displays lack a real <span style="font-weight:
+ bold;">contrast</span> control. Those that do present such a
+ control generally fake it by adjusting the video signal. For this
+ reason it is usually best to set an LCD's <span style="font-weight:
+ bold;">contrast</span> control at its neutral setting (ie. the
+ setting at which it doesn't change the video signal). Unfortunately,
+ it can be hard to know what this neutral setting is. On some
+ displays it is 50%, others 75%. If the LCD display has a "reset to
+ factory defaults" mode, then try using this first, as a way of
+ setting the <span style="font-weight: bold;">contrast</span>
+ control to neutral. The LCD <span style="font-weight: bold;">brightness</span>
+ control generally adjusts the level of backlighting the display
+ gets, which affects the maximum brightness, and also tends to raise
+ or lower the black level in proportion, without changing the
+ displays response curve shape or overall contrast ratio. If your LCD
+ display has a <span style="font-weight: bold;">backlight</span>
+ control as well as a <span style="font-weight: bold;">brightness</span>
+ control, then the brightness control is also probably being faked,
+ and you are probably better off setting it to it's neutral setting,
+ and using the <span style="font-weight: bold;">backlight</span>
+ control in place of <span style="font-weight: bold;">brightness</span>
+ in the following adjustments.<br>
+ <br>
+ Some high end displays have the ability to mimic various standard
+ colorspaces such as sRGB or AdobeRGB. You could choose to calibrate
+ and profile the display in such an emulation mode, although you
+ probably don't want to fight the emulations white point and gamma.
+ To get the best out of such a display you really want to choose it's
+ "Native Gamut" setting, whatever that is called. Note that some
+ people have reported bad experiences in trying to use "6-axis custom
+ controls" on displays such as the Dell U2410, so attempting to use
+ such a mode should be approached with caution. Ideally such a mode
+ should be used to give just the underlying native display response,
+ but the settings to achieve this may be very difficult to determine,
+ and/or it may not be possible, depending on how such a mode distorts
+ the RGB signals.<br>
+ <br>
+ On CRT based displays, the <span style="font-weight: bold;">brightness</span>
+ control generally adjusts the black level of the display (sometimes
+ called the <span style="font-weight: bold;">offset</span>), and as
+ a side effect, tends to change the maximum brightness too. A CRT <span
+ style="font-weight: bold;">contrast</span> control generally
+ adjusts the maximum brightness (sometimes called <span
+ style="font-weight: bold;">gain</span>) without affecting the
+ black level a great deal. On a CRT both the <span
+ style="font-weight: bold;">brightness</span> and <span
+ style="font-weight: bold;">contrast</span> controls will tend to
+ affect the shape or gamma of the display response curve.<br>
+ <br>
+ Many displays have some sort of color temperature adjustment. This
+ may be in the form of some pre-set color temperatures, or in the
+ form of individual Red, Green and Blue channel gain adjustments.
+ Some CRT displays also have R, G & B channel offset adjustments
+ that will affect the color temperatures near black, as well as
+ affect the individual channels curve shape. The color temperature
+ adjustment will generally affect the maximum brightness, and may
+ also affect the black level and the shape of the display response
+ curves.<br>
+ <br>
+ Some special (expensive) LCD displays may have a white point
+ adjustment that changes the color of the backlight. If you do not
+ have one of these types of LCD displays, then attempting to change
+ the white point of the display (even if it appears to have a "<span
+ style="font-weight: bold;">white point selection</span>" or <span
+ style="font-weight: bold;">R/G/B</span> "<span style="font-weight:
+ bold;">gain</span>" controls") may not be a good idea, as once
+ again these controls are probably being faked by manipulating the
+ signal levels. Even if you do manage to change the white point
+ significantly, it may do things like change the mid tone color too
+ dramatically, or create a display response that is hard to correct
+ with calibration, or results in side effects such as quantization
+ (banding) or other undesirable effects. You may have to try out
+ various controls (and your aim points for the display calibration),
+ to decide what is reasonable to attempt on an LCD display.<br>
+ <br>
+ Due to the variety of controls as well as the interaction between
+ them, it can be an iterative process to arrive at a good monitor
+ set-up, before proceeding on to calibrating and profiling a display.
+ For this reason, <span style="font-weight: bold;">dispcal</span>
+ offers a menu of adjustment modes, so that the user can
+ interactively and iteratively adjust the display controls to meet
+ the desired targets.<br>
+ <br>
+ 1) Black level (CRT: Brightness)<br>
+ 2) White point (Color temperature, R,G,B, Gain/Contrast)<br>
+ 3) White level (CRT: Gain/Contrast, LCD:
+ Brightness/Backlight)<br>
+ 4) Black point (R,G,B, Offset/Brightness)<br>
+ 5) Check all<br>
+ 6) Measure and set ambient for viewing condition adjustment<br>
+ 7) Continue on to calibration<br>
+ 8) Exit<br>
+ <br>
+ There are four basic adjustment modes. Normally one would proceed
+ through them in the order above, then perhaps repeat the first
+ adjustment, before checking the overall settings. The White point
+ and White level modes operate slightly differently, depending on
+ whether a white target point has been set using the <span
+ style="font-weight: bold;">-t -T</span> or <span
+ style="font-weight: bold;">-w</span> options, and on whether a
+ brightness target has been set using the <span style="font-weight:
+ bold;">-b</span> option.<br>
+ <br>
+ <br>
+ The first mode lets you adjust the black level of a CRT display.
+ Given the current white level, it calculates a value that should
+ produce a 1% display brightness if the black level is set correctly.
+ After doing some initial measurements, it will show the target
+ brightness value (in cd/m^2) on one line, and then underneath it
+ will show continuously updated readings from the display. The left
+ most character will switch from '\' to '/' or back again each time a
+ reading is updated. Some instruments can be quite slow in measuring
+ dark colors, and it's best to wait for a reading update before
+ changing the controls more than once. Underneath the target value is
+ displayed the current reading, and to the right of this is a '+',
+ '-' or '=' symbol, which gives a hint as to which way to adjust the
+ brightness control to improve the match to the target.<br>
+ <br>
+ <small style="font-weight: bold;"><span style="font-family:
+ monospace;"> Adjust CRT brightness to get target level.
+ Press space when done.</span><br style="font-family: monospace;">
+ <span style="font-family: monospace;"> Target
+ 0.60</span><br style="font-family: monospace;">
+ <span style="font-family: monospace;"> / Current 0.68
+ -</span></small><br>
+ <br>
+ Once happy with the adjustment, press space to go back to the menu.<br>
+ <br>
+ <br>
+ The second mode lets you adjust the color of the white point of the
+ display. If a target white point has been set, it will show the
+ target brightness value (in cd/m^2) on one line, together with the
+ target chromaticity co-ordinates for the white point, and then
+ underneath it will show continuously updated readings from the
+ display. The left most character will switch from '\' to '/' or back
+ again each time a reading is updated. Underneath the target
+ brightness value is displayed the current reading, and then the
+ current chromaticity co-ordinate values. To the right of this is the
+ current delta E of the white point from the target, and further to
+ the right are hints '+', '-' or '=' as to which direction to
+ adjust the individual Red, Green and Blue gain settings to move the
+ white point in the direction of the target, and reduce the delta E.
+ If the symbol is doubled, then this channel will have the greatest
+ effect. If you do not have individual channel gain controls, then
+ try choosing amongst color temperature pre-sets, to find one with
+ the lowest delta E. Depending on the stability of the display, the
+ coarseness of the controls, and the repeatability of the instrument,
+ you may not be able to get a perfectly zero delta E.<br>
+ <br>
+ <small style="font-weight: bold;"><span
+ style="font-family: monospace;">Adjust R,G & B gain to get
+ target x,y. Press space when done.<br>
+ Target B 60.00, x 0.3451, y 0.3516<br>
+ / Current B 60.05, x 0.3426, y 0.3506 DE
+ 1.4 R+ G+ B--</span><span style="font-family:
+ monospace;"></span></small><br>
+ <br>
+ If you did not set a white point target, then the information shown
+ is a little different - it will show the initial white point value,
+ as well as the color temperature, and the CIEDE2000 of the white
+ point to either the Daylight or Black Body locus (depending on
+ whether the <span style="font-weight: bold;">-T</span> flag was
+ set). The constantly updated values show the same thing, and the
+ Red, Green and Blue control hints show the direction to adjust the
+ controls to place the white point on the locus. The control that
+ will have the most direct effect on the color temperature will be
+ the Blue, while the Green will most directly move the white point
+ towards or away from the locus, thereby reducing the delta E of the
+ white point to the locus (but there is interaction).<br>
+ <br>
+ <small style="font-weight: bold;"><span style="font-family:
+ monospace;">Adjust R,G & B gain to desired white point.
+ Press space when done.</span><br style="font-family: monospace;">
+ <span style="font-family: monospace;"> Initial B 47.25, x
+ 0.3417, y 0.3456, CDT 5113 DE 6.9</span><br
+ style="font-family: monospace;">
+ <span style="font-family: monospace;">\ Current B 47.38, x 0.3420,
+ y 0.3460 CDT 5104 DE 6.7 R-- G+ B-</span></small><br>
+ <br>
+ The brightness value is just there as a guide to what effect
+ the adjustment is having on the overall brightness. Usually the
+ white level brightness is adjusted using the next adjustment mode.
+ Once happy with the adjustment, press space to go back to the menu.<br>
+ <br>
+ <br>
+ The third mode lets you adjust the brightness of white on the
+ display. If you set a target brightness using the <span
+ style="font-weight: bold;"><span style="font-weight: bold;">-b</span></span>
+ parameter, it will show the target brightness value (in cd/m^2) on
+ one line, and then underneath it will show continuously updated
+ readings from the display. The left most character will switch from
+ '\' to '/' or back again each time a reading is updated. Underneath
+ the target value is displayed the current reading, and to the right
+ of this is a '+', '-' or '=' symbol, which gives a hint as to which
+ way to adjust the CRT contrast or LCD brightness control to improve
+ the match to the target.<br>
+ <br>
+ <small style="font-weight: bold;"><span
+ style="font-family: monospace;">Adjust CRT Contrast or LCD
+ Brightness to get target level. Press space when done.<br>
+ Target 60.00<br>
+ / Current 59.96 +</span><span style="font-family:
+ monospace;"></span></small><br>
+ <br>
+ If you did not set a brightness target, it will show the initial
+ brightness as the target, and the current brightness, which you can
+ then set any way you want:<br>
+ <br>
+ <small style="font-weight: bold;"><span style="font-family:
+ monospace;">Adjust CRT Contrast or LCD Brightness to desired
+ level. Press space when done.</span><br style="font-family:
+ monospace;">
+ <span style="font-family: monospace;"> Initial 47.32</span><br
+ style="font-family: monospace;">
+ <span style="font-family: monospace;">/ Current 47.54</span></small><br>
+ <br>
+ Once happy with the adjustment, press space to go back to the menu.<br>
+ <br>
+ <br>
+ The fourth mode lets you adjust the color of the black point of the
+ display, if the display has Red, Green and Blue channel offset
+ controls. It will show the target 1% brightness value (in cd/m^2) on
+ one line, together with the target chromaticity co-ordinates for the
+ black point, and then underneath it will show continuously updated
+ readings from the display. The left most character will switch from
+ '\' to '/' or back again each time a reading is updated. Underneath
+ the target brightness value is displayed the current reading, and
+ then the current chromaticity co-ordinate values. To the right of
+ this is the current delta E of the black point from the target, and
+ further to the right are hints '+', '-' or '=' as to which
+ direction to adjust the individual Red, Green and Blue offset
+ settings to move the black point in the right direction. If the
+ symbol is doubled, then this channel will have the greatest effect.
+ <br>
+ <br>
+ <span style="font-family: monospace;"><span style="font-weight:
+ bold;"> Adjust R,G & B offsets to get target x,y.
+ Press space when done.<br>
+ Target B 0.60, x 0.3451, y 0.3516<br>
+ \ Current B 0.62, x 0.2782, y 0.2331 DE
+ 10.3 R+ G++ B-</span></span><small
+ style="font-weight: bold;"><span style="font-family: monospace;"></span><span
+ style="font-family: monospace;"></span></small><br>
+ <br>
+ The 1% brightness value is just there as a guide to what
+ effect the adjustment is having on the 1% brightness level. The
+ combined channel offsets may have an effect on this in combination
+ with the CRT brightness control. Press space to go back to the menu.<br>
+ <br>
+ <br>
+ The fifth selection checks on the overall settings. If targets
+ have been set, it will be like:<br>
+ <br>
+ <small style="font-weight: bold;"><span style="font-family:
+ monospace;"> Target Brightness = 50.00, Current = 47.44,
+ error = -5.1%<br>
+ Target 50% Level = 10.32, Current = 8.10,
+ error = -4.4%<br>
+ Target Near Black = 0.47, Current = 0.68,
+ error = 0.4%<br>
+ Target white = x 0.3458, y 0.3586, Current = x 0.3420, y
+ 0.3454, error = 7.55 DE<br>
+ Target black = x 0.3458, y 0.3586, Current = x 0.2908, y
+ 0.2270, error = 29.69 DE</span><span style="font-family:
+ monospace;"></span></small><br>
+ <br>
+ or if no targets are set:<br>
+ <br>
+ <small style="font-weight: bold;"><span style="font-family:
+ monospace;"> Current Brightness = 46.28</span><br
+ style="font-family: monospace;">
+ <span style="font-family: monospace;"> Target 50%
+ Level = 10.07, Current = 7.52, error = -5.5%</span><br
+ style="font-family: monospace;">
+ <span style="font-family: monospace;"> Target Near Black
+ = 0.46, Current = 0.46, error = -0.0%</span><br
+ style="font-family: monospace;">
+ <span style="font-family: monospace;"> Current white = x
+ 0.3439, y 0.3466, VCT 5098K DE 3.0</span><br
+ style="font-family: monospace;">
+ <span style="font-family: monospace;"> Target black = x
+ 0.3439, y 0.3466, Current = x 0.3093, y 0.2165, error = 30.30 DE</span></small><br>
+ <br>
+ and will then go back to the menu.<br>
+ <br>
+ The sixth selection <span style="font-weight: bold;">6)</span>
+ allows the reading of you ambient lighting conditions if your
+ instrument supports such a mode. Doing so will enable the <span
+ style="font-weight: bold;">-a</span> option to compensate for your
+ viewing conditions in the subsequent calibration. See <a
+ href="dispcal.html#a">-a</a>.<br>
+ <br>
+ Once you're happy with the display set-up, you can either
+ proceed on to the rest of the calibration by selecting <span
+ style="font-weight: bold;">7)</span>, or exit and re-start by
+ selecting <span style="font-weight: bold;">8)</span>. You might
+ want to re-start if you want to change the calibration targets.<br>
+ <br>
+ <hr style="width: 100%; height: 2px;">
+ <h2>Other caveats:</h2>
+ NOTE that some <span style="font-weight: bold;">LCD</span> screens
+ behave a little strangely near their absolute white point, and may
+ therefore exhibit odd behavior at values just below white. It may be
+ advisable in such cases to set a brightness slightly less than the
+ maximum such a display is capable of.<br>
+ <br>
+ The program attempts to stop any screensaver or powersaver from
+ interfering with the measurements, but this may not be effective on
+ some systems, so it may be necessary to manually disable the
+ screensaver and/or powersaver before commencing the calibration with
+ a large number of patches.<br>
+ <br>
+ The calibration tables produced maintain the maximum level of
+ precision available on a system. If the display has VideoLUTs
+ available (Video Lookup Tables that the frame buffer values pass
+ through on their way to the display) and thier outputs are better
+ than 8 bits per component, then the resulting curves can reflect
+ this, although few current operating systems and/or display cards
+ actually support better than 8 bit per component output.<br>
+ <br>
+ If calibration curves are created for a display in which VideoLUTs
+ are not available, then the resulting calibration file will be
+ marked to indicate this, and a subsequent profile created with the
+ calibration will not have the calibration converted to the 'vcgt'
+ tag, since such a tag can't be loaded into the displays VideoLUTs.<br>
+ <br>
+ If communications break down with a USB connected instrument, you
+ may have to unplug it, and plug it in again to recover operation.<br>
+ <br>
+ Some systems (Apple OS X in particular) have a special set of user
+ interface controls ("Universal Access") that allows altering the
+ display in ways designed to assist visually impaired users, by
+ increasing contrast etc. This will interfere badly with any attempts
+ to calibrate or profile such a system, and must be turned off in
+ order to do so. Note that certain magic keyboard sequences can turn
+ this on by accident.<br>
+ <br>
+ <br>
+ <br>
+ <br>
+ <br>
+ </body>
+</html>
|