<!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 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;"> -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 VRML .wrl file as well as CGATS .gam file</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> -n Don't add VRML axes or white/black point</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> -k Add 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;"> -i intent p = perceptual, r = relative colorimetric,</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> s = saturation, a = absolute*,</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> j = Appearance CIECAM02, d = default</span><br style="font-family: monospace;"> <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)</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 style="font-family: monospace;"> <span style="font-family: monospace;"></span></small><small><span style="font-family: monospace;"> pp - Practical Reflection Print</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> pe - Print evaluation environment</span><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></small><small><span style="font-family: monospace;"></span><span style="font-family: monospace;"></span><br style="font-family: monospace;"> <span style="font-family: monospace;"> s:surround 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)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> f:flare Flare light % of image luminance (default 1)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> f:X:Y:Z Flare color as XYZ (default media white)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> f:x:y Flare color as x, y</span><br style="font-family: monospace;"> <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#.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 & 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> parameter allows choosing the table being used by its intent. Anything other than colorimetric may not represent the native capabilities of the device. A parameter value of <span style="font-weight: bold;">j</span> interprets the absolute colorimetric table in terms of CIECAM02 appearance space Jab values.<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> 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.<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.<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> <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.wrl</span>.<br> <br style="font-weight: bold;"> <span style="font-weight: bold;"></span><br> <br> <br> <br> <br> <br> <br> </body> </html>
