summaryrefslogtreecommitdiff
path: root/doc/colprof.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/colprof.html')
-rw-r--r--doc/colprof.html341
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&nbsp;<a href="File_Formats.html#ICC">ICC</a> profile from
- the&nbsp;<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&nbsp;<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>
&nbsp;<tt><small>colprof [-<i>options</i>] inoutfile<br>
&nbsp;<a href="#v">-v</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -48,6 +50,10 @@
+
+
+
+
&nbsp; &nbsp; &nbsp; &nbsp; Verbose mode<br>
&nbsp;<a href="#A">-A "manufacturer"</a>&nbsp; Set the
manufacturer description string<br>
@@ -86,6 +92,10 @@
+
+
+
+
&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Default
intent: Perceptual, Rel. Colorimetric, Saturation, Abs.
Colorimetric</small></tt><tt><br>
@@ -129,6 +139,10 @@
+
+
+
+
&nbsp; &nbsp; &nbsp; &nbsp; Don't create input (Device) shaper
curves<br>
</small></tt><tt><small>&nbsp;<a href="#np">-np</a>
@@ -168,6 +182,10 @@
+
+
+
+
&nbsp; &nbsp; &nbsp; &nbsp; Don't create output (PCS) shaper
curves<br>
</small></tt><tt><small>&nbsp;<a href="#nc">-nc</a>
@@ -221,6 +239,10 @@ x
+
+
+
+
max K, r = ramp K<br>
&nbsp;<a href="#kp">-k p stle stpo enpo enle shape</a><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -267,6 +289,10 @@ White
+
+
+
+
- 1.0<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
@@ -313,6 +339,10 @@ Wh
+
+
+
+
0.0 - Bk 1.0<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
@@ -359,6 +389,10 @@ Wh
+
+
+
+
0.0 - Bk 1.0<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
@@ -404,6 +438,10 @@ Black
+
+
+
+
0.0 - 1.0<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
@@ -450,6 +488,10 @@ concave,
+
+
+
+
1.0-2.0 convex<br>
&nbsp;<a href="#K">-K parameters</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -476,6 +518,10 @@ concave,
+
+
+
+
Same as -k, but target is K locus rather than K value itself<br>
&nbsp;<a href="#l">-l <i>tlimit</i></a>&nbsp;&nbsp; &nbsp;
&nbsp; &nbsp;&nbsp; override CMYK total ink limit, 0 - 400%
@@ -529,6 +575,10 @@ cLUT
+
+
+
+
x = XYZ cLUT, X = display XYZ cLUT + matrix<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
@@ -574,6 +624,10 @@ s
+
+
+
+
shaper+matrix, m = matrix only,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
@@ -620,6 +674,10 @@ S
+
+
+
+
single shaper+matrix<br>
&nbsp;<a href="#u">-u</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
@@ -651,6 +709,10 @@ S
+
+
+
+
If input profile, auto scale WP to allow extrapolation</small></tt><tt><br>
</tt><tt> </tt><tt><small><small>&nbsp;<a href="#uc">-uc</a>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp; &nbsp;
@@ -699,6 +761,10 @@ and
+
+
+
+
primaries to be +ve</tt><tt><br>
&nbsp;<a href="#B">-B X,Y,Z</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -709,6 +775,10 @@ and
+
+
+
+
Display Black Point override hack<br>
&nbsp;<a href="#V">-V demphasis</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -725,6 +795,10 @@ and
+
+
+
+
Degree of dark region cLUT grid emphasis 1.0-3.0 (default 1.00 =
none)<br>
</tt><tt>&nbsp;</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>&nbsp;<a href="#i">-i <i>illum</i></a>&nbsp;&nbsp;
@@ -780,6 +858,10 @@ and
+
+
+
+
&nbsp; &nbsp; &nbsp; &nbsp; Choose illuminant for
computation of CIE XYZ from spectral data &amp; FWA:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -816,6 +898,10 @@ D50M2,
+
+
+
+
D65, F5, F8, F10 or file.sp</small></small></small><br>
&nbsp;<a href="#o">-o <i>observ</i></a>&nbsp; &nbsp; &nbsp;
&nbsp; &nbsp; Choose CIE Observer for spectral data:<br>
@@ -853,82 +939,22 @@ D50M2,
+
+
+
+
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 1931_2 </small></tt><tt><small>(def.)</small></tt><tt><small>,
1964_10, S&amp;B 1955_2, shaw, J&amp;V 1978_2<br>
&nbsp;<a href="#r">-r avgdev</a> &nbsp; &nbsp; &nbsp;
&nbsp;&nbsp; Average deviation of device+instrument readings as
a percentage (default 0.5%)<br>
- &nbsp;<a href="#s">-s src.icc</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Apply
-gamut
-mapping
-to
-output
-profile
-perceptual
-B2A
-table
-for
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- given source<br>
- &nbsp;<a href="#S">-S src.icc</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+ &nbsp;<a href="#s">-s src.icm|cperc</a> &nbsp; Apply gamut
+ mapping to output profile perceptual B2A table for given source,
+ or compression percentage<br>
+ &nbsp;<a href="#S">-S src.icm|experc</a>&nbsp; Apply gamut
+ mapping to output profile perceptual and saturation B2A table,
+ or expansion percentage<br>
+ &nbsp;<a href="#nP">-nP</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -937,9 +963,6 @@ for
- Apply gamut mapping to output profile perceptual and saturation
- B2A table<br>
- &nbsp;<a href="#nP">-nP</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -969,13 +992,13 @@ for
+ Use colormetric source gamut to make output profile perceptual
+ table<br>
+ &nbsp;<a href="#nS">-nS</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- Use colormetric source gamut to make output profile perceptual
- table<br>
- &nbsp;<a href="#nS">-nS</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1053,6 +1076,10 @@ for
+
+
+
+
Override gamut mapping intent for output profile saturation
table:<br>
</small></tt><tt><small> &nbsp; &nbsp; &nbsp;
@@ -1105,9 +1132,17 @@ for
+
+
+
+
pa - Perceptual Appearance</small></tt><br>
<tt><tt><small>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
lp - Luminance Preserving Perceptual</small></tt><br>
</tt><tt> </tt><tt><small>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1143,6 +1178,10 @@ for
+
+
+
+
&nbsp; &nbsp;&nbsp; &nbsp;&nbsp;&nbsp; ms - Saturation<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;
&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; s - Enhanced Saturation [ICC
@@ -1171,6 +1210,10 @@ for
+
+
+
+
rl - White Point Matched Colorimetric (Lab)<br>
&nbsp;<a href="#c">-c viewcond</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1206,6 +1249,10 @@ for
+
+
+
+
set input viewing conditions for output profile CIECAM02 gamut
mapping,<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1242,6 +1289,10 @@ for
+
+
+
+
either an enumerated choice, or a parameter<br>
&nbsp;<a href="#d">-d viewcond</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1277,6 +1328,10 @@ for
+
+
+
+
set output viewing conditions for output profile CIECAM02, gamut
mapping<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1313,6 +1368,10 @@ for
+
+
+
+
either an enumerated choice, or a parameter:value change<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1348,6 +1407,10 @@ for
+
+
+
+
Also sets out of gamut clipping CAM space.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1383,6 +1446,10 @@ for
+
+
+
+
Enumerated Viewing Conditions:<br>
</small></tt><tt><small>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
&nbsp;&nbsp; &nbsp; pp - Practical Reflection Print (ISO-3664
@@ -1447,6 +1514,10 @@ for
+
+
+
+
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp; c = transparency (default average)<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
@@ -1495,6 +1566,10 @@ for
+
+
+
+
g:glare&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 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>&nbsp;<a href="#O">-O outputfile</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Override
@@ -1580,6 +1659,10 @@ Override
+
+
+
+
the default output filename &amp; extension.</small></tt><tt><br>
</tt><tt> </tt><tt><small>&nbsp;<a href="#p1"><i>inoutfile</i></a>
&nbsp;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; 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
+
+
+
+
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp; &nbsp;
&nbsp;_______&nbsp; enle<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1879,6 +1975,10 @@ the
+
+
+
+
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp; &nbsp; &nbsp;/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1914,6 +2014,10 @@ the
+
+
+
+
|&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp; &nbsp; /<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1949,6 +2053,10 @@ the
+
+
+
+
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp; &nbsp;/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1984,6 +2092,10 @@ the
+
+
+
+
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp; /<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
stle&nbsp; | ------/<br>
@@ -2027,6 +2139,10 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
+
+
Black<br>
</tt> <br>
For minimum sensitivity of printed output to the lighting spectrum,
@@ -2286,6 +2402,10 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
<br>
<a name="S"></a><a name="s"></a><span style="font-weight: bold;">-s
-S&nbsp; </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>].&nbsp; 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&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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,