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/spec2cie.html | 118 ++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 74 insertions(+), 44 deletions(-) (limited to 'doc/spec2cie.html') diff --git a/doc/spec2cie.html b/doc/spec2cie.html index 7911948..2780161 100644 --- a/doc/spec2cie.html +++ b/doc/spec2cie.html @@ -1,7 +1,7 @@ - fakeread + spec2cie @@ -9,38 +9,60 @@

spectro/spec2cie

Summary

- Convert reflective spectral .ti3 - readings into CIE XYZ and D50 L*a*b* readings. Apply FWA, plot - spectrums.
+ Convert spectral .ti3 or .sp readings into CIE XYZ and D50 + L*a*b* readings. Apply FWA, plot spectrums.
+ This is assumed to be for a reflective media by default - i.e. that + the input .ti3 or .sp file values are spectral reflectances, unless + the input is marked as DEVICE_CLASS  + + + EMISINPUT (See the description of the .ti3 format. This + would have to be done manually, as no ArgyllCMS tools generate such + data.)

Usage

- spec2cie [options] input.ti3 + spec2cie [options] input.[ti3|sp] - output.ti3
+ + + + output.[ti3|sp]
 -v -            +                + Verbose mode
 -I illum   -    Override actual instrument illuminant in .ti3 - file:
+ + + +        Override actual + instrument illuminant in .ti3 or .sp file:
           -      A, C, D50, D50M2, D65, F5, F8, F10 or - file.sp
-                 +          A, C, D50, D50M2, + D65, F5, F8, F10 or file.sp
+                     + + + (only used in conjunction with -f)
 -f [illum]    Use - Fluorescent Whitening Agent compensation [simulated inst. - illum.:
-                 + href="colprof.html#f">-f [illum] +        Use Fluorescent Whitening + Agent compensation [simulated inst. illum.:
+                     + + + @@ -48,56 +70,61 @@ file.sp]
 -i illum   -    Choose illuminant for computation of CIE XYZ - from spectral data & FWA:
+        Choose illuminant for + computation of CIE XYZ from spectral data & FWA:
           -       A, C, D50 (def.), D50M2, D65, F5, - F8, F10 or file.sp
+          A, C, D50 + (def.), D50M2, D65, F5, F8, F10 or file.sp
 -o observ  -    Choose CIE Observer for spectral data:
+ + + +        Choose CIE Observer for + spectral data:
              -   +      + + + 1931_2 (def.), 1964_10, S&B 1955_2, shaw, J&V 1978_2 or file.cmf
-  -n             +  -n                Don't output - spectral values
-  -p -             - Plot each values spectrum
-  input.ti3      -Measurement - - file
-  output.ti3     - + spectral values
+  -p +                - Converted measurement file
+ Plot each values spectrum
+  input.[ti3|sp] +    Measurement file
+  output.[ti3|sp] +   Converted measurement file

Comments

This program takes the (usually reflective) spectral data in a .ti3 - file, converts them to XYZ and D50 L*a*b* and fills the XYZ_[XYZ] - and LAB_[LAB] columns in the output .ti3 file. If the columns - XYZ_[XYZ] and/or LAB_[LAB] are missing in the input file, they are - added to the output file.
+ or .sp file, converts them to XYZ and D50 L*a*b* and fills the + XYZ_[XYZ] and LAB_[LAB] columns in the output .ti3 or .sp file. If + the columns XYZ_[XYZ] and/or LAB_[LAB] are missing in the input + file, they are added to the output file.

If FWA correction is applied, then the spectra saved will be FWA corrected, as well as the XYZ and D50 L*a*b* values.

- All other columns are copied from the input to the output .ti3 file.
+ All other columns are copied from the input to the output .ti3 or + .sp file.

Setting an actual instrument/simulated instrument/CIE illuminant only has an effect for reflective/transmissive spectra. Emissive @@ -139,15 +166,18 @@ Measurement + + + colprof -f for a fuller explanation.

The -i parameter allows specifying a standard or custom illumination spectrum, applied to spectral .ti3 - data to compute PCS (Profile Connection Space) tristimulus values. A, - D50, 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 + pr .sp data to compute PCS (Profile Connection Space) tristimulus + values. A, D50, 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 custom spectrum file. This only works if spectral data is available. Illuminant details are:

-- cgit v1.2.3