Sophie

Sophie

distrib > Mageia > 2 > i586 > media > core-updates > by-pkgid > adc4c2856edabd8f6936716da011b744 > files > 208

argyllcms-1.4.0-1.1.mga2.i586.rpm

<!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.<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>