summaryrefslogtreecommitdiff
path: root/doc/collink.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/collink.html')
-rw-r--r--doc/collink.html1945
1 files changed, 1911 insertions, 34 deletions
diff --git a/doc/collink.html b/doc/collink.html
index 0b94bc7..778b682 100644
--- a/doc/collink.html
+++ b/doc/collink.html
@@ -27,6 +27,30 @@
style="font-family: monospace;">                
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Verbose<br>
</span></small><small><span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#A">-A "manufacturer"</a><span
@@ -57,6 +81,30 @@ Verify
existing
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
profile, rather than link (Debug option)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -71,6 +119,30 @@ Override
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
@@ -79,6 +151,30 @@ Don't
preserve
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
device curves in result</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -112,15 +208,73 @@ preserve
Include
- abstract profile in link</span><br style="font-family:
- monospace;">
- <span style="font-family: monospace;">&nbsp;</span><a
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ abstract profile in link</span></small><br>
+ <small><span style="font-family: monospace;"><small><span
+ style="font-family: monospace;">&nbsp;</span><a
+ style="font-family: monospace;" href="#a">-a file.cal</a><span
+ style="font-family: monospace;">
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Apply calibration
+ curves</span></small> to link output and append linear<br>
+ &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
style="font-family: monospace;" href="#s">-s</a><span
style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Simple
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
@@ -133,6 +287,30 @@ Mode
Gamut
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Mapping Mode using inverse outprofile A2B [optional source
gamut]</span><br style="font-family: monospace;">
<br style="font-family: monospace;">
@@ -149,6 +327,30 @@ Gamut
s
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
= saturation, a = absolute colorimetric</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -162,6 +364,30 @@ s
s
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
= saturation, a = absolute colorimetric</span><br
style="font-family: monospace;">
<br style="font-family: monospace;">
@@ -178,12 +404,60 @@ a
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Absolute Colorimetric (in Jab) [ICC Absolute Colorimetric]<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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;
@@ -191,12 +465,60 @@ 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
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
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;
@@ -204,6 +526,30 @@ 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;
@@ -211,11 +557,59 @@ 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
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
- Perceptual Appearance</span></small><br style="font-family:
monospace;">
<small><span style="font-family: monospace;"></span><span
@@ -224,12 +618,60 @@ 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
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
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;
@@ -237,8 +679,56 @@ al
-
- Absolute Colorimetric (Lab)</span><span style="font-family:
- monospace;"></span><br style="font-family: monospace;">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Absolute Colorimetric (Lab)<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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
@@ -254,6 +744,30 @@ al
either
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
an enumerated choice, or a parameter</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -266,6 +780,30 @@ either
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
@@ -276,12 +814,60 @@ either
&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
&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;
&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
&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
@@ -296,6 +882,30 @@ either
&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
mb - Monitor in bright work environment</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; &nbsp;
@@ -321,6 +931,30 @@ s:surround
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;
@@ -328,6 +962,30 @@ n
&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
c = transparency (default average)</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -335,6 +993,30 @@ w:X:Y:Z&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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;
@@ -342,12 +1024,60 @@ w:x:y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
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;
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;
@@ -356,30 +1086,105 @@ Background
%
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
of image luminance (default 20)<br>
- &nbsp;&nbsp;&nbsp; &nbsp;&nbsp; &nbsp;&nbsp; l:scenewhite&nbsp;
- Scene white in cd.m^2 if surround = auto (default 250)<br
- style="font-family: monospace;">
- </span><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp; &nbsp;&nbsp; l:imagewhite&nbsp;
+ Image white in cd.m^2 if surround = auto (default 250)</span></small><br
+ style="font-family: monospace;">
+ <small><span style="font-family: monospace;"><small><span
+ style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
f:flare&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Flare
light
- % of image luminance (default 1)</span><br style="font-family:
- monospace;">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ % of image luminance (default 0)<br>
+ </span></small>&nbsp;</span><span style="font-family:
+ monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ g:glare&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Glare light % of
+ ambient (default 1)</span><br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-f:X:Y:Z&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Flare
- color as XYZ (default media white)</span><br style="font-family:
- monospace;">
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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;
-f:x:y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
-Flare
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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
style="font-family: monospace;" href="#t">-t <i>tlimit</i></a><span
@@ -388,6 +1193,30 @@ set
source
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
total ink limit, 0 - 400% (estimate by default)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -397,6 +1226,30 @@ set
source
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
total ink limit, 0 - 100% (estimate by default)</span><br
style="font-family: monospace;">
<br style="font-family: monospace;">
@@ -413,6 +1266,30 @@ source
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;
@@ -420,6 +1297,30 @@ t
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
@@ -430,6 +1331,30 @@ z
p
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
= black level generation curve parameters</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -441,6 +1366,30 @@ p
q
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
= transfer source K to dual curve limits</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -455,6 +1404,30 @@ set
destination
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
total ink limit, 0 - 400% (estimate by default)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -464,16 +1437,349 @@ set
destination
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
total ink limit, 0 - 100% (estimate by default)<br>
- </span></small>&nbsp;&nbsp;<small><span style="font-family:
- monospace;"><a href="#P">-P</a>
+ &nbsp;<a href="#3">-3 flag</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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 input as:<br>
+ &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;
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+ RGB (16-235)/255 "TV" levels<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;
+ 6&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+ Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV"
+ levels<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;
+ x&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+ xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV"
+ levels<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;
+ X&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+ xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV"
+ levels<br>
+ </span></small>&nbsp;</span></small>&nbsp; <small><span
+ style="font-family: monospace;"><a href="#P">-P</a>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Create
gamut
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
gammap_p.wrl and gammap_s.wrl diagostics</span></small><small><br>
- <br>
<span style="font-family: monospace;"></span></small><span
style="font-family: monospace;">&nbsp;<span
style="text-decoration: underline;"><span style="font-style:
@@ -484,9 +1790,57 @@ source
ICC
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
profile. 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: monospace;">
&nbsp; <span style="font-family: monospace;"><span
@@ -498,6 +1852,30 @@ destination
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:
@@ -570,6 +1948,30 @@ ICC
&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
&nbsp;Override clut res. set by <b>-q</b><br>
<br>
This sets the basic quality of the resulting link, by choosing the
@@ -644,13 +2046,28 @@ ICC
conflict with achieving a smooth mapping, warnings messages will be
emitted.<br>
<br>
- <a name="p"></a> The <b>-p</b> option alows specifying an abstract
- profile be applied between the source and destination profiles. An
- abstract profile is a way of specifying a color adjustment in a
- device independent way. The abstract profile might have been created
- using one of the <span style="font-weight: bold;">tweak</span>
+ <a name="p"></a> The <b>-p</b> parameter allows specifying an
+ abstract profile be applied between the source and destination
+ profiles. An abstract profile is a way of specifying a color
+ adjustment in a device independent way. The abstract profile might
+ have been created using one of the <span style="font-weight: bold;">tweak</span>
tools, such as <a href="refine.html">refine</a>.<br>
<br>
+ <a name="a"></a> The <b>-a</b> parameter causes calibration curves
+ in the supplied file to be applied after the link of the profiles.
+ This is used as an alternative to calibration curves being loaded
+ into the graphics card VideoLut. For MadVR 3dlut output, a linear
+ set of calibration curves will also be appended to the 3dlut,
+ ensuring that the correct VideoLUT curves get loaded at the time the
+ 3dLut is used by MadVR v0.86.9 or latter. By default no calibration
+ curves are appended to a MadVR 3dLut.<br>
+ <br>
+ <a name="H"></a> The <b>-H</b> parameter causes calibration curves
+ in the supplied file to be appended to a MadVR 3dlut output,
+ ensuring that the correct VideoLUT curves get loaded at the time the
+ 3dLut is used by MadVR v0.86.9 or latter. By default no calibration
+ curves are appended to a MadVR 3dLut.<br>
+ <br>
The basic linking style is chosen by using the <b>-s</b> (default),
<b>-g</b> or <b>-G</b> flags. The three behaviors are:<br>
<br>
@@ -698,6 +2115,30 @@ ICC
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
@@ -710,6 +2151,30 @@ ICC
&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
&nbsp;<b>p</b> = perceptual, <b>r</b> = relative colorimetric,<br>
&nbsp;&nbsp;&nbsp;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <b>s</b>
@@ -778,10 +2243,10 @@ ICC
<br>
<a name="ila"></a>The <span style="font-weight: bold;">la</span>
intent, Luminance matched appearance, linearly compresses or
- expands the the luminance axis to match the source to the
- destination space, while not otherwise altering the gamut,
- clipping any out of gamut colors to the closest match. This is
- often useful for appearance based soft proofing.<br>
+ expands the the luminance axis from white to black to match the
+ source to the destination space, while not otherwise altering the
+ gamut, clipping any out of gamut colors to the closest match. This
+ is often useful for appearance based soft proofing.<br>
<br>
<a name="ip"></a>The&nbsp; <span style="font-weight: bold;">p</span>
intent, Perceptual, uses "knee" type 3 Dimensional compression to
@@ -816,11 +2281,18 @@ ICC
The white point is mapped precisely from source to destination.<br>
<br>
<a name="ial"></a>The <span style="font-weight: bold;">al</span>
- intent, Absolute Appearance (Lab), is similar to intent <span
- style="font-weight: bold;">a</span>, but L*a*b* colorspace is
- used rather than CIECAM02 Jab appearance space. This often leads
- to poor reproduction of blue and red hues, but can be useful as a
- reference mapping.<br>
+ intent, Absolute Colorimetric (Lab), is similar to intent <span
+ style="font-weight: bold;">a</span>, but <b>L*a*b*</b>
+ colorspace is used rather than CIECAM02 Jab appearance space. This
+ often leads to poor reproduction of blue and red hues, but can be
+ useful as a reference mapping.<br>
+ <br>
+ <a name="iar"></a>The <span style="font-weight: bold;">ar</span>
+ intent, White Point Matched Colorimetric (Lab), is similar to
+ intent <span style="font-weight: bold;">r</span>, but L*a*b*
+ colorspace is used rather than CIECAM02 Jab appearance space. This
+ often leads to poor reproduction of blue and red hues, but can be
+ useful as a reference mapping.<br>
</div>
<br>
<a name="w"></a> The <b>-w</b> flag forces the white points to be
@@ -919,30 +2391,150 @@ ICC
&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
&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;
&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
&nbsp; &nbsp;/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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;
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
&nbsp;/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
stle&nbsp; | ------/<br>
@@ -955,6 +2547,30 @@ ICC
White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Black<br>
<br>
</tt>For minimum sensitivity of printed output to the lighting
@@ -1023,6 +2639,243 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
in final calibrated device values if the profile includes
calibration information.<br>
<br>
+ <a name="3"></a>The <b>-3</b> <i>flag</i> triggers creation of a
+ "3dLut" of one of the following formats:<br>
+ &nbsp;&nbsp;&nbsp; <b>e</b>&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; <a
+ href="http://www.eecolor.com/">eeColor </a>format ".txt" files.
+ This includes 3 input curve files, the cLut file and 3 output curve
+ files.<br>
+ &nbsp;&nbsp;&nbsp; <b>m</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <a
+ href="http://forum.doom9.org/showthread.php?t=146228&amp;page=22">MadVR</a>
+ format ".3dlut" file.<br>
+ <br>
+ Some hardware devices and other software make use of cLUT type
+ tables that are analogous to ICC device links, but are typically
+ less sophisticated and flexible. The <b>-3</b> flag allows creation
+ of some of these file formats as well as the normal ICC device link.
+ Choosing one of these formats will typically also configure various
+ other parameters to default values suitable for that format, such as
+ the&nbsp; table resolution (<b>-r</b>), and the use of 1D input and
+ output curves (<b>-n</b>). Other parameters (such as <b>-I</b>, <b>-e</b>
+ and <b>-E</b>) may have to be set to get a table suitable for the
+ particular target and situation.<br>
+ <br>
+ The <b>-3 e</b> eeColor format is basically a 65^3 cLUT, but the
+ hardware is unable to map a 1.0 input value to anything other than
+ 1.0 output. If one of the video input encodings is being used (<b>-e
+ t</b> or <b>-e 7</b> etc.), then this is not an issued, since a
+ 1.0 input is not used for image data. For normal (full) input range
+ (ie. if the eeColor is being used to process the output of a
+ computer Video card, and the video card is not encoding using TV
+ values), then this is a problem, and collink will compensate for
+ this by creating a set of per channel input curve files that can be
+ loaded into the eeColor. The xvYCC encoding (<b>-e x</b> and <b>-e
+ X</b>) uses almost the full range of values for the Cb &amp; Cr
+ values, and also needs per channel input curves to allow a full
+ range of mapping.<br>
+ <br>
+ &nbsp;For this reason collink generates the following 7 files:<br>
+ <br>
+ &nbsp;&nbsp;&nbsp; basename-first1dred.txt<br>
+ &nbsp;&nbsp;&nbsp; basename-first1dgreen.txt<br>
+ &nbsp;&nbsp;&nbsp; basename-first1dblue.txt<br>
+ &nbsp;&nbsp;&nbsp; test.txt <br>
+ &nbsp;&nbsp;&nbsp; basename-second1dred.txt<br>
+ &nbsp;&nbsp;&nbsp; basename-second1dgreen.txt<br>
+ &nbsp;&nbsp;&nbsp; basename-second1dblue.txt<br>
+ <br>
+ even though the 1d files will be linear for all cases except the
+ normal and xvYCC input range.<br>
+ <br>
+ The MadVR format is an 8 bit input, 16 bit output cLUT of 100 Mbytes
+ size, and will written to the file <b>basename.3dlut</b>. If the -a
+ or -H options are used, then the MadVR 3dLut will have a set of
+ appropriate per channel calibration curves appended to the 3dLut, to
+ ensure that the hardware is correctly set for it if used with MadVR
+ V0.86.9 or latter. This functionality is analogous to a 'VCGT' tag
+ in a normal ICC display profile.<br>
+ <br>
+ 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
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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>
+ <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><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>
+ <small><span style="font-family: monospace;"><small><span
+ style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;
+ x&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+ xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV"
+ levels<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;
+ X&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+ xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV"
+ levels</span></small></span></small><br>
+ <br>
+ When xvYCC is chosen, the encoding is either a Rec601 YCbCr or
+ Rec709 YCbCr with extended range Cb and Cr values, and a hard coded
+ Rec709 source colorspace, corresponding to the xvYCC specifications.
+ The <a href="#p1">source profile</a> provided to collink is used to
+ define the source gamut for gamut mapping, and also the space that
+ any <a href="#Ib">BT.1886</a> processing will be performed in. For
+ instance, if the xvYCC is being used to encode a larger gamut such
+ as UHD Rec2020, or Digital Cinema SMPTE431 P3, then the
+ corresponding ICC profile should be provided as the source profile.<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>
+ <small><span style="font-family: monospace;"><small><span
+ style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;
+ n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+ RGB (16-235)/255 "TV" levels<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;
+ 6&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+ 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;
+
+
+
+
+
+
+
+
+
+ Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV"
+ levels<br>
+ </span></small></span></small><br>
+ <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
illustrate the gamut mapping generated.<br>
@@ -1044,6 +2897,30 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
For information on typical usage, see the <a href="Scenarios.html">Typical
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Usage Scenarios</a> page.<br>
<br>
<br>