summaryrefslogtreecommitdiff
path: root/doc/dispread.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/dispread.html')
-rw-r--r--doc/dispread.html369
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