diff options
Diffstat (limited to 'doc/spotread.html')
| -rw-r--r-- | doc/spotread.html | 468 |
1 files changed, 435 insertions, 33 deletions
diff --git a/doc/spotread.html b/doc/spotread.html index 3fe030f..36ee999 100644 --- a/doc/spotread.html +++ b/doc/spotread.html @@ -47,6 +47,15 @@ + + + + + + + + + Verbose mode</span><br style="font-family: monospace;"> <span style="font-family: monospace;"></span><span @@ -80,6 +89,15 @@ + + + + + + + + + Print spectrum for each reading.</span></small><br style="font-family: monospace;"> <small><span style="font-family: monospace;"></span><span @@ -118,6 +136,15 @@ + + + + + + + + + Set COM port, 1..4 (default 1)</span><span style="font-family: monospace;"></span><span style="font-family: monospace;"><br style="font-family: monospace;"> @@ -150,6 +177,15 @@ + + + + + + + + + Use transmission measurement mode</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a style=" @@ -182,6 +218,15 @@ + + + + + + + + + Use emissive measurement mode (absolute results)<br> </span></small><small><span style="font-family: monospace;"> </span><a style=" font-family: monospace;" href="#eb">-eb</a><span @@ -213,6 +258,15 @@ + + + + + + + + + Use display white brightness relative measurement mode<br> </span></small><small><span style="font-family: monospace;"> </span><a style=" font-family: monospace;" href="#ew">-ew</a><span @@ -227,6 +281,15 @@ + + + + + + + + + Use display white point relative chromatically adjusted mode<br> </span></small><small><span style="font-family: monospace;"> </span><a style=" font-family: monospace;" href="#p">-p</a><span @@ -258,6 +321,15 @@ + + + + + + + + + Use telephoto measurement mode (absolute results)<br> </span></small><small><span style="font-family: monospace;"> </span><a style=" font-family: monospace;" href="#pb">-pb</a><span @@ -289,6 +361,15 @@ + + + + + + + + + Use </span></small><small><span style="font-family: monospace;">projector</span></small><small><span style="font-family: monospace;"> white brightness relative measurement mode<br> @@ -322,6 +403,15 @@ + + + + + + + + + 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 @@ -356,6 +446,15 @@ + + + + + + + + + Use ambient measurement mode (absolute results)<br> <a href="#f">-f</a> @@ -384,6 +483,15 @@ + + + + + + + + + Use ambient flash measurement mode (absolute results)<br> </span></small><font size="-1"><span style="font-family: monospace;"> <a href="#y">-y X</a> @@ -414,6 +522,15 @@ + + + + + + + + + Display type - instrument specific list to choose from.</span></font><br> <small><span style="font-family: monospace;"> </span><a style="font-family: monospace;" href="spotread.html#I">-I illum</a><span @@ -442,6 +559,15 @@ 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 @@ -487,6 +613,15 @@ D50 + + + + + + + + + D50M2, D65, F5, F8, F10 or file.sp</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a style=" @@ -522,6 +657,15 @@ D50 + + + + + + + + + </span></small><small><span style="font-family: monospace;">1931_2 </span></small><small><span style="font-family: monospace;"> (def.)</span></small><small><span @@ -556,6 +700,15 @@ D50 + + + + + + + + + Set filter configuration:<br> n @@ -585,6 +738,15 @@ D50 + + + + + + + + + None<br> p @@ -614,6 +776,15 @@ D50 + + + + + + + + + Polarising filter<br> 6 @@ -643,6 +814,15 @@ D50 + + + + + + + + + D65<br> u @@ -672,9 +852,27 @@ D50 + + + + + + + + + U.V. Cut<br> <a href="#E">-E extrafilterfile</a> Apply extra filter compensation file<br> + <a href="#A">-A N|A|X|G</a> + + + + + + + + XRGA conversion (default N)<br> </span></font><font size="-1"><span style="font-family: monospace;"> <a href="#x">-x</a> @@ -704,6 +902,15 @@ D50 + + + + + + + + + Display Yxy instead of Lab<br> </span></font><font size="-1"><span style="font-family: monospace;"> <a href="#h">-h</a> @@ -734,6 +941,15 @@ D50 + + + + + + + + + Display LCh instead of Lab</span></font><br> <font size="-1"><span style="font-family: monospace;"> <a href="#V">-V</a> @@ -764,6 +980,15 @@ D50 + + + + + + + + + Show running average and std. devation from ref.</span></font><br> <font size="-1"><span style="font-family: monospace;"> <a href="#T">-T</a> @@ -794,6 +1019,15 @@ D50 + + + + + + + + + Display correlated color temperatures, CRI and TLCI<br> </span></font><font size="-1"><span style="font-family: monospace;"> <a href="#N">-N</a> @@ -823,6 +1057,15 @@ D50 + + + + + + + + + Disable initial calibration of instrument if possible</span></font><br> <font size="-1"><span style="font-family: monospace;"> <a href="spotread.html#O">-O</a> @@ -853,6 +1096,15 @@ D50 + + + + + + + + + Do one cal. or measure and exit</span></font><br> <font size="-1"><span style="font-family: monospace;"> </span><a style="font-family: monospace;" href="#H">-H</a><span @@ -860,6 +1112,14 @@ D50 Use high resolution spectrum mode (if available)<br> + <a href="#R">-R fname.sp</a> + + + + + + + Preset reference to spectrum<br> </span></font><font size="-1"><span style="font-family: monospace;"><a href="#X1">-X file.ccmx</a> @@ -888,6 +1148,15 @@ D50 + + + + + + + + + Apply Colorimeter Correction Matrix</span></font><br> <span style="font-family: monospace;"> <a href="#X2">-X file.ccss</a> @@ -922,6 +1191,15 @@ Samples + + + + + + + + + for calibration</span><br> <font size="-1"><span style="font-family: monospace;"> </span><a style=" font-family: monospace;" href="#Yrn">-<font size="-1">Y</font> @@ -945,6 +1223,15 @@ Samples + + + + + + + + + Override refresh, non-refresh display mode</span></font><br> <tt> <a href="#YR">-Y R:<i>rate</i></a> @@ -958,6 +1245,15 @@ Samples + + + + + + + + + Override measured refresh rate with rate Hz</tt><br> <font size="-1"><span style="font-family: monospace;"> </span><a style=" font-family: monospace;" href="#YA">-<font size="-1">Y </font>A</a><span @@ -965,6 +1261,17 @@ Samples Use non-adaptive integration time mode (if available).</span></font><br> + <tt> <a href="#YW">-Y W:fname.sp</a> + + + + + + + Save white tile ref. spectrum to file</tt><br> + <tt> <a href="#YL">-Y L</a> + Test for i1Pro Lamp + Drift, and remediate it</tt><br> <font size="-1"><span style="font-family: monospace;"> <a href="#W">-W n|h|x</a> Override @@ -1001,6 +1308,15 @@ none, + + + + + + + + + h = HW, x = Xon/Xoff</span></font><br> <small><span style="font-family: monospace;"> </span><a style=" font-family: monospace;" href="#D">-D [level]</a><span @@ -1035,6 +1351,15 @@ none, + + + + + + + + + Optional file to save reading results<br style="font-family: monospace;"> </span></font><small><span style="font-family: monospace;"></span><span @@ -1061,10 +1386,10 @@ none, The Graph plots light wavelength on the X axis, and either absolute or relative level on the Y axis. <br> <br> - <table cellpadding="0" cellspacing="0" border="1" height="153" - width="200"> + <table border="1" cellpadding="0" cellspacing="0" width="200" + height="153"> </table> - <table cellpadding="0" cellspacing="0" border="1"> + <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <th valign="top"> Measurement Mode <br> @@ -1073,20 +1398,29 @@ none, </th> </tr> <tr> - <td align="center" valign="top">Emission<br> + <td valign="top" align="center">Emission<br> </td> - <td align="center" valign="top">mW/(m<sup>2</sup>.sr.nm)</td> + <td valign="top" align="center">mW/(m<sup>2</sup>.sr.nm)</td> </tr> <tr> - <td align="center" valign="top">Ambient<br> + <td valign="top" align="center">Ambient<br> </td> - <td align="center" valign="top">mW/(m<sup>2</sup>.nm)<br> + <td valign="top" align="center">mW/(m<sup>2</sup>.nm)<br> </td> </tr> <tr> - <td align="center" valign="top">Emission Flash<br> + <td valign="top" align="center">Emission Flash<br> </td> - <td align="center" valign="top"> mW/(m<sup>2</sup>.sr.nm.s) + <td valign="top" align="center"> mW/(m<sup>2</sup>.sr.nm.s) + + + + + + + + + @@ -1097,21 +1431,21 @@ none, </td> </tr> <tr> - <td align="center" valign="top">Ambient Flash<br> + <td valign="top" align="center">Ambient Flash<br> </td> - <td align="center" valign="top">mW/(m<sup>2</sup>.nm.s)<br> + <td valign="top" align="center">mW/(m<sup>2</sup>.nm.s)<br> </td> </tr> <tr> - <td align="center" valign="top">Reflective<br> + <td valign="top" align="center">Reflective<br> </td> - <td align="center" valign="top">%/nm<br> + <td valign="top" align="center">%/nm<br> </td> </tr> <tr> - <td align="center" valign="top">Transmissive<br> + <td valign="top" align="center">Transmissive<br> </td> - <td align="center" valign="top">%/nm<br> + <td valign="top" align="center">%/nm<br> </td> </tr> </tbody> @@ -1185,11 +1519,19 @@ none, allows measuring in ambient illumination mode using instruments that support this mode (i.e. Eye-One Display 2). Values returned are absolute, and include the various color temperatures and Color - Rendering Index (see <span style="font-weight: bold;">-T</span>). + 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> <br> + For an instrument that supports it (i.e. the Emulated transmission + measurement mode of the JETI 1211), then using <b>-a</b> after the + <b>-t</b> switch will select the alternate 90/diffuse transmission + geometry (i.e. using the ambient adapter for transmission + measurement).<br> + <br> <a name="f"></a>The <span style="font-weight: bold;">-f</span> flag allows measuring a flash with those instruments that support scanning emissive measurements. The instrument needs to be triggered @@ -1223,13 +1565,10 @@ 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 - - - using <b>M0</b>, <b>M1</b> or <b>M2</b>, then the <b>-i</b> - option is <b>not</b> normally used. See <a href="colprof.html#f">colprof - - - -f</a> for a fuller explanation. <br> + 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 <b>-i</b> + option. See <a href="colprof.html#f">colprof -f</a> for a fuller + explanation. <br> <br> <a name="i"></a>The <b>-i</b> parameter allows specifying a standard or custom reflectance illumination spectrum applied to <span @@ -1237,12 +1576,13 @@ none, spectral data to <u>compute</u> CIE tristimulus values. <b>A</b>, <b>D50</b>, <b>D50M2, D65</b>, <b>F5</b>, <b>F8</b>, <b>F10</b> are a selection of standard illuminant spectrums, with <b>D50</b> - being the default. If using <b>-I M0</b>, <b>M1</b> or <b>M2</b>, - then this <b>-i</b> option is <b>not</b> normally used. If a - filename is specified instead, it will be assumed to be an Argyll - specific <a href="File_Formats.html#.sp">.sp</a> spectrum file. If - FWA compensation is used during measurement, this illuminant will be - used by default as the simulated instrument illuminant.<br> + being the default. If using <b>-I</b> to obtain standard <b>M0</b>, + <b>M1</b> or <b>M2</b> conditions, then this <b>-i</b> option is <b>not</b> + normally used. If a filename is specified instead, it will be + assumed to be an Argyll specific <a href="File_Formats.html#.sp">.sp</a> + spectrum file. If FWA compensation is used during measurement, this + illuminant will be used by default as the simulated instrument + illuminant.<br> <br> <a name="Q"></a> The <b>-Q</b> flag allows specifying a tristimulus observer, and is used to compute PCS (Profile Connection Space) @@ -1275,6 +1615,21 @@ none, style="font-weight: bold;">Note</span> that this is currently only supported by the Spectrolino driver.]<br> <br> + <a name="A"></a>The <b>-A</b> options allows overriding the default + or environment variable set <a href="XRGA.html">XRGA</a> + conversion:<br> + <br> + <b>-A N|A|X|G</b><br> + <br> + The <b>N</b> argument sets + the calibration to Native (default).<br> + The <b>A</b> argument sets + the calibration to XRGA.<br> + The <b>X</b> argument sets + the calibration to XRDI.<br> + The <b>G</b> argument sets + the calibration to GMDI.<br> + <br> <a name="x"></a>The <b>-x</b> option causes the reading to be displayed as XYZ and Yxy values, rather than the default XYZ and L*a*b*<br> @@ -1327,6 +1682,13 @@ none, supports it. See <a href="instruments.html">Operation of particular instruments</a> for more details.<br> <br> + <a name="R"></a><font size="-1">The <b>-R <i>fname.sp</i></b> + option allows specifying a reference spectrum</font> to preset the + reference values used to calculate delta E etc. This can be useful + in checking against a previously saved value (<b>'s' </b>command), + or in checking the instruments consistency against it's <a + href="#YW">reflective white reference spectrum</a>.<br> + <br> <a name="X1"></a> The -<span style="font-weight: bold;">X <span style="font-style: italic;">file.ccmx</span></span> option reads a <a href="File_Formats.html#.ccmx">Colorimeter Correction Matrix</a> @@ -1343,10 +1705,8 @@ none, colorimeters that rely on sensor spectral sensitivity calibration information (ie. the X-Rite <span style="font-weight: bold;">i1d3</span>, or the DataColor <span style="font-weight: bold;">Spyder4 & - Spyder5</span>).This - can - improve - a colorimeters accuracy for a particular type of display.<br> + Spyder5</span>).This can improve a colorimeters accuracy for a + particular type of display.<br> <br> <a name="Yrn"></a> The -<span style="font-weight: bold;">Y r </span>and @@ -1367,6 +1727,15 @@ 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, @@ -1397,6 +1766,39 @@ none, sets Xon/Xoff handshaking. This commend may be useful in workaround serial communications issues with some systems and cables. <br> <br> + <a name="YW"></a>The <b>-Y W:<i>fname.s</i>p</b> option allows + saving an instruments reference white tile reflectance spectrum to a + file. Reflective instruments use a white reference tile to calibrate + against, and typically the spectral reflectance of the white tile is + recorded inside the instrument to calibrate to. The saved spectrum + can be used to compare against the measurements of a reference grade + measurement of the white tile to check for tile deterioration, or + can be used as a reference for checking on instrument calibration + accuracy or consistency (See the <a href="#R">-R option</a>). Not + all instruments support this option (Currently the Spectrolino, + i1Pro, i1Pro2 and ColorMunki spectrometer.)<br> + <br> + <a name="YL"></a> The <b>-Y l|L</b> option is a special function + for X-Rite <a href="instruments.html#i1p2">i1Pro</a> instruments. + These instruments use an incandescent lamp as a light source for + reflectance measurement, and some instruments after some patterns of + use, can suffer from Lamp output thermal drift, due to the build up + of filament tungsten on the bulb inner surface. This function first + measures the Lamp drift, and then if the <b>-Y L</b> version is + used and the drift is greater than normal (0.06 - 0.1 Delta E), it + will attempt to remediate the problem by turning the lamp on for + some seconds so that it reaches normal operating temperature and is + able to re-circulate the tungsten back onto the filament properly. + It will then wait for the lamp to cool, and re-measure the drift. + These operations can take a few minutes, and it is advisable to let + the instrument cool off further after this operation, for 2 - 5 + minutes, to allow it to return to normal operation conditions.<br> + <br> + The remediation function should be used infrequently or if the + repeatability of the instrument seems to be poorer than usual, as + frequent use may consume lamp life unnecessarily. If the lamp is + nearing its end of life, this function may not be effecive.<br> + <br> <a name="D"></a>The <b>-D</b> flag causes communications and other instrument diagnostics to be printed to stdout. A level can be set between 1 .. 9, that may give progressively more verbose |