From c07d0c2d2f6f7b0eb6e92cc6204bf05037957e82 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Mon, 1 Sep 2014 15:43:52 +0200 Subject: Imported Upstream version 1.6.3 --- doc/collink.html | 2365 ++++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 2121 insertions(+), 244 deletions(-) (limited to 'doc/collink.html') diff --git a/doc/collink.html b/doc/collink.html index 0b94bc7..778b682 100644 --- a/doc/collink.html +++ b/doc/collink.html @@ -27,6 +27,30 @@ style="font-family: monospace;">                 + + + + + + + + + + + + + + + + + + + + + + + + Verbose
 -A "manufacturer"
 
 -n
 
-  
+  -a file.cal +        Apply calibration + curves to link output and append linear
+  -H file.cal        + + + Append calibration curves to 3dlut
+  -s                 Simple Mode + + + + + + + + + + + + + + + + + + + + + + + + (default)
 -g [src.gam]

@@ -149,6 +327,30 @@ Gamut s + + + + + + + + + + + + + + + + + + + + + + + + = saturation, a = absolute colorimetric
 

@@ -178,302 +404,1382 @@ a - - Absolute Colorimetric (in Jab) [ICC Absolute Colorimetric]
-              -aw -- - Absolute Colorimetric (in Jab) with scaling to fit white point
-              -aa -- - Absolute Appearance
-               -r -- - White Point Matched Appearance [ICC Relative Colorimetric]
-              -la -- - Luminance matched Appearance
-               -p -- - Perceptual (Preferred) [ICC Perceptual]
-              -pa - - Perceptual Appearance
-              -ms -- - Saturation
-               -s -- - Enhanced Saturation [ICC Saturation]
+              +aw +- + + + + + + + + + + + + + + + + + + + + + + + + + + + Absolute Colorimetric (in Jab) with scaling to fit white point
+              +aa +- + + + + + + + + + + + + + + + + + + + + + + + + + + + Absolute Appearance
+               +r +- + + + + + + + + + + + + + + + + + + + + + + + + + + + White Point Matched Appearance [ICC Relative Colorimetric]
             -al +la - - Absolute Colorimetric (Lab)
-  -w [J,a,b]     Use forced - whitepoint hack [optional color to map the white to]
-  -c viewcond    set source viewing - conditions for CIECAM02,
-                -   -either - an enumerated choice, or a parameter
-  -d viewcond    set destination - viewing conditions for CIECAM02,
-                -   -either - an enumerated choice, or a parameter:value change
-   -             pp - Practical - Reflection Print (ISO-3664 P2)
-         -  -  -   pe - Print evaluation environment (CIE 116-1995)
-         -  -  -   pc - Critical print evaluation environment (ISO-3664 P1)
-    -            mt - Monitor in - typical work environment
-           -  -  - mb - Monitor in bright work environment
-       -         md - Monitor in darkened work - environment
-       -         jm - Projector in dim - environment
-       -         jd - Projector in dark - environment
-        -       pcd - Photo CD - original scene - outdoors
-       -         ob - Original scene - Bright - Outdoors
-       -         cx - Cut Sheet Transparencies - on a viewing box
-           -s:surround -n - = auto, a = average, m = dim, d = dark,
-                -  -    - c = transparency (default average)
-           -w:X:Y:Z       -Adapted - white point as XYZ (default media white)
-           -w:x:y         -Adapted - white point as x, y
-           -a:adaptation  -Adaptatation - luminance in cd.m^2 (default 50.0)
-           -b:background  -Background -% +               +p +- + + + + + + + + + + + + + + + + + + + + + + + + + + + Perceptual (Preferred) [ICC Perceptual]
+              +pa + + + + + + + + + + + + + + + + + + + + + + + + + + + - Perceptual Appearance
+              +ms +- + + + + + + + + + + + + + + + + + + + + + + + + + + + Saturation
+               +s +- + + + + + + + + + + + + + + + + + + + + + + + + + + + Enhanced Saturation [ICC Saturation]
+              +al +- + + + + + + + + + + + + + + + + + + + + + + + + + + + Absolute Colorimetric (Lab)
+              + + + + + + + + + + + + + + + + + + + + + + rl - White Point Matched Colorimetric (Lab)
+  -w [J,a,b]     Use forced + whitepoint hack [optional color to map the white to]
+  -c viewcond    set source viewing + conditions for CIECAM02,
+                +   +either + + + + + + + + + + + + + + + + + + + + + + + + + + + an enumerated choice, or a parameter
+  -d viewcond    set destination + viewing conditions for CIECAM02,
+                +   +either + + + + + + + + + + + + + + + + + + + + + + + + + + + an enumerated choice, or a parameter:value change
+   +             pp - Practical + Reflection Print (ISO-3664 P2)
+         +  +  + + + + + + + + + + + + + + + + + + + + + + + + + + +   pe - Print evaluation environment (CIE 116-1995)
+         +  +  + + + + + + + + + + + + + + + + + + + + + + + + + + +   pc - Critical print evaluation environment (ISO-3664 P1)
+    +            mt - Monitor in + typical work environment
+           +  +  + + + + + + + + + + + + + + + + + + + + + + + + + + + mb - Monitor in bright work environment
+       +         md - Monitor in darkened work + environment
+       +         jm - Projector in dim + environment
+       +         jd - Projector in dark + environment
+        +       pcd - Photo CD - original scene + outdoors
+       +         ob - Original scene - Bright + Outdoors
+       +         cx - Cut Sheet Transparencies + on a viewing box
+           +s:surround +n + + + + + + + + + + + + + + + + + + + + + + + + + + + = auto, a = average, m = dim, d = dark,
+                +  +    + + + + + + + + + + + + + + + + + + + + + + + + + + + c = transparency (default average)
+           +w:X:Y:Z       +Adapted + + + + + + + + + + + + + + + + + + + + + + + + + + + white point as XYZ (default media white)
+           +w:x:y         +Adapted + + + + + + + + + + + + + + + + + + + + + + + + + + + white point as x, y
+           +a:adaptation  +Adaptatation + + + + + + + + + + + + + + + + + + + + + + + + + + + luminance in cd.m^2 (default 50.0)
+           +b:background  +Background +% + + + + + + + + + + + + + + + + + + + + + + + + + + + of image luminance (default 20)
+           l:imagewhite  + Image white in cd.m^2 if surround = auto (default 250)
+           +f:flare       +Flare +light + + + + + + + + + + + + + + + + + + + + + + + + + + + % of image luminance (default 0)
+           + g:glare       Glare light % of + ambient (default 1)
+           + + + + + + + + + + + + + + + + g:X:Y:Z       Glare color as XYZ + (default media white)
+           + + + + + + + + + + + + + + + + g:x:y         Glare + color as x, y
+  -t tlimit          +set +source + + + + + + + + + + + + + + + + + + + + + + + + + + + total ink limit, 0 - 400% (estimate by default)
+  -T klimit          +set +source + + + + + + + + + + + + + + + + + + + + + + + + + + + total ink limit, 0 - 100% (estimate by default)
+
+        Inverse outprofile A2B Options:
+  -k tezhxr   +      CMYK Black generation
+                +   +t + + + + + + + + + + + + + + + + + + + + + + + + + + + = transfer K from source to destination, e = retain K of + destination B2A table
+                +   +z + + + + + + + + + + + + + + + + + + + + + + + + + + + = zero K, h = 0.5 K, x = maximum K, r = ramp K (default)
+  -k p stle stpo enpo + enle shape
+                +   +p + + + + + + + + + + + + + + + + + + + + + + + + + + + = black level generation curve parameters
+  -k q stle0 stpo0 + enpo0 enle0 shape0 stle2 stpo2 enpo2 enle2 shape2
+                +   +q + + + + + + + + + + + + + + + + + + + + + + + + + + + = transfer source K to dual curve limits
+  -K parameters      + Same as -k, but target is K locus rather than K value itself
+  -l tlimit          +set +destination + + + + + + + + + + + + + + + + + + + + + + + + + + + total ink limit, 0 - 400% (estimate by default)
+  -L klimit          +set +destination + + + + + + + + + + + + + + + + + + + + + + + + + + + total ink limit, 0 - 100% (estimate by default)
+  -3 flag            + + + + + + + + + + + + + + + + + + + + + Create "3DLut" output file as well as devlink
+      + e               + + + + + + + + + + + + + + + + + + + + + eeColor .txt file
+      + m               + + + + + + + + + MadVR .3dlut   file
+  -I b               + + + + + + + + + + + + + + + + + + + + + Apply BT.1886-like mapping with effective gamma 2.2 to input
+  -I + b:g.g           + + + + + + + + + + + + + + Apply BT.1886-like mapping with effective gamma g.g to + input
+  -I B +               + + + + + + + + + + + + + + Apply BT.1886 mapping with technical gamma 2.4 to input
+  -I B:g.g           + + + + + + + + + + + + + + Apply BT.1886-like mapping with technical gamma g.g to input
+  -e flag            + + + + + + + + + + + + + + + + + + + + + Video encode input as:
+  -E flag            + + + + + + + + + + + + + + + + + + + + + Video encode output as:
+      + n                + + + + + + + + + + normal RGB 0..1 levels (default)
+      + t                + + + + + + + + + + RGB (16-235)/255 "TV" 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
+      + x                + + + + + + + + + + xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV" + levels
+      + X                + + + + + + + + + + xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV" + levels
+    -P +                 +Create +gamut - of image luminance (default 20)
-           l:scenewhite  - Scene white in cd.m^2 if surround = auto (default 250)
-           -f:flare       -Flare -light - % of image luminance (default 1)
-           -f:X:Y:Z       -Flare - color as XYZ (default media white)
-           -f:x:y         -Flare - color as x, y
-  -t tlimit          -set -source - total ink limit, 0 - 400% (estimate by default)
-  -T klimit          -set -source - total ink limit, 0 - 100% (estimate by default)
-
-        Inverse outprofile A2B Options:
-  -k tezhxr   -      CMYK Black generation
-                -   -t - = transfer K from source to destination, e = retain K of - destination B2A table
-                -   -z - = zero K, h = 0.5 K, x = maximum K, r = ramp K (default)
-  -k p stle stpo enpo - enle shape
-                -   -p - = black level generation curve parameters
-  -k q stle0 stpo0 - enpo0 enle0 shape0 stle2 stpo2 enpo2 enle2 shape2
-                -   -q - = transfer source K to dual curve limits
-  -K parameters      - Same as -k, but target is K locus rather than K value itself
-  -l tlimit          -set -destination - total ink limit, 0 - 400% (estimate by default)
-  -L klimit          -set -destination - total ink limit, 0 - 100% (estimate by default)
-   -P -                 -Create -gamut gammap_p.wrl and gammap_s.wrl diagostics
-
 TIFF + + + + + + + + + + + + + + + + + + + + + + + + or JPEG file with embedded profile may be used here.
  A TIFF or JPEG file with embedded profile may be used here.
The -p option alows specifying an abstract - profile be applied between the source and destination profiles. An - abstract profile is a way of specifying a color adjustment in a - device independent way. The abstract profile might have been created - using one of the tweak + The -p 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 tweak tools, such as refine.

+ The -a 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.
+
+ The -H 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.
+
The basic linking style is chosen by using the -s (default), -g or -G flags. The three behaviors are:

@@ -698,6 +2115,30 @@ ICC except the last one (no. 7), + + + + + + + + + + + + + + + + + + + + + + + + the space should be Jab appearance space, with the viewing conditions generally being those of the source profile viewing conditions. The source profile will normally be the one used to @@ -710,6 +2151,30 @@ ICC   + + + + + + + + + + + + + + + + + + + + + + + +  p = perceptual, r = relative colorimetric,
                            s @@ -778,10 +2243,10 @@ ICC
The la intent, Luminance matched appearance, linearly compresses or - expands the the luminance axis to match the source to the - destination space, while not otherwise altering the gamut, - clipping any out of gamut colors to the closest match. This is - often useful for appearance based soft proofing.
+ 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.

The  p intent, Perceptual, uses "knee" type 3 Dimensional compression to @@ -816,11 +2281,18 @@ ICC The white point is mapped precisely from source to destination.

The al - intent, Absolute Appearance (Lab), is similar to intent a, 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.
+ intent, Absolute Colorimetric (Lab), is similar to intent a, 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.
+
+ The ar + intent, White Point Matched Colorimetric (Lab), is similar to + intent r, 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.

The -w flag forces the white points to be @@ -919,30 +2391,150 @@ ICC    + + + + + + + + + + + + + + + + + + + + + + + +    _______  enle
                 |        + + + + + + + + + + + + + + + + + + + + + + + +    /
                 |        + + + + + + + + + + + + + + + + + + + + + + + +   /
                 |        + + + + + + + + + + + + + + + + + + + + + + + +  /
                 |        + + + + + + + + + + + + + + + + + + + + + + + + /
           stle  | ------/
@@ -955,6 +2547,30 @@ ICC White              + + + + + + + + + + + + + + + + + + + + + + + + Black

For minimum sensitivity of printed output to the lighting @@ -1023,6 +2639,243 @@ White            &nb in final calibrated device values if the profile includes calibration information.

+ The -3 flag triggers creation of a + "3dLut" of one of the following formats:
+     e        eeColor format ".txt" files. + This includes 3 input curve files, the cLut file and 3 output curve + files.
+     m       MadVR + format ".3dlut" file.
+
+ 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 -3 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 (-r), and the use of 1D input and + output curves (-n). Other parameters (such as -I, -e + and -E) may have to be set to get a table suitable for the + particular target and situation.
+
+ The -3 e 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 (-e + t or -e 7 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 (-e x and -e + X) 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.
+
+  For this reason collink generates the following 7 files:
+
+     basename-first1dred.txt
+     basename-first1dgreen.txt
+     basename-first1dblue.txt
+     test.txt
+     basename-second1dred.txt
+     basename-second1dgreen.txt
+     basename-second1dblue.txt
+
+ even though the 1d files will be linear for all cases except the + normal and xvYCC input range.
+
+ The MadVR format is an 8 bit input, 16 bit output cLUT of 100 Mbytes + size, and will written to the file basename.3dlut. 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.
+
+ There is more information on the Typical + Usage Scenarios page.
+
+ The -I b flag applies extra input + processing, applying BT.1886-like + + + + + + + + + + + + + + video gamma mapping using an effective gamma of 2.2 by default, and + overridable using -I b:g.g where g.g is the gamma. + The gamma is an effective gamma, meaning that its effect on 50% + input is the same as that of a pure power curve, in spite of any + black offset added by BT.1886. This has the benefit of making the + overall effect of brightness independent of the black level of the + display. Setting an effective gamma other than 2.2 is one way of + making the viewing condition adjustment for the different conditions + of video encoding and decoding, or for modelling the source + colorspace as a rendering on a video display. This would be used as + an alternative to using gamut mapping mode and setting explicit + input and output viewing conditions, or in combination with + appearance adjustments. BT.1886 will only work with matrix type + input profiles. The default value of 2.2 is probably suitable for + dim viewing conditions, and it may be desirable to override this + default if your viewing conditions are darker or lighter. For + lighter conditions, try "-I b:2.2". For darker conditions, try "-I + b:2.6".
+
+ The -I B flag applies extra input + processing, applying BT.1886 + video gamma mapping using the BT.1886 gamma of 2.4 by default, and + overridable using -I b:g.g where g.g is the gamma. + The gamma is the technical gamma, or power applied to the input + image, and this means that its effect on 50% input will depend on + the black level of the display, making the overall brightness + somewhat unpredictable. For a more predictable effect, use -I b.
+
+ The -e flag applies a Video + encoding to the input. See below and -E + for the list of encodings.
+
+      + x                + + + + + + + + + + xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV" + levels
+      + X                + + + + + + + + + + xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV" + levels
+
+ 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 source profile provided to collink is used to + define the source gamut for gamut mapping, and also the space that + any BT.1886 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.
+
+ The -E flag applies a Video + encoding to the output. The possible encoding are:
+
+      + n                + + + + + + + + + + normal RGB 0..1 full range levels (default)
+      + t                + + + + + + + + + + RGB (16-235)/255 "TV" 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
+
+
The -P option causes a diagnostic 3D VRML plots to be created that illustrate the gamut mapping generated.
@@ -1044,6 +2897,30 @@ White            &nb For information on typical usage, see the Typical + + + + + + + + + + + + + + + + + + + + + + + + Usage Scenarios page.


-- cgit v1.2.3