diff options
Diffstat (limited to 'doc/dispread.html')
-rw-r--r-- | doc/dispread.html | 369 |
1 files changed, 345 insertions, 24 deletions
diff --git a/doc/dispread.html b/doc/dispread.html index e1ce861..071fa7d 100644 --- a/doc/dispread.html +++ b/doc/dispread.html @@ -34,6 +34,15 @@ + + + + + + + + + Verbose mode<br> </small><font size="-1"><a style="font-family: monospace;" href="#display">-display displayname</a><span @@ -65,6 +74,15 @@ m + + + + + + + + + for VideoLUT access.</span></font><br> <font size="-1"><span style="font-family: monospace;"> <a href="#d">-d n</a> @@ -88,6 +106,15 @@ list + + + + + + + + + (default 1)</span></font><small style="font-family: monospace;"><br> </small><span style="font-family: monospace;"> <a href="#dweb">-dweb[:port]</a> @@ -105,7 +132,30 @@ list + + + + + + + + + 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> <small style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a style="font-family: monospace;" href="#c">-c listno</a><span style="font-family: monospace;"> @@ -126,6 +176,15 @@ list + + + + + + + + + Use telephoto mode (ie. for a projector) (if available)</span></font><br> <font size="-1"><span style="font-family: monospace;"><a href="#y">-y X</a> @@ -145,6 +204,15 @@ Display + + + + + + + + + type - instrument specific list to choose from.</span></font><br> <small style="font-family: monospace;"> <span style="text-decoration: underline;">-</span><a href="#k">k @@ -162,6 +230,15 @@ Display + + + + + + + + + Load calibration file into display while reading<br> </small><small style="font-family: monospace;"> <span style="text-decoration: underline;">-</span><a href="#K">K @@ -180,7 +257,21 @@ Apply + + + + + + + + + calibration file to test values while reading</small><br> + <tt> <a href="#V">-V</a> + + + + [MSWin] Enable MadVR color management (3dLut)</tt><br> <small style="font-family: monospace;"> <a href="#s">-s</a> @@ -195,6 +286,15 @@ Apply + + + + + + + + + Save spectral information (default don't save)<br> </small><font style="font-family: monospace;" size="-1"> <a @@ -221,6 +321,15 @@ center, + + + + + + + + + 1.0 = right/bottom etc.<br> ss: @@ -243,6 +352,15 @@ normal, + + + + + + + + + 2.0 = double etc.<br> </font><font size="-1"><span style="font-family: monospace;"> @@ -251,6 +369,15 @@ normal, + + + + + + + + + ss,vs: = optional horizontal, vertical scale.</span></font><br> <font style="font-family: monospace;" size="-1"> </font><font size="-1"><span style="font-family: monospace;"><a href="#F">-F</a> @@ -268,7 +395,28 @@ normal, - Fill whole screen with black background</span></font><br + + + + + + + + + + Fill whole screen with black background</span></font><br> + <font size="-1"><span style="font-family: monospace;"> </span></font><font + size="-1"><span style="font-family: monospace;"><a href="#E">-E</a> + + + + + + + + + </span></font><small><span style="font-family: monospace;">Video + encode output as (16-235)/255 "TV" levels</span></small><br style="font-family: monospace;"> <small style="font-family: monospace;"> <span style="text-decoration: underline;"></span><a href="#n">-n</a> @@ -292,6 +440,15 @@ redirect + + + + + + + + + on test window<br> </small><small style="font-family: monospace;"> <a href="#J">-J</a> @@ -308,6 +465,15 @@ redirect + + + + + + + + + Run calibration first</small><br> <font size="-1"><span style="font-family: monospace;"> <a href="#N">-N</a> @@ -324,6 +490,15 @@ redirect + + + + + + + + + Disable initial calibration of instrument if possible<br> </span></font><font size="-1"><span style="font-family: monospace;"> </span><a style="font-family: monospace;" @@ -355,6 +530,15 @@ Y + + + + + + + + + 100</span></font><small><span style="font-family: monospace;"></span></small><br> <font size="-1"><span style="font-family: monospace;"><a href="#X1">-X file.ccmx</a> @@ -371,6 +555,15 @@ Y + + + + + + + + + Apply Colorimeter Correction Matrix</span></font><br> <span style="font-family: monospace;"> <a href="#X2">-X file.ccss</a> @@ -390,6 +583,15 @@ 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 @@ -411,6 +613,15 @@ 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, @@ -437,18 +648,46 @@ 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 + + + + + + + + + + -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> + <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 @@ -480,6 +719,15 @@ n + + + + + + + + + none, h = HW, x = Xon/Xoff</span></font><br> <small style="font-family: monospace;"> <a href="#D">-D [level]</a> Print debug @@ -498,6 +746,15 @@ n + + + + + + + + + Base name for input[<a href="File_Formats.html#.ti1">.ti1</a>]/output[<a href="File_Formats.html#.ti3">.ti3</a>] file.<br> </small> <br> @@ -578,6 +835,15 @@ n + + + + + + + + + 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 @@ -600,9 +866,9 @@ n URL will be printed once the server is started, or you could run <span style="font-weight: bold;">ipconfig</span> (MSWin) or <span style="font-weight: bold;">/sbin/ifconfig</span> (Linux or OS X) - and identify an internet address for your machine that way. - <b> JavaScript</b> needs to be enabled in your web browser for this - to work.<br> + and identify an internet address for your machine that way. <b> + JavaScript</b> needs to be enabled in your web browser for this to + work.<br> <br> Note that if you use this method of displaying test patches, that there is no access to the display VideoLUTs and that the colors will @@ -613,6 +879,17 @@ n 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> + <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, so the <a + href="#K">-K</a> option should be used to read calibrated values. + Be aware that the state of the Graphics Card VideoLUTs may affect + the results, and therefore may have to be set appropriately using + dispwin. By default the test patch colors will <u>not</u> be + processed by the MadVR 3dLut (see the -<a href="#V">V</a> flag).<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> @@ -650,9 +927,9 @@ n 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>, + using <a href="ccxxmake.html">ccxxmake</a>, and installed using <a - href="file:///D:/src/argyll/doc/oeminst.html">oeminst</a>. The + href="oeminst.html">oeminst</a>. The default and Base Calibration types will be indicated in the usage.<br> <br> <a name="s"></a><span style="font-weight: bold;">-s</span>: By @@ -664,7 +941,7 @@ n <a name="k"></a> <span style="font-weight: bold;">-k: </span>If a display video lookup table calibration <a href="File_Formats.html#.cal">.cal</a> file is provided, it will - be loaded into the display <span style="font-weight: bold;">ViedoLUTs</span> + be loaded into the display <span style="font-weight: bold;">VideoLUTs</span> while the measurements are being taken, thereby being applied to the measurement values, and the calibration will also included in the resulting .ti3 data file, so that <a href="colprof.html">colprof</a> @@ -672,14 +949,20 @@ n tag in the resulting profile. This is the <span style="font-weight: bold;">normal</span> way to profile a calibrated display. The calibration file has usually been created using <a - href="dispcal.html">dispcal</a>. If a calibration file is not - created, then the display will be read in whatever calibration state - it is in. If the calibration file indicates that the displays - VideoLUTs are not accessible, or if they prove not to be accessible, - then dispread will switch to <span style="font-weight: bold;">-K</span> - mode (see below). <span style="font-weight: bold;">NOTE</span> that - the calibration is loaded into the display hardware just before the - instrument starts measurement, after the test window first appears.<br> + href="dispcal.html">dispcal</a>. If the calibration file indicates + that the displays VideoLUTs are not accessible, or if they prove not + to be accessible, then dispread will switch to <span + style="font-weight: bold;">-K</span> mode (see below). If a + calibration file is not supplied using <b>-k</b> or <b>-K</b>, + then the display will be measured in whatever calibration state it + is in, and no calibration information is saved to the resulting .ti3 + file.<br> + If the calibration file provided created using video range encoding + (dispcal -E), then the <b>-E</b> option in dispread will be + triggered automatically.<br> + <span style="font-weight: bold;">NOTE</span> that the calibration is + loaded into the display hardware just before the instrument starts + measurement, after the test window first appears.<br> <br> <a name="K"></a> <span style="font-weight: bold;">-K: </span>If a display video lookup table calibration <a @@ -691,7 +974,18 @@ n profile. This is <span style="font-weight: bold;">NOT</span> normally the best way to profile a calibrated display, since the frame buffer may have lower precision than the VideoLUTs output - values.<br> + values. This is the way calibration should be applied if MadVR is + being used to display the test patches. If a calibration file is not + supplied using <b>-k</b> or <b>-K</b>, then the display will be + measured in whatever calibration state it is in, and no calibration + information is saved to the resulting .ti3 file.<br> + If the calibration file provided created using video range encoding + (dispcal -E), then the <b>-E</b> option in dispread will be + triggered automatically.<br> + <br> + <a name="V"></a><b>-V:</b> [MSWin] If using MadVR to display test + patches, then enable Color Managenent (3dLut). This would be used + for verification measurement.<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 @@ -720,6 +1014,12 @@ n with black. This can aid black accuracy when measuring CRT displays or projectors.<br> <br> + <a name="E"></a> The <span style="font-weight: bold;">-E</span> + flag causes the test values to be scaled to the Video RGB encoding + range of 16/255 to 235/255. If the calibration file provided using + the <b>-k</b> or <b>-K</b> flag was created using video range + encoding, then this option will be triggered automatically.<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>dispread</b> normally selects the override redirect so that the test window will @@ -795,6 +1095,15 @@ a + + + + + + + + + colorimeters accuracy for a particular type of display.<br> <br> <a name="Q"></a> The <b>-Q</b> flag allows specifying a tristimulus @@ -835,9 +1144,14 @@ a 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;"> <br> - <br> + style="font-weight: bold;">-Iwb</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> + <span style="font-weight: bold;"> <br> </span><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 @@ -846,7 +1160,14 @@ a a fixed integration time mode that can be used with display devices. This may give increased consistency and faster measurement times, but may also give less accurate low level readings.<br> - <span style="font-weight: bold;"> <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> + <span style="font-weight: bold;"><br> </span><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 |