summaryrefslogtreecommitdiff
path: root/doc/xicclu.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/xicclu.html')
-rw-r--r--doc/xicclu.html125
1 files changed, 114 insertions, 11 deletions
diff --git a/doc/xicclu.html b/doc/xicclu.html
index 831977d..bd98058 100644
--- a/doc/xicclu.html
+++ b/doc/xicclu.html
@@ -3,7 +3,7 @@
<head>
<title>xicclu</title>
<meta http-equiv="content-type" content="text/html;
- charset=ISO-8859-1">
+ charset=windows-1252">
<meta name="author" content="Graeme Gill">
</head>
<body>
@@ -29,9 +29,9 @@
<span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#v">-v level</a><span
style="font-family: monospace;"> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- Verbosity level 0 - 2 (default = 1)</span><br
- style="font-family: monospace;">
- <span style="font-family: monospace;">&nbsp;</span><a
+ Verbosity level 0 - 2 (default = 1)<br style="font-family:
+ monospace;">
+ </span> <span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#g">-g</a><span
style="font-family: monospace;"> &nbsp; &nbsp; &nbsp; &nbsp;
&nbsp; &nbsp; Plot slice instead of looking colors up. (Default
@@ -39,8 +39,11 @@
&nbsp;<a href="#Gs">-G s:L:a:b</a>&nbsp;&nbsp;&nbsp;&nbsp;
Override plot slice start with Lab or Jab co-ordinate<br>
&nbsp;<a href="#Ge">-G e:L:a:b</a>&nbsp;&nbsp;&nbsp;&nbsp;
- Override plot slice end with Lab or Jab co-ordinate<br
- style="font-family: monospace;">
+ Override plot slice end with Lab or Jab co-ordinate<br>
+ &nbsp;<a href="#V">-V</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+ Use 'vcgt' calibration tag from profile<br style="font-family:
+ monospace;">
</span><span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#f">-f function</a><span
style="font-family: monospace;">&nbsp;&nbsp;&nbsp; f = forward,
@@ -54,6 +57,8 @@ if
+
+
inverted forward, ib = inverted backwards</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -67,10 +72,13 @@ if
+
+
</span></small><small><span style="font-family: monospace;"> p =
perceptual, </span></small><small><span style="font-family:
- monospace;">s = saturation</span><span style="font-family:
- monospace;"></span><br style="font-family: monospace;">
+ monospace;">s = saturation, A = disp. abs. measurements</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="#o">-o order</a><span
style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -79,6 +87,8 @@ if
+
+
n = normal (priority: lut &gt; matrix &gt; monochrome)</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;&nbsp;
@@ -89,6 +99,8 @@ r
+
+
reverse (priority: monochrome &gt; matrix &gt; lut)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -99,6 +111,8 @@ r
+
+
x = XYZ_PCS, X = XYZ * 100, l = Lab_PCS, L = LCh, y = Yxy,<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; j =
CIECAM02 Appearance Jab, J = CIECAM02 Appearance JCh<br>
@@ -111,16 +125,22 @@ Scale
+
+
device range 0.0 - scale rather than 0.0 - 1.0<br>
</span></small><br>
&nbsp; <small><span style="font-family: monospace;"><small><span
style="font-family: monospace;"><a href="#e">-e flag</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
Video encode device input as:<br>
&nbsp;<a href="#E">-E flag</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
Video decode device output as:<br>
&nbsp;&nbsp;&nbsp;&nbsp;
n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -159,6 +179,8 @@ h
+
+
= 0.5 K, x = max K, r = ramp K (def.)</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;
@@ -169,6 +191,8 @@ l
+
+
= extra PCS input is portion of K locus</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;
@@ -179,6 +203,8 @@ v
+
+
= extra PCS input is K target value</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -192,6 +218,8 @@ stle:
+
+
K level at White 0.0 - 1.0</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;
@@ -202,6 +230,8 @@ stpo:
+
+
start point of transition Wh 0.0 - Bk 1.0</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;
@@ -212,6 +242,8 @@ enpo:
+
+
End point of transition Wh 0.0 - Bk 1.0</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;
@@ -222,6 +254,8 @@ enle:
+
+
K level at Black 0.0 - 1.0</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;
@@ -232,6 +266,8 @@ shape:
+
+
1.0 = straight, 0.0-1.0 concave, 1.0-2.0 convex</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -246,6 +282,8 @@ extra
+
+
PCS input to dual curve limits</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">&nbsp;</span><a
@@ -273,6 +311,8 @@ actual
+
+
target values if clipped<br>
&nbsp;<a href="#b">-b</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
use
@@ -282,6 +322,8 @@ CAM
+
+
Jab for clipping<br style="font-family: monospace;">
</span><span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#m">-m</a><span
@@ -304,6 +346,8 @@ either
+
+
an enumerated choice, or a parameter:value change</span><span
style="font-family: monospace;"></span><br style="font-family:
monospace;">
@@ -319,6 +363,8 @@ 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;
@@ -328,6 +374,8 @@ pc
+
+
- Critical print evaluation environment (ISO-3664 P1)</span></small><small><span
style="font-family: monospace;"></span><span style="font-family:
monospace;"></span><br style="font-family: monospace;">
@@ -342,6 +390,8 @@ pc
+
+
mb - Monitor in bright work environment</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;
@@ -372,6 +422,8 @@ 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;
@@ -382,6 +434,8 @@ 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;
@@ -392,6 +446,8 @@ Adapted
+
+
white point as XYZ (default media white, Abs: D50)</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -402,6 +458,8 @@ 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
@@ -411,6 +469,8 @@ Adaptation
+
+
luminance in cd.m^2 (default 50.0)</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">&nbsp; &nbsp;
@@ -428,12 +488,16 @@ light
+
+
% of image luminance (default 1)<br>
</span></small>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
g:glare&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Glare light % of ambient
(default 2)</span><br style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;&nbsp;&nbsp; &nbsp;
@@ -445,6 +509,8 @@ light
+
+
g:x:y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FGare color as
x, y</span><br style="font-family: monospace;">
<br style="font-family: monospace;">
@@ -497,6 +563,8 @@ light
If a CAL file is used, then <b>-g</b> will simply plot the each
channels calibration curve. It will also plot the invers curve for <b>-f
+
+
b</b>.<br>
<br>
<a name="Gs"></a>The <span style="font-weight: bold;">-G </span><small><span
@@ -517,6 +585,11 @@ light
separated by the '<span style="font-weight: bold;">:'</span>
character (no spaces).<br>
<br>
+ <a name="V"></a>The <b>-V</b> flag tells xicclu to load the given
+ ICC profile, and the extract the 'vcgt' display calibration curves
+ from the profile. The calibration curves can then be looked up in
+ the normal way, or plotted using <b>-g.</b><br>
+ <br>
<a name="f"></a> The <b>-f</b> flag selects which type of table or
conversion is to be used. In addition to the usual four tables that
can be accessed in a fully populated Lut based profile, two
@@ -529,6 +602,9 @@ light
<a name="i"></a> The <b>-i</b> flag selects the intent table used
for a lut based profile. It also selects between relative and
absolute colorimetric for non-lut base profiles.<br>
+ The -A flag selects Display absolute measurement mode, where the
+ Luminance tag value is used restore absolute measurement XYZ values.
+ The PCS will be force to be XYZ with this selection.<br>
<br>
<a name="o"></a> A profile is allowed to contain more than the
minimum number of elements or table needed to describe a certain
@@ -566,9 +642,8 @@ light
between 0 and 255, use <span style="font-weight: bold;">-s 255.</span><br>
<br>
<a name="e"></a>The <b>-e</b> <i>flag</i> applies a Video encoding
- to the input. See <a
- href="collink.html#E"><b>-E</b></a> for
- the list of encodings.<br>
+ to the input. See <a href="collink.html#E"><b>-E</b></a> for the
+ list of encodings.<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>
@@ -580,6 +655,8 @@ light
+
+
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;
@@ -587,6 +664,8 @@ light
+
+
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;
@@ -594,6 +673,8 @@ light
+
+
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;
@@ -601,6 +682,8 @@ light
+
+
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;
@@ -608,6 +691,8 @@ light
+
+
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;
@@ -615,6 +700,8 @@ light
+
+
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;
@@ -622,6 +709,8 @@ light
+
+
Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV"
levels<br>
</span></small></span></small><br>
@@ -635,6 +724,8 @@ light
+
+
with the addition of two extra options.<br>
<br>
&nbsp;Possible arguments to the <b>-k</b> option are:<br>
@@ -675,6 +766,8 @@ light
+
+
&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;
@@ -684,6 +777,8 @@ light
+
+
&nbsp; &nbsp;/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
|&nbsp;&nbsp;&nbsp;&nbsp;
@@ -693,6 +788,8 @@ light
+
+
&nbsp; /<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -702,6 +799,8 @@ light
+
+
&nbsp;/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -711,6 +810,8 @@ light
+
+
/<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
stle&nbsp; | ------/<br>
@@ -726,6 +827,8 @@ White&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nb
+
+
Black<br>
</tt><br>
<b><a name="kq"></a>-k q stle0 stpo0 enpo0 enle0 shape0 stle2 stpo2