From 3db384424bd7398ffbb7a355cab8f15f3add009f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Sun, 2 Oct 2016 19:24:58 +0200 Subject: New upstream version 1.9.1+repack --- doc/spotread.html | 468 ++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 435 insertions(+), 33 deletions(-) (limited to 'doc/spotread.html') diff --git a/doc/spotread.html b/doc/spotread.html index 3fe030f..36ee999 100644 --- a/doc/spotread.html +++ b/doc/spotread.html @@ -37,6 +37,15 @@ + + + + + + + + + @@ -70,6 +79,15 @@ + + + + + + + + + @@ -108,6 +126,15 @@ + + + + + + + + + @@ -140,6 +167,15 @@ + + + + + + + + + @@ -172,6 +208,15 @@ + + + + + + + + + @@ -203,6 +248,15 @@ + + + + + + + + + @@ -227,6 +281,15 @@ + + + + + + + + + Use display white point relative chromatically adjusted mode
 -p
 -E extrafilterfile    Apply extra filter compensation file
+  -A N|A|X|G            + + + + + + + + XRGA conversion (default N)
 -x                    @@ -694,6 +892,15 @@ D50 + + + + + + + + + @@ -724,6 +931,15 @@ D50 + + + + + + + + + @@ -754,6 +970,15 @@ D50 + + + + + + + + + @@ -784,6 +1009,15 @@ D50 + + + + + + + + + @@ -813,6 +1047,15 @@ D50 + + + + + + + + + @@ -843,6 +1086,15 @@ D50 + + + + + + + + + @@ -860,6 +1112,14 @@ D50                    Use high resolution spectrum mode (if available)
+  -R fname.sp           + + + + + + + Preset reference to spectrum
 -X file.ccmx          @@ -878,6 +1138,15 @@ D50 + + + + + + + + + @@ -912,6 +1181,15 @@ Samples + + + + + + + + + @@ -937,6 +1215,15 @@ Samples + + + + + + + + + @@ -958,6 +1245,15 @@ Samples + + + + + + + + + Override measured refresh rate with rate Hz
 -Y A
+  -Y W:fname.sp         + + + + + + + Save white tile ref. spectrum to file
+  -Y L       +            Test for i1Pro Lamp + Drift, and remediate it
 -W n|h|x              Override @@ -991,6 +1298,15 @@ none, + + + + + + + + + @@ -1025,6 +1341,15 @@ none, + + + + + + + + + @@ -1061,10 +1386,10 @@ none, The Graph plots light wavelength on the X axis, and either absolute or relative level on the Y axis.

- +
- +
- - + - - - - - - - - - - @@ -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 -T). + Rendering Index (see -T). + + 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.

+ For an instrument that supports it (i.e. the Emulated transmission + measurement mode of the JETI 1211), then using -a after the + -t switch will select the alternate 90/diffuse transmission + geometry (i.e. using the ambient adapter for transmission + measurement).
+
The -f 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 measurement, overriding the default D50 or CIE computation illuminant used for FWA (see -i below). If - - - using M0, M1 or M2, then the -i - option is not normally used. See colprof - - - -f for a fuller explanation.
+ intending to use standard M0, M1 or M2 + conditions, then use just the -I option and not the  -i + option. See colprof -f for a fuller + explanation.

The -i parameter allows specifying a standard or custom reflectance illumination spectrum applied to compute CIE tristimulus values. A, D50, D50M2, D65, F5, F8, F10 are a selection of standard illuminant spectrums, with D50 - being the default. If using -I M0, M1 or M2, - then this -i option is not normally used. If a - filename is specified instead, it will be assumed to be an Argyll - specific .sp spectrum file. If - FWA compensation is used during measurement, this illuminant will be - used by default as the simulated instrument illuminant.
+ being the default. If using -I to obtain standard M0, + M1 or M2 conditions, then this -i option is not + normally used. If a filename is specified instead, it will be + assumed to be an Argyll specific .sp + spectrum file. If FWA compensation is used during measurement, this + illuminant will be used by default as the simulated instrument + illuminant.

The -Q 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 that this is currently only supported by the Spectrolino driver.]

+ The -A options allows overriding the default + or environment variable set XRGA + conversion:
+
+     -A N|A|X|G
+
+         The N argument sets + the calibration to Native (default).
+         The A argument sets + the calibration to XRGA.
+         The X argument sets + the calibration to XRDI.
+         The G argument sets + the calibration to GMDI.
+
The -x option causes the reading to be displayed as XYZ and Yxy values, rather than the default XYZ and L*a*b*
@@ -1327,6 +1682,13 @@ none, supports it. See Operation of particular instruments for more details.

+ The -R fname.sp + option allows specifying a reference spectrum to preset the + reference values used to calculate delta E etc. This can be useful + in checking against a previously saved value ('s' command), + or in checking the instruments consistency against it's reflective white reference spectrum.
+
The -X file.ccmx option reads a Colorimeter Correction Matrix @@ -1343,10 +1705,8 @@ none, colorimeters that rely on sensor spectral sensitivity calibration information (ie. the X-Rite i1d3, or the DataColor Spyder4 & - Spyder5).This - can - improve - a colorimeters accuracy for a particular type of display.
+ Spyder5).This can improve a colorimeters accuracy for a + particular type of display.

The -Y r and @@ -1360,6 +1720,15 @@ none, + + + + + + + + + @@ -1397,6 +1766,39 @@ none, sets Xon/Xoff handshaking. This commend may be useful in workaround serial communications issues with some systems and cables.

+ The -Y W:fname.sp 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 -R option). Not + all instruments support this option (Currently the Spectrolino, + i1Pro, i1Pro2 and ColorMunki spectrometer.)
+
+ The -Y l|L option is a special function + for X-Rite i1Pro 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 -Y L 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.
+
+ 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.
+
The -D 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 -- cgit v1.2.3
  Measurement Mode  
@@ -1073,20 +1398,29 @@ none,
Emission
+ 		Emission
mW/(m2.sr.nm)mW/(m2.sr.nm)
Ambient
+ 		Ambient
mW/(m2.nm)
+ 		mW/(m2.nm)
Emission Flash
+ 		Emission Flash
  mW/(m2.sr.nm.s) +   mW/(m2.sr.nm.s) + + + + + + + + + @@ -1097,21 +1431,21 @@ none,
Ambient Flash
+ 		Ambient Flash
mW/(m2.nm.s)
+ 		mW/(m2.nm.s)
Reflective
+ 		Reflective
%/nm
+ 		%/nm
Transmissive
+ 		Transmissive
%/nm
+ 		%/nm