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
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>iccgamut</title>
<meta http-equiv="content-type" content="text/html;
charset=windows-1252">
<meta name="author" content="Graeme Gill">
</head>
<body>
<h2><b>xicc/iccgamut</b></h2>
<br>
Create a gamut file or X3DOM file 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 X3DOM file.<br>
<br>
See <a href="3dformat.html">3D Viewing Format</a> for switching to
VRML or X3D output format.<br>
<h3>Usage<br>
</h3>
<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;"> -v
Verbose</span><br style="font-family: monospace;">
<span style="font-family: monospace;"> -d
sres Surface resolution
details 1.0 - 50.0</span><br style="font-family: monospace;">
<span style="font-family: monospace;"> -w
emit
X3DOM .x3d.html file as well as CGATS .gam file</span><br
style="font-family: monospace;">
<span style="font-family: monospace;"> -n
Don't
add X3DOM axes or white/black point</span><br style="font-family:
monospace;">
<span style="font-family: monospace;"> -k
Add
X3DOM markers for prim. & sec. "cusp" points</span><br
style="font-family: monospace;">
<span style="font-family: monospace;"> -f function
f = forward*, b = backwards</span><br style="font-family:
monospace;">
<span style="font-family: monospace;"></span><span
style="font-family: monospace;">-i intent
p = perceptual, r = relative colorimetric,</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
s
= saturation, a = absolute (default), d = profile default</span><span
style="font-family: monospace;"></span><br style="font-family:
monospace;">
<span style="font-family: monospace;"></span><span
style="font-family: monospace;"> -o
order n = normal (priority: lut >
matrix > monochrome)</span><br style="font-family: monospace;">
<span style="font-family: monospace;">
r
= reverse (priority: monochrome > matrix > lut)<br>
</span><span style="font-family: monospace;"> </span><span
style="font-family: monospace;">-p oride</span><span
style="font-family: monospace;"> l =
Lab_PCS (default), j = CIECAM02 Appearance Jab</span><span
style="font-family: monospace;"></span><span style="font-family:
monospace;"></span><br style="font-family: monospace;">
<span style="font-family: monospace;"> -l
tlimit set total ink limit, 0 - 400%
(estimate by default)</span><br style="font-family: monospace;">
<span style="font-family: monospace;"> -L
klimit set black ink limit, 0 - 100%
(estimate by default)</span><br style="font-family: monospace;">
<span style="font-family: monospace;"> -c viewcond
set viewing conditions for CIECAM02,</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">
either
an enumerated choice, or a series of parameters:value changes</span><br>
<tt> </tt><tt><tt>pc
- Critical print evaluation environment (ISO-3664 P1)</tt><tt><br>
</tt>pp - Practical Reflection Print (ISO-3664 P2)<br>
pe - Print
evaluation environment (CIE 116-1995)<br>
</tt><tt> pm - Print
evaluation with partial Mid-tone adaptation</tt><br
style="font-family: monospace;">
<span style="font-family: monospace;">
mt - Monitor in typical work environment</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
mb - Monitor in bright work environment</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
md - Monitor in darkened work
environment</span><br style="font-family: monospace;">
<span style="font-family: monospace;">
jm - Projector in dim environment</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
jd - Projector in dark environment</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
pcd - Photo CD - original scene outdoors</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
ob - Original scene - Bright Outdoors</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
cx - Cut Sheet Transparencies on a
viewing box</span><span style="font-family: monospace;"></span><span
style="font-family: monospace;"></span><br style="font-family:
monospace;">
<span style="font-family: monospace;">
s:surround
n = auto, a = average, m = dim, d = dark,</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
c = transparency (default average)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
w:X:Y:Z
Adapted white point as XYZ (default media white)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
w:x:y
Adapted white point as x, y</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">
a:adaptation
Adaptation luminance in cd.m^2 (default 50.0)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
b:background
Background
% of image luminance (default 20)<br>
l:imagewhite Image
white in cd.m^2 if surround = auto (default 250)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;"><span style="font-family:
monospace;">
f:flare Flare light % of image
luminance (default 0)<br>
</span> </span><span style="font-family: monospace;">
g:glare Glare light % of ambient
(default 5)</span><br style="font-family: monospace;">
<span style="font-family: monospace;">
g:X:Y:Z Glare color as XYZ (default
media white)</span><br style="font-family: monospace;">
<span style="font-family: monospace;">
g:x:y Glare color as x,
y</span><br>
<span style="font-family: monospace;"><tt><span style="font-family:
monospace;"><tt><span style="font-family: monospace;"><span
style="font-family: monospace;">
h:hkscale Helmholtz-Kohlrausch effect
scale factor (default 1.0)<br>
</span></span><span style="font-family: monospace;">
m:mtaf Mid-tone
partial adaptation factor (default 0.0)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">
m:X:Y:Z Mid-tone Adaptation
white as XYZ (default D50)</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">
m:x:y Mid-tone
Adaptation white as x, y</span></tt></span></tt><br>
-x pcent Expand/compress
gamut cylindrically by percent<br>
-s
Create
special cube surface topology plot<br style="font-family:
monospace;">
</span><i style="font-family: monospace;">profile</i><span
style="font-family: monospace;">
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#X3DOM">X3DOM</a><span
style="font-family: monospace;"> [.x3d.html] file.</span> <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 X3DOM 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
X3DOM.<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 & 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. 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. <br>
<br>
<span style="font-weight: bold;">-p</span>: By default the gamut
will be created in L*a*b* colorspace. If <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 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 <b>-x</b> parameter allows expanding or compressing the
resulting gamut in a cylindrical direction by the given percentage
:- i.e "-x 120" will expand by 20%. This may be useful for creating
a general compression gamut mapping by using such an expanded device
gamut as input to <a href="collink.html#g">collink -g or -G</a>.<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>
<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.x3d.html</span>.<br>
<br>
To create a gamut suitable for CIECAM02 gamut mapping space in
colprof or collink, something like<br>
<br>
iccgamut -ir -pj -cmt profile.icm<br>
<br>
where the viewing conditions "mt" should the same as the source
conditions in colprof or collink.<br>
<br style="font-weight: bold;">
<span style="font-weight: bold;"></span><br>
<br>
<br>
<br>
<br>
<br>
<br>
</body>
</html>
|
