summaryrefslogtreecommitdiff
path: root/doc/fakeread.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/fakeread.html')
-rw-r--r--doc/fakeread.html186
1 files changed, 104 insertions, 82 deletions
diff --git a/doc/fakeread.html b/doc/fakeread.html
index 2a7b5c0..376e971 100644
--- a/doc/fakeread.html
+++ b/doc/fakeread.html
@@ -3,7 +3,7 @@
<head>
<title>fakeread</title>
<meta http-equiv="content-type" content="text/html;
- charset=ISO-8859-1">
+ charset=windows-1252">
<meta name="author" content="Graeme Gill">
</head>
<body>
@@ -34,6 +34,9 @@
style="font-family: monospace;"></span><i style="font-family:
monospace;">profile.</i><span style="font-family: monospace;">[icm|mpp|ti3]
+
+
+
</span><i style="font-family: monospace;">inoutfile</i></small><small><span
style="font-family: monospace;"><br>
&nbsp;-v
@@ -44,24 +47,45 @@
Video encode device input to sepration as:<br>
&nbsp;&nbsp;&nbsp;&nbsp;
n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
normal 0..1 full range RGB levels (default)<br>
&nbsp;&nbsp;&nbsp;&nbsp;
t&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
(16-235)/255 "TV" RGB levels<br>
&nbsp;&nbsp;&nbsp;&nbsp;
6&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;
+
+
+
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;
+
+
+
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;
+
+
+
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;
+
+
+
Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV"
levels<br>
&nbsp;-p <i>separation.icm</i> Use device link separation
@@ -69,7 +93,13 @@
&nbsp;-E
flag&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Video decode separation device output. See -e above<br>
- &nbsp;-k <i>file.cal</i>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ &nbsp;-Z nbits&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp; </span></small><small><span
+ style="font-family: monospace;"><small><span style="font-family:
+ monospace;">Quantize test values to fit in nbits<br>
+ </span></small>&nbsp;-k <i>file.cal</i>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
Apply calibration (include in .ti3 output)<br>
&nbsp;-i <i>file.cal</i>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Include calibration in .ti3 output, but don't apply it<br>
@@ -82,32 +112,42 @@
&nbsp;-0
pow&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Apply power to device chanel 0-9<br>
- &nbsp;-b <i>output.icm</i>&nbsp;&nbsp;&nbsp;&nbsp; Apply
- BT.1886-like mapping with effective gamma 2.2<br>
- &nbsp;-b g.g:<i>output.icm</i> Apply BT.1886-like mapping with
- effective gamma g.g<br>
- &nbsp;-B <i>output.icm</i>&nbsp;&nbsp;&nbsp;&nbsp; Apply
- BT.1886 mapping with technical gamma 2.4<br>
- &nbsp;-B g.g:<i>output.icm</i> Apply BT.1886 mapping with
- technical gamma g.g<br>
+ &nbsp;-B
+ display.icm&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ Use BT.1886 source EOTF with technical gamma 2.4<br>
+ &nbsp;-b g.g:display.icm&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Use
+ BT.1886-like source EOTF with effective gamma g.g<br>
+ &nbsp;-b p.p:g.g:display.icm&nbsp; Use effective gamma g.g
+ source EOTF with p.p prop. output black point offset<br>
+ &nbsp;-g g.g:display.icm&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Use
+ effective gamma g.g source EOTF with all output black point
+ offset<br>
&nbsp;-I intent&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
r = relative colorimetric, a = absolute (default)<br>
&nbsp;-A
L,a,b&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Scale black point to target Lab value<br>
&nbsp;-l&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
Output Lab rather than XYZ<br>
&nbsp;-s&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
Lookup </span></small><small><span style="font-family:
monospace;"><small><a style="font-family: monospace;"
- href="File_Formats.html#MPP">MPP</a></small>
- spectral values</span></small><br>
+ href="File_Formats.html#MPP">MPP</a></small> spectral values</span></small><br>
<small><span style="font-family: monospace;"><small><span
style="font-family: monospace;">&nbsp;-R
level&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Add average random deviation of &lt;level&gt;% to output PCS
values<br>
</span></small>&nbsp;-u&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
Make random deviations have uniform distributions rather than
normal<br>
&nbsp;-S
@@ -130,6 +170,9 @@
&nbsp;
+
+
+
&nbsp; Base name for input[</span><a style="font-family:
monospace;" href="File_Formats.html#.ti1">.ti1</a><span
style="font-family: monospace;">]/output[</span><a
@@ -179,12 +222,34 @@
<br>
<a name="E"></a>The <b>-E</b> <i>flag</i> applies a Video decoding
to the output of the separation.<small><small> &nbsp; </small></small>See
- <a href="#e"><b>-e</b></a> for the list of decodings.<br>
+
+
+
+ <a href="#e"><b>-e</b></a> for the list of decodings. Setting a
+ video encoding for output will also set quantization of 8 bits (see
+ -Z flag below). If your video connection is better than 8 bits (ie.
+ 10 or 12 bits), then you may wish to raise this default.<br>
+ <br>
+ <a name="Z"></a> <b>-Z nbits </b>Normally the target device values
+ are floating point numbers that may get rounded and quantized in the
+ process of printing them or reproducing them on the display device.
+ If some of this quantization can be accounted for, it may improve
+ the accuracy of the resulting profile, and the <span
+ style="font-weight: bold;">Q</span> parameter allows this
+ quantization to be specified. The parameter is the number of binary
+ digits (bits) that the device values should be quantized to. An idea
+ of the number of bits of precision that makes its way to your
+ display can be obtained by using <a
+ href="file:///D:/src/argyll/doc/dispcal.html#R">dispcal -R</a> If
+ Video encoding is selected (see -E flag above), then 8 bits is
+ selected by default. On systems using an VGA connection or Display
+ Port with a graphics card with VideoLUT entries with greater than 8
+ bits depth, or if using the MadVR rendered with dithering, then a
+ higher bit depth is typically possible.<br>
<br>
<a name="k"></a>The <b>-k file.cal</b> parameter specifies a
- calibration file created by <a
- href="printcal.html">printcal</a> or <a
- href="dispcal.html">dispcal</a>, and the supplied calibration
+ calibration file created by <a href="printcal.html">printcal</a> or
+ <a href="dispcal.html">dispcal</a>, and the supplied calibration
curves will be applied to the chart device values after any
separation and before the device profile. This allows emulating a
system that uses per device channel calibration. The calibration
@@ -193,26 +258,24 @@
computation of ink limits.<br>
<br>
<a name="i"></a> The <b>-i file.cal</b> parameter specifies a
- printer calibration file created by <a
- href="printcal.html">printcal</a> or <a
- href="dispcal.html">dispcal</a>, and the
- calibration curves will be included in the included in the resulting
- .ti3 file, so that they can be passed through to the ICC profile, to
- allow accurate computation of ink limits. The calibration <span
+ printer calibration file created by <a href="printcal.html">printcal</a>
+ or <a href="dispcal.html">dispcal</a>, and the calibration curves
+ will be included in the included in the resulting .ti3 file, so that
+ they can be passed through to the ICC profile, to allow accurate
+ computation of ink limits. The calibration <span
style="font-weight: bold;">is not applied</span> to tchart values.
<span style="font-weight: bold;">Note</span> that if the supplied
ICC profile contains VCGT calibration curves, that these will be
included in the resulting .ti3 by default.<br>
<br>
<a name="K"></a>The <b>-K</b> <b>file.cal</b> parameter specifies
- a calibration file created by <a
- href="printcal.html">printcal</a> or <a
- href="dispcal.html">dispcal</a>, and the
- inverse of the supplied calibration curves will be applied to the
- chart device values after any separation and before the device
- profile. This allows for undoing calibration curves that may be part
- of a video calibration device link, so that the (calibrated device
- value) device profile will work as expected.<br>
+ a calibration file created by <a href="printcal.html">printcal</a>
+ or <a href="dispcal.html">dispcal</a>, and the inverse of the
+ supplied calibration curves will be applied to the chart device
+ values after any separation and before the device profile. This
+ allows for undoing calibration curves that may be part of a video
+ calibration device link, so that the (calibrated device value)
+ device profile will work as expected.<br>
<br>
<a name="r"></a>The <span style="font-weight: bold;">-r</span>
parameter is a way of simulating instability in the behaviour of the
@@ -230,59 +293,18 @@
them to the power of the parameter. This applies a transfer curve to
the simulated device response.<br>
<br>
- <a name="b"></a>The <b>-b output.icm</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>-b g.g:output.icm</b> where <b>g.g</b> is the
- gamma. <b>output.icm</b> is the display ICC profile that provides
- the black point that the BT.1886 curves will target. 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. BT.1886 will only work with matrix type input
- profiles. Typically this will be used to create a verification test
+ <b><a name="b"></a></b>The <b>-[b|B|g|G] [p.p:][g.g:]</b><b>display.icm</b>
+ series of options, substitutes an alternative EOTF (Electro-Optical
+ Transfer Function) for the one specified by the matrix input
+ profile. <b>display.icm</b> is the display ICC profile that
+ provides the black point that the gamma curve curves will target.
+ Typically these options will be used to create a verification test
set for checking the operation of a device link or 3dLut created
- using <a href="collink.html">collink</a>, using the same BT.1886
- parameters.<br>
- <br>
- <b><a name="B"></a></b>The <b>-B output.icm</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 a gamma of 2.4 by default, and overridable
- using <b>-B g.g:output.icm</b> where <b>g.g</b> is the gamma. <b>output.icm</b>
- is the display ICC profile that provides the black point that the
- BT.1886 curves will target. 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>-b</b>.<br>
+ using <a href="collink.html">collink</a>, using the same gamma
+ curve parameters. See <a href="collink.html#Ib">collink -I b</a>
+ for a full explanation of these parameters, and <a
+ href="Scenarios.html#TV2">Verifying Video Calibration</a> for more
+ detail.<br>
<br>
<a name="I"></a>The <span style="font-weight: bold;">-I</span>
parameter allows changing the intent used in looking up the ICC