diff options
Diffstat (limited to 'doc/mpplu.html')
| -rw-r--r-- | doc/mpplu.html | 182 |
1 files changed, 182 insertions, 0 deletions
diff --git a/doc/mpplu.html b/doc/mpplu.html new file mode 100644 index 0000000..2f0b955 --- /dev/null +++ b/doc/mpplu.html @@ -0,0 +1,182 @@ +<!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#VRML">VRML</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 VRML as well<br> +-n +Don't add VRML 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 VRML 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#VRML">VRML</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 VRML 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 VRML 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> |