summaryrefslogtreecommitdiff
path: root/doc/spotread.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/spotread.html')
-rwxr-xr-x[-rw-r--r--]doc/spotread.html287
1 files changed, 274 insertions, 13 deletions
diff --git a/doc/spotread.html b/doc/spotread.html
index 36ee999..143b61e 100644..100755
--- a/doc/spotread.html
+++ b/doc/spotread.html
@@ -56,6 +56,11 @@
+
+
+
+
+
&nbsp; &nbsp; &nbsp; Verbose mode</span><br style="font-family:
monospace;">
<span style="font-family: monospace;"></span><span
@@ -98,6 +103,11 @@
+
+
+
+
+
&nbsp; &nbsp; &nbsp; Print spectrum for each reading.</span></small><br
style="font-family: monospace;">
<small><span style="font-family: monospace;"></span><span
@@ -145,6 +155,11 @@
+
+
+
+
+
Set COM port, 1..4 (default 1)</span><span style="font-family:
monospace;"></span><span style="font-family: monospace;"><br
style="font-family: monospace;">
@@ -186,6 +201,11 @@
+
+
+
+
+
&nbsp; &nbsp; &nbsp; Use transmission measurement mode</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a style="
@@ -227,6 +247,11 @@
+
+
+
+
+
Use emissive measurement mode (absolute results)<br>
</span></small><small><span style="font-family: monospace;">&nbsp;</span><a
style=" font-family: monospace;" href="#eb">-eb</a><span
@@ -267,6 +292,11 @@
+
+
+
+
+
Use display white brightness relative measurement mode<br>
</span></small><small><span style="font-family: monospace;">&nbsp;</span><a
style=" font-family: monospace;" href="#ew">-ew</a><span
@@ -290,6 +320,11 @@
+
+
+
+
+
Use display white point relative chromatically adjusted mode<br>
</span></small><small><span style="font-family: monospace;">&nbsp;</span><a
style=" font-family: monospace;" href="#p">-p</a><span
@@ -330,6 +365,11 @@
+
+
+
+
+
Use telephoto measurement mode (absolute results)<br>
</span></small><small><span style="font-family: monospace;">&nbsp;</span><a
style=" font-family: monospace;" href="#pb">-pb</a><span
@@ -370,6 +410,11 @@
+
+
+
+
+
Use </span></small><small><span style="font-family: monospace;">projector</span></small><small><span
style="font-family: monospace;"> white brightness relative
measurement mode<br>
@@ -412,6 +457,11 @@
+
+
+
+
+
Use </span></small><small><span style="font-family: monospace;">projector</span></small><small><span
style="font-family: monospace;"> </span></small><small><span
style="font-family: monospace;">white point relative
@@ -455,6 +505,11 @@
+
+
+
+
+
Use ambient measurement mode (absolute results)<br>
&nbsp;<a href="#f">-f</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -492,6 +547,11 @@
+
+
+
+
+
Use ambient flash measurement mode (absolute results)<br>
</span></small><font size="-1"><span style="font-family:
monospace;">&nbsp;<a href="#y">-y X</a>
@@ -531,6 +591,11 @@
+
+
+
+
+
Display type - instrument specific list to choose from.</span></font><br>
<small><span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="spotread.html#I">-I illum</a><span
@@ -568,6 +633,11 @@ M0,
+
+
+
+
+
M1, M2, A, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp</span></small><br
style="font-family: monospace;">
<small><span style="font-family: monospace;"></span><span
@@ -622,6 +692,11 @@ D50
+
+
+
+
+
D50M2, D65, F5, F8, F10 or file.sp</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">&nbsp;</span><a style="
@@ -666,13 +741,20 @@ D50
+
+
+
+
+
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; </span></small><small><span
style="font-family: monospace;">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,
- J&amp;V 1978_2</span></small><small><span style="font-family:
- monospace;"></span></small><font size="-1"><span
- style="font-family: monospace;"><br>
+ style="font-family: monospace;">, 1964_10, </span></small><small><span
+ style="font-family: monospace;"><tt><small>2012_2, 2012_10, </small></tt>S&amp;B
+
+ 1955_2, shaw, J&amp;V 1978_2</span></small><small><span
+ style="font-family: monospace;"></span></small><font size="-1"><span
+ style="font-family: monospace;"> or file.cmf<br>
&nbsp;<a href="#F">-F filter</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -709,6 +791,11 @@ D50
+
+
+
+
+
Set filter configuration:<br>
&nbsp;&nbsp;
n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -747,6 +834,11 @@ D50
+
+
+
+
+
None<br>
&nbsp;&nbsp;
p&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -785,6 +877,11 @@ D50
+
+
+
+
+
Polarising filter<br>
&nbsp;&nbsp;
6&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -823,6 +920,11 @@ D50
+
+
+
+
+
D65<br>
&nbsp;&nbsp;
u&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -861,6 +963,11 @@ D50
+
+
+
+
+
U.V. Cut<br>
&nbsp;<a href="#E">-E extrafilterfile</a>&nbsp;&nbsp;&nbsp;
Apply extra filter compensation file<br>
@@ -872,6 +979,11 @@ D50
+
+
+
+
+
XRGA conversion (default N)<br>
</span></font><font size="-1"><span style="font-family:
monospace;">&nbsp;<a href="#x">-x</a>
@@ -911,6 +1023,11 @@ D50
+
+
+
+
+
Display Yxy instead of Lab<br>
</span></font><font size="-1"><span style="font-family:
monospace;">&nbsp;<a href="#h">-h</a>
@@ -950,9 +1067,59 @@ D50
+
+
+
+
+
Display LCh instead of Lab</span></font><br>
- <font size="-1"><span style="font-family: monospace;">&nbsp;<a
- href="#V">-V</a>
+ <font size="-1"><span style="font-family: monospace;"><font
+ size="-1"><span style="font-family: monospace;">&nbsp;<a
+ href="#u">-u</a>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Display Luv instead of Lab</span></font><br>
+ </span></font> <font size="-1"><span style="font-family:
+ monospace;">&nbsp;<a href="#V">-V</a>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -989,6 +1156,11 @@ D50
+
+
+
+
+
Show running average and std. devation from ref.</span></font><br>
<font size="-1"><span style="font-family: monospace;">&nbsp;<a
href="#T">-T</a>
@@ -1028,6 +1200,11 @@ D50
+
+
+
+
+
Display correlated color temperatures, CRI and TLCI<br>
</span></font><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;&nbsp;
@@ -1066,6 +1243,11 @@ D50
+
+
+
+
+
Disable initial calibration of instrument if possible</span></font><br>
<font size="-1"><span style="font-family: monospace;">&nbsp;<a
href="spotread.html#O">-O</a>
@@ -1105,6 +1287,11 @@ D50
+
+
+
+
+
Do one cal. or measure and exit</span></font><br>
<font size="-1"><span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#H">-H</a><span
@@ -1119,6 +1306,11 @@ D50
+
+
+
+
+
Preset reference to spectrum<br>
&nbsp;</span></font><font size="-1"><span style="font-family:
monospace;"><a href="#X1">-X file.ccmx</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1157,6 +1349,11 @@ D50
+
+
+
+
+
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;
@@ -1200,6 +1397,11 @@ Samples
+
+
+
+
+
for calibration</span><br>
<font size="-1"><span style="font-family: monospace;">&nbsp;</span><a
style=" font-family: monospace;" href="#Yrn">-<font size="-1">Y</font>
@@ -1232,6 +1434,11 @@ Samples
+
+
+
+
+
&nbsp;&nbsp;&nbsp;&nbsp; Override refresh, non-refresh display
mode</span></font><br>
<tt>&nbsp;<a href="#YR">-Y R:<i>rate</i></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1254,6 +1461,11 @@ Samples
+
+
+
+
+
Override measured refresh rate with rate Hz</tt><br>
<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
@@ -1268,6 +1480,11 @@ Samples
+
+
+
+
+
Save white tile ref. spectrum to file</tt><br>
<tt>&nbsp;<a href="#YL">-Y L</a> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; Test for i1Pro Lamp
@@ -1317,6 +1534,11 @@ none,
+
+
+
+
+
h = HW, x = Xon/Xoff</span></font><br>
<small><span style="font-family: monospace;">&nbsp;</span><a style="
font-family: monospace;" href="#D">-D [level]</a><span
@@ -1360,6 +1582,11 @@ none,
+
+
+
+
+
Optional file to save reading results<br style="font-family:
monospace;">
</span></font><small><span style="font-family: monospace;"></span><span
@@ -1386,10 +1613,10 @@ none,
The Graph plots light wavelength on the X axis, and either absolute
or relative level on the Y axis. <br>
<br>
- <table border="1" cellpadding="0" cellspacing="0" width="200"
- height="153">
+ <table width="200" height="153" cellspacing="0" cellpadding="0"
+ border="1">
</table>
- <table border="1" cellpadding="0" cellspacing="0">
+ <table cellspacing="0" cellpadding="0" border="1">
<tbody>
<tr>
<th valign="top">&nbsp; Measurement Mode &nbsp; <br>
@@ -1427,6 +1654,11 @@ none,
+
+
+
+
+
&nbsp;&nbsp; <br>
</td>
</tr>
@@ -1522,6 +1754,11 @@ none,
Rendering Index (<a href="#T">see <span style="font-weight: bold;">-T</span></a>).
+
+
+
+
+
If the instrument does not support ambient mode, emissive mode will
be used instead. An adaptive integration time will be used in
devices that support it. <br>
@@ -1565,6 +1802,11 @@ none,
reflectance instrument illuminant when FWA compensation is used
during <u>measurement</u>, overriding the default <b>D50</b> or
CIE computation illuminant used for FWA (see <b>-i</b> below<b>). </b>If
+
+
+
+
+
intending to use standard <b>M0</b>, <b>M1</b> or <b>M2</b>
conditions, then use just the <b>-I</b> option and not the&nbsp; <b>-i</b>
option. See <a href="colprof.html#f">colprof -f</a> for a fuller
@@ -1593,12 +1835,17 @@ none,
observer. The default.<br>
&nbsp; <b>1964_10</b> selects the standard CIE 1964 10 degree
observer.<br>
+ <b>&nbsp; 2012_2</b> selects the proposed CIE 2012 2 degree observer<br>
+ &nbsp; <b>2012_10</b> selects the proposed CIE 2012 10 degree
+ observer<br>
&nbsp; <b>1955_2</b> selects the Stiles and Birch 1955 2 degree
observer<br>
&nbsp; <b>1978_2 </b>selects the Judd and Voss 1978 2 degree
observer<br>
&nbsp; <b>shaw</b> selects the Shaw and Fairchild 1997 2 degree
observer<br>
+ &nbsp; <i><b>file.cmf</b></i> selects an observer specified by the
+ given <a href="File_Formats.html#.cmf">.cmf</a> file.<br>
<br>
<a name="F"></a>The <b>-F</b> options allows configuring the
instrument to have a particular filter fitted to it. Some
@@ -1638,6 +1885,10 @@ none,
displayed as XYZ and LCh values, rather than the default XYZ and
L*a*b*<br>
<br>
+ <a name="u"></a>The <b>-u</b> option causes the reading to be
+ displayed as XYZ and L*u*v* values, rather than the default XYZ and
+ L*a*b*<br>
+ <br>
<a name="V"></a>The <b>-V</b> enables average and standard
deviation statistics on the XYZ and L*a*b* values. This start and is
reset whenever a reference is taken ('r' key). A side effect of this
@@ -1657,9 +1908,12 @@ none,
also shown for each. The Color Rendering Index (CRI Ra) including
the R9 value, plus the TLCI (Qa) is also computed if the instrument
is capable of spectral measurement. If the notation <span
- style="font-weight: bold;">(Invalid)</span> is displayed after the
- CRI or TLCI, then this means that the the spectrum white point is to
- far from the black body and Daylight locus to be meaningful.<br>
+ style="font-weight: bold;">(Caution)</span> is displayed after the
+ CRI or TLCI, then this means that the the spectrum white point is
+ beyond the standard tolerance distance from the black body or
+ Daylight illuminant locus. This may make the CRI or TLCI measurement
+ less accurate, and indicates that the illuminant may be a lower
+ quality source of light.<br>
<br>
<a name="N"></a> <span style="font-weight: bold;">-N</span> Any
instrument that requires regular calibration will ask for
@@ -1706,7 +1960,9 @@ none,
information (ie. the X-Rite <span style="font-weight: bold;">i1d3</span>,
or the DataColor <span style="font-weight: bold;">Spyder4 &amp;
Spyder5</span>).This can improve a colorimeters accuracy for a
- particular type of display.<br>
+ particular type of display. A list of contributed <span
+ style="font-weight: bold;">ccss</span> files is <a
+ href="ccsss.html">here</a>.<br>
<br>
<a name="Yrn"></a> The -<span style="font-weight: bold;">Y r </span>and
@@ -1736,6 +1992,11 @@ none,
+
+
+
+
+
<b>-Y n</b> options overrides the refresh display mode set by the <a
href="#y">-y display type selection</a>, with <b>-Y</b><span
style="font-weight: bold;"> r</span> forcing refresh display mode,