diff options
Diffstat (limited to 'doc/dispcal.html')
| -rw-r--r-- | doc/dispcal.html | 754 |
1 files changed, 736 insertions, 18 deletions
diff --git a/doc/dispcal.html b/doc/dispcal.html index 7327c8f..e23a8d0 100644 --- a/doc/dispcal.html +++ b/doc/dispcal.html @@ -43,6 +43,20 @@ + + + + + + + + + + + + + + Verbose mode<br> </span></font><font size="-1"><span style="font-family: monospace;"> </span><a style="font-family: monospace;" @@ -82,6 +96,20 @@ for + + + + + + + + + + + + + + VideoLUT access.</span></font><br> <font size="-1"><span style="font-family: monospace;"> <a href="#d">-d n</a> @@ -112,6 +140,20 @@ list + + + + + + + + + + + + + + 1)</span></font><br> <span style="font-family: monospace;"> <a href="#dweb">-dweb[:port]</a> @@ -132,7 +174,40 @@ list - Display via a web server at port (default 8080)</span><br + + + + + + + + + + + + + + + Display via a web server at port (default 8080)</span><br> + <span style="font-family: monospace;"> <a href="#dmadvr">-dmadvr</a> + + + + + + + + + + + + + + + + + + [MSWin] Display via MadVR Video Renderer</span><br style="font-family: monospace;"> <font size="-1"><span style="font-family: monospace;"></span><span style="font-family: monospace;"></span><span style="font-family: @@ -158,6 +233,20 @@ list + + + + + + + + + + + + + + listno</a><span style="font-family: monospace;"> Set communication port from the following list (default 1)<br> @@ -208,6 +297,20 @@ list + + + + + + + + + + + + + + Fast ICC Profile Description string (Default "outfile")<br> <a href="#u">-u</a> Update @@ -237,6 +340,20 @@ ICC + + + + + + + + + + + + + + profile VideoLUTs</span><span style="font-family: monospace;"></span><span style="font-family: monospace;"></span><br style="font-family: monospace;"> @@ -262,6 +379,20 @@ ICC + + + + + + + + + + + + + + Quality - Low, Medium (def), High<br> <a href="#p">-p</a> @@ -272,6 +403,20 @@ 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> @@ -295,6 +440,20 @@ ICC + + + + + + + + + + + + + + Display type - instrument specific list to choose from.</span></font><font size="-1"><span style="font-family: monospace;"><br style="font-family: monospace;"> @@ -328,6 +487,20 @@ in + + + + + + + + + + + + + + deg. K (deflt.)<br> </span></font><font size="-1"><span style="font-family: monospace;"> </span><a style="font-family: monospace;" @@ -359,6 +532,20 @@ 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 @@ -383,6 +570,20 @@ temperaturee + + + + + + + + + + + + + + Set the target white point as chromaticity coordinates</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a @@ -407,6 +608,20 @@ temperaturee + + + + + + + + + + + + + + Set the target white brightness in cd/m^2</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a @@ -431,6 +646,20 @@ temperaturee + + + + + + + + + + + + + + Set the target response curve gamma (Def. 2.4)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -453,6 +682,20 @@ temperaturee + + + + + + + + + + + + + + Use "-gl" for L*a*b* curve</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -475,6 +718,20 @@ temperaturee + + + + + + + + + + + + + + Use "-gs" for sRGB curve<br> Use @@ -504,6 +761,20 @@ use + + + + + + + + + + + + + + -a as well!)<br> @@ -525,6 +796,20 @@ 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> <font size="-1"><span style="font-family: monospace;"> @@ -547,6 +832,20 @@ use + + + + + + + + + + + + + + Use "-G2.4 -f0" for BT.1886</span></font> @@ -560,6 +859,20 @@ use + + + + + + + + + + + + + + <br> <font size="-1"><span style="font-family: monospace;"> </span><a style="font-family: monospace;" href="#G">-G gamma</a><span @@ -594,6 +907,20 @@ output + + + + + + + + + + + + + + offset (default all output offset)<br> <a href="#a">-a ambient</a> @@ -615,6 +942,20 @@ 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> @@ -647,6 +988,20 @@ 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 @@ -672,10 +1027,25 @@ 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="#E">-E</a><span style="font-family: monospace;"> + href="#z">-<font size="-1">z</font></a><span style="font-family: + monospace;"> @@ -696,6 +1066,20 @@ 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 @@ -730,6 +1114,20 @@ center, + + + + + + + + + + + + + + = right/bottom etc.</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> ss: @@ -759,6 +1157,20 @@ normal, + + + + + + + + + + + + + + = double etc.<br> </span></font><font size="-1"><span style="font-family: monospace;"> @@ -768,6 +1180,20 @@ normal, + + + + + + + + + + + + + + ss,vs: = optional horizontal, vertical scale.</span></font><br> <font size="-1"><span style="font-family: monospace;"> <a href="#F">-F</a> @@ -791,8 +1217,39 @@ normal, + + + + + + + + + + + + + + Fill whole screen with black background</span></font><font - size="-1"><span style="font-family: monospace;"></span></font><br + 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> + + + + + + + + + + + + + + </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 @@ -825,6 +1282,20 @@ on + + + + + + + + + + + + + + test window<br> </span></font><font size="-1"><span style="font-family: monospace;"> </span><a style="font-family: monospace;" @@ -852,6 +1323,20 @@ 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 @@ -883,6 +1368,20 @@ on + + + + + + + + + + + + + + Apply Colorimeter Correction Matrix</span></font><br> <span style="font-family: monospace;"> <a href="#X2">-X file.ccss</a> @@ -908,6 +1407,20 @@ 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 @@ -935,6 +1448,20 @@ 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, @@ -959,14 +1486,42 @@ Calibration - Drift compensation, Black: -Ib, White: -Iw, Both: -Ibw<br> - </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 + + + + + + + + + + + + + + + Drift compensation, Black: -Ib, White: -Iw, Both: -Ibw</span></small><br> + <small><span style="font-family: monospace;"><tt> <a href="#YR">-Y + + + R:<i>rate</i></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 @@ -1009,6 +1564,20 @@ 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 @@ -1034,6 +1603,20 @@ none, + + + + + + + + + + + + + + Print debug diagnostics to stderr</span></font><br style="font-family: monospace;"> <font size="-1"><span style="font-family: monospace;"></span><span @@ -1059,6 +1642,20 @@ 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 @@ -1079,7 +1676,9 @@ none, <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.<br> + 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 @@ -1149,6 +1748,20 @@ 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 @@ -1183,6 +1796,16 @@ none, 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 you may have to start the video playback + software and load a video clip in pause for this to work. MadVR + rendering does not need or support VideoLUT access, but be aware + that the state of the Graphics Card VideoLUTs may affect the + results, and therefore may have to be set appropriately using + dispwin. Test patch colors will <u>not</u> be processed by the + MadVR 3dLut by default.<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> @@ -1198,9 +1821,11 @@ none, 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. If <span style="font-weight: bold;">-R</span> - is use, then the uncalibrated ("raw" or "native") behaviour is - measured. Reported are: <br> + 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> @@ -1339,10 +1964,9 @@ none, 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="file:///D:/src/argyll/doc/ccxxmake.html">ccxxmake</a>, - and installed using <a - href="file:///D:/src/argyll/doc/oeminst.html">oeminst</a>. The - default and Base Calibration types will be indicated in the usage.<br> + 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 @@ -1410,6 +2034,20 @@ 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 @@ -1438,6 +2076,20 @@ 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>) @@ -1517,6 +2169,20 @@ 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 @@ -1606,7 +2272,8 @@ As 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).<br> + 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 @@ -1629,6 +2296,20 @@ 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 @@ -1668,7 +2349,7 @@ If ascertained. The verification uses a fixed number of semi-random test values to test the calibration.<br> <br> - <a name="E"></a><span style="font-weight: bold;">-E</span> Run + <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 @@ -1677,7 +2358,7 @@ If 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;">-E</span>. + 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 @@ -1710,6 +2391,16 @@ If 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 @@ -1789,6 +2480,20 @@ a + + + + + + + + + + + + + + colorimeters accuracy for a particular type of display.<br> <br> <a name="Q"></a> The <b>-Q</b> flag allows specifying a tristimulus @@ -1832,6 +2537,12 @@ a 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 or @@ -1841,6 +2552,13 @@ a This may give increased consistency and 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 |