state from 2014-09-07 13:30 MESZ

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 @@
 
 
 
+
+
+
+
+
+
+
+
+
       &nbsp;&nbsp;&nbsp;&nbsp; Verbose mode<br>
       &nbsp;</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;">&nbsp;<a
           href="#d">-d n</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -88,6 +106,15 @@ list
 
 
 
+
+
+
+
+
+
+
+
+
         (default 1)</span></font><small style="font-family: monospace;"><br>
     </small><span style="font-family: monospace;">&nbsp;<a href="#dweb">-dweb[:port]</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
@@ -105,7 +132,30 @@ list
 
 
 
+
+
+
+
+
+
+
+
+
       Display via a web server at port (default 8080)</span><br>
+    <span style="font-family: monospace;">&nbsp;<a href="#dmadvr">-dmadvr</a>
+      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+      [MSWin] Display via MadVR Video Renderer</span><br>
     <small style="font-family: monospace;"> <span style="font-family:
         monospace;">&nbsp;</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>
     &nbsp; <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;">&nbsp;<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;">&nbsp;<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>&nbsp;<a href="#V">-V</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+      [MSWin] Enable MadVR color management (3dLut)</tt><br>
     <small style="font-family: monospace;">&nbsp;<a href="#s">-s</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
 
@@ -195,6 +286,15 @@ Apply
 
 
 
+
+
+
+
+
+
+
+
+
       &nbsp;&nbsp;&nbsp;&nbsp; Save spectral information (default don't
       save)<br>
     </small><font style="font-family: monospace;" size="-1">&nbsp;<a
@@ -221,6 +321,15 @@ center,
 
 
 
+
+
+
+
+
+
+
+
+
       1.0 = right/bottom etc.<br>
       &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 ss:
@@ -243,6 +352,15 @@ normal,
 
 
 
+
+
+
+
+
+
+
+
+
       2.0 = double etc.<br>
     </font><font size="-1"><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
@@ -251,6 +369,15 @@ normal,
 
 
 
+
+
+
+
+
+
+
+
+
         ss,vs: = optional horizontal, vertical scale.</span></font><br>
     <font style="font-family: monospace;" size="-1"> &nbsp;</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;">&nbsp;</span></font><font
+      size="-1"><span style="font-family: monospace;"><a href="#E">-E</a>
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+      </span></font><small><span style="font-family: monospace;">Video
+        encode output as (16-235)/255 "TV" levels</span></small><br
       style="font-family: monospace;">
     <small style="font-family: monospace;">&nbsp;<span
         style="text-decoration: underline;"></span><a href="#n">-n</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -292,6 +440,15 @@ redirect
 
 
 
+
+
+
+
+
+
+
+
+
       on test window<br>
     </small><small style="font-family: monospace;">&nbsp;<a href="#J">-J</a>
       &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -308,6 +465,15 @@ redirect
 
 
 
+
+
+
+
+
+
+
+
+
       &nbsp;&nbsp;&nbsp;&nbsp; Run calibration first</small><br>
     <font size="-1"><span style="font-family: monospace;">&nbsp;<a
           href="#N">-N</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -324,6 +490,15 @@ redirect
 
 
 
+
+
+
+
+
+
+
+
+
         Disable initial calibration of instrument if possible<br>
       </span></font><font size="-1"><span style="font-family:
         monospace;">&nbsp;</span><a style="font-family: monospace;"
@@ -355,6 +530,15 @@ Y
 
 
 
+
+
+
+
+
+
+
+
+
         100</span></font><small><span style="font-family: monospace;"></span></small><br>
     &nbsp; <font size="-1"><span style="font-family: monospace;"><a
           href="#X1">-X file.ccmx</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -371,6 +555,15 @@ Y
 
 
 
+
+
+
+
+
+
+
+
+
         Apply Colorimeter Correction Matrix</span></font><br>
     <span style="font-family: monospace;">&nbsp;<a href="#X2">-X
         file.ccss</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -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;">&nbsp;</span><a
@@ -411,6 +613,15 @@ Calibration
 
 
 
+
+
+
+
+
+
+
+
+
         &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 1931_2 </span></small><small><span
         style="font-family: monospace;">(def.)</span></small><small><span
         style="font-family: monospace;">, 1964_10, S&amp;B 1955_2, shaw,
@@ -437,18 +648,46 @@ Both:
 
 
 
-        -Ibw<br>
-      </span></small><font size="-1"><span style="font-family:
-        monospace;">&nbsp;</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>&nbsp;<a href="#YR">-Y
+            R:<i>rate</i></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+          Override measured refresh rate with rate Hz<br>
+        </tt>&nbsp;</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;">
         &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
 
 
 
+
+
+
+
+
+
+
+
+
         Use non-adaptive integration time mode (if available).</span></font><br>
     <font size="-1"><span style="font-family: monospace;">&nbsp;</span><a
+        style=" font-family: monospace;" href="#Yp">-<font size="-1">Y</font>
+        <font size="-1">p</font></a><span style="font-family:
+        monospace;">
+        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+        &nbsp;&nbsp;&nbsp; Don't wait for the instrument to be placed on
+        the display</span></font><br>
+    <font size="-1"><span style="font-family: monospace;">&nbsp;</span><a
         style="font-family: monospace;" href="#C">-C "command"</a><span
         style="font-family: monospace;">
         &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Invoke shell
@@ -480,6 +719,15 @@ n
 
 
 
+
+
+
+
+
+
+
+
+
         none, h = HW, x = Xon/Xoff</span></font><br>
     <small style="font-family: monospace;">&nbsp;<a href="#D">-D [level]</a>
       &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 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;">&nbsp;<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