spotread

From 094535c010320967639e8e86f974d878e80baa72 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Fri, 1 May 2015 16:13:57 +0200 Subject: Imported Upstream version 1.7.0 --- doc/spotread.html | 436 ++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 406 insertions(+), 30 deletions(-) (limited to 'doc/spotread.html') diff --git a/doc/spotread.html b/doc/spotread.html index aaac0a1..f3964f5 100644 --- a/doc/spotread.html +++ b/doc/spotread.html @@ -3,14 +3,18 @@ spotread + charset=windows-1252">

spectro/spotread

Summary

Use an instrument to read a single color value. This can be a useful - diagnostic aid. + diagnostic aid.
+
+ [ A commercial tool that does much of what spotread does and more, + is the ArgyllPRO ColorMeter. + ]

Usage Summary

spotread [-options] [logfile]
@@ -29,6 +33,14 @@ + + + + + + + + @@ -53,6 +65,14 @@ + + + + + + + + @@ -82,6 +102,14 @@ + + + + + + + + @@ -105,6 +133,14 @@ + + + + + + + + @@ -128,6 +164,14 @@ + + + + + + + + @@ -150,6 +194,14 @@ + + + + + + + + @@ -160,6 +212,14 @@ style=" font-family: monospace;" href="#ew">-ew                   + + + + + + + + Use display white point relative chromatically adjusted mode
-p
-i illum      Choose illuminant for computation of - CIE XYZ from spectral data & FWA:

            @@ -343,6 +459,14 @@ D50 + + + + + + + + @@ -369,6 +493,14 @@ D50 + + + + + + + + @@ -394,6 +526,14 @@ D50 + + + + + + + + @@ -414,6 +554,14 @@ D50 + + + + + + + + @@ -434,6 +582,14 @@ D50 + + + + + + + + @@ -454,6 +610,14 @@ D50 + + + + + + + + @@ -474,6 +638,14 @@ D50 + + + + + + + + @@ -497,6 +669,14 @@ D50 + + + + + + + + @@ -518,6 +698,14 @@ D50 + + + + + + + + @@ -539,6 +727,14 @@ D50 + + + + + + + + @@ -560,6 +756,14 @@ D50 + + + + + + + + @@ -580,12 +784,49 @@ D50 + + + + + + + + Disable initial calibration of instrument if possible
+ -O +                    + + + + + + + + + + + + + + + + + + + + + + + + + + Do one cal. or measure and exit
-H @@ -606,6 +847,14 @@ D50 + + + + + + + + @@ -631,6 +880,14 @@ Samples + + + + + + + + @@ -650,10 +907,26 @@ Samples + + + + + + + +      Override refresh, non-refresh display mode
-Y R:rate             + + + + + + + + Override measured refresh rate with rate Hz
-Y A
+ The Graph plots light wavelength on the X axis, and either absolute + or relative level on the Y axis.
+
+ +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Measurement Mode +	Y Units +
Emission +	mW/(m².sr.nm)
Ambient +	mW/(m².nm) +
Emission Flash +	mW/(m².sr.nm.s) + + + + + + +
Ambient Flash +	mW/(m².nm.s) +
Reflective +	%/nm +
Transmissive +	%/nm +

+
The instrument is assumed to communicate through a USB or serial communication port, and the port can be selected with the -c option, if the instrument is not connected to the @@ -833,29 +1180,33 @@ none, and how this works, see Operation of particular instruments. 3) Any installed CCSS files (if applicable), or CCMX files. These files are typically created - using ccxxmake, - and installed using oeminst. The - default and Base Calibration types will be indicated in the usage.
+ using ccxxmake, and installed using oeminst. The default and Base Calibration + types will be indicated in the usage.

The -I parameter allows specifying a - standard or custom illumination spectrum to be used as the similated - instrument illuminant when FWA compensation is used during - measurement, overriding the default D50 or CIE computation - illuminant used for FWA (see -i below). See colprof -f for a fuller explanation.
+ standard or custom illumination spectrum to be used as the simulated + 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.

The -i parameter allows specifying a - standard or custom illumination spectrum applied to reflective or transmissive - spectral data 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 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.
+ spectral data 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.

The -Q flag allows specifying a tristimulus observer, and is used to compute PCS (Profile Connection Space) @@ -930,6 +1281,11 @@ none, computer. It is advisable to only use this option on the second and subsequent measurements in a single session.

+ -O Do a calibration or a single measurement + and exit. To take a measurement with an instrument that always does + a calibration first, calibrate it and then use -O with -N. The -O + option is intended to simplify scripted use of spotread.
+
The -H option turns on high resolution spectral mode, if the instrument supports it. See Operation of particular @@ -966,6 +1322,14 @@ a + + + + + + + + @@ -982,6 +1346,14 @@ a + + + + + + + + -Y n options overrides the refresh display mode set by the -y display type selection, with -Y r forcing refresh display mode, @@ -997,12 +1369,12 @@ a
The -Y A option uses a non-adaptive integration time emission measurement - mode, if the instrument supports it, such as the Eye-One Pro or - ColorMunki. By default an adaptive integration time measurement mode - will be used for emission measurements, but some instruments support - 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.
+ mode, if the instrument supports it, such as the Eye-One Pro, + ColorMunki, i1d3 or K10. By default an adaptive integration time + measurement mode will be used for emission measurements, but some + instruments support a fixed integration time mode that can be used + with display devices. This may give faster measurement times, but + may also give less accurate low level readings.

The -W n|h|x parameter overrides the default serial communications flow control @@ -1041,9 +1413,13 @@ a the range 0 .. 100 for reflective or transmissive readings, and absolute cd/m^2 for display, emissive and ambient readings.

- The L*a*b* values are computed relative to a D50 100 scale white - point. (Note that using display white relative mode makes the L*a*b - relative to the display white point.)
+ By default the L*a*b* values are computed relative to a fixed D50 + 100 scale white point, so values for emissive sources are not + particularly useful.
+ Using the display white relative mode uses a Bradford chromatic + transform to transform from the measured white to a D50 white (the + same as ArgyllCMS ICC profile deals a display white), and then + computes the D50 L*a*b from that.

If Fluorescent Whiter Additive (FWA) compensated readings are to be made, then this needs to be enabled with the correct command line -- cgit v1.2.3