diff options
Diffstat (limited to 'doc/iccgamut.html')
| -rw-r--r-- | doc/iccgamut.html | 334 |
1 files changed, 334 insertions, 0 deletions
diff --git a/doc/iccgamut.html b/doc/iccgamut.html new file mode 100644 index 0000000..6d2f5ba --- /dev/null +++ b/doc/iccgamut.html @@ -0,0 +1,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 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 + VRML 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></small><small><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></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;"> -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></small><small><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></small><small><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 style="font-family: + monospace;"> + <span style="font-family: monospace;"></span></small><small><span + style="font-family: monospace;"> + pp - Practical Reflection + Print + (ISO-3664 P2)</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> + + pe - Print evaluation environment (CIE 116-1995)<br> + </span></small><small><span style="font-family: monospace;"> + + 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;"> + + 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 + 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:scenewhite Scene + white in + cd.m^2 if surround = auto (default 250)<br style="font-family: + monospace;"> + </span><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<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#.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 & 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 <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.wrl</span>.<br> + <br style="font-weight: bold;"> + <span style="font-weight: bold;"></span><br> + <br> + <br> + <br> + <br> + <br> + <br> + </body> +</html> |