diff options
Diffstat (limited to 'doc/colprof.html')
| -rw-r--r-- | doc/colprof.html | 341 |
1 files changed, 243 insertions, 98 deletions
diff --git a/doc/colprof.html b/doc/colprof.html index 755226b..d5df56e 100644 --- a/doc/colprof.html +++ b/doc/colprof.html @@ -9,9 +9,11 @@ <body> <h2> profile/colprof</h2> <h3>Summary</h3> - Create an <a href="File_Formats.html#ICC">ICC</a> profile from - the <a href="File_Formats.html#.ti3">.ti3</a> test chart patch - values.<br> + Create an RGB, CMY or CMYK <a href="File_Formats.html#ICC">ICC</a> + profile from the <a href="File_Formats.html#.ti3">.ti3</a> test + chart patch values.<br> + [ Note that currently, Monochrome and N-Color profiles are not + supported. ]<br> <h3>Usage Summary</h3> <tt><small>colprof [-<i>options</i>] inoutfile<br> <a href="#v">-v</a> @@ -48,6 +50,10 @@ + + + + Verbose mode<br> <a href="#A">-A "manufacturer"</a> Set the manufacturer description string<br> @@ -86,6 +92,10 @@ + + + + Default intent: Perceptual, Rel. Colorimetric, Saturation, Abs. Colorimetric</small></tt><tt><br> @@ -129,6 +139,10 @@ + + + + Don't create input (Device) shaper curves<br> </small></tt><tt><small> <a href="#np">-np</a> @@ -168,6 +182,10 @@ + + + + Don't create output (PCS) shaper curves<br> </small></tt><tt><small> <a href="#nc">-nc</a> @@ -221,6 +239,10 @@ x + + + + max K, r = ramp K<br> <a href="#kp">-k p stle stpo enpo enle shape</a><br> @@ -267,6 +289,10 @@ White + + + + - 1.0<br> @@ -313,6 +339,10 @@ Wh + + + + 0.0 - Bk 1.0<br> @@ -359,6 +389,10 @@ Wh + + + + 0.0 - Bk 1.0<br> @@ -404,6 +438,10 @@ Black + + + + 0.0 - 1.0<br> @@ -450,6 +488,10 @@ concave, + + + + 1.0-2.0 convex<br> <a href="#K">-K parameters</a> @@ -476,6 +518,10 @@ concave, + + + + Same as -k, but target is K locus rather than K value itself<br> <a href="#l">-l <i>tlimit</i></a> override CMYK total ink limit, 0 - 400% @@ -529,6 +575,10 @@ cLUT + + + + x = XYZ cLUT, X = display XYZ cLUT + matrix<br> @@ -574,6 +624,10 @@ s + + + + shaper+matrix, m = matrix only,<br> @@ -620,6 +674,10 @@ S + + + + single shaper+matrix<br> <a href="#u">-u</a> @@ -651,6 +709,10 @@ S + + + + If input profile, auto scale WP to allow extrapolation</small></tt><tt><br> </tt><tt> </tt><tt><small><small> <a href="#uc">-uc</a> @@ -699,6 +761,10 @@ and + + + + primaries to be +ve</tt><tt><br> <a href="#B">-B X,Y,Z</a> @@ -709,6 +775,10 @@ and + + + + Display Black Point override hack<br> <a href="#V">-V demphasis</a> @@ -725,6 +795,10 @@ and + + + + Degree of dark region cLUT grid emphasis 1.0-3.0 (default 1.00 = none)<br> </tt><tt> </tt><tt><small><small><a href="#f">-f [<i>illum</i>]</a> @@ -754,6 +828,10 @@ and + + + + M0, M1, M2, </small></small></tt><tt><small><small><small>A, C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp ]</small></small></small></tt><tt><br> </tt><tt><small><small><small><small> <a href="#i">-i <i>illum</i></a> @@ -780,6 +858,10 @@ and + + + + Choose illuminant for computation of CIE XYZ from spectral data & FWA:<br> @@ -816,6 +898,10 @@ D50M2, + + + + D65, F5, F8, F10 or file.sp</small></small></small><br> <a href="#o">-o <i>observ</i></a> Choose CIE Observer for spectral data:<br> @@ -853,82 +939,22 @@ D50M2, + + + + 1931_2 </small></tt><tt><small>(def.)</small></tt><tt><small>, 1964_10, S&B 1955_2, shaw, J&V 1978_2<br> <a href="#r">-r avgdev</a> Average deviation of device+instrument readings as a percentage (default 0.5%)<br> - <a href="#s">-s src.icc</a> -Apply -gamut -mapping -to -output -profile -perceptual -B2A -table -for - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - given source<br> - <a href="#S">-S src.icc</a> - - - - - - - - - - - - - - - - - - - - - - - - - + <a href="#s">-s src.icm|cperc</a> Apply gamut + mapping to output profile perceptual B2A table for given source, + or compression percentage<br> + <a href="#S">-S src.icm|experc</a> Apply gamut + mapping to output profile perceptual and saturation B2A table, + or expansion percentage<br> + <a href="#nP">-nP</a> @@ -937,9 +963,6 @@ for - Apply gamut mapping to output profile perceptual and saturation - B2A table<br> - <a href="#nP">-nP</a> @@ -969,13 +992,13 @@ for + Use colormetric source gamut to make output profile perceptual + table<br> + <a href="#nS">-nS</a> - Use colormetric source gamut to make output profile perceptual - table<br> - <a href="#nS">-nS</a> @@ -1053,6 +1076,10 @@ for + + + + Override gamut mapping intent for output profile saturation table:<br> </small></tt><tt><small> @@ -1105,9 +1132,17 @@ for + + + + pa - Perceptual Appearance</small></tt><br> <tt><tt><small> + + + + lp - Luminance Preserving Perceptual</small></tt><br> </tt><tt> </tt><tt><small> @@ -1143,6 +1178,10 @@ for + + + + ms - Saturation<br> s - Enhanced Saturation [ICC @@ -1171,6 +1210,10 @@ for + + + + rl - White Point Matched Colorimetric (Lab)<br> <a href="#c">-c viewcond</a> @@ -1206,6 +1249,10 @@ for + + + + set input viewing conditions for output profile CIECAM02 gamut mapping,<br> @@ -1242,6 +1289,10 @@ for + + + + either an enumerated choice, or a parameter<br> <a href="#d">-d viewcond</a> @@ -1277,6 +1328,10 @@ for + + + + set output viewing conditions for output profile CIECAM02, gamut mapping<br> @@ -1313,6 +1368,10 @@ for + + + + either an enumerated choice, or a parameter:value change<br> @@ -1348,6 +1407,10 @@ for + + + + Also sets out of gamut clipping CAM space.<br> @@ -1383,6 +1446,10 @@ for + + + + Enumerated Viewing Conditions:<br> </small></tt><tt><small> pp - Practical Reflection Print (ISO-3664 @@ -1447,6 +1514,10 @@ for + + + + c = transparency (default average)<br> @@ -1495,6 +1566,10 @@ for + + + + g:glare Glare light % of ambient (default 5)</span><br style="font-family: monospace;"> @@ -1544,6 +1619,10 @@ for + + + + Create gamut gammap_p.x3d.html and gammap_s.x3d.html diagostics<br> </small></tt><tt><small> <a href="#O">-O outputfile</a> Override @@ -1580,6 +1659,10 @@ Override + + + + the default output filename & extension.</small></tt><tt><br> </tt><tt> </tt><tt><small> <a href="#p1"><i>inoutfile</i></a> Base name for @@ -1650,7 +1733,8 @@ Override Perceptual, <span style="font-weight: bold;">r</span> to set Relative Colorimetric, <span style="font-weight: bold;">s</span> to set Saturation, and <span style="font-weight: bold;">a</span> to - set Absolute colorimetric.<br> + set Absolute colorimetric. Some CMM's will use this to determine the + default intent that they will use.<br> <br> <a name="q"></a> The <b>-q</b> parameter sets the level of effort and/or detail in the resulting profile. For table based profiles @@ -1736,6 +1820,10 @@ the + + + + device and CIE/spectral sample data and calibration curves used to create a profile is stored in the <span style="font-weight: bold;">'targ'</span> text tag in the resulting ICC profile. To suppress this and make the @@ -1772,6 +1860,10 @@ the + + + + </span>flag. <span style="font-weight: bold;">Note</span> that this will then preclude final calibrated device value ink limits from being computed for the resulting profile in subsequent use (ie. <a @@ -1843,6 +1935,10 @@ the + + + + | _______ enle<br> @@ -1879,6 +1975,10 @@ the + + + + | /<br> @@ -1914,6 +2014,10 @@ the + + + + | /<br> @@ -1949,6 +2053,10 @@ the + + + + | /<br> @@ -1984,6 +2092,10 @@ the + + + + | /<br> stle | ------/<br> @@ -2027,6 +2139,10 @@ White &nb + + + + Black<br> </tt> <br> For minimum sensitivity of printed output to the lighting spectrum, @@ -2286,6 +2402,10 @@ White &nb + + + + Violet</span> spectral content, otherwise FWA compensation won't work properly. This means you ideally need to measure your illuminant spectrum using an instrument that can measure down to @@ -2428,31 +2548,54 @@ White &nb <br> <a name="S"></a><a name="s"></a><span style="font-weight: bold;">-s -S </span>In order to generate perceptual and saturation - intent B2A tables for output profiles, it is necessary to specify at - least one profile to define what source gamut should be used in the - source to destination gamut mapping. [For more information on <span + intent B2A tables for output profiles, it is necessary to have + something that defines what source gamut should be used to create + the source to destination gamut mapping. [For more information on <span style="text-decoration: underline;">why</span> a source gamut is needed, see <a href="iccgamutmapping.html">About ICC profiles and - Gamut Mapping</a>] The <b>-S</b> parameter is used to do this, - and doing so causes perceptual and saturation tables to be + Gamut Mapping</a>]. The <b>-S</b> parameter is used to do + this, and doing so causes perceptual and saturation tables to be generated. If only a perceptual intent is needed, then the <b>-s</b> flag can be used, and the saturation intent will use the same table - as the perceptual intent. Note that a input, output, display or - device colororspace profile should be specified, not a non-device - colorspace, device link, abstract or named color profile.<br> - If no source gamut is specified for a cLUT Display profile, then an - ICC Version 2.2.0 profile will be created with only an A2B0 and B2A0 - tag. If a source gamut is specified, then an ICC Version 2.4.0 - profile will be created with a full complement of B2A tags to - support all intents. The source gamut is created from the - corresponding intent table of the provided profile to the output - table being created. A TIFF or JPEG file containing an embedded ICC - profile may be supplied as the argument.<br> + as the perceptual intent.<br> + <br> + There are two ways of specifying a source gamut 1) Specify a + specific source ICC profile or 2) Specify a general compression of + the output gamut as a percentage. With the second choice, incoming + colors that are up to the percentage outside the devices gamut will + be compressed to fit into it. The same percentage is used for + expansion if a saturation table is generated, or a separate + percentage can be specified by including both a <b>-s</b> and <b>-S</b> + percentage. You can optionally specify <u>both</u> and input ICC + profile and a general compression percentage by using the -S option + twice, in which case the input profile determines just the luminance + range mapping, with the percentage determining the gamut volume + compression. If a percentage compression is specified without an ICC + profile, then the incoming luminance range will be assumed to be + full range (perfect white to perfect black), which is compatible + with idealized colorspaces such as sRGB, AdobeRGB and other working + RGB spaces. The input viewing conditions are applicable to the + assumed full range input.<br> + <br> + If no source ICC or compression percentage is specified for a cLUT + Display profile, then an ICC Version 2.2.0 profile will be created + with only an A2B0 and B2A0 tag. If a source gamut is specified, then + an ICC Version 2.4.0 profile will be created with a full complement + of B2A tags to support all intents.<br> + <br> + The source gamut is created from the corresponding intent table of + the provided profile to the output table being created. A TIFF or + JPEG file containing an embedded ICC profile may be supplied as the + argument, instead of an ICC profile.<br> + <br> <span style="font-weight: bold;">Note</span> that input profiles and matrix profiles will only contain a colorimetric intent table or matrix, and hence the <span style="font-weight: bold;">-s</span> and <span style="font-weight: bold;">-S</span> option is not relevant.<br> + <b>Note</b> that an input, output, display or device colororspace + profile should be specified, not a non-device colorspace, device + link, abstract or named color profile.<br> <br> <a name="nP"></a><span style="font-weight: bold;">-nP</span>: Normally when a source profile is provided to define the source @@ -2499,7 +2642,9 @@ White &nb space should be Jab appearance space, with the viewing conditions generally being those of the input profile viewing conditions. The input profile will normally be the one used to create a source image - gamut using <span style="font-weight: bold;">tiffgamut</span>.<br> + gamut using <span style="font-weight: bold;">tiffgamut</span>. Note + that a source gamut is not used if a general compression ratio gamut + mapping is used.<br> <br> <b><a name="p"></a></b>The <b>-p</b> option allows specifying one or more abstract profiles that will be applied to the output tables, |