diff options
Diffstat (limited to 'doc/mpplu.html')
-rwxr-xr-x[-rw-r--r--] | doc/mpplu.html | 382 |
1 files changed, 203 insertions, 179 deletions
diff --git a/doc/mpplu.html b/doc/mpplu.html index 8d4e755..68f985b 100644..100755 --- a/doc/mpplu.html +++ b/doc/mpplu.html @@ -1,182 +1,206 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> -<head> - <title>mpplu</title> - <meta http-equiv="content-type" - content="text/html; charset=ISO-8859-1"> - <meta name="author" content="Graeme Gill"> -</head> -<body> -<h2><b>xicc/mpplu</b></h2> -<h3>Summary</h3> -Lookup individual color values though an <a - href="File_Formats.html#MPP">MPP</a> profile. Also -create MPP gamut files or <a href="File_Formats.html#X3DOM">X3DOM</a> -views.<br> -<h3>Usage</h3> -<small><span style="font-family: monospace;">mpplu [-v level] [-f func] -[-i intent] [-o order] profile.mpp</span><br - style="font-family: monospace;"> -<span style="font-family: monospace;">-v -Verbose</span><br style="font-family: monospace;"> -<span style="font-family: monospace;">-f </span><i - style="font-family: monospace;">function</i><span - style="font-family: monospace;"> f = forward, b = -backwards</span><br style="font-family: monospace;"> -<span style="font-family: monospace;">-p </span><i - style="font-family: monospace;">oride</i><span - style="font-family: monospace;"> x -= XYZ_PCS, l = -Lab_PCS, y = Yxy, s = spectral,</span><br - style="font-family: monospace;"> -<span style="font-family: monospace;">-l </span><i - style="font-family: monospace;">limit</i><span - style="font-family: monospace;"> override -default -ink limit, 1 - N00%</span><br style="font-family: monospace;"> -<span style="font-family: monospace;">-i </span><i - style="font-family: monospace;">illum</i><span - style="font-family: monospace;"> Choose -illuminant for -print/transparency spectral data:</span><br - style="font-family: monospace;"> -<span style="font-family: monospace;"> - A, C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp</span><br - style="font-family: monospace;"> -<span style="font-family: monospace;">-o </span><i - style="font-family: monospace;">observ</i><span - style="font-family: monospace;"> Choose CIE -Observer for spectral -data:</span><br style="font-family: monospace;"> -<span style="font-family: monospace;"> - </span></small><small><span - style="font-family: monospace;">1931_2 </span></small><small><span - style="font-family: monospace;"> (def.)</span></small><small><span - style="font-family: monospace;">, 1964_10, S&B -1955_2, shaw, J&V 1978_2</span></small><small><span - style="font-family: monospace;"></span><br - style="font-family: monospace;"> -<span style="font-family: monospace;">-u - Use Fluorescent Whitening Agent compensation</span><br - style="font-family: monospace;"> -<span style="font-family: monospace;">-g - Create gamut output</span><br - style="font-family: monospace;"> -<span style="font-family: monospace;">-w - Create gamut X3DOM as well<br> --n -Don't add X3DOM axes<br> --a n Gamut -transparency level<br style="font-family: monospace;"> -</span><span style="font-family: monospace;">-d -n Gamut -surface detail level</span><br style="font-family: monospace;"> -<span style="font-family: monospace;">-t num - Invoke debugging test code -"num" 1..n</span><br style="font-family: monospace;"> -<span style="font-family: monospace;"> - 1 - check partial derivative for device -input</span><br style="font-family: monospace;"> -<span style="font-family: monospace;"> - 2 - create overlap diagnostic X3DOM gamut -surface</span><br style="font-family: monospace;"> -<span style="font-family: monospace;">profile.mpp Profile to be -used</span><br style="font-family: monospace;"> -<br style="font-family: monospace;"> -<span style="font-family: monospace;"> The colors to -be translated should be fed into -standard input,</span><br style="font-family: monospace;"> -<span style="font-family: monospace;"> one input -color per line, white space separated.</span><br - style="font-family: monospace;"> -<span style="font-family: monospace;"> A line -starting with a # will be ignored.</span><br - style="font-family: monospace;"> -<span style="font-family: monospace;"> A line not -starting with a number will terminate the -program.</span></small> -<br> -<h3>Usage Details and Discussion</h3> -This is an analogous tool to <a href="icclu.html"> icclu </a>, but -applying -to <a href="File_Formats.html#MPP">MPP</a> profile, rather than <a - href="File_Formats.html#ICC">ICC</a> profiles. Because MPP profiles -can also contain a spectral description of device behavior, there are -extra options in mpplu to describe how to convert spectral values into -CIE tristimulus values.<br> -Some additional functionality is included in mpplu, analogous to <a - href="iccgamut.html"> iccgamut</a>, allowing gamut files and images to -be generated from MPP profiles.<br> -<br> -The <b>-v</b> flag causes extra information about the profile to be -printed.<br> -<br> -The <b>-f</b> flag is experimental, and should be ignored.<br> -<br> -Normally L*a*b* is displayed, but this can be changed using the the <b>-p</b> -flag and XYZ, Yxy, or spectral values to be be displayed.<br> -<br> -If an illuminant, observer or Fluorescent Whitening Agent compensation -is selected, then the CIE tristimulus values will be computed from the -spectral information in the MPP profile (if present).<br> -<br> -The <b>-l</b> flag overrides any default ink limit (Total Area -Coverage) recorded in the profile. The ink limit has an effect on the -results of a gamut -generated from the profile.<br> -<br> -The <b>-i</b> flag allows specifying a standard or custom illumination -spectrum, applied to reflective spectral profile data to compute CIE -tristimulus -values. <b>A</b>, <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> spectrum file.<br> -<br> -<a name="o"></a> The <b>-o</b> flag allows specifying a tristimulus -observer, and is used to compute PCS (Profile Connection Space) -tristimulus values. The following choices are available:<br> -<b> 1931_2</b> selects the standard CIE 1931 2 degree observer. -The default.<br> - <b>1964_10</b> selects the standard CIE 1964 10 degree observer.<br> - <b>1955_2</b> selects the Stiles and Birch 1955 2 degree -observer<br> - <b>1978_2 </b>selects the Judd and Voss 1978 2 degree observer<br> - <b>shaw</b> selects the Shaw and Fairchild 1997 2 degree -observer<br> -<br> -The <b>-u</b> flag enables Fluorescent Whitening Agent compensation, -which compensates for the effect a different illuminant will have, on -any Fluorescent Whitening Agent present in the reflective media.<br> -<br> -The <b>-g</b> flag causes mpplu to simply generate a gamut surface -description from the profile, creating a <a - href="File_Formats.html#.gam">.gam</a> file with the same base name as -the given profile.<br> -<br> -The <b>-w</b> flag causes the gamut surface to be generated in <a - href="File_Formats.html#X3DOM">X3DOM</a> format -as well as <a href="File_Formats.html#.gam">.gam</a> format.<br> -<br> -<small><span style="font-family: monospace;">The <span - style="font-weight: bold;">-n</span> flag suppresses the X3DOM axes.<br> -<br> -The <span style="font-weight: bold;">-a</span> <span - style="font-weight: bold;">n</span> parameter sets a transparency -level in the X3DOM surface.</span></small><br> -<br> -The <b>-d</b> parameter controls the level of detail displayed in the -gamut surface. The parameter roughly corresponds to a deltaE value, so -smaller values give greater detail. The default value is around 10, and -is a good place to start. Small values may take a lot of time to -generate, and will produce big files.<br> -<br> -The <b>-t</b> parameter invokes special MPP test and diagnostic output.<br> -<br> -<br> -<br> -<br> -</body> + <head> + <title>mpplu</title> + <meta http-equiv="content-type" content="text/html; + charset=windows-1252"> + <meta name="author" content="Graeme Gill"> + </head> + <body> + <h2><b>xicc/mpplu</b></h2> + <h3>Summary</h3> + Lookup individual color values though an <a + href="File_Formats.html#MPP">MPP</a> profile. Also create MPP + gamut files or <a href="File_Formats.html#X3DOM">X3DOM</a> + views.<br> + <h3>Usage</h3> + <small><span style="font-family: monospace;">mpplu [-v level] [-f + func] [-i intent] [-o order] profile.mpp</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;">-v + + Verbose</span><br style="font-family: monospace;"> + <span style="font-family: monospace;">-f </span><i + style="font-family: monospace;">function</i><span + style="font-family: monospace;"> f = forward, + b = backwards</span><br style="font-family: monospace;"> + <span style="font-family: monospace;">-p </span><i + style="font-family: monospace;">oride</i><span + style="font-family: monospace;"> + + x = XYZ_PCS, l = Lab_PCS, y = Yxy, s = spectral,</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;">-l </span><i + style="font-family: monospace;">limit</i><span + style="font-family: monospace;"> + override default ink limit, 1 - N00%</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;">-i </span><i + style="font-family: monospace;">illum</i><span + style="font-family: monospace;"> + Choose illuminant for print/transparency spectral data:</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + + + A, C, D50 (def.), D50M2, D65, F5, F8, F10 or + file.sp</span><br style="font-family: monospace;"> + <span style="font-family: monospace;">-o </span><i + style="font-family: monospace;">observ</i><span + style="font-family: monospace;"> Choose CIE + Observer for spectral data:</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> + + + </span></small><small><span style="font-family: + monospace;">1931_2 </span></small><small><span + style="font-family: monospace;"> (def.)</span></small><small><span + style="font-family: monospace;">, 1964_10, </span></small><small><span + style="font-family: monospace;"><tt><small>2012_2, 2012_10, </small></tt>S&B +1955_2, + + shaw, J&V 1978_2 or file.cmf</span></small><small><br + style="font-family: monospace;"> + <span style="font-family: monospace;">-u + + + Use Fluorescent Whitening Agent compensation</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;">-g + + + Create gamut output</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;">-w + + + Create gamut X3DOM as well<br> + -n +Don't + + add X3DOM axes<br> + -a n + Gamut transparency level<br style="font-family: monospace;"> + </span><span style="font-family: monospace;">-d + n Gamut + surface detail level</span><br style="font-family: monospace;"> + <span style="font-family: monospace;">-t + num Invoke debugging test + code "num" 1..n</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> + + + 1 - check partial derivative for device input</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + + + 2 - create overlap diagnostic X3DOM gamut surface</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;">profile.mpp Profile + to be used</span><br style="font-family: monospace;"> + <br style="font-family: monospace;"> + <span style="font-family: monospace;"> The + colors to be translated should be fed into standard input,</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> one input + color per line, white space separated.</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> A line + starting with a # will be ignored.</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> A line + not starting with a number will terminate the program.</span></small> + <br> + <h3>Usage Details and Discussion</h3> + This is an analogous tool to <a href="icclu.html"> icclu </a>, but + applying to <a href="File_Formats.html#MPP">MPP</a> profile, rather + than <a href="File_Formats.html#ICC">ICC</a> profiles. Because MPP + profiles can also contain a spectral description of device behavior, + there are extra options in mpplu to describe how to convert spectral + values into CIE tristimulus values.<br> + Some additional functionality is included in mpplu, analogous to <a + href="iccgamut.html"> iccgamut</a>, allowing gamut files and + images to be generated from MPP profiles.<br> + <br> + The <b>-v</b> flag causes extra information about the profile to be + printed.<br> + <br> + The <b>-f</b> flag is experimental, and should be ignored.<br> + <br> + Normally L*a*b* is displayed, but this can be changed using the the + <b>-p</b> flag and XYZ, Yxy, or spectral values to be be displayed.<br> + <br> + If an illuminant, observer or Fluorescent Whitening Agent + compensation is selected, then the CIE tristimulus values will be + computed from the spectral information in the MPP profile (if + present).<br> + <br> + The <b>-l</b> flag overrides any default ink limit (Total Area + Coverage) recorded in the profile. The ink limit has an effect on + the results of a gamut generated from the profile.<br> + <br> + The <b>-i</b> flag allows specifying a standard or custom + illumination spectrum, applied to reflective spectral profile data + to compute CIE tristimulus values. <b>A</b>, <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> spectrum file.<br> + <br> + <a name="o"></a> The <b>-o</b> flag allows specifying a tristimulus + observer, and is used to compute PCS (Profile Connection Space) + tristimulus values. The following choices are available:<br> + <b> 1931_2</b> selects the standard CIE 1931 2 degree + observer. The default.<br> + <b>1964_10</b> selects the standard CIE 1964 10 degree + observer.<br> + <b> 2012_2</b> selects the proposed CIE 2012 2 degree observer<br> + <b>2012_10</b> selects the proposed CIE 2012 10 degree + observer<br> + <b>1955_2</b> selects the Stiles and Birch 1955 2 degree + observer<br> + <b>1978_2 </b>selects the Judd and Voss 1978 2 degree + observer<br> + <b>shaw</b> selects the Shaw and Fairchild 1997 2 degree + observer<br> + <i><b>file.cmf</b></i> selects an observer specified by the + given <a href="File_Formats.html#.cmf">.cmf</a> file.<br> + <br> + The <b>-u</b> flag enables Fluorescent Whitening Agent + compensation, which compensates for the effect a different + illuminant will have, on any Fluorescent Whitening Agent present in + the reflective media.<br> + <br> + The <b>-g</b> flag causes mpplu to simply generate a gamut surface + description from the profile, creating a <a + href="File_Formats.html#.gam">.gam</a> file with the same base + name as the given profile.<br> + <br> + The <b>-w</b> flag causes the gamut surface to be generated in <a + href="File_Formats.html#X3DOM">X3DOM</a> format as well as <a + href="File_Formats.html#.gam">.gam</a> format.<br> + <br> + <small><span style="font-family: monospace;">The <span + style="font-weight: bold;">-n</span> flag suppresses the X3DOM + axes.<br> + <br> + The <span style="font-weight: bold;">-a</span> <span + style="font-weight: bold;">n</span> parameter sets a + transparency level in the X3DOM surface.</span></small><br> + <br> + The <b>-d</b> parameter controls the level of detail displayed in + the gamut surface. The parameter roughly corresponds to a deltaE + value, so smaller values give greater detail. The default value is + around 10, and is a good place to start. Small values may take a lot + of time to generate, and will produce big files.<br> + <br> + The <b>-t</b> parameter invokes special MPP test and diagnostic + output.<br> + <br> + <br> + <br> + <br> + </body> </html> |