summaryrefslogtreecommitdiff
path: root/doc/spec2cie.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/spec2cie.html')
-rwxr-xr-x[-rw-r--r--]doc/spec2cie.html149
1 files changed, 111 insertions, 38 deletions
diff --git a/doc/spec2cie.html b/doc/spec2cie.html
index 2780161..d973289 100644..100755
--- a/doc/spec2cie.html
+++ b/doc/spec2cie.html
@@ -11,12 +11,17 @@
<h3>Summary</h3>
Convert spectral <a href="File_Formats.html#.ti3">.ti3</a> or <a
href="File_Formats.html#.sp">.sp</a> readings into CIE XYZ and D50
- L*a*b* readings. Apply FWA, plot spectrums.<br>
+ L*a*b* readings. Apply FWA, plot spectrums. Convert to/from XRGA
+ standard.<br>
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 <span style="font-weight: bold;">DEVICE_CLASS</span>&nbsp;
+
+
+
+
<span style="font-weight: bold;">EMISINPUT</span> (See the <a
href="ti3_format.html">description of the .ti3 format</a>. This
would have to be done manually, as no ArgyllCMS tools generate such
@@ -29,52 +34,71 @@
+
+
+
+
output.[ti3|sp]<br>
&nbsp;</span></small></tt><tt><small>-v
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+ Verbose mode<br>
+ &nbsp;<a href="A">-A NN|AX|AG|XA|XG|GA|GX</a>&nbsp;&nbsp; XRGA
+ conversion (default NN)<br>
+ </small></tt> <tt><small><small>&nbsp;<a href="#I">-I <i>illum</i></a>&nbsp;&nbsp;
+
- Verbose mode</small></tt><br>
- <tt><small><small>&nbsp;<a href="spec2cie.html#I">-I <i>illum</i></a>&nbsp;&nbsp;
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Override actual
- instrument illuminant in .ti3 or .sp file:<br>
+
+
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+ Override actual instrument illuminant in .ti3 or .sp file:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; A, C, D50, D50M2,
- D65, F5, F8, F10 or file.sp<br>
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp; &nbsp; &nbsp;
+ &nbsp;&nbsp; A, C, D50, D50M2, D65, F5, F8, F10 or file.sp<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+ &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; (only used in conjunction
+ with <span style="font-weight: bold;">-f</span>)<br>
+ </small></small></tt><tt><small><small>&nbsp;<a href="#f">-f [<i>illum</i>]</a>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ Use Fluorescent Whitening Agent compensation [simulated inst.
+ illum.:<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- (only used in conjunction with <span style="font-weight:
- bold;">-f</span>)<br>
- </small></small></tt><tt><small><small>&nbsp;<a
- href="colprof.html#f">-f [<i>illum</i>]</a>
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Use Fluorescent Whitening
- Agent compensation [simulated inst. illum.:<br>
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ &nbsp; &nbsp; &nbsp; &nbsp; M0, M1, M2, A, C, D50 (def.),
+ D50M2, D65, F5, F8, F10 or file.sp]<br>
+ </small></small></tt><tt><small><small><small>&nbsp;<a href="#i">-i
+ <i>illum</i></a>&nbsp;&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- M0, M1, M2, A, C, D50 (def.), D50M2, D65, F5, F8, F10 or
- file.sp]<br>
- </small></small></tt><tt><small><small><small>&nbsp;<a
- href="spec2cie.html#i">-i <i>illum</i></a>&nbsp;&nbsp;
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Choose illuminant for
- computation of CIE XYZ from spectral data &amp; FWA:<br>
+
+
+ Choose illuminant for computation of CIE XYZ from spectral
+ data &amp; FWA:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; A, C, D50
- (def.), D50M2, D65, F5, F8, F10 or file.sp<br>
+ &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp; &nbsp; &nbsp;
+ &nbsp; A, C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp<br>
&nbsp;</small></small><a href="#o">-o <i>observ</i></a>&nbsp;
@@ -82,20 +106,28 @@
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Choose CIE Observer for
- spectral data:<br>
+
+
+
+
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+ &nbsp; Choose CIE Observer for spectral data:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-
+&nbsp;&nbsp;&nbsp;&nbsp;
+ &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; 1931_2 </small></tt><tt><small>
+ (def.)</small></tt><tt><small>, 1964_10, </small></tt><tt><small><tt><small>2012_2,
- 1931_2 </small></tt><tt><small> (def.)</small></tt><tt><small>,
- 1964_10, S&amp;B 1955_2, shaw, J&amp;V 1978_2 or file.cmf<br>
- &nbsp;<a href="#p">-n</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ 2012_10, </small></tt>S&amp;B 1955_2, shaw, J&amp;V 1978_2
+ or file.cmf<br>
+ &nbsp;<a href="#p">-n</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Don't
output
@@ -104,15 +136,25 @@ output
+
+
+
+
spectral values<br>
</small></tt><tt><small>&nbsp;<a href="#p">-p</a>
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
Plot each values spectrum</small></tt><tt><br>
</tt><tt> </tt><tt><small>&nbsp;<span style="font-style: italic;">input.[ti3|sp]</span>
- &nbsp;&nbsp; Measurement file<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ Measurement file<br>
&nbsp;<span style="font-style: italic;">output.[ti3</span>|sp]
- &nbsp; Converted measurement file</small></tt><br>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Converted
+ measurement file</small></tt><br>
<h3>Comments</h3>
This program takes the (usually reflective) spectral data in a .ti3
or .sp file, converts them to XYZ and D50 L*a*b* and fills the
@@ -131,12 +173,36 @@ output
spectra don't have an illuminant, and will simply be converted to
XYZ using the given observer. <br>
<br>
+ <a name="A"></a>The <b>-A</b> parameter allows specifying a
+ conversion between the <a href="XRGA.html">XRGA</a> measurement
+ standards:<br>
+ <br>
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; The <b>NN</b> argument
+ disabled any conversion.<br>
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; The <b>AX</b> argument
+ converts from XRGA to XRDI<br>
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; The <b>AG</b> argument
+ converts from XRGA to GMDI<br>
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; The <b>XA</b> argument
+ converts from XRDI to XRGA<br>
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; The <b>XG</b> argument
+ converts from XRDI to GMDI<br>
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; The <b>GA</b> argument
+ converts from GMDI to XRGA<br>
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; The <b>GX</b> argument
+ converts from GMDI to XRDI<br>
+ <br>
+ A warning will be issued if the "from" setting doesn't match that
+ contained in the .ti3 file.<br>
+ <br>
+ (XRGA = Modern X-Rite, XRDI = Historical X-Rite, GMD = Historical
+ GretagMacbeth).<br>
<br>
<a name="I"></a>The <b>-I</b> parameter allows specifying a an
illumination spectrum for the actual instrument illuminant,
overriding that computed from the type of instrument (recorded in
- the .ti3 file). This is rarely used. This parameter is can only be
- used in combination with the <span style="font-weight: bold;">-f</span>
+ the .ti3 file). This is rarely used. This parameter can only be used
+ in combination with the <span style="font-weight: bold;">-f</span>
flag. If a filename is specified instead, it will be assumed to be
an Argyll specific <a href="File_Formats.html#.sp">.sp</a> custom
spectrum file. Illuminant details are:<br>
@@ -169,6 +235,10 @@ output
+
+
+
+
<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
@@ -218,14 +288,17 @@ output
(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>
- <br>
- or a .cmf file can be provided as an argument.<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>
Note that if an observer other than 1931 2 degree is chosen, the
resulting ICC profile will not be standard, and cannot be freely