From 22f703cab05b7cd368f4de9e03991b7664dc5022 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Mon, 1 Sep 2014 13:56:46 +0200 Subject: Initial import of argyll version 1.5.1-8 --- doc/mpplu.html | 182 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 182 insertions(+) create mode 100644 doc/mpplu.html (limited to 'doc/mpplu.html') 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 @@ + + + + mpplu + + + + +

xicc/mpplu

+

Summary

+Lookup individual color values though an MPP profile. Also +create MPP gamut files or VRML +views.
+

Usage

+mpplu [-v level] [-f func] +[-i intent] [-o order] profile.mpp
+-v             +Verbose
+-f function    f = forward, b = +backwards
+-p oride       x += XYZ_PCS, l = +Lab_PCS, y = Yxy, s = spectral,
+-l limit       override +default +ink limit, 1 - N00%
+-i illum       Choose +illuminant for +print/transparency spectral data:
+            +     A, C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp
+-o observ      Choose CIE +Observer for spectral +data:
+            +     1931_2 (def.), 1964_10, S&B +1955_2, shaw, J&V 1978_2
+-u         +    Use Fluorescent Whitening Agent compensation
+-g         +    Create gamut output
+-w         +    Create gamut VRML as well
+-n             +Don't add VRML axes
+-a n           Gamut +transparency level
+-d +n           Gamut +surface detail level
+-t num     +    Invoke debugging test code +"num" 1..n
+            +     1 - check partial derivative for device +input
+            +     2 - create overlap diagnostic VRML gamut +surface
+profile.mpp   Profile to be +used
+
+    The colors to +be translated should be fed into +standard input,
+    one input +color per line, white space separated.
+    A line +starting with a # will be ignored.
+    A line not +starting with a number will terminate the +program. +
+

Usage Details and Discussion

+This is an analogous tool to icclu , but +applying +to MPP profile, rather than ICC 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.
+Some additional functionality is included in mpplu, analogous to iccgamut, allowing gamut files and images to +be generated from MPP profiles.
+
+The -v flag causes extra information about the profile to be +printed.
+
+The -f flag is experimental, and should be ignored.
+
+Normally L*a*b* is displayed, but this can be changed using the the -p +flag and XYZ, Yxy, or spectral values to be be displayed.
+
+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).
+
+The -l 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.
+
+The -i flag allows specifying a standard or custom illumination +spectrum, applied to reflective spectral profile data to compute CIE +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 spectrum file.
+
+ The -o flag allows specifying a tristimulus +observer, and is used to compute PCS (Profile Connection Space) +tristimulus values. The following choices are available:
+  1931_2 selects the standard CIE 1931 2 degree observer. +The default.
+  1964_10 selects the standard CIE 1964 10 degree observer.
+  1955_2 selects the Stiles and Birch 1955 2 degree +observer
+  1978_2 selects the Judd and Voss 1978 2 degree observer
+  shaw selects the Shaw and Fairchild 1997 2 degree +observer
+
+The -u 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.
+
+The -g flag causes mpplu to simply generate a gamut surface +description from the profile, creating a .gam file with the same base name as +the given profile.
+
+The -w flag causes the gamut surface to be generated in VRML format +as well as .gam format.
+
+The -n flag suppresses the VRML axes.
+
+The -a n parameter sets a transparency +level in the VRML surface.
+
+The -d 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.
+
+The -t parameter invokes special MPP test and diagnostic output.
+
+
+
+
+ + -- cgit v1.2.3