4350 lines
71 KiB
HTML
Executable File
4350 lines
71 KiB
HTML
Executable File
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<title>collink</title>
|
|
<meta http-equiv="content-type" content="text/html;
|
|
charset=windows-1252">
|
|
<meta name="author" content="Graeme Gill">
|
|
</head>
|
|
<body>
|
|
<h2><b>link/collink</b></h2>
|
|
<h3>Summary</h3>
|
|
Link two ICC device profiles to create an ICC device link profile.<br>
|
|
<br>
|
|
<b> collink</b> takes two device ICC profiles, and links them
|
|
together, either in a simple fashion using the standard ICC forward
|
|
and reverse tables of the specified intent, or using color
|
|
appearance space and true gamut mapping, together with possibly
|
|
inverting the forward profile, to allow black ink regeneration
|
|
or to retain the source black characteristic from the source
|
|
profile.<br>
|
|
<br>
|
|
<small>The <a href="#O">-O</a> option allows creation of a device
|
|
link that contains just per channel calibration curves.</small>
|
|
<h3>Usage Summary</h3>
|
|
<tt>collink [-options] <i>srcprofile dstprofile linkedprofile</i></tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#v">-v</a></tt><tt>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Verbose</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#A">-A "manufacturer"</a></tt><tt>
|
|
|
|
Set the manufacturer description string</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#M">-M "model"</a></tt><tt>
|
|
Set the model
|
|
description string</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#D">-D "description"</a></tt><tt>
|
|
|
|
Set the profile Description string (Default "inoutfile")</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#C">-C "copyright"</a></tt><tt>
|
|
Set the copyright string</tt><br>
|
|
|
|
|
|
<tt><a href="#V">-V</a></tt><tt>
|
|
Verify
|
|
existing
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
profile, rather than link (Debug option)</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#q">-q lmhu</a></tt><tt>
|
|
Quality - Low,
|
|
Medium (def), High, Ultra</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#r">-r res</a></tt><tt>
|
|
Override
|
|
clut
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
res. set by -q</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#n">-n</a></tt><tt>
|
|
Don't
|
|
preserve
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
device curves in result</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#f">-f</a></tt><tt>
|
|
|
|
Special :- Force neutral colors to
|
|
be K only output.</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#fk">-fk</a></tt><tt>
|
|
|
|
Special :- Force K only neutral colors to
|
|
be K only output</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#fcmy">-fcmy</a></tt><tt>
|
|
|
|
Special :- Force 100% C,M or Y only to stay pure</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#F">-F</a></tt><tt>
|
|
|
|
Special :- Force all colors to be K
|
|
only output.</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#p">-p aprof.icm</a></tt><tt>
|
|
Include
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
abstract profile in link</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#a">-a file.cal</a></tt><tt>
|
|
Apply calibration curves to
|
|
link output and append linear</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#H">-H file.cal</a></tt><tt>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Append calibration curves to 3dlut</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#O">-O file.cal</a></tt><tt>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Use just calibration curves as link and append linear</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#s">-s</a></tt><tt>
|
|
Simple
|
|
Mode
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(default)</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#g">-g [src.gam]</a></tt><tt>
|
|
|
|
Gamut Mapping Mode [optional source image
|
|
gamut]</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#G">-G [src.gam]</a></tt><tt>
|
|
Gamut
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Mapping Mode using inverse outprofile A2B [optional source gamut]</tt><tt><br>
|
|
</tt><tt> </tt><tt><br>
|
|
</tt><tt> <u>Simple Mode Options:</u></tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#si">-i in_intent</a></tt><tt>
|
|
|
|
p = perceptual, r = relative colorimetric,</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
|
|
s
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
= saturation, a = absolute colorimetric</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#so">-o </a></tt><tt><a
|
|
href="#so">out_intent</a></tt><tt> p =
|
|
perceptual, r = relative colorimetric,</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
|
|
s
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
= saturation, a = absolute colorimetric</tt><tt><br>
|
|
</tt><tt> </tt><tt><br>
|
|
</tt><tt> <u>Mapping Mode Options:</u></tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#i">-i intent</a></tt><tt>
|
|
|
|
set linking intent from the following choice:</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
a
|
|
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Absolute Colorimetric (in Jab) [ICC Absolute Colorimetric]</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
aw - Absolute Colorimetric (in Jab) with scaling to fit white
|
|
point</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
aa - Absolute Appearance</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
r
|
|
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
White Point Matched Appearance [ICC Relative Colorimetric]</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
la - Luminance matched Appearance</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
p
|
|
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Perceptual (Preferred) [ICC Perceptual]</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
pa - Perceptual Appearance</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
lp - Luminance Preserving Perceptual</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
ms - Saturation</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
s
|
|
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Enhanced Saturation [ICC Saturation]</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
al - Absolute Colorimetric (Lab)</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
rl - White Point Matched Colorimetric (Lab)</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#w">-w [J,a,b]</a></tt><tt>
|
|
Use forced whitepoint hack [optional color to
|
|
map the white to]</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#b">-b</a></tt><tt>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Use RGB->RGB forced black point hack</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#c">-c viewcond</a></tt><tt>
|
|
set source viewing conditions for CIECAM02,</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
|
|
either
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
an enumerated choice, or a parameter</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#d">-d viewcond</a></tt><tt>
|
|
set destination viewing conditions for CIECAM02,</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
|
|
either
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
an enumerated choice, or a parameter:value change</tt><tt><br>
|
|
</tt><tt> pc -
|
|
Critical print evaluation environment (ISO-3664 P1)</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
pp - Practical Reflection Print (ISO-3664 P2)</tt><tt><br>
|
|
</tt><tt>
|
|
pe - Print evaluation environment (CIE
|
|
116-1995)</tt><tt><br>
|
|
</tt><tt>
|
|
pm - Print evaluation with partial Mid-tone adapation</tt><tt><br>
|
|
</tt><tt>
|
|
mt - Monitor in typical work environment</tt><tt><br>
|
|
</tt><tt>
|
|
mb - Monitor in bright work environment</tt><tt><br>
|
|
</tt><tt>
|
|
md - Monitor in darkened work environment</tt><tt><br>
|
|
</tt><tt>
|
|
jm - Projector in dim environment</tt><tt><br>
|
|
</tt><tt>
|
|
jd - Projector in dark environment</tt><tt><br>
|
|
</tt><tt> pcd -
|
|
Photo CD - original scene outdoors</tt><tt><br>
|
|
</tt><tt>
|
|
ob - Original scene - Bright Outdoors</tt><tt><br>
|
|
</tt><tt>
|
|
cx - Cut Sheet Transparencies on a viewing box</tt><tt><br>
|
|
</tt><tt>
|
|
s:surround n = auto, a = average, m = dim, d = dark,</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
c = transparency (default average)</tt><tt><br>
|
|
</tt><tt>
|
|
w:X:Y:Z Adapted white point as
|
|
XYZ (default media white)</tt><tt><br>
|
|
</tt><tt>
|
|
w:x:y Adapted
|
|
white point as x, y</tt><tt><br>
|
|
</tt><tt>
|
|
a:adaptation Adaptatation luminance in cd.m^2 (default 50.0)</tt><tt><br>
|
|
</tt><tt>
|
|
b:background Background % of image luminance (default 20)</tt><tt><br>
|
|
</tt><tt>
|
|
l:imagewhite Image white in cd.m^2 if surround = auto
|
|
(default 250)</tt><tt><br>
|
|
</tt><tt>
|
|
f:flare Flare light % of image
|
|
luminance (default 0)</tt><tt><br>
|
|
</tt><tt>
|
|
g:glare Glare light % of
|
|
ambient (default 5)</tt><tt><br>
|
|
</tt><tt>
|
|
g:X:Y:Z Glare color as XYZ
|
|
(default media white)</tt><tt><br>
|
|
</tt><tt>
|
|
g:x:y Glare color
|
|
as x, y</tt><tt><br>
|
|
</tt><tt>
|
|
h:hkscale Helmholtz-Kohlrausch effect
|
|
scale factor (default 1.0)</tt><tt><br>
|
|
</tt><tt>
|
|
m:mtaf Mid-tone partial
|
|
adaptation factor (default 0.0)</tt><tt><br>
|
|
</tt><tt>
|
|
m:X:Y:Z Mid-tone Adaptation
|
|
white as XYZ (default D50)</tt><tt><br>
|
|
</tt><tt>
|
|
m:x:y Mid-tone
|
|
Adaptation white as x, y</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#t">-t tlimit</a></tt><tt>
|
|
set
|
|
source
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
total ink limit, 0 - 400% (estimate by default)</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#T">-T klimit</a></tt><tt>
|
|
set
|
|
source
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
total ink limit, 0 - 100% (estimate by default)</tt><tt><br>
|
|
</tt><tt> </tt><tt><br>
|
|
</tt><tt> <u>Inverse outprofile A2B
|
|
Options:</u></tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#k">-k tezhxr</a></tt><tt>
|
|
|
|
|
|
CMYK Black generation</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
|
|
t
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
= transfer K from source to destination, e = retain K of
|
|
destination B2A table</tt><tt><br>
|
|
</tt><tt>
|
|
|
|
|
|
z
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
= zero K, h = 0.5 K, x = maximum K, r = ramp K (default)</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#kp">-k p stle stpo enpo enle
|
|
shape</a></tt><tt><br>
|
|
</tt><tt>
|
|
|
|
|
|
p
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
= black level generation curve parameters</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#kq">-k q stle0 stpo0 enpo0 enle0
|
|
shape0 stle2 stpo2 enpo2 enle2 shape2</a></tt><tt><br>
|
|
</tt><tt>
|
|
|
|
|
|
q
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
= transfer source K to dual curve limits</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#K">-K parameters</a></tt><tt>
|
|
|
|
|
|
Same as -k, but target is K locus rather than K value itself</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#l">-l tlimit</a></tt><tt>
|
|
set
|
|
destination
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
total ink limit, 0 - 400% (estimate by default)</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#L">-L klimit</a></tt><tt>
|
|
set
|
|
destination
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
total ink limit, 0 - 100% (estimate by default)</tt><tt><br>
|
|
</tt><tt> </tt><tt><a moz-do-not-send="true" href="#Yc">-Y
|
|
c:file.cal</a></tt><tt> Provide or overide calibration
|
|
total ink curves</tt><br>
|
|
|
|
|
|
<tt> </tt><tt><a href="#3">-3 flag</a></tt><tt>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Create "3DLut" output file as well as devlink</tt><tt><br>
|
|
</tt><tt>
|
|
e
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
eeColor .txt file</tt><tt><br>
|
|
</tt><tt>
|
|
m
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
MadVR .3dlut file</tt><tt><br>
|
|
</tt><tt>
|
|
c
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
IRIDAS .cube file</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#Ib">-I B</a></tt><tt>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Use BT.1886 source EOTF with technical gamma 2.4</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#Ib">-I b:g.g</a></tt><tt>
|
|
Use
|
|
BT.1886-like source EOTF with effective gamma g.g</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#Ib">-I b:p.p:g.g</a></tt><tt>
|
|
Use effective gamma g.g source EOTF
|
|
with p.p prop. output black point offset</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="collink.html#Ib">-I g:g.g</a></tt><tt>
|
|
Use
|
|
effective gamma g.g source EOTF with all output black point offset</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#e">-e flag</a></tt><tt>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Video encode input as:</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#E">-E flag</a></tt><tt>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Video encode output as:</tt><tt><br>
|
|
</tt><tt>
|
|
n
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
normal RGB 0..1 levels (default)</tt><tt><br>
|
|
</tt><tt>
|
|
t
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
RGB (16-235)/255 "TV" levels</tt><tt><br>
|
|
</tt><tt> T
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
RGB (16-235)/255 "TV" levels, clip WTW [Input Only]</tt><tt><br>
|
|
</tt><tt>
|
|
6
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rec601 YCbCr SD (16-235,240)/255 "TV" levels</tt><tt><br>
|
|
</tt><tt>
|
|
7
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels</tt><tt><br>
|
|
</tt><tt>
|
|
5
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels</tt><tt><br>
|
|
</tt><tt>
|
|
2
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels</tt><tt><br>
|
|
</tt><tt>
|
|
C
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV" levels</tt><tt><br>
|
|
</tt><tt>
|
|
x
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV" levels</tt><tt><br>
|
|
</tt><tt>
|
|
X
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV" levels</tt><tt><br>
|
|
</tt><tt> </tt><tt><a href="#P">-P</a></tt><tt>
|
|
|
|
Create
|
|
gamut
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
gammap_p.x3d.html and gammap_s.x3d.html diagostics</tt><tt><br>
|
|
</tt><tt> </tt><i><tt><a href="#p1">srcprofile</a></tt></i><tt>
|
|
source
|
|
ICC
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
profile. A TIFF or JPEG file with embedded profile may be used
|
|
here.</tt><tt><br>
|
|
</tt><tt> </tt><i><tt><a href="#p2">dstprofile</a></tt></i><tt>
|
|
destination
|
|
ICC
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
profile. A TIFF or JPEG file with embedded profile may be used
|
|
here.</tt><tt><br>
|
|
</tt><tt> </tt><i><tt><a href="#p3">linkedprofile</a></tt></i><tt>
|
|
|
|
|
|
resulting device link profile</tt><br>
|
|
<h3>Usage Details and Discussion</h3>
|
|
<b><a name="v"></a> -v</b> Turns on verbose mode. Gives progress
|
|
information as the profile is created. Since gamut map mode inverse
|
|
profile linking can take a long time to perform, this is often
|
|
useful. <br>
|
|
<br>
|
|
<a name="A"></a>The <b>-A</b> parameter allows setting of the
|
|
device manufacturer description tag. This parameter may not be
|
|
relevant for a link profile, but if used should be a string that
|
|
identifies the manufacturer of the primary device used in the link.
|
|
With most command line shells, it will be necessary to enclose the
|
|
parameter with double quotes, so that spaces and other special
|
|
characters are included in the parameter, and not mistaken for the
|
|
start of another flag, or as a final command line parameters. By
|
|
default no manufacturer description string tag will be generated for
|
|
the profile.<br>
|
|
<br>
|
|
<a name="M"></a>The <b>-M</b> parameter allows setting of the
|
|
device mode description tag. This parameter may not be relevant for
|
|
a link profile, but if used should be a string that identifies the
|
|
particular model of primary device used in the link. With most
|
|
command line shells, it will be necessary to enclose the parameter
|
|
with double quotes, so that spaces and other special characters are
|
|
included in the parameter, and not mistaken for the start of another
|
|
flag, or as a final command line parameters. By default no model
|
|
description string tag will be generated for the profile.<br>
|
|
<br>
|
|
<a name="D"></a>The <b>-D</b> parameter allows setting of the
|
|
profile description tag. The parameter should be a string that
|
|
describes the profile. On many systems, it will be this string that
|
|
will be used to identify the profile from a list of possible
|
|
profiles. With most command line shells, it will be necessary to
|
|
enclose the parameter with double quotes, so that spaces and other
|
|
special characters are included in the parameter, and not mistaken
|
|
for the start of another flag, or as a final command line parameter.
|
|
Many programs that deal with ICC profiles use the description tag to
|
|
identify a profile, rather than the profile filename, so using a
|
|
descriptive string is important in being able to find a profile. By
|
|
default, the base name of the resulting profile will be used as the
|
|
description.<br>
|
|
<br>
|
|
<a name="C"></a>The <b>-C</b> parameter allows setting of the
|
|
profile copyright tag. The parameter should be a string that
|
|
describes the copyright (if any) claimed on the profile being
|
|
generated.. With most command line shells, it will be necessary to
|
|
enclose the parameter with double quotes, so that spaces and other
|
|
special characters are included in the parameter, and not mistaken
|
|
for the start of another flag, or as a final command line
|
|
parameters. By default a generic copyright string will be generated
|
|
for the profile.<br>
|
|
<br>
|
|
|
|
|
|
<b><a name="V"></a> -V</b> Verifies an existing profile. This is
|
|
really a debugging option. It is only useful if all the linking
|
|
parameters are identical to those used during the creation of the
|
|
profile being verified.<br>
|
|
<br>
|
|
<b><a name="q"></a> -q [lmhu]</b> Quality
|
|
- Low, Medium (def), High, Ultra<br>
|
|
<b><a name="r"></a> -r res </b>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Override clut res. set by <b>-q</b><br>
|
|
<br>
|
|
This sets the basic quality of the resulting link, by choosing the
|
|
resolution of various tables in the resulting profile, as well as
|
|
the resolution of other temporary tables used in creating the link.
|
|
The <b>-r</b> flag allows overriding the resolution set by the <b>-q</b>
|
|
option, for the ICC profile CLUT multi-dimensional interpolation
|
|
table. It is highly recommended that <span style="font-weight:
|
|
bold;">-qm</span> be used as a starting point, and other settings
|
|
only tried after this has been evaluated. <span style="font-weight:
|
|
bold;">-qu</span> should almost never be used, except to prove
|
|
that it should almost never be used.<br>
|
|
<br>
|
|
<a name="n"></a>Normally the per channel device curves in the source
|
|
and destination profiles are preserved in the resulting device link
|
|
profile, but the <b>-n</b> option disables this. This can be useful
|
|
if the device linearisation curves are inappropriate in nature. Note
|
|
that both input and output curves will not be preserved if a 3d LUT
|
|
output is selected.<br>
|
|
<br>
|
|
<a name="f"></a> The <b>-f</b> option is a special purpose flag
|
|
useful only for 3 or 4 component (RGB, CMY or CMYK) source to CMYK
|
|
destination linking, that causes the destination to be <span
|
|
style="font-weight: bold;">K only</span> for neutral axis input.
|
|
Neutral axis input is assumed for R=G=B or C=M=Y input values. So as
|
|
to get a smooth mapping from the source to the K only destination,
|
|
by default the gamut mapping will be adjusted to target the
|
|
destination K only black, and Perceptual gamut mapping will be
|
|
selected along with maximum K inking. If other options are selected
|
|
that conflict with achieving a smooth mapping, warnings messages
|
|
will be emitted.<br>
|
|
<br>
|
|
<a name="F"></a> The <b>-F</b> option is a special purpose flag
|
|
useful only mapping to a CMYK destination, that causes the
|
|
destination to be converted to K only monochrome. So as to get a
|
|
smooth mapping from the source to the K only destination, by default
|
|
the gamut mapping will be adjusted to target the destination K only
|
|
black, and Perceptual gamut mapping will be selected along with
|
|
maximum K inking. If other options are selected that conflict with
|
|
achieving a smooth mapping, warnings messages will be emitted.<br>
|
|
<br>
|
|
<a name="fk"></a> The <b>-fk</b> option is a special purpose
|
|
flag useful only for CMYK source to CMYK destination linking, that
|
|
causes K only source values to map to K only destination values.
|
|
This is often useful in re-targeting CMYK material while preserving
|
|
K only text and graphics. So as to get a smooth mapping from the
|
|
source to the K only destination, by default the gamut mapping will
|
|
be adjusted to assume K only black source to destination K only
|
|
black for K only values, and Perceptual gamut mapping will be
|
|
selected along with a black generation rule (<span
|
|
style="font-weight: bold;">-kt</span>) that preserves the black
|
|
level from source to destination. If other options are selected that
|
|
conflict with achieving a smooth mapping, warnings messages will be
|
|
emitted.<br>
|
|
<br>
|
|
<a name="fcmy"></a> The <b>-fcmy</b> options are special
|
|
purpose flags useful only for CMY or CMYK source to CMY or CMYK
|
|
destination linking. The <span style="font-weight: bold;">cmy</span>
|
|
flags may be used independently or in combination (ie. <span
|
|
style="font-weight: bold;">-fc, -fm, -fy, -fcm, -fcy, -fmy, -fcmy</span>)
|
|
or combined with the <span style="font-weight: bold;">-fk</span>
|
|
option. These flags ensure that the pure 100% primary colorant
|
|
source values map to 100% pure colorant destination values, and may
|
|
be useful in some situations where CMYK material is being
|
|
re-targeted. <span style="font-weight: bold;">Note</span> that
|
|
forcing the 100% colorant values to map this way largely works
|
|
against the aims of color management in preserving colors
|
|
appearance. So as to get a smooth mapping from the source
|
|
to destination, by default the gamut mapping will a Saturation
|
|
intent with 100 percept alignment of the selected C, M and/or Y cusp
|
|
values. A Saturation intent is often what is desired in such CMYK to
|
|
CMYK re-renderings, as it makes best use of the (usually quite
|
|
similar sized) destination gamut. If other options are selected that
|
|
conflict with achieving a smooth mapping, warnings messages will be
|
|
emitted.<br>
|
|
<br>
|
|
<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>
|
|
<a name="O"></a> The <b>-O</b> parameter causes calibration curves
|
|
in the supplied file to be use to create the link. ICC profiles are
|
|
not expected or used. This option allows a device link to be used to
|
|
apply just per channel calibration curves. Note that many normal
|
|
options will be ignored or may cause unexpected results when used
|
|
with this option.<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>
|
|
<a name="s"></a> <b>-s</b> Simple mode. No gamut
|
|
mapping is performed, the selected intent AtoB and BtoA tables are
|
|
simply concatenated to create the output link, with the gamut
|
|
mapping behavior being determined solely by the BtoA table. The -i
|
|
and -o options allow selection of the source and destination ICC
|
|
intents. This is typically how other CMS do ICC linking. <a
|
|
href="#ss">Details</a>.<br>
|
|
<br>
|
|
<a name="g"></a> <b>-g</b> Gamut mapping mode. In
|
|
this mode, the absolute colorimetric AtoB and BtoA tables are used
|
|
to perform the link, and the intermediate linking color space is
|
|
(generally) the CIECAM02 Jab appearance space. The source and
|
|
destination viewing conditions can be selected using the <b>-c</b>
|
|
and <b>-d</b> options. A gamut mapping is performed between the two
|
|
spaces, using the intent selected by the <b>-i</b> option.
|
|
There is an optional argument, which is a source gamut to use
|
|
instead of that of the source profile. This is to allow optimizing
|
|
the gamut mapping to a source gamut of a particular image,
|
|
which can give better results that gamut mapping from the gamut of
|
|
the source colorspace, particularly if the source colorspace (i.e.
|
|
ProPhoto etc.) has a gamut much larger than the images encoded in
|
|
that space. Such a source image gamut can be created using the <a
|
|
href="tiffgamut.html"> tiffgamut</a> tool. More <a
|
|
href="#gg">details</a> about gamut mapping mode.<br>
|
|
<br>
|
|
<a name="G"></a> <b>-G</b> Use the gamut mapped, inverse
|
|
AtoB table linking method. This is generally the most accurate,
|
|
smooth and flexible linking method, but takes the longest to
|
|
perform. The gamut mapping mode (<span style="font-weight:
|
|
bold;">-g</span>) options <b>-i</b>, <b>-c</b>, <b>-d</b>, <b>-k</b>
|
|
and <b>-l</b> are effective when this method is selected. There is
|
|
an optional argument, which is a source gamut to use instead of that
|
|
of the source profile. This is to allow optimizing the gamut mapping
|
|
to a source gamut of a particular image, which can give better
|
|
results that gamut mapping from the gamut of the source colorspace,
|
|
particularly if the source colorspace (i.e. ProPhoto etc.) has a
|
|
gamut much larger than the images encoded in that space. Such a
|
|
source image gamut can be created using the <a
|
|
href="tiffgamut.html"> tiffgamut</a> tool. More <a href="#GG">details</a>
|
|
about the gamut mapping, inverse AtoB mode.<br>
|
|
<br>
|
|
<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>
|
|
<br>
|
|
<u><a name="ss"></a> Simple mode gamut mapping options:</u><br>
|
|
<br>
|
|
<a name="si"></a> <b>-i</b> <i>in_intent</i>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<b>p</b> = perceptual, <b>r</b> = relative colorimetric,<br>
|
|
|
|
<b>s</b>
|
|
= saturation, <b>a</b> = absolute colorimetric<br>
|
|
<a name="so"></a> <b>-o</b> <i>out_intent</i>
|
|
<b>p</b> = perceptual, <b>r</b> = relative
|
|
colorimetric,<br>
|
|
|
|
<b>s</b>
|
|
= saturation, <b>a</b> = absolute colorimetric<br>
|
|
<br>
|
|
These two options simply select the appropriate ICC table, according
|
|
to desired intent. Generally, it is a good idea to use the same
|
|
intent for both source and destination. Not all ICC profiles support
|
|
all four intents.<br>
|
|
<br>
|
|
<u><a name="gg"></a> Gamut mapping mode options:</u><br>
|
|
<br>
|
|
<a name="i"></a> <b>-i</b> <i>intent</i><br>
|
|
<br>
|
|
Select the gamut mapping intent. In gamut mapping mode there is only
|
|
a single overall intent. The intent is selected using the 1 two
|
|
letter option parameter, the standard ICC profile being a subset of
|
|
the available selections.<br>
|
|
<br>
|
|
<div style="margin-left: 40px;"><a name="ia"></a>The <span
|
|
style="font-weight: bold;">a</span> intent, Absolute
|
|
Colorimetric, is intended to reproduce colors exactly,
|
|
irrespective of the white point of the each medium. This is done
|
|
using CIECAM02 Jab appearance colorspace by forcing the source and
|
|
destination to have a common white point (but other aspects of the
|
|
individual viewing conditions are active), and colors are mapped
|
|
directly from source to destination, clipping any out of gamut
|
|
colors to the closest match. This is equivalent to the ICC <span
|
|
style="font-weight: bold;">Absolute Colorimetric</span> intent,
|
|
and is often used for proofing purposes. <br>
|
|
<br>
|
|
<a name="iaw"></a>The <span style="font-weight: bold;">aw</span>
|
|
intent, Absolute Colorimetric with scaling to fit white point, is
|
|
very similar to the <span style="font-weight: bold;">a</span>
|
|
intent, except that it will scale the source colorspace down in
|
|
order to make sure that the source white point isn't clipped by
|
|
the gamut of the destination. This might be used in some print
|
|
proofing situations where the source white is lightly lighter than
|
|
the destination white (as an alternative to using the <a
|
|
href="#w">-w</a> flag), or it may be useful in some soft
|
|
proofing situations where the differences in white point of the
|
|
display destination would cause clipping of the source white
|
|
point. When the <a href="#v">-v</a> flag is on, the scaling
|
|
factor used will be displayed during execution.<br>
|
|
<br>
|
|
<a name="iaa"></a>The <span style="font-weight: bold;">aa</span>
|
|
intent, Absolute Appearance, simply maps the Jab colors directly
|
|
from source to destination, clipping any out of gamut colors to
|
|
the closest match. This attempts to match the exact appearance of
|
|
colors as closely as possible, but may not exactly map the white
|
|
point of the source to the destination, depending on how different
|
|
the viewing conditions are.<br>
|
|
<br>
|
|
<a name="ir"></a>The <span style="font-weight: bold;">r</span>
|
|
intent is like Absolute Appearance mode, but maps the white point
|
|
and neutral axis from source to destination, and otherwise maps
|
|
the Jab colors directly from source to destination, clipping any
|
|
out of gamut colors to the closest match. This is equivalent to
|
|
the ICC <span style="font-weight: bold;">Relative Colorimetric</span>
|
|
intent.<br>
|
|
<br>
|
|
<a name="ila"></a>The <span style="font-weight: bold;">la</span>
|
|
intent, Luminance matched appearance, maps the white point and
|
|
neutral axis, and linearly compresses or 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 <span style="font-weight: bold;">p</span>
|
|
intent, Perceptual, maps the white point and neutral axis from
|
|
source to destination, and uses "knee" type 3 Dimensional
|
|
compression to make the source gamut fit within the destination
|
|
gamut. As much as possible, clipping is avoided, hues and the
|
|
overall appearance is maintained. This is equivalent to the ICC <span
|
|
style="font-weight: bold;">Perceptual</span> intent.<br>
|
|
<br>
|
|
<a name="ipa"></a>The <span style="font-weight: bold;">pa</span>
|
|
intent, Perceptual Appearance uses "knee" type 3 Dimensional
|
|
compression to make the source gamut fit within the destination
|
|
gamut. As much as possible, clipping is avoided, hues and the
|
|
overall appearance is maintained. The white point is<span
|
|
style="font-weight: bold;"> not</span> mapped from source to
|
|
destination, allowing the appearance parameters to alter the
|
|
chromatic mapping.<br>
|
|
<br>
|
|
<a name="ilp"></a>The <span style="font-weight: bold;">lp</span>
|
|
intent, Luminance Preserving Perceptual Appearance maps the white
|
|
point and neutral axis from source to destination, and uses
|
|
compression to make the source gamut fit within the destination
|
|
gamut, but very heavily weights the preservation of the Luminance
|
|
value of the source, which will compromise the preservation of
|
|
saturation. No contrast enhancement is used if the dynamic range
|
|
is reduced. This intent may be of use where preserving the tonal
|
|
distinctions in images is more important than maintaining overall
|
|
colorfulness or contrast.<br>
|
|
<br>
|
|
<a name="ims"></a>The <span style="font-weight: bold;">ms</span>
|
|
intent, Saturation, uses 3 Dimensional compression and <span
|
|
style="text-decoration: underline;">expansion</span> to try and
|
|
make the source gamut exactly match the destination gamut, and
|
|
also favours higher saturation over hue or lightness preservation.
|
|
The white point and neutral axis is mapped from source to
|
|
destination.<br>
|
|
<br>
|
|
<a name="is"></a>The <span style="font-weight: bold;"></span><span
|
|
style="font-weight: bold;">s</span> intent, Enhanced Saturation,
|
|
uses the same basic gamut mapping as <span style="font-weight:
|
|
bold;">ms</span>, Saturation, but increases saturation slightly
|
|
in highly saturated areas of the gamut. This is equivalent to the
|
|
ICC <span style="font-weight: bold;">Saturation</span> intent.
|
|
The white point is and neutral axis is mapped from source to
|
|
destination.<br>
|
|
<br>
|
|
<a name="ial"></a>The <span style="font-weight: bold;">al</span>
|
|
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
|
|
mapped from source to destination, irrespective of the intent
|
|
chosen. This is useful if absolute intent is being used, and the two
|
|
media white points should match, but don't quite due to measurement
|
|
error.<br>
|
|
The <b>-w</b> flag can optionally be followed by three numbers,
|
|
that specify a color that white should be mapped to. This will be in
|
|
the colorspace used during linking (typically Jab space, which has
|
|
similar characteristics to L*a*b* space). This options can be useful
|
|
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 <u>well
|
|
behaved</u> with black at 0,0,0, and forcing the black mapping
|
|
avoids any slight raising of the black due to display profile
|
|
tolerances. On the other hand, any "dead zone" above zero device
|
|
input, won't be corrected.<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
|
|
information is used to map the profile PCS (Profile Connection
|
|
Space, which us either XYZ or L*a*b*) color into appearance space
|
|
(CIECAM02), which is a better colorspace to do gamut mapping in. The
|
|
viewing conditions allow the conversion into appearance space to
|
|
take account of how color will be seen under particular viewing
|
|
conditions.<br>
|
|
Viewing conditions can be specified in two basic ways. One is to
|
|
select from the list of "pre canned", enumerated viewing conditions,
|
|
choosing one that is closest to the conditions that are appropriate
|
|
for the media type and situation. Alternatively, the viewing
|
|
conditions parameters can be specified in detail individually. If
|
|
both methods are used, them the chosen enumerated condition will be
|
|
used as a base, and its parameters will then be individually
|
|
overridden.<br>
|
|
<br>
|
|
<a name="t"></a> The <b>-t</b> <i>tlimit</i> parameter sets the
|
|
total ink limit (TAC, Total Area Coverage) for a CMYK source
|
|
profile, as a total percentage from 0% to 400%. This affects the
|
|
gamut assumed for the source profile. By default, a total ink limit
|
|
will be estimated from the source profile B2A table.<br>
|
|
Ink limits will be computed in final raw device values if the
|
|
profile includes a calibration table in the profile 'targ' tag <span
|
|
style="font-weight: bold;">.ti3</span> data.<br>
|
|
|
|
|
|
<br>
|
|
<a name="T"></a> The <b>-T</b> <i>klimit</i> parameter sets the
|
|
black channel ink limit for a CMYK source profile, as a total
|
|
percentage from 0% to 100%. This affects the gamut assumed for the
|
|
source profile. By default, a black ink limit will be estimated from
|
|
the source profile B2A table.<br>
|
|
Ink limits will be computed in final raw device values if the
|
|
profile includes a calibration table in the profile 'targ' tag <span
|
|
style="font-weight: bold;">.ti3</span> data.<br>
|
|
|
|
|
|
<br>
|
|
<u> <a name="GG"></a>Inverse outprofile A2B Options:</u><br>
|
|
<br>
|
|
When the <b>-G</b> flag is used, the A2B table is inverted "on the
|
|
fly", allowing various additional choices as to what device values
|
|
are used to reproduce a particular color. (If the <b>-G</b> flag is
|
|
not used, then such decisions are already encoded in the B2A table
|
|
in the profile, and cannot be altered during linking).<br>
|
|
<br>
|
|
<a name="k"></a> -<b>k</b> parameter sets the target level of black
|
|
(K) when creating a B2A CMYK output tables. This is often called a
|
|
black level, a black inking rule, black generation, or under color
|
|
removal. These set the target black level:<br>
|
|
<br>
|
|
<b> -kz</b> selects minimum black (0.0)<br>
|
|
<b> -kh</b> selects a black level value of 0.5<br>
|
|
<b> -kx</b> selects the maximum possible black (1.0)<br>
|
|
<b> -kr</b> selects a linear level ramp, starting at minimum black
|
|
for highlight, and maximum black for shadow (equivalent to -kp 0 0 1
|
|
1 1). This is the default.<br>
|
|
<b>-kt</b>, will preserve the black amount from the source (CMYK)
|
|
profile to the destination (CMYK) profile as much as possible.
|
|
This may be most useful in creating a CMYK to CMYK conversion
|
|
between two different press conditions, while preserving as much as
|
|
possible the black only use for text etc. in anything
|
|
converted. Note that if the source black point is darker than the
|
|
destination, composite black will still be generated for K only
|
|
input. The <span style="font-weight: bold;">-fk</span> option can
|
|
be used to avoid this behavior.<br>
|
|
<b>-ke</b>, will preserve the black amount from the destination
|
|
profile B2A table (CMYK).<br>
|
|
<br>
|
|
<b><a name="kp"></a>-k p stle stpo enpo enle shape</b> allows
|
|
an arbitrary black locus ramp to be defined, consisting of a
|
|
starting value (stle) for highlights, a breakpoint L value (stpo)
|
|
where it starts to transition to the shadow level, an end breakpoint
|
|
L (enpo) where it flattens out again, and the finishing black level
|
|
(enle) for the shadows. There is also a curve parameter, that
|
|
modifies the transition from stle to enle to either be concave
|
|
(ie. the transition starts gradually and and finished more
|
|
abruptly) using values 0.0-1.0, with 0.0 being most concave, or
|
|
convex (the transition starts more abruptly but finishes gradually),
|
|
using values 1.0-2.0, with 2.0 being the most convex.<br>
|
|
<br>
|
|
Typical black value generation curve with parameters something like:
|
|
-kp 0 .1 .9 1 .5<br>
|
|
<br>
|
|
<tt> 1.0 K |
|
|
enpo<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
_______ enle<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/<br>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/<br>
|
|
|
|
stle | ------/<br>
|
|
|
|
+-------------------<br>
|
|
0.0 K
|
|
0.0
|
|
stpo 1.0<br>
|
|
|
|
White
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Black<br>
|
|
<br>
|
|
</tt>For minimum sensitivity of printed output to the lighting
|
|
spectrum, it currently seems best to use the maximum possible black,
|
|
but other black generation levels (ie. 0.3 to 0.5) may well be
|
|
preferred if one wants to minimize the noisy appearance of black on
|
|
an inkjet device, or if the banding behaviour or other rendering
|
|
flaws of the printer is to be minimized. <br>
|
|
<br>
|
|
Note that the black level curve is applied throughout the gamut,
|
|
resulting in GCR (Grey Component Replacement). There is no facility
|
|
to restrict black to just neutral colors, hence UCR is not currently
|
|
supported.<br>
|
|
<br>
|
|
<b><a name="kq"></a>-k q stle0 stpo0 enpo0 enle0 shape0 stle2 stpo2
|
|
enpo2 enle2 shape2</b> is a combination of the <b>-kt</b> and <b>-kp</b>
|
|
functionality, with the black being preserved in CMYK to CMYK
|
|
linking, with the output black constrained to be between the first
|
|
and second set of curve parameters.<br>
|
|
<br>
|
|
The <a href="xicclu.html">xicclu</a> tool can be used to plot out
|
|
the resulting black level for a given set of parameters, by using
|
|
the <a href="xicclu.html#g">-g</a> flag of a profile already
|
|
created from the same .ti3 file.<br>
|
|
<br>
|
|
<a name="K"></a> <span style="font-weight: bold;">-K parameters.</span>
|
|
Any of the <span style="font-weight: bold;">-k</span> options above
|
|
can use the <span style="font-weight: bold;">-K</span> version, in
|
|
which rather than an absolute black value target being defined by
|
|
the inking rule, the black proportion out of the maximum possible
|
|
for each color is defined. This makes the inking curve scale
|
|
proportionally over the gamut, rather than clipping in dark
|
|
chromatic regions where not much black can be added.<br>
|
|
<tt> </tt><br>
|
|
<a name="l"></a> The <b>-l</b> <i>tlimit</i> parameter sets the
|
|
total ink limit (TAC, Total Area Coverage) for the CMYK separation,
|
|
as a total percentage from 0% to 400%. This affects the gamut
|
|
assumed for the destination profile, as well as the ink limit in the
|
|
generated device link. The limit value should generally be set a
|
|
little below the value used in the test chart generation, to avoid
|
|
the very edges of the gamut. If the test chart ink limit has been
|
|
chosen to be a little beyond an acceptable level, then this number
|
|
should be the acceptable level. Although limits can be set below
|
|
200%, this will generally restrict the color gamut noticeably, as
|
|
fully saturated secondary colors will not be reproduced. Values are
|
|
between 220% and 300% for typical printing devices. By default, a
|
|
total ink limit will be estimated from the destination profile B2A
|
|
table.<br>
|
|
Ink limits will be computed in final raw device values if the
|
|
profile includes a calibration table in the profile 'targ' tag <span
|
|
style="font-weight: bold;">.ti3</span> data.<br>
|
|
|
|
|
|
<br>
|
|
<a name="L"></a> The <b>-L</b> <i>klimit</i> parameter sets the
|
|
black channel ink limit for the CMYK separation, as a total
|
|
percentage from 0% to 100%. This affects the gamut assumed for the
|
|
source profile, as well as the ink limit in the generated device
|
|
link. For printing press like devices, this can be used to prevent
|
|
the black channel screening pattern "filling in". Typical values
|
|
might be from 95% to 99%. By default, a black ink limit will be
|
|
estimated from the source profile B2A table.<br>
|
|
Ink limits will be computed in final raw device values if the
|
|
profile includes a calibration table in the profile 'targ' tag <span
|
|
style="font-weight: bold;">.ti3</span> data.<br>
|
|
|
|
|
|
<br>
|
|
<a name="Yc"></a>The <span style="font-weight: bold;">-Y c:</span><span
|
|
style="font-style: italic;">file.cal</span> parameter adds
|
|
or overrides Calibration curves that will be used in the computation
|
|
of the total or black ink limit calculation for the output profile.
|
|
This allows the ink limits to be computed in final raw device units.<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>
|
|
<b>e</b> <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>
|
|
<b>m</b> <a
|
|
href="http://forum.doom9.org/showthread.php?t=146228&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 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 & Cr
|
|
values, and also needs per channel input curves to allow a full
|
|
range of mapping.<br>
|
|
<br>
|
|
For this reason collink generates the following 7 files:<br>
|
|
<br>
|
|
basename-first1dred.txt<br>
|
|
basename-first1dgreen.txt<br>
|
|
basename-first1dblue.txt<br>
|
|
test.txt <br>
|
|
basename-second1dred.txt<br>
|
|
basename-second1dgreen.txt<br>
|
|
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|g|G][:p.p][:g.g]</b> series
|
|
of options, substitutes an alternative EOTF (Electro-Optical
|
|
Transfer Function) for the one specified by a 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>
|
|
</b>Full
|
|
input offset (BT.1886 like) with effective gamma of 2.2<b><br>
|
|
</b><b>-I g</b><b>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</b>Full output offset with effective gamma of 2.2<b><br>
|
|
</b><b></b><b>-I B</b><b>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</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>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Full output offset with technical gamma of 2.2<br>
|
|
<br>
|
|
<b>-I b</b><b>:2.3</b><b>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</b>Full input offset (BT.1886 like) with effective gamma of 2.3<b>
|
|
<br>
|
|
</b><b> -I g:2.3</b><b>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</b>Full output offset with effective gamma of 2.3<b><br>
|
|
</b><b> -I B:2.35</b><b>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</b>Full input offset (BT.1886 like) with technical gamma of 2.35<br>
|
|
<b> -I G:2.35</b>
|
|
Full
|
|
|
|
|
|
|
|
|
|
|
|
|
|
output offset with technical gamma of 2.35<br>
|
|
<br>
|
|
<b>-I b</b><b>:0.4:2.3</b>
|
|
60% input offset, 40% output offset with effective gamma of 2.3<b></b><br>
|
|
<b> -I g:0.4:2.3</b><b> </b>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Same as above.<b><br>
|
|
</b><b> -I B:0.4:2.35</b> 60% input
|
|
offset, 40% output offset with technical gamma of 2.35 <b><br>
|
|
</b><b> -I G:0.4:2.35</b> 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;"><small><span
|
|
style="font-family: monospace;"><small><span
|
|
style="font-family: monospace;"><small><span
|
|
style="font-family: monospace;"><small><span
|
|
style="font-family: monospace;">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
T
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
RGB (16-235)/255 "TV" levels, clip WTW
|
|
[Input Only]<br>
|
|
</span></small></span></small></span></small></span></small>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
x
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV"
|
|
levels<br>
|
|
|
|
X
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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>
|
|
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 by scaling
|
|
them, to preserve hue. 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>
|
|
<small><span style="font-family: monospace;"><small><span
|
|
style="font-family: monospace;">
|
|
n
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
normal RGB 0..1 full range levels (default)<br>
|
|
|
|
t
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
6
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rec601 YCbCr SD (16-235,240)/255 "TV" levels<br>
|
|
|
|
7
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels<br>
|
|
|
|
5
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels<br>
|
|
|
|
2
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels<br>
|
|
|
|
C
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV"
|
|
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>-e t</b> option assumes TV encoding range 16-235, and
|
|
preserves WTW (Whiter Than White, or out of range values) using
|
|
extrapolation, as long as per channel input and output curves are
|
|
disabled (see the <a href="#n">-n</a> option), which is
|
|
automatically the case if a <a href="#3">3dlut</a> output format is
|
|
selected.<br>
|
|
<br>
|
|
<b><a name="P"></a></b>The <b>-P</b> option causes a diagnostic 3D
|
|
<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>srcprofile</b></i> argument specifies
|
|
the source profile. This is the color space/device we are attempting
|
|
to emulate in the overall conversion. A <small>TIFF or JPEG file
|
|
with embedded profile may be used here. This argument must be
|
|
omitted if the <a href="#O">-O</a> option is used.</small><br>
|
|
<br>
|
|
<a name="p2"></a>The<i><b> dstprofile</b></i> argument specifies the
|
|
destination profile. This is the device we are actually displaying
|
|
on or printing to. A <small>TIFF or JPEG file with embedded profile
|
|
may be used here. </small><small>This argument must be omitted if
|
|
the <a href="#O">-O</a> option is used.</small><br>
|
|
<br>
|
|
<a name="p3"></a>The <i><b>linkedprofile</b></i> argument specifies
|
|
the resulting device link profile. This profile will contain the
|
|
color transform from the source space to destination space.<br>
|
|
<br>
|
|
For information on typical usage, see the <a href="Scenarios.html">Typical
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Usage Scenarios</a> page.<br>
|
|
<h3>Discussion</h3>
|
|
The viewing condition parameter <b>m:</b> is a hack, intended to
|
|
address certain situations involving the use of papers containing
|
|
FWA/OBE brighteners when viewed in an environment that has a very
|
|
noticeably warmer white point than the paper itself under the
|
|
illuminant. While the white point will remain that of the paper, it
|
|
allows the mid-tones to be partially adapted to a warmer white
|
|
point, possibly reducing visual discrepancy. NOTE though, that this
|
|
viewing situation doesn't often arise in real world viewing of such
|
|
media, as such documents are typically viewed in isolation or
|
|
against a background of other pieces of the same paper. Note that it
|
|
is a trap to evaluate such FWA/OBE rich paper using standard
|
|
proofing viewing conditions, since they deliberately use a
|
|
spectrally flat grey surround, unnaturally emphasizing the white
|
|
point difference between FWA/OBE rich papers and spectrally flat
|
|
neutrals, something that isn't present in real world conditions. The
|
|
<b>pm</b> preset condition has mtaf value of 0.7, and Wxyz2 of D50.<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
<br>
|
|
</body>
|
|
</html>
|