1
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<title>iccgamut</title>
5
<meta http-equiv="content-type"
6
content="text/html; charset=ISO-8859-1">
7
<meta name="author" content="Graeme Gill">
10
<h2><b>xicc/iccgamut</b></h2>
12
Create a gamut file or VRML file of the color gamut of an ICC
14
<span style="font-weight: bold;"> iccgamut</span> allows creation of
15
gamut files from the forward or backwards
16
table of an ICC profile, in Lab or CIECAM02 Jab colorspace, and can
18
representing the gamut as a VRML file.<br>
21
<small><span style="font-family: monospace;">iccgamut [-options] </span><i
22
style="font-family: monospace;">profile</i><br
23
style="font-family: monospace;">
24
<span style="font-family: monospace;"> -v
25
Verbose</span><br style="font-family: monospace;">
26
<span style="font-family: monospace;"> -d
27
sres Surface
28
resolution details 1.0 - 50.0</span><br style="font-family: monospace;">
29
<span style="font-family: monospace;"> -w
30
emit VRML .wrl file as well as CGATS .gam file</span><br
31
style="font-family: monospace;">
32
<span style="font-family: monospace;"> -n
33
Don't add VRML axes or white/black point</span><br
34
style="font-family: monospace;">
35
<span style="font-family: monospace;"> -k
36
Add VRML markers for prim. & sec. "cusp" points</span><br
37
style="font-family: monospace;">
38
<span style="font-family: monospace;"> -f function f =
39
forward*, b = backwards</span><br style="font-family: monospace;">
41
<span style="font-family: monospace;"></span></small><small><span
42
style="font-family: monospace;">-i
43
intent p =
44
perceptual, r = relative colorimetric,</span><br
45
style="font-family: monospace;">
46
<span style="font-family: monospace;">
47
s = saturation, a = absolute (default), d = profile default</span></small><small><span
48
style="font-family: monospace;"></span></small><br
49
style="font-family: monospace;">
50
<small><span style="font-family: monospace;"></span><span
51
style="font-family: monospace;"> -o
52
order n = normal
53
(priority: lut > matrix > monochrome)</span><br
54
style="font-family: monospace;">
55
<span style="font-family: monospace;">
56
r = reverse (priority: monochrome >
58
</span></small><small><span style="font-family: monospace;"> </span><span
59
style="font-family: monospace;">-p oride</span><span
60
style="font-family: monospace;"> l =
61
Lab_PCS (default), j = CIECAM02 Appearance Jab</span></small><small><span
62
style="font-family: monospace;"></span><span
63
style="font-family: monospace;"></span><br
64
style="font-family: monospace;">
65
<span style="font-family: monospace;"> -l
66
tlimit set total
67
ink limit, 0 - 400% (estimate by default)</span><br
68
style="font-family: monospace;">
69
<span style="font-family: monospace;"> -L
70
klimit set black ink
71
limit, 0 - 100% (estimate by default)</span><br
72
style="font-family: monospace;">
73
<span style="font-family: monospace;"> -c viewcond set
74
viewing conditions for CIECAM02,</span><br
75
style="font-family: monospace;">
76
<span style="font-family: monospace;">
77
either an enumerated choice, or a series of
78
parameters:value changes</span><br style="font-family: monospace;">
79
<span style="font-family: monospace;"></span></small><small><span
80
style="font-family: monospace;">
81
pp - Practical Reflection Print
82
(ISO-3664 P2)</span><br style="font-family: monospace;">
83
<span style="font-family: monospace;">
84
pe - Print evaluation environment (CIE 116-1995)<br>
85
</span></small><small><span style="font-family: monospace;">
86
pc - Critical print evaluation environment (ISO-3664 P1)</span></small><small><span
87
style="font-family: monospace;"></span><span
88
style="font-family: monospace;"></span><br
89
style="font-family: monospace;">
90
<span style="font-family: monospace;">
91
mt - Monitor in typical work environment</span><br
92
style="font-family: monospace;">
93
<span style="font-family: monospace;">
94
mb - Monitor in bright work environment</span><br
95
style="font-family: monospace;">
96
<span style="font-family: monospace;">
97
md - Monitor in darkened work
98
environment</span><br style="font-family: monospace;">
99
<span style="font-family: monospace;">
100
jm - Projector in dim environment</span><br
101
style="font-family: monospace;">
102
<span style="font-family: monospace;">
103
jd - Projector in dark environment</span><br
104
style="font-family: monospace;">
105
<span style="font-family: monospace;">
106
pcd - Photo CD - original scene
107
outdoors</span><br style="font-family: monospace;">
108
<span style="font-family: monospace;">
109
ob - Original scene - Bright Outdoors</span><br
110
style="font-family: monospace;">
111
<span style="font-family: monospace;">
112
cx - Cut Sheet Transparencies on a viewing box</span></small><small><span
113
style="font-family: monospace;"></span><span
114
style="font-family: monospace;"></span><br
115
style="font-family: monospace;">
116
<span style="font-family: monospace;">
117
s:surround n = auto, a = average, m = dim, d = dark,</span><br
118
style="font-family: monospace;">
119
<span style="font-family: monospace;">
120
c = transparency (default average)</span><br
121
style="font-family: monospace;">
122
<span style="font-family: monospace;">
123
w:X:Y:Z Adapted white point
124
as XYZ (default media white)</span><br style="font-family: monospace;">
125
<span style="font-family: monospace;">
126
w:x:y Adapted white point as
127
x, y</span><br style="font-family: monospace;">
128
<span style="font-family: monospace;">
129
a:adaptation Adaptation luminance in cd.m^2 (default 50.0)</span><br
130
style="font-family: monospace;">
131
<span style="font-family: monospace;">
4
<title>iccgamut</title>
5
<meta http-equiv="content-type" content="text/html;
7
<meta name="author" content="Graeme Gill">
10
<h2><b>xicc/iccgamut</b></h2>
12
Create a gamut file or VRML file of the color gamut of an ICC
14
<span style="font-weight: bold;"> iccgamut</span> allows creation of
15
gamut files from the forward or backwards
16
table of an ICC profile, in Lab or CIECAM02 Jab colorspace, and can
18
representing the gamut as a VRML file.<br>
21
<small><span style="font-family: monospace;">iccgamut [-options] </span><i
22
style="font-family: monospace;">profile</i><br
23
style="font-family: monospace;">
24
<span style="font-family: monospace;"> -v
25
Verbose</span><br style="font-family: monospace;">
26
<span style="font-family: monospace;"> -d
27
sres Surface
28
resolution details 1.0 - 50.0</span><br style="font-family:
30
<span style="font-family: monospace;"> -w
32
VRML .wrl file as well as CGATS .gam file</span><br
33
style="font-family: monospace;">
34
<span style="font-family: monospace;"> -n
36
add VRML axes or white/black point</span><br style="font-family:
38
<span style="font-family: monospace;"> -k
40
VRML markers for prim. & sec. "cusp" points</span><br
41
style="font-family: monospace;">
42
<span style="font-family: monospace;"> -f
43
function f =
44
forward*, b = backwards</span><br style="font-family:
47
<span style="font-family: monospace;"></span></small><small><span
48
style="font-family: monospace;">-i
49
intent p =
50
perceptual, r = relative colorimetric,</span><br
51
style="font-family: monospace;">
52
<span style="font-family: monospace;">
54
= saturation, a = absolute (default), d = profile default</span></small><small><span
55
style="font-family: monospace;"></span></small><br
56
style="font-family: monospace;">
57
<small><span style="font-family: monospace;"></span><span
58
style="font-family: monospace;"> -o
59
order n = normal
60
(priority: lut > matrix > monochrome)</span><br
61
style="font-family: monospace;">
62
<span style="font-family: monospace;">
64
= reverse (priority: monochrome >
66
</span></small><small><span style="font-family: monospace;"> </span><span
67
style="font-family: monospace;">-p oride</span><span
68
style="font-family: monospace;"> l
70
Lab_PCS (default), j = CIECAM02 Appearance Jab</span></small><small><span
71
style="font-family: monospace;"></span><span style="font-family:
72
monospace;"></span><br style="font-family: monospace;">
73
<span style="font-family: monospace;"> -l
74
tlimit set total
75
ink limit, 0 - 400% (estimate by default)</span><br
76
style="font-family: monospace;">
77
<span style="font-family: monospace;"> -L
78
klimit set black ink
79
limit, 0 - 100% (estimate by default)</span><br
80
style="font-family: monospace;">
81
<span style="font-family: monospace;"> -c
82
viewcond set
83
viewing conditions for CIECAM02,</span><br style="font-family:
85
<span style="font-family: monospace;">
87
an enumerated choice, or a series of
88
parameters:value changes</span><br style="font-family:
90
<span style="font-family: monospace;"></span></small><small><span
91
style="font-family: monospace;">
92
pp - Practical Reflection
94
(ISO-3664 P2)</span><br style="font-family: monospace;">
95
<span style="font-family: monospace;">
97
pe - Print evaluation environment (CIE 116-1995)<br>
98
</span></small><small><span style="font-family: monospace;">
100
pc - Critical print evaluation environment (ISO-3664 P1)</span></small><small><span
101
style="font-family: monospace;"></span><span style="font-family:
102
monospace;"></span><br style="font-family: monospace;">
103
<span style="font-family: monospace;">
105
mt - Monitor in typical work environment</span><br
106
style="font-family: monospace;">
107
<span style="font-family: monospace;">
109
mb - Monitor in bright work environment</span><br
110
style="font-family: monospace;">
111
<span style="font-family: monospace;">
113
md - Monitor in darkened work
114
environment</span><br style="font-family: monospace;">
115
<span style="font-family: monospace;">
117
jm - Projector in dim environment</span><br
118
style="font-family: monospace;">
119
<span style="font-family: monospace;">
121
jd - Projector in dark environment</span><br
122
style="font-family: monospace;">
123
<span style="font-family: monospace;">
125
pcd - Photo CD - original scene
126
outdoors</span><br style="font-family: monospace;">
127
<span style="font-family: monospace;">
129
ob - Original scene - Bright Outdoors</span><br
130
style="font-family: monospace;">
131
<span style="font-family: monospace;">
133
cx - Cut Sheet Transparencies on a viewing
134
box</span></small><small><span style="font-family: monospace;"></span><span
135
style="font-family: monospace;"></span><br style="font-family:
137
<span style="font-family: monospace;">
138
s:surround
139
n = auto, a = average, m = dim, d = dark,</span><br
140
style="font-family: monospace;">
141
<span style="font-family: monospace;">
143
c = transparency (default average)</span><br
144
style="font-family: monospace;">
145
<span style="font-family: monospace;">
146
w:X:Y:Z
148
as XYZ (default media white)</span><br style="font-family:
150
<span style="font-family: monospace;">
151
w:x:y
152
Adapted white point as
153
x, y</span><br style="font-family: monospace;">
154
<span style="font-family: monospace;">
156
Adaptation luminance in cd.m^2 (default 50.0)</span><br
157
style="font-family: monospace;">
158
<span style="font-family: monospace;">
133
Background % of image luminance (default 20)<br>
134
l:scenewhite Scene white in
135
cd.m^2 if surround = auto (default 250)<br
136
style="font-family: monospace;">
137
</span><span style="font-family: monospace;">
138
f:flare Flare
139
light % of image luminance (default 1)</span><br
140
style="font-family: monospace;">
141
<span style="font-family: monospace;">
142
f:X:Y:Z Flare color as
143
XYZ (default media white)</span><br style="font-family: monospace;">
144
<span style="font-family: monospace;">
145
f:x:y Flare color as x, y<br>
146
-s
147
Create special cube surface topology plot<br
148
style="font-family: monospace;">
149
</span><i style="font-family: monospace;">profile</i><span
150
style="font-family: monospace;"> The
151
name of the </span><a style="font-family: monospace;"
152
href="File_Formats.html#ICC">ICC</a><span
153
style="font-family: monospace;">
154
profile, as well as the basename of the </span><a
155
style="font-family: monospace;" href="File_Formats.html#.gam">gamut</a><span
156
style="font-family: monospace;"> [.gam] and/or </span><a
157
style="font-family: monospace;" href="File_Formats.html#.wrl">VRML</a><span
158
style="font-family: monospace;"> [.wrl] file.</span></small>
161
The parameters are all those that control which table in the ICC
162
profile to use, as well as what color space to convert it to. <br>
164
The<b> -v</b> flag dumps out the ICC profile header information.<br>
166
The <b>-d</b> parameter controls the level of detail displayed in the
167
surface. The parameter roughly corresponds to a deltaE value, so
169
values give greater detail. The default value is around 10, and is a
171
place to start. Small values may take a lot of time to generate, and
173
produce big files.<br>
175
The <b>-w</b> flag causes a VRML file to be produced, as well as a
178
The <b>-n</b> flag suppresses the L*a*b* axes being created in
181
The <span style="font-weight: bold;">-k</span> flag adds markers for
182
each of the primary and secondary "cusp" points (Red, Yellow, Green,
183
Cyan, Blue & Magenta). No markers will be displayed if the cusps
184
cannot be determined.<br>
186
The <b>-f </b>parameter allows choosing the ICC table to be used in
187
plotting the gamut. The backwards tables generally incorporate gamut
188
compression, and therefore don't reflect the native capabilities of the
191
The <b>-i</b> flag selects the intent transform used for a lut based
192
profile. It also selects between relative and absolute colorimetric for
193
non-lut base profiles. Note that anything other than colorimetric may
195
native capabilities of the device. The default intent will be absolute
196
colorimetic for L*a*b* output, and CIECAM02 appearance for Jab output.<br>
198
An ICC profile is allowed to contain more than the minimum number of
199
elements or table needed to describe a certain transform, and may
200
contain redundant descriptions. By default, lut based table
201
information will be used first if present, followed by matrix/shaper
202
information, and only using
203
monochrome information if it is all that is present. The <b>-o</b>
205
reverses this order. <br>
207
<span style="font-weight: bold;">-p</span>: By default the gamut will
208
be created in L*a*b* colorspace. If <span
209
style="font-weight: bold;">-pj</span> is selected, then CIECAM02
210
appearance space Jab will be used for the output, and the viewing
211
conditions will be taken into account. Jab space is what is normally
212
needed to be compatible with the default intents used in <a
213
href="colprof.html">colprof</a>. <span style="font-weight: bold;"><br>
214
</span>Note that the CIECAM02 output space selection by default uses
215
the colorimetric transform of the profile resulting in the appearance
216
of the native device, but that the perceptual or
217
saturation transforms may be used by selecting them using the <span
218
style="font-weight: bold;">-i</span> parameter, which may give a
219
different result with some profiles. This may be desirable if an image
220
is to be transformed through the perceptual or saturation tables of a
221
profile as part of a link with an Argyll generated output profile,
222
since it will then represent the apparent gamut of the image when
223
subject to these tables. If the absolute colorimetric intent is chosen
224
using <span style="font-weight: bold;">-ia</span> in combinations with
225
<span style="font-weight: bold;">-pj</span>, then Jab with
226
a fixed white reference is used, which emulates an absolute CIECAM02
228
appearance space. <br>
230
The <b>-l</b> parameter allows setting a total ink limit (TAC) for
232
devices. If a device has a total ink limit, and hasn't been
233
characterised with device values above this limit, then plotting the
234
gamut in these areas will almost certainly be misleading. tables. By
235
default, a total ink limit will
236
be estimated from the profile tables. The ink limit
237
will be in final calibrated device values if the profile includes
238
calibration information.<br>
240
The <b>-L</b> parameter allows setting a black ink limit for printing
241
devices. If a device is to be used with a black ink limit, then it is
243
the gamut with the limit in place. By default, a black ink limit will
244
be estimated from the profile tables. The ink limit
245
will be in final calibrated device values if the profile includes
246
calibration information.<br>
248
The <b>-c</b> parameter allows setting the CIECAM02 viewing
250
either by choosing a typical viewing environment, or controlling
251
particular viewing condition parameters.<br>
253
The <span style="font-weight: bold;">-s</span> flag creates a special
254
hyper-cube surface plot that is artificially colored. This can be
255
useful for identifying the topology of the black ink color response.<br>
258
To create a view in L*a*b* of the absolute gamut of a CMYK file with an
259
ink limit of 260%, one might use:<br>
261
<span style="font-style: italic;">iccgamut -w -ff
262
-ia -l260 profile.icm</span><br>
264
and the resulting files will be <span
265
style="text-decoration: underline;">profile.gam</span> and <span
266
style="text-decoration: underline;">profile.wrl</span>.<br>
267
<br style="font-weight: bold;">
268
<span style="font-weight: bold;"></span><br>
161
% of image luminance (default 20)<br>
162
l:scenewhite Scene
164
cd.m^2 if surround = auto (default 250)<br style="font-family:
166
</span><span style="font-family: monospace;">
167
f:flare
169
light % of image luminance (default 1)</span><br
170
style="font-family: monospace;">
171
<span style="font-family: monospace;">
172
f:X:Y:Z
174
XYZ (default media white)</span><br style="font-family:
176
<span style="font-family: monospace;">
177
f:x:y
178
Flare color as x, y<br>
179
-s
181
special cube surface topology plot<br style="font-family:
183
</span><i style="font-family: monospace;">profile</i><span
184
style="font-family: monospace;">
186
name of the </span><a style="font-family: monospace;"
187
href="File_Formats.html#ICC">ICC</a><span style="font-family:
189
profile, as well as the basename of the </span><a
190
style="font-family: monospace;" href="File_Formats.html#.gam">gamut</a><span
191
style="font-family: monospace;"> [.gam] and/or </span><a
192
style="font-family: monospace;" href="File_Formats.html#.wrl">VRML</a><span
193
style="font-family: monospace;"> [.wrl] file.</span></small>
196
The parameters are all those that control which table in the ICC
197
profile to use, as well as what color space to convert it to. <br>
199
The<b> -v</b> flag dumps out the ICC profile header information.
200
Using <b>-v</b> <b>-w</b> will also print the gamut volume in
201
cubic L*a*b* units.<br>
203
The <b>-d</b> parameter controls the level of detail displayed in
205
surface. The parameter roughly corresponds to a deltaE value, so
207
values give greater detail. The default value is around 10, and is a
209
place to start. Small values may take a lot of time to generate, and
211
produce big files.<br>
213
The <b>-w</b> flag causes a VRML file to be produced, as well as a
216
The <b>-n</b> flag suppresses the L*a*b* axes being created in
219
The <span style="font-weight: bold;">-k</span> flag adds markers
221
each of the primary and secondary "cusp" points (Red, Yellow, Green,
222
Cyan, Blue & Magenta). No markers will be displayed if the cusps
223
cannot be determined.<br>
225
The <b>-f </b>parameter allows choosing the ICC table to be used
227
plotting the gamut. The backwards tables generally incorporate gamut
228
compression, and therefore don't reflect the native capabilities of
232
The <b>-i</b> flag selects the intent transform used for a lut
234
profile. It also selects between relative and absolute colorimetric
236
non-lut base profiles. Note that anything other than colorimetric
239
native capabilities of the device. The default intent will be
241
colorimetic for L*a*b* output, and CIECAM02 appearance for Jab
244
An ICC profile is allowed to contain more than the minimum number of
245
elements or table needed to describe a certain transform, and may
246
contain redundant descriptions. By default, lut based table
247
information will be used first if present, followed by matrix/shaper
248
information, and only using
249
monochrome information if it is all that is present. The <b>-o</b>
251
reverses this order. <br>
253
<span style="font-weight: bold;">-p</span>: By default the gamut
255
be created in L*a*b* colorspace. If <span style="font-weight:
256
bold;">-pj</span> is selected, then CIECAM02
257
appearance space Jab will be used for the output, and the viewing
258
conditions will be taken into account. Jab space is what is normally
259
needed to be compatible with the default intents used in <a
260
href="colprof.html">colprof</a>. <span style="font-weight: bold;"><br>
261
</span>Note that the CIECAM02 output space selection by default uses
262
the colorimetric transform of the profile resulting in the
264
of the native device, but that the perceptual or
265
saturation transforms may be used by selecting them using the <span
266
style="font-weight: bold;">-i</span> parameter, which may give a
267
different result with some profiles. This may be desirable if an
269
is to be transformed through the perceptual or saturation tables of
271
profile as part of a link with an Argyll generated output profile,
272
since it will then represent the apparent gamut of the image when
273
subject to these tables. If the absolute colorimetric intent is
275
using <span style="font-weight: bold;">-ia</span> in combinations
277
<span style="font-weight: bold;">-pj</span>, then Jab with
278
a fixed white reference is used, which emulates an absolute CIECAM02
280
appearance space. <br>
282
The <b>-l</b> parameter allows setting a total ink limit (TAC) for
284
devices. If a device has a total ink limit, and hasn't been
285
characterised with device values above this limit, then plotting the
286
gamut in these areas will almost certainly be misleading. tables. By
287
default, a total ink limit will
288
be estimated from the profile tables. The ink limit
289
will be in final calibrated device values if the profile includes
290
calibration information.<br>
292
The <b>-L</b> parameter allows setting a black ink limit for
294
devices. If a device is to be used with a black ink limit, then it
297
the gamut with the limit in place. By default, a black ink limit
299
be estimated from the profile tables. The ink limit
300
will be in final calibrated device values if the profile includes
301
calibration information.<br>
303
The <b>-c</b> parameter allows setting the CIECAM02 viewing
305
either by choosing a typical viewing environment, or controlling
306
particular viewing condition parameters.<br>
308
The <span style="font-weight: bold;">-s</span> flag creates a
310
hyper-cube surface plot that is artificially colored. This can be
311
useful for identifying the topology of the black ink color response.<br>
314
To create a view in L*a*b* of the absolute gamut of a CMYK file with
316
ink limit of 260%, one might use:<br>
318
<span style="font-style: italic;">iccgamut -w
320
-ia -l260 profile.icm</span><br>
322
and the resulting files will be <span style="text-decoration:
323
underline;">profile.gam</span> and <span style="text-decoration:
324
underline;">profile.wrl</span>.<br>
325
<br style="font-weight: bold;">
326
<span style="font-weight: bold;"></span><br>
added
removed
doc/iccgamut.html
