summaryrefslogtreecommitdiff
path: root/doc/iccgamut.html
blob: 6d2f5ba81a1b734b6c3645da79b2e70b0273b09f (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
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>iccgamut</title>
    <meta http-equiv="content-type" content="text/html;
      charset=ISO-8859-1">
    <meta name="author" content="Graeme Gill">
  </head>
  <body>
    <h2><b>xicc/iccgamut</b></h2>
    <br>
    Create a gamut file or VRML file &nbsp;of the color gamut of an ICC
    profile.<br>
    <span style="font-weight: bold;"> iccgamut</span> allows creation of
    gamut files from the forward or backwards
    table of an ICC profile, in Lab or CIECAM02 Jab colorspace, and can
    also
    representing the gamut as a VRML file.<br>
    <h3>Usage<br>
    </h3>
    <small><span style="font-family: monospace;">iccgamut [-options] </span><i
        style="font-family: monospace;">profile</i><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;-v&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        Verbose</span><br style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;-d
        sres&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Surface
        resolution details 1.0 - 50.0</span><br style="font-family:
        monospace;">
      <span style="font-family: monospace;">&nbsp;-w&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
emit
        VRML .wrl file as well as CGATS .gam file</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;-n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Don't
        add VRML axes or white/black point</span><br style="font-family:
        monospace;">
      <span style="font-family: monospace;">&nbsp;-k&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Add
        VRML markers for prim. &amp; sec. "cusp" points</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;-f
        function&nbsp;&nbsp; f =
        forward*, b = backwards</span><br style="font-family:
        monospace;">
      &nbsp;
      <span style="font-family: monospace;"></span></small><small><span
        style="font-family: monospace;">-i
        intent&nbsp;&nbsp;&nbsp;&nbsp; p =
        perceptual, r = relative colorimetric,</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;
s
        = saturation, a = absolute (default), d = profile default</span></small><small><span
        style="font-family: monospace;"></span></small><br
      style="font-family: monospace;">
    <small><span style="font-family: monospace;"></span><span
        style="font-family: monospace;">&nbsp;-o
        order&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; n = normal
        (priority: lut &gt; matrix &gt; monochrome)</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;
r
        = reverse (priority: monochrome &gt;
        matrix &gt; lut)<br>
      </span></small><small><span style="font-family: monospace;">&nbsp;</span><span
        style="font-family: monospace;">-p oride</span><span
        style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; l
        =
        Lab_PCS (default), j = CIECAM02 Appearance Jab</span></small><small><span
        style="font-family: monospace;"></span><span style="font-family:
        monospace;"></span><br style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;-l
        tlimit&nbsp;&nbsp;&nbsp;&nbsp; set total
        ink limit, 0 - 400% (estimate by default)</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;-L
        klimit&nbsp;&nbsp;&nbsp;&nbsp; set black ink
        limit, 0 - 100% (estimate by default)</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;-c
        viewcond&nbsp;&nbsp; set
        viewing conditions for CIECAM02,</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;
either
        an enumerated choice, or a series of
        parameters:value changes</span><br style="font-family:
        monospace;">
      <span style="font-family: monospace;"></span></small><small><span
        style="font-family: monospace;">&nbsp;
        &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; pp - Practical Reflection
        Print
        (ISO-3664 P2)</span><br style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
        &nbsp; pe - Print evaluation environment (CIE 116-1995)<br>
      </span></small><small><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
        &nbsp; pc - Critical print evaluation environment (ISO-3664 P1)</span></small><small><span
        style="font-family: monospace;"></span><span style="font-family:
        monospace;"></span><br style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
        &nbsp; &nbsp; mt - Monitor in typical work environment</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
        &nbsp; mb - Monitor in bright work environment</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; &nbsp;
        &nbsp;
        &nbsp;&nbsp;&nbsp; md - Monitor in darkened work
        environment</span><br style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; &nbsp;
        &nbsp;
        &nbsp;&nbsp;&nbsp; jm - Projector in dim environment</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; &nbsp;
        &nbsp;
        &nbsp;&nbsp;&nbsp; jd - Projector in dark environment</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;
        &nbsp;
        &nbsp;&nbsp;&nbsp; pcd - Photo CD - original scene
        outdoors</span><br style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; &nbsp;
        &nbsp;
        &nbsp;&nbsp;&nbsp; ob - Original scene - Bright Outdoors</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; &nbsp;
        &nbsp;
        &nbsp;&nbsp;&nbsp; cx - Cut Sheet Transparencies on a viewing
        box</span></small><small><span style="font-family: monospace;"></span><span
        style="font-family: monospace;"></span><br style="font-family:
        monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
s:surround&nbsp;&nbsp;
        n = auto, a = average, m = dim, d = dark,</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;
&nbsp;
        &nbsp; &nbsp;&nbsp; c = transparency (default average)</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
w:X:Y:Z&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        Adapted white point
        as XYZ (default media white)</span><br style="font-family:
        monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
w:x:y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        Adapted white point as
        x, y</span><br style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
a:adaptation
        Adaptation luminance in cd.m^2 (default 50.0)</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
b:background
Background
        % of image luminance (default 20)<br>
        &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp; l:scenewhite Scene
        white in
        cd.m^2 if surround = auto (default 250)<br style="font-family:
          monospace;">
      </span><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
f:flare&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        Flare
        light % of image luminance (default 1)</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
f:X:Y:Z&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        Flare color as
        XYZ (default media white)</span><br style="font-family:
        monospace;">
      <span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
f:x:y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        Flare color as x, y<br>
        &nbsp;-s&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Create
        special cube surface topology plot<br style="font-family:
          monospace;">
      </span><i style="font-family: monospace;">profile</i><span
        style="font-family: monospace;"> &nbsp; &nbsp; &nbsp;
        &nbsp;&nbsp; The
        name of the </span><a style="font-family: monospace;"
        href="File_Formats.html#ICC">ICC</a><span style="font-family:
        monospace;">
        profile, as well as the basename of the </span><a
        style="font-family: monospace;" href="File_Formats.html#.gam">gamut</a><span
        style="font-family: monospace;"> [.gam] and/or </span><a
        style="font-family: monospace;" href="File_Formats.html#.wrl">VRML</a><span
        style="font-family: monospace;"> [.wrl] file.</span></small>
    <br>
    <h3>Comments</h3>
    The parameters are all those that control which table in the ICC
    profile to use, as well as what color space to convert it to. <br>
    <br>
    The<b> -v</b> flag dumps out the ICC profile header information.
    Using <b>-v</b> <b>-w</b> will also print the gamut volume in
    cubic L*a*b* units.<br>
    <br>
    The <b>-d</b> parameter controls the level of detail displayed in
    the
    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>-w</b> flag causes a VRML file to be produced, as well as a
    gamut file.<br>
    <br>
    The <b>-n</b> flag suppresses the L*a*b* axes being created in
    the VRML.<br>
    <br>
    The <span style="font-weight: bold;">-k</span> flag adds markers
    for
    each of the primary and secondary "cusp" points (Red, Yellow, Green,
    Cyan, Blue &amp; Magenta). No markers will be displayed if the cusps
    cannot be determined.<br>
    <br>
    The <b>-f </b>parameter allows choosing the ICC table to be used
    in
    plotting the gamut. The backwards tables generally incorporate gamut
    compression, and therefore don't reflect the native capabilities of
    the
    device.<br>
    <br>
    The <b>-i</b> flag selects the intent transform used for a lut
    based
    profile. It also selects between relative and absolute colorimetric
    for
    non-lut base profiles. Note that anything other than colorimetric
    may
    not represent the
    native capabilities of the device. The default intent will be
    absolute
    colorimetic for L*a*b* output, and CIECAM02 appearance for Jab
    output.<br>
    <br>
    An ICC profile is allowed to contain more than the minimum number of
    elements or table needed to describe a certain transform, and may
    contain redundant descriptions. &nbsp;By default, lut based table
    information will be used first if present, followed by matrix/shaper
    information, and only using
    monochrome information if it is all that is present. The <b>-o</b>
    flag,
    reverses this order.&nbsp;&nbsp;&nbsp; <br>
    <br>
    <span style="font-weight: bold;">-p</span>: By default the gamut
    will
    be created in L*a*b* colorspace. If&nbsp; <span style="font-weight:
      bold;">-pj</span> is selected, then CIECAM02
    appearance space Jab will be used for the output, and the viewing
    conditions will be taken into account. Jab space is what is normally
    needed to be compatible with the default intents used in <a
      href="colprof.html">colprof</a>. <span style="font-weight: bold;"><br>
    </span>Note that the CIECAM02 output space selection by default uses
    the colorimetric transform of the profile resulting in the
    appearance
    of the native device, but that the perceptual or
    saturation transforms may be used by selecting them using the <span
      style="font-weight: bold;">-i</span> parameter, which may give a
    different result with some profiles. This may be desirable if an
    image
    is to be transformed through the perceptual or saturation tables of
    a
    profile as part of a link with an Argyll generated output profile,
    since it will then represent the apparent gamut of the image when
    subject to these tables. If the absolute colorimetric intent is
    chosen
    using <span style="font-weight: bold;">-ia</span> in combinations
    with
    <span style="font-weight: bold;">-pj</span>, then&nbsp; Jab with
    a fixed white reference is used, which emulates an absolute CIECAM02
    Jab
    appearance space. <br>
    <br>
    The <b>-l</b> parameter allows setting a total ink limit (TAC) for
    printing
    devices. If a device has a total ink limit, and hasn't been
    characterised with device values above this limit, then plotting the
    gamut in these areas will almost certainly be misleading. tables. By
    default, a total ink limit will
    be estimated from the profile tables. The ink limit
    will be in final calibrated device values if the profile includes
    calibration information.<br>
    <br>
    The <b>-L</b> parameter allows setting a black ink limit for
    printing
    devices. If a device is to be used with a black ink limit, then it
    is
    useful to evaluate
    the gamut with the limit in place. By default, a black ink limit
    will
    be estimated from the profile tables. The ink limit
    will be in final calibrated device values if the profile includes
    calibration information.<br>
    <br>
    The <b>-c</b> parameter allows setting the CIECAM02 viewing
    conditions,
    either by choosing a typical viewing environment, or controlling
    particular viewing condition parameters.<br>
    <br>
    The <span style="font-weight: bold;">-s</span> flag creates a
    special
    hyper-cube surface plot that is artificially colored. This can be
    useful for identifying the topology of the black ink color response.<br>
    <h3>Example<br>
    </h3>
    To create a view in L*a*b* of the absolute gamut of a CMYK file with
    an
    ink limit of 260%, one might use:<br>
    <br>
    &nbsp;&nbsp;&nbsp; <span style="font-style: italic;">iccgamut -w
      -ff
      -ia -l260 profile.icm</span><br>
    <br>
    and the resulting files will be <span style="text-decoration:
      underline;">profile.gam</span> and <span style="text-decoration:
      underline;">profile.wrl</span>.<br>
    <br style="font-weight: bold;">
    <span style="font-weight: bold;"></span><br>
    <br>
    <br>
    <br>
    <br>
    <br>
    <br>
  </body>
</html>