summaryrefslogtreecommitdiff
path: root/doc/mpplu.html
blob: 68f985bc29c1ab63bb361f34e5341d98125fa1da (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
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
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=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&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, </span></small><small><span
        style="font-family: monospace;"><tt><small>2012_2, 2012_10, </small></tt>S&amp;B
1955_2,

        shaw, J&amp;V 1978_2 or file.cmf</span></small><small><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>
    <b>&nbsp; 2012_2</b> selects the proposed CIE 2012 2 degree observer<br>
    &nbsp; <b>2012_10</b> selects the proposed CIE 2012 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>
    &nbsp; <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>