summaryrefslogtreecommitdiff
path: root/doc/mpplu.html
blob: 8d4e7557bbe1625682f191503ead249d8e533bd0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
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&nbsp;<a
 href="File_Formats.html#MPP">MPP</a> profile. Also
create MPP gamut files or&nbsp;<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&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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;">&nbsp;&nbsp; &nbsp;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;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 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;">&nbsp;&nbsp; &nbsp; &nbsp; 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;">&nbsp;&nbsp; &nbsp; &nbsp; Choose
illuminant for
print/transparency spectral data:</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">&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</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;">&nbsp; &nbsp; &nbsp; Choose CIE
Observer for spectral
data:</span><br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp; &nbsp;&nbsp; </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&amp;B
1955_2, shaw, J&amp;V 1978_2</span></small><small><span
 style="font-family: monospace;"></span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">-u&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp; &nbsp; Use Fluorescent Whitening Agent compensation</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">-g&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp; &nbsp; Create gamut output</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">-w&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp; &nbsp; Create gamut X3DOM as well<br>
-n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Don't add X3DOM axes<br>
-a n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Gamut
transparency level<br style="font-family: monospace;">
</span><span style="font-family: monospace;">-d
n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp; &nbsp; Gamut
surface detail level</span><br style="font-family: monospace;">
<span style="font-family: monospace;">-t num&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp; &nbsp; Invoke debugging test code
"num" 1..n</span><br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp; &nbsp;&nbsp; 1 - check partial derivative for device
input</span><br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp; &nbsp;&nbsp; 2 - create overlap diagnostic X3DOM gamut
surface</span><br style="font-family: monospace;">
<span style="font-family: monospace;">profile.mpp &nbsp; Profile to be
used</span><br style="font-family: monospace;">
<br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; The colors to
be translated should be fed into
standard input,</span><br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; one input
color per line, white space separated.</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; A line
starting with a # will be ignored.</span><br
 style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; 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>&nbsp; 1931_2</b> selects the standard CIE 1931 2 degree observer.
The default.<br>
&nbsp; <b>1964_10</b> selects the standard CIE 1964 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>
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>