diff options
Diffstat (limited to 'doc/spec2cie.html')
| -rw-r--r-- | doc/spec2cie.html | 133 |
1 files changed, 68 insertions, 65 deletions
diff --git a/doc/spec2cie.html b/doc/spec2cie.html index c928f9a..d25b0a0 100644 --- a/doc/spec2cie.html +++ b/doc/spec2cie.html @@ -3,38 +3,43 @@ <head> <title>fakeread</title> <meta http-equiv="content-type" content="text/html; - charset=ISO-8859-1"> + charset=windows-1252"> <meta name="author" content="Graeme Gill"> </head> <body> <h2><b>spectro/</b><span style="text-decoration: underline;"></span>spec2cie</h2> <h3>Summary</h3> - Convert spectral <a href="File_Formats.html#.ti3">.ti3</a> - readings into CIE XYZ or L*a*b* readings. FWA compensation may be - applied.<br> + Convert reflective spectral <a href="File_Formats.html#.ti3">.ti3</a> + readings into CIE XYZ and D50 L*a*b* readings. Apply FWA, plot + spectrums.<br> <h3>Usage</h3> <tt><small>spec2cie [options] <span style="font-style: italic;">input.ti3 + + output.ti3<br> </span></small></tt><tt><small>-v Verbose mode</small></tt><br> - <tt><small><small> <a - href="spec2cie.html#I">-I <i>illum</i></a> - Override - actual instrument illuminant - in .ti3 file:<br> + <tt><small><small> <a href="spec2cie.html#I">-I <i>illum</i></a> + + + Override actual instrument illuminant in .ti3 + file:<br> - - A, C, D50, D50M2, D65, F5, - F8, F10 or file.sp<br> + A, C, D50, D50M2, D65, F5, F8, F10 or + file.sp<br> - (only - used in conjunction with <span style="font-weight: bold;">-f</span>)<br> + + + (only used in conjunction with <span style="font-weight: + bold;">-f</span>)<br> </small></small></tt><tt><small><small> <a - href="colprof.html#f">-f [<i>illum</i>]</a> - Use Fluorescent Whitening Agent compensation - [simulated inst. illum.:<br> + href="colprof.html#f">-f [<i>illum</i>]</a> Use + Fluorescent Whitening Agent compensation [simulated inst. + illum.:<br> + + M0, M1, M2, A, C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp]<br> </small></small></tt><tt><small><small><small> <a @@ -42,64 +47,66 @@ Choose illuminant for computation of CIE XYZ from spectral data & FWA:<br> - - - A, C, D50 (def.), D50M2, D65, F5, + A, C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp<br> - </small></small><a href="#o">-o - <i>observ</i></a> - Choose CIE Observer for spectral - data:<br> + </small></small><a href="#o">-o <i>observ</i></a> + + + Choose CIE Observer for spectral data:<br> + + 1931_2 </small></tt><tt><small> (def.)</small></tt><tt><small>, - 1964_10, S&B - 1955_2, shaw, J&V 1978_2<br> + 1964_10, S&B 1955_2, shaw, J&V 1978_2<br> <a href="#p">-n</a> Don't output + + spectral values<br> </small></tt><tt><small> <a href="#p">-p</a> - Plot - each values spectrum</small></tt><tt><br> - </tt><tt> - </tt><tt><small> <span style="font-style: italic;">input.ti3</span> + Plot each values spectrum</small></tt><tt><br> + </tt><tt> </tt><tt><small> <span style="font-style: italic;">input.ti3</span> Measurement + + file<br> <span style="font-style: italic;">output.ti3</span> - Converted - measurement file</small></tt><br> + + + Converted measurement file</small></tt><br> <h3>Comments</h3> - This program takes the spectral data in a .ti3 file, converts them - to - XYZ and Lab and fills the XYZ_[XYZ] and LAB_[LAB] columns in the - output - .ti3 file with the computed XYZ and Lab values. If the columns + 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.<br> <br> + If FWA correction is applied, then the spectra saved will be FWA + corrected, as well as the XYZ and D50 L*a*b* values.<br> + <br> All other columns are copied from the input to the output .ti3 file.<br> <br> + Setting an actual instrument/simulated instrument/CIE illuminant + only has an effect for reflective/transmissive spectra. Emissive + spectra don't have an illuminant, and will simply be converted to + XYZ using the given observer. <br> + <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> - 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> + 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> + 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> <br> A CIE - tungsten - filament lamp 2848K<br> + tungsten filament lamp 2848K<br> D50 CIE daylight 5000K<br> D65 CIE daylight 6500K<br> F5 CIE Fluorescent @@ -107,8 +114,7 @@ Measurement F8 CIE Fluorescent 5000K, CRI 95<br> F10 CIE Fluorescent - 5000K, - CRI 81<br> + 5000K, CRI 81<br> <br> <br> <a name="f"></a> The <b>-f</b> flag enables Fluorescent Whitening @@ -121,6 +127,8 @@ Measurement standard or custom illumination spectrum to be used as the similated instrument illuminant, overriding the default <b>D50</b> or CIE computation illuminant used for FWA (see <b>-i</b> below<b>). </b>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 @@ -129,8 +137,7 @@ Measurement <b>D50</b>, <b>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 a filename is specified instead, it will be assumed - to be an Argyll specific <a - href="File_Formats.html#.sp">.sp</a> + to be an Argyll specific <a href="File_Formats.html#.sp">.sp</a> custom spectrum file. This only works if spectral data is available. Illuminant details are:<br> <br> @@ -181,22 +188,18 @@ Measurement Note that if an observer other than 1931 2 degree is chosen, the resulting ICC profile will not be standard, and cannot be freely interchanged with other profiles that that us the standard 1931 2 - degree - observer. Profiles should only be linked with other profiles that - have - the same illuminant and observer.<br> - <br> + degree observer. Profiles should only be linked with other profiles + that have the same illuminant and observer.<br> <br> <br> <a name="n"></a>The <span style="font-weight: bold;">-n</span> flag - disables the output of the spectral values. If just the XYZ and - L*a*b* - values are needed, this makes for a smaller, easier to read file.<br> + disables the output of the spectral values. If just the XYZ and D50 + L*a*b* values are needed, this makes for a smaller, easier to read + file.<br> <br> <a name="p"></a>The <span style="font-weight: bold;">-p</span> flag causes each spectrum to be plotted. If FWA compensation is used, - then - the before/after compensation spectrums will be shown.<br> + then the before/after compensation spectruma will be shown.<br> <br> <br> <br> |