fakeread

From 094535c010320967639e8e86f974d878e80baa72 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Fri, 1 May 2015 16:13:57 +0200 Subject: Imported Upstream version 1.7.0 --- doc/fakeread.html | 186 ++++++++++++++++++++++++++++++------------------------ 1 file changed, 104 insertions(+), 82 deletions(-) (limited to 'doc/fakeread.html') 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 @@ fakeread + charset=windows-1252"> @@ -34,6 +34,9 @@ style="font-family: monospace;">profile.[icm|mpp|ti3] + + + inoutfile
-v @@ -44,24 +47,45 @@ Video encode device input to sepration as:
     n              + + + normal 0..1 full range RGB levels (default)
     t              + + + (16-235)/255 "TV" RGB levels
     6              + + + Rec601 YCbCr SD (16-235,240)/255 "TV" levels
     7              + + + Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels
     5              + + + Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels
     2              + + + Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels
     C              + + + Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV" levels
-p separation.icm Use device link separation @@ -69,7 +93,13 @@ -E flag           Video decode separation device output. See -e above
- -k file.cal       + -Z nbits        Quantize test values to fit in nbits
+ -k file.cal       + + + Apply calibration (include in .ti3 output)
-i file.cal       Include calibration in .ti3 output, but don't apply it
@@ -82,32 +112,42 @@ -0 pow            Apply power to device chanel 0-9
- -b output.icm     Apply - BT.1886-like mapping with effective gamma 2.2
- -b g.g:output.icm Apply BT.1886-like mapping with - effective gamma g.g
- -B output.icm     Apply - BT.1886 mapping with technical gamma 2.4
- -B g.g:output.icm Apply BT.1886 mapping with - technical gamma g.g
+ -B + display.icm          + Use BT.1886 source EOTF with technical gamma 2.4
+ -b g.g:display.icm      Use + BT.1886-like source EOTF with effective gamma g.g
+ -b p.p:g.g:display.icm Use effective gamma g.g + source EOTF with p.p prop. output black point offset
+ -g g.g:display.icm      Use + effective gamma g.g source EOTF with all output black point + offset
-I intent         r = relative colorimetric, a = absolute (default)
-A L,a,b          Scale black point to target Lab value
-l                + + + Output Lab rather than XYZ
-s                + + + Lookup MPP - spectral values
+ href="File_Formats.html#MPP">MPP spectral values
-R level          Add average random deviation of <level>% to output PCS values
-u                + + + Make random deviations have uniform distributions rather than normal
-S @@ -130,6 +170,9 @@ + + + Base name for input[.ti1]/output[ The -E flag applies a Video decoding to the output of the separation. See - -e for the list of decodings.
+ + + + -e 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.
+
+ -Z nbits 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 Q 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 dispcal -R 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.

The -k file.cal parameter specifies a - calibration file created by printcal or dispcal, and the supplied calibration + calibration file created by printcal or + dispcal, 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.

The -i file.cal parameter specifies a - printer calibration file created by printcal or dispcal, 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 printcal + or dispcal, 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 is not applied to tchart values. Note that if the supplied ICC profile contains VCGT calibration curves, that these will be included in the resulting .ti3 by default.

The -K file.cal parameter specifies - a calibration file created by printcal or dispcal, 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.
+ a calibration file created by printcal + or dispcal, 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.

The -r 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.

- The -b output.icm flag applies extra input - processing, applying BT.1886-like - - - - - - - - - - - - video gamma mapping using an effective gamma of 2.2 by default, and - overridable using -b g.g:output.icm where g.g is the - gamma. output.icm 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 + The -[b|B|g|G] [p.p:][g.g:]display.icm + series of options, substitutes an alternative EOTF (Electro-Optical + Transfer Function) for the one specified by the matrix input + profile. display.icm 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 collink, using the same BT.1886 - parameters.
-
- The -B output.icm flag applies extra - input processing, applying BT.1886-like - - - - - - - - - - - - video gamma mapping using a gamma of 2.4 by default, and overridable - using -B g.g:output.icm where g.g is the gamma. output.icm - 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.
+ using collink, using the same gamma + curve parameters. See collink -I b + for a full explanation of these parameters, and Verifying Video Calibration for more + detail.

The -I parameter allows changing the intent used in looking up the ICC -- cgit v1.2.3