summaryrefslogtreecommitdiff
path: root/doc/collink.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/collink.html')
-rw-r--r--doc/collink.html1019
1 files changed, 919 insertions, 100 deletions
diff --git a/doc/collink.html b/doc/collink.html
index 778b682..edd58b1 100644
--- a/doc/collink.html
+++ b/doc/collink.html
@@ -3,7 +3,7 @@
<head>
<title>collink</title>
<meta http-equiv="content-type" content="text/html;
- charset=ISO-8859-1">
+ charset=windows-1252">
<meta name="author" content="Graeme Gill">
</head>
<body>
@@ -51,6 +51,15 @@
+
+
+
+
+
+
+
+
+
Verbose<br>
</span></small><small><span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#A">-A "manufacturer"</a><span
@@ -105,6 +114,15 @@ existing
+
+
+
+
+
+
+
+
+
profile, rather than link (Debug option)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -143,6 +161,15 @@ clut
+
+
+
+
+
+
+
+
+
res. set by -q</span><br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#n">-n</a><span
@@ -175,6 +202,15 @@ preserve
+
+
+
+
+
+
+
+
+
device curves in result</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -232,6 +268,15 @@ Include
+
+
+
+
+
+
+
+
+
abstract profile in link</span></small><br>
<small><span style="font-family: monospace;"><small><span
style="font-family: monospace;">&nbsp;</span><a
@@ -242,6 +287,15 @@ Include
&nbsp;<a href="H">-H file.cal</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
Append calibration curves to 3dlut<br style="font-family:
monospace;">
</span> <span style="font-family: monospace;">&nbsp;</span><a
@@ -275,6 +329,15 @@ Mode
+
+
+
+
+
+
+
+
+
(default)</span><br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#g">-g [src.gam]</a><span
@@ -311,6 +374,15 @@ Gamut
+
+
+
+
+
+
+
+
+
Mapping Mode using inverse outprofile A2B [optional source
gamut]</span><br style="font-family: monospace;">
<br style="font-family: monospace;">
@@ -351,6 +423,15 @@ s
+
+
+
+
+
+
+
+
+
= saturation, a = absolute colorimetric</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -388,6 +469,15 @@ s
+
+
+
+
+
+
+
+
+
= saturation, a = absolute colorimetric</span><br
style="font-family: monospace;">
<br style="font-family: monospace;">
@@ -428,6 +518,15 @@ a
+
+
+
+
+
+
+
+
+
Absolute Colorimetric (in Jab) [ICC Absolute Colorimetric]<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
aw
@@ -458,6 +557,15 @@ aw
+
+
+
+
+
+
+
+
+
Absolute Colorimetric (in Jab) with scaling to fit white point<br
style="font-family: monospace;">
</span><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -489,6 +597,15 @@ aa
+
+
+
+
+
+
+
+
+
Absolute Appearance</span><br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
r
@@ -519,6 +636,15 @@ r
+
+
+
+
+
+
+
+
+
White Point Matched Appearance [ICC 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;
@@ -550,6 +676,15 @@ la
+
+
+
+
+
+
+
+
+
Luminance matched Appearance</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -581,6 +716,15 @@ p
+
+
+
+
+
+
+
+
+
Perceptual (Preferred) [ICC Perceptual]<br>
</span></small><small><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
pa
@@ -610,6 +754,15 @@ pa
+
+
+
+
+
+
+
+
+
- Perceptual Appearance</span></small><br style="font-family:
monospace;">
<small><span style="font-family: monospace;"></span><span
@@ -642,6 +795,15 @@ ms
+
+
+
+
+
+
+
+
+
Saturation</span><br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
s
@@ -672,6 +834,15 @@ s
+
+
+
+
+
+
+
+
+
Enhanced Saturation [ICC Saturation]</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -703,6 +874,15 @@ al
+
+
+
+
+
+
+
+
+
Absolute Colorimetric (Lab)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -726,15 +906,32 @@ al
+
+
+
+
+
+
+
+
+
rl - White Point Matched Colorimetric (Lab)</span><span
style="font-family: monospace;"></span><br style="font-family:
monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#w">-w [J,a,b]</a><span
style="font-family: monospace;"> &nbsp;&nbsp;&nbsp; Use forced
- whitepoint hack [optional color to map the white to]</span><br
- style="font-family: monospace;">
- <span style="font-family: monospace;">&nbsp;</span><a
+ whitepoint hack [optional color to map the white to]<br>
+ &nbsp;<a href="#b">-b</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+ Use RGB-&gt;RGB forced black point hack<br style="font-family:
+ monospace;">
+ </span> <span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#c">-c <i>viewcond</i></a><span
style="font-family: monospace;">&nbsp; &nbsp; set source viewing
conditions for CIECAM02,</span><br style="font-family:
@@ -768,6 +965,15 @@ either
+
+
+
+
+
+
+
+
+
an enumerated choice, or a parameter</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -804,6 +1010,15 @@ either
+
+
+
+
+
+
+
+
+
an enumerated choice, or a parameter:value change<br>
</span></small><small><span style="font-family: monospace;">&nbsp;
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; pp - Practical
@@ -838,6 +1053,15 @@ either
+
+
+
+
+
+
+
+
+
&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;
@@ -868,6 +1092,15 @@ either
+
+
+
+
+
+
+
+
+
&nbsp; pc - Critical print evaluation environment (ISO-3664 P1)</span></small><small><span
style="font-family: monospace;"></span><span style="font-family:
monospace;"></span><span style="font-family: monospace;"></span><span
@@ -906,6 +1139,15 @@ either
+
+
+
+
+
+
+
+
+
mb - Monitor in bright work environment</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; &nbsp;
@@ -955,6 +1197,15 @@ 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;
@@ -986,6 +1237,15 @@ n
+
+
+
+
+
+
+
+
+
c = transparency (default average)</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1017,6 +1277,15 @@ 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;&nbsp;
@@ -1048,6 +1317,15 @@ 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;&nbsp;
a:adaptation&nbsp;
@@ -1078,6 +1356,15 @@ Adaptatation
+
+
+
+
+
+
+
+
+
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;&nbsp;
@@ -1110,6 +1397,15 @@ Background
+
+
+
+
+
+
+
+
+
of image luminance (default 20)<br>
&nbsp;&nbsp;&nbsp; &nbsp;&nbsp; &nbsp;&nbsp; l:imagewhite&nbsp;
Image white in cd.m^2 if surround = auto (default 250)</span></small><br
@@ -1145,6 +1441,15 @@ light
+
+
+
+
+
+
+
+
+
% of image luminance (default 0)<br>
</span></small>&nbsp;</span><span style="font-family:
monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1166,6 +1471,15 @@ light
+
+
+
+
+
+
+
+
+
g:X:Y:Z&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Glare 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;&nbsp;
@@ -1184,6 +1498,15 @@ light
+
+
+
+
+
+
+
+
+
g:x:y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Glare
color as x, y</span><br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -1217,6 +1540,15 @@ source
+
+
+
+
+
+
+
+
+
total ink limit, 0 - 400% (estimate by default)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -1250,6 +1582,15 @@ source
+
+
+
+
+
+
+
+
+
total ink limit, 0 - 100% (estimate by default)</span><br
style="font-family: monospace;">
<br style="font-family: monospace;">
@@ -1290,6 +1631,15 @@ t
+
+
+
+
+
+
+
+
+
= transfer K from source to destination, e = retain K of
destination B2A table</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;
@@ -1321,6 +1671,15 @@ z
+
+
+
+
+
+
+
+
+
= zero K, h = 0.5 K, x = maximum K, r = ramp K (default)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -1355,6 +1714,15 @@ p
+
+
+
+
+
+
+
+
+
= black level generation curve parameters</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -1390,6 +1758,15 @@ q
+
+
+
+
+
+
+
+
+
= transfer source K to dual curve limits</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -1428,6 +1805,15 @@ destination
+
+
+
+
+
+
+
+
+
total ink limit, 0 - 400% (estimate by default)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -1461,6 +1847,15 @@ destination
+
+
+
+
+
+
+
+
+
total ink limit, 0 - 100% (estimate by default)<br>
&nbsp;<a href="#3">-3 flag</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1483,6 +1878,15 @@ destination
+
+
+
+
+
+
+
+
+
Create "3DLut" output file as well as devlink<br>
&nbsp;&nbsp;&nbsp;&nbsp;
e&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1506,6 +1910,15 @@ destination
+
+
+
+
+
+
+
+
+
eeColor .txt file</span></small><br>
<tt>&nbsp;&nbsp;&nbsp;&nbsp;
m&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1517,9 +1930,17 @@ destination
+
+
+
+
+
+
+
+
+
MadVR .3dlut&nbsp;&nbsp; file</tt><br>
- <small><span style="font-family: monospace;"><small><span
- style="font-family: monospace;">&nbsp;<a href="#Ib">-I b</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ <tt>&nbsp;<a href="#Ib">-I B</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1527,6 +1948,23 @@ destination
+ Use BT.1886 source EOTF with technical gamma 2.4</tt><tt><br>
+ </tt><tt>&nbsp;<a href="#Ib">-I b:g.g</a>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Use
+ BT.1886-like source EOTF with effective gamma g.g</tt><tt><br>
+ &nbsp;</tt><tt><a href="#Ib">-I b:p.p:g.g</a>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Use effective gamma g.g source EOTF
+ with p.p prop. output black point offset</tt><small><span
+ style="font-family: monospace;"><small><span style="font-family:
+ monospace;"></span></small></span></small><br>
+ <small><span style="font-family: monospace;"><small><span
+ style="font-family: monospace;"><tt>&nbsp;<a
+ href="file:///D:/src/argyll/doc/collink.html#Ib">-I
+ g:g.g</a>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Use
+ effective gamma g.g source EOTF with all output black
+ point offset</tt><br>
+ </span></small>&nbsp;<a href="#e">-e flag</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1540,10 +1978,6 @@ destination
- Apply BT.1886-like mapping with effective gamma 2.2 to input</span></small><br>
- <small><span style="font-family: monospace;"><small><span
- style="font-family: monospace;">&nbsp;<a href="#Ib">-I
- b:g.g</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1557,13 +1991,11 @@ destination
- Apply BT.1886-like mapping with effective gamma g.g to
- input<br>
- </span></small></span></small>&nbsp;<a href="#IB">-I B</a>
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ Video encode input as:<br>
+ &nbsp;<a href="#E">-E flag</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1574,9 +2006,6 @@ destination
- Apply BT.1886 mapping with technical gamma 2.4 to input</span></small><br>
- <small><span style="font-family: monospace;"><small><span
- style="font-family: monospace;">&nbsp;<a href="#IB">-I B:g.g</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1590,14 +2019,17 @@ destination
- Apply BT.1886-like mapping with technical gamma g.g to input<br>
- </span></small>&nbsp;<a href="#e">-e flag</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ Video encode output as:</span></small><small><span
+ style="font-family: monospace;"><small><span style="font-family:
+ monospace;"><br>
+ &nbsp;&nbsp;&nbsp;&nbsp;
+ n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1612,12 +2044,13 @@ destination
- Video encode input as:<br>
- &nbsp;<a href="#E">-E flag</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ normal RGB 0..1 levels (default)<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;
+ t&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1634,13 +2067,15 @@ destination
- Video encode output as:</span></small><small><span
- style="font-family: monospace;"><small><span style="font-family:
- monospace;"><br>
- &nbsp;&nbsp;&nbsp;&nbsp;
- n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ RGB (16-235)/255 "TV" levels</span></small></span></small><br>
+ <small><span style="font-family: monospace;"><small><span
+ style="font-family: monospace;"><small><span
+ style="font-family: monospace;"><small><span
+ style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;
+ T
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1648,9 +2083,6 @@ destination
- normal RGB 0..1 levels (default)<br>
- &nbsp;&nbsp;&nbsp;&nbsp;
- t&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1660,7 +2092,9 @@ destination
- RGB (16-235)/255 "TV" levels<br>
+
+
+ RGB (16-235)/255 "TV" levels, clip WTW [Input Only]</span></small></span></small><br>
&nbsp;&nbsp;&nbsp;&nbsp;
6&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1672,6 +2106,15 @@ destination
+
+
+
+
+
+
+
+
+
Rec601 YCbCr SD (16-235,240)/255 "TV" levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
7&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1684,6 +2127,15 @@ destination
+
+
+
+
+
+
+
+
+
Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
5&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1696,6 +2148,15 @@ destination
+
+
+
+
+
+
+
+
+
Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1708,6 +2169,15 @@ destination
+
+
+
+
+
+
+
+
+
Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
C&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1720,6 +2190,15 @@ destination
+
+
+
+
+
+
+
+
+
Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV"
levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1733,6 +2212,15 @@ destination
+
+
+
+
+
+
+
+
+
xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV"
levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
@@ -1746,6 +2234,15 @@ destination
+
+
+
+
+
+
+
+
+
xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV"
levels<br>
</span></small>&nbsp;</span></small>&nbsp; <small><span
@@ -1779,7 +2276,16 @@ gamut
- gammap_p.wrl and gammap_s.wrl diagostics</span></small><small><br>
+
+
+
+
+
+
+
+
+
+ gammap_p.x3d.html and gammap_s.x3d.html diagostics</span></small><small><br>
<span style="font-family: monospace;"></span></small><span
style="font-family: monospace;">&nbsp;<span
style="text-decoration: underline;"><span style="font-style:
@@ -1814,6 +2320,15 @@ ICC
+
+
+
+
+
+
+
+
+
profile. A </span><small><span style="font-family: monospace;">TIFF
@@ -1841,6 +2356,15 @@ ICC
+
+
+
+
+
+
+
+
+
or JPEG file with embedded profile may be used here.</span></small><br
style="font-family: monospace;">
&nbsp; <span style="font-family: monospace;"><span
@@ -1876,6 +2400,15 @@ ICC
+
+
+
+
+
+
+
+
+
profile. </span><span style="font-family: monospace;">A </span><small><span
style="font-family: monospace;">TIFF or JPEG file with embedded
profile may be used here.</span></small><br style="font-family:
@@ -1972,6 +2505,15 @@ ICC
+
+
+
+
+
+
+
+
+
&nbsp;Override clut res. set by <b>-q</b><br>
<br>
This sets the basic quality of the resulting link, by choosing the
@@ -2108,26 +2650,22 @@ ICC
the <a href="tiffgamut.html"> tiffgamut</a> tool. More <a
href="#GG">details</a> about the gamut mapping, inverse AtoB mode.<br>
<br>
- The gamut provided to the <span style="font-weight: bold;">-g</span>
- or <span style="font-weight: bold;">-G</span> flag should be in the
- same colorspace that <span style="font-weight: bold;">collink</span>
- is using internally to connect the two profiles. For all intents
- except the last one (no. <span style="font-weight: bold;">7</span>),
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+ <a name="Gp"></a>The gamut provided to the <span
+ style="font-weight: bold;">-g</span> or <span style="font-weight:
+ bold;">-G</span> flag should be in the same colorspace that <span
+ style="font-weight: bold;">collink</span> is using internally to
+ connect the two profiles. For all intents except the last one (no. <span
+ style="font-weight: bold;">7</span>), the space should be Jab
+ appearance space, with the viewing conditions generally being those
+ of the source profile viewing conditions. The source profile will
+ normally be the one used to create a source image gamut using <span
+ style="font-weight: bold;">tiffgamut</span>.<br>
+ &nbsp;<br>
+ <u><a name="ss"></a> Simple mode gamut mapping options:</u><br>
+ <br>
+ <a name="si"></a> &nbsp;&nbsp; &nbsp;&nbsp; <b>-i</b> <i>in_intent</i>&nbsp;
+&nbsp;
+&nbsp;
@@ -2139,18 +2677,6 @@ ICC
- the space should be Jab appearance space, with the viewing
- conditions generally being those of the source profile viewing
- conditions. The source profile will normally be the one used to
- create a source image gamut using <span style="font-weight: bold;">tiffgamut</span>.<br>
- &nbsp;<br>
- <u><a name="ss"></a> Simple mode gamut mapping options:</u><br>
- <br>
- <a name="si"></a> &nbsp;&nbsp; &nbsp;&nbsp; <b>-i</b> <i>in_intent</i>&nbsp;
-&nbsp;
-&nbsp;
-
-
@@ -2307,6 +2833,13 @@ ICC
in fine tuning paper emulation in absolute colorimetric mapping
mode.<br>
<br>
+ <a name="b"></a> The <b>-b</b> flag forces RGB source 0,0,0 to map
+ to RGB destination 0,0,0. This may be useful for Video
+ proofing/calibration purposes, where the source is a standard
+ colorspace such as Rec709, and the display device is well behaved
+ with black at 0,0,0. By forcing the black mapping, any slight
+ raising of the black due to display profile tolerances is avoided.<br>
+ <br>
<a name="c"></a><a name="d"></a> The <b>-c</b> and <b>-d</b>
options allow specification of the viewing conditions for the source
and destination colorspaces respectively. The viewing condition
@@ -2415,6 +2948,15 @@ ICC
+
+
+
+
+
+
+
+
+
&nbsp; &nbsp;_______&nbsp; enle<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2445,6 +2987,15 @@ ICC
+
+
+
+
+
+
+
+
+
&nbsp; &nbsp;/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
|&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2475,6 +3026,15 @@ ICC
+
+
+
+
+
+
+
+
+
&nbsp; /<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2505,6 +3065,15 @@ ICC
+
+
+
+
+
+
+
+
+
&nbsp;/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2535,6 +3104,15 @@ ICC
+
+
+
+
+
+
+
+
+
/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
stle&nbsp; | ------/<br>
@@ -2571,6 +3149,15 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
+
+
+
+
+
+
+
Black<br>
<br>
</tt>For minimum sensitivity of printed output to the lighting
@@ -2698,15 +3285,78 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
There is more information on the <a href="Scenarios.html">Typical
Usage Scenarios</a> page.<br>
<b><br>
- <a name="Ib"></a></b>The <b>-I b</b> flag applies extra input
- processing, applying <a
- href="http://www.itu.int/rec/R-REC-BT.1886-0-201103-I">BT.1886</a>-like
+ <a name="Ib"></a></b>The <b>-I [b|B|g|G][:p.p][:g.g]</b> series
+ of options, substitutes an alternative EOTF (Electro-Optical
+ Transfer Function) for the one specified by the matrix input
+ profile. This is typically used for creating Video display
+ emulations.<br>
+ <br>
+ The basic curve is a pure power curve with scaling and a combination
+ of input black offset and/or output black offset. The choice of flag
+ determines the way the power value is interpreted, and the default
+ balance between input and output black offset handling.<br>
+ <br>
+ The lower case <b>b</b> and <b>g</b> flags use an effective power
+ value specification, where the 50% input maps to the same output
+ value as a pure power curve with a perfect black. These are the
+ recommended flags to use, since this means that the overall contrast
+ of the reproduction will not be affected so much by differences and
+ variations in the black level, or how the black level is accounted
+ for. The default effective power value is 2.2.<br>
+ <br>
+ The upper case <b>B</b> and <b>G</b> flags use a technical power
+ value specification, where the power value is the actual one that
+ will be used. The end result will vary much more with the black
+ level of the display though. The default technical power value is
+ 2.4.<br>
+ <br>
+ The <b>b</b> and <b>B</b> flags default to the black level being
+ accounted for as a full input offset, where the power curve is
+ shifted and scaled to match the black point, preserving the black
+ shadow tonality. This is what <a
+ href="http://www.itu.int/rec/R-REC-BT.1886-0-201103-I">BT.1886</a>
+ uses.<br>
+ <br>
+ The <b>g</b> and <b>G</b> flags default to the black level being
+ accounted for as a full output offset, where the power curve is
+ scaled to allow for the black point, losing some black shadow
+ tonality with higher black points. This is what many people think of
+ as a "pure" power curve, even though this is not possible unless the
+ display has a perfect zero black level.<br>
+ <br>
+ The optional <b>:g.g</b> value is the power to be used. This will
+ be an effective value if the <b>b</b> or <b>g</b> flags is used,
+ or the technical value if the <b>B</b> or <b>G</b> flag is used.
+ This is the primary way to make an allowance for the brightness of
+ the viewing environment for Video . Darker viewing environments
+ probably need a larger gamma value, while lighter viewing
+ environments probably need a lower value.<br>
+ <br>
+ The second optional <b>:p.p</b> value is the proportion of black
+ value that should be accounted for as output offset (the gamma value
+ must also be specified after this). This defaults to 0.0 for the <b>b</b>
+ and <b>B</b> flags, and 1.0 for the <b>g</b> and <b>G</b> flags,
+ but by specifying it explicitly as a value between 0.0 and 1.0, a
+ hybrid curve characteristic can be obtained. Setting a hybrid value
+ is a way of maintaining black shadow tonality while being able to
+ control how much detail is retained in those shadows. An appropriate
+ value may depend on exactly how the video material was mastered.<br>
+ <br>
+ Illustrative combinations are:<br>
+ <br>
+ <b>-I b</b><b>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </b>Full
+ input offset (BT.1886 like) with effective gamma of 2.2<b><br>
+ </b><b>-I g</b><b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+ </b>Full output offset with effective gamma of 2.2<b><br>
+ </b><b></b><b>-I B</b><b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2714,41 +3364,107 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
- video gamma mapping using an effective gamma of 2.2 by default, and
- overridable using <b>-I b:g.g</b> where <b>g.g</b> is the gamma.
- The gamma is an effective gamma, meaning that its effect on 50%
- input is the same as that of a pure power curve, in spite of any
- black offset added by BT.1886. This has the benefit of making the
- overall effect of brightness independent of the black level of the
- display. Setting an effective gamma other than 2.2 is one way of
- making the viewing condition adjustment for the different conditions
- of video encoding and decoding, or for modelling the source
- colorspace as a rendering on a video display. This would be used as
- an alternative to using gamut mapping mode and setting explicit
- input and output viewing conditions, or in combination with
- appearance adjustments. BT.1886 will only work with matrix type
- input profiles. The default value of 2.2 is probably suitable for
- dim viewing conditions, and it may be desirable to override this
- default if your viewing conditions are darker or lighter. For
- lighter conditions, try "-I b:2.2". For darker conditions, try "-I
- b:2.6".<br>
+ </b>Full input offset (BT.1886 like) with technical gamma of 2.4.
+ This exactly implements the BT.1886 specification.<b><br>
+ </b><b>-I G</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+ Full output offset with technical gamma of 2.2<br>
<br>
- <b><a name="IB"></a></b>The <b>-I B</b> flag applies extra input
- processing, applying <a
- href="http://www.itu.int/rec/R-REC-BT.1886-0-201103-I">BT.1886</a>
- video gamma mapping using the BT.1886 gamma of 2.4 by default, and
- overridable using <b>-I b:g.g</b> where <b>g.g</b> is the gamma.
- The gamma is the technical gamma, or power applied to the input
- image, and this means that its effect on 50% input will depend on
- the black level of the display, making the overall brightness
- somewhat unpredictable. For a more predictable effect, use <b>-I b</b>.<br>
+ <b>-I b</b><b>:2.3</b><b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+ </b>Full input offset (BT.1886 like) with effective gamma of 2.3<b>
+ <br>
+ </b><b> -I g:2.3</b><b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+ </b>Full output offset with effective gamma of 2.3<b><br>
+ </b><b> -I B:2.35</b><b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+ </b>Full input offset (BT.1886 like) with technical gamma of 2.35<br>
+ <b> -I G:2.35</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+ Full output offset with technical gamma of 2.35<br>
+ <br>
+ <b>-I b</b><b>:0.4:2.3</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ 60% input offset, 40% output offset with effective gamma of 2.3<b></b><br>
+ <b> -I g:0.4:2.3</b><b>&nbsp;</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+ Same as above.<b><br>
+ </b><b> -I B:0.4:2.35</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 60% input
+ offset, 40% output offset with technical gamma of 2.35 <b><br>
+ </b><b> -I G:0.4:2.35</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Same as
+ above.<br>
<b><br>
<a name="e"></a></b>The <b>-e</b> <i>flag</i> applies a Video
encoding to the input. See below<b> and</b> <a href="#E"><b>-E</b></a>
for the list of encodings.<br>
<br>
+ <br>
<small><span style="font-family: monospace;"><small><span
- style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;
+ style="font-family: monospace;"><small><span
+ style="font-family: monospace;"><small><span
+ style="font-family: monospace;"><small><span
+ style="font-family: monospace;"><small><span
+ style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;
+ T
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ RGB (16-235)/255 "TV" levels, clip WTW
+ [Input Only]<br>
+ </span></small></span></small></span></small></span></small>&nbsp;&nbsp;&nbsp;&nbsp;
+
x&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2759,6 +3475,15 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
+
+
+
+
+
+
+
xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV"
levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2772,6 +3497,15 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
+
+
+
+
+
+
+
xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV"
levels</span></small></span></small><br>
<br>
@@ -2785,6 +3519,13 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
as UHD Rec2020, or Digital Cinema SMPTE431 P3, then the
corresponding ICC profile should be provided as the source profile.<br>
<br>
+ The <b>-e T</b> option uses the same encoding as <b>-e t</b>, but
+ rather than handling WTW (Whiter Than White, or out of range values)
+ using extrapolation, it clips them to the valid range. This can be
+ useful if you are dealing with source material that has WTW values,
+ but your TV or Video display clips these out of range values in a
+ way that alters the hue.<br>
+ <br>
<b><a name="E"></a></b>The <b>-E</b> <i>flag</i> applies a Video
encoding to the output. The possible encoding are:<br>
<br>
@@ -2800,6 +3541,15 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
+
+
+
+
+
+
+
normal RGB 0..1 full range levels (default)<br>
&nbsp;&nbsp;&nbsp;&nbsp;
t&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2812,8 +3562,22 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
- RGB (16-235)/255 "TV" levels<br>
- &nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+ RGB (16-235)/255 "TV" levels</span></small></span></small><small><span
+ style="font-family: monospace;"><small><span style="font-family:
+ monospace;"></span></small></span></small><br>
+ <small><span style="font-family: monospace;"><small><span
+ style="font-family: monospace;"><small><span
+ style="font-family: monospace;"></span></small>&nbsp;&nbsp;&nbsp;&nbsp;
+
6&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2824,6 +3588,15 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
+
+
+
+
+
+
+
Rec601 YCbCr SD (16-235,240)/255 "TV" levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
7&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2836,6 +3609,15 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
+
+
+
+
+
+
+
Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
5&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2848,6 +3630,15 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
+
+
+
+
+
+
+
Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
2&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2860,6 +3651,15 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
+
+
+
+
+
+
+
Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
C&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -2872,12 +3672,22 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
+
+
+
+
+
+
+
Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV"
- levels<br>
- </span></small></span></small><br>
- <br>
+ levels</span></small></span></small><br>
+ <small><span style="font-family: monospace;"><small><span
+ style="font-family: monospace;"></span></small></span></small><br>
+ The <b>T</b> <br>
<b><a name="P"></a></b>The <b>-P</b> option causes a diagnostic 3D
- <a href="File_Formats.html#VRML">VRML</a> plots to be created that
+ <a href="File_Formats.html#X3DOM">X3DOM</a> plots to be created that
illustrate the gamut mapping generated.<br>
<br>
<a name="p1"></a>The <i><b>inprofile</b></i> argument specifies the
@@ -2921,6 +3731,15 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
+
+
+
+
+
+
+
Usage Scenarios</a> page.<br>
<br>
<br>