From f6b8e0eae4374f339487a33e3e4fe5462d5816e1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Sat, 25 Nov 2017 10:16:00 +0100 Subject: New upstream version 2.0.0 --- doc/collink.html | 1067 ++++++++++++++++++++++++++++++++---------------------- 1 file changed, 633 insertions(+), 434 deletions(-) mode change 100644 => 100755 doc/collink.html (limited to 'doc/collink.html') diff --git a/doc/collink.html b/doc/collink.html old mode 100644 new mode 100755 index dc67463..b746c5d --- a/doc/collink.html +++ b/doc/collink.html @@ -19,12 +19,12 @@ or to retain the source black characteristic from the source profile.

Usage Summary

- collink [-options] srcprofile dstprofile - linkedprofile
-  -v                 + collink [-options] srcprofile dstprofile linkedprofile
+  -v                 @@ -63,32 +63,34 @@ - Verbose
-  -A "manufacturer"  Set the manufacturer - description string
-  -M "model" -         Set the model - description string
-  -D "description"   Set the profile - Description string  (Default "inoutfile")
-  -C "copyright"     Set the - copyright string
 -A "manufacturer"  Set the manufacturer + description string
+  -M "model" +         Set the model + description string
+  -D "description"   Set the profile + Description string  (Default "inoutfile")
-  -V                 +  -C "copyright"     Set the + copyright string
+  -V                 Verify existing @@ -129,16 +131,19 @@ existing - profile, rather than link (Debug option)
-  -q lmhu      -       Quality - Low, Medium (def), - High, Ultra
-  -r res             + + + + profile, rather than link (Debug option)
+  -q lmhu      +       Quality - Low, Medium (def), High, + Ultra
+  -r res             Override clut @@ -179,10 +184,13 @@ clut - res. set by -q
-  -n                 + + + + res. set by -q
+  -n                 Don't preserve @@ -223,36 +231,38 @@ preserve - device curves in result
-  -f -           -       Special :- Force neutral colors - to be K only output.
-  -fk -           -      Special :- Force K only neutral colors - to be K only output
-  -fcmy -           -    Special :- Force 100% C,M or Y only to stay pure

+  -f -  -F -           -       Special :- Force all colors to be - K only output.
-  -p aprof.icm       +           +       Special :- Force neutral colors to + be K only output.
+  -fk +           +      Special :- Force K only neutral colors to + be K only output
+  -fcmy +           +    Special :- Force 100% C,M or Y only to stay pure
+  -F +           +       Special :- Force all colors to be K + only output.
+  -p aprof.icm       Include @@ -292,14 +302,16 @@ Include - abstract profile in link
-  -a file.cal -        Apply calibration - curves to link output and append linear
-  -H file.cal        + + + + abstract profile in link
+  -a file.cal +        Apply calibration curves + to link output and append linear
+  -H file.cal        @@ -314,11 +326,14 @@ Include - Append calibration curves to 3dlut
-  -s                 + + + + Append calibration curves to 3dlut
+  -s                 Simple Mode @@ -359,15 +374,18 @@ Mode - (default)
-  -g [src.gam]       - Gamut Mapping Mode [optional source image gamut]
-  -G [src.gam]       + + + + (default)
+  -g [src.gam]       + Gamut Mapping Mode [optional source image gamut]
+  -G [src.gam]       Gamut @@ -407,18 +425,21 @@ Gamut - Mapping Mode using inverse outprofile A2B [optional source - gamut]
-
-      Simple Mode Options:
-  -i in_intent      p = - perceptual, r = relative colorimetric,
-                + + + + Mapping Mode using inverse outprofile A2B [optional source gamut]
+
+      Simple Mode Options:
+  -i in_intent      p = + perceptual, r = relative colorimetric,
+                    s @@ -459,15 +480,18 @@ s - = saturation, a = absolute colorimetric
-  -o out_intent     p = - perceptual, r = relative colorimetric,
-                + + + + = saturation, a = absolute colorimetric
+  -o out_intent     p = perceptual, + r = relative colorimetric,
+                    s @@ -508,18 +532,21 @@ s - = saturation, a = absolute colorimetric
-
-      Mapping Mode Options:
-  -i intent      - set linking intent from the following choice:
-               + + + + = saturation, a = absolute colorimetric
+
+      Mapping Mode Options:
+  -i intent      set + linking intent from the following choice:
+               a - @@ -560,8 +587,11 @@ a - Absolute Colorimetric (in Jab) [ICC Absolute Colorimetric]
-              + + + + Absolute Colorimetric (in Jab) [ICC Absolute Colorimetric]
+              aw - @@ -602,9 +632,12 @@ aw - Absolute Colorimetric (in Jab) with scaling to fit white point
-              + + + + Absolute Colorimetric (in Jab) with scaling to fit white point
+              aa - @@ -645,8 +678,11 @@ aa - Absolute Appearance
-               + + + + Absolute Appearance
+               r - @@ -687,9 +723,12 @@ r - White Point Matched Appearance [ICC Relative Colorimetric]
-              + + + + White Point Matched Appearance [ICC Relative Colorimetric]
+              la - @@ -730,9 +769,12 @@ la - Luminance matched Appearance
-               + + + + Luminance matched Appearance
+               p - @@ -773,8 +815,11 @@ p - Perceptual (Preferred) [ICC Perceptual]
-              + + + + Perceptual (Preferred) [ICC Perceptual]
+              pa @@ -814,12 +859,18 @@ pa - - Perceptual Appearance
+ + + + - Perceptual Appearance
             + + + lp - Luminance Preserving Perceptual
-              +              ms - @@ -860,8 +911,11 @@ ms - Saturation
-               + + + + Saturation
+               s - @@ -902,9 +956,12 @@ s - Enhanced Saturation [ICC Saturation]
-              + + + + Enhanced Saturation [ICC Saturation]
+              al - @@ -945,11 +1002,11 @@ al - Absolute Colorimetric (Lab)
-              + Absolute Colorimetric (Lab)
+              @@ -980,14 +1037,23 @@ al - rl - White Point Matched Colorimetric (Lab)
-  -w [J,a,b]     Use forced - whitepoint hack [optional color to map the white to]
-  -b             + + + + + + + rl - White Point Matched Colorimetric (Lab)
+  -w [J,a,b]     Use forced + whitepoint hack [optional color to map the white to]
+  -b             + + + @@ -997,14 +1063,13 @@ al - Use RGB->RGB forced black point hack
-  -c viewcond    set source viewing - conditions for CIECAM02,
-                +  -c viewcond    set source viewing + conditions for CIECAM02,
+                   either @@ -1045,14 +1110,17 @@ either - an enumerated choice, or a parameter
-  -d viewcond    set destination - viewing conditions for CIECAM02,
-                + + + + an enumerated choice, or a parameter
+  -d viewcond    set destination + viewing conditions for CIECAM02,
+                   either @@ -1093,12 +1161,27 @@ either - an enumerated choice, or a parameter:value change
-   -             pp - Practical - Reflection Print (ISO-3664 P2)
-         + + + + an enumerated choice, or a parameter:value change
+               pc + - Critical print evaluation environment (ISO-3664 P1)
+               + + + + + pp - Practical Reflection Print (ISO-3664 P2)
+             +   pe - Print evaluation environment (CIE 116-1995)
+             +   pm - Print evaluation with partial Mid-tone adapation
+    +            mt - Monitor in + typical work environment
+               @@ -1139,13 +1222,32 @@ either -   pe - Print evaluation environment (CIE 116-1995)
-         -  -  + 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 @@ -1181,24 +1283,17 @@ either -   pc - Critical print evaluation environment (ISO-3664 P1)
-    -            mt - Monitor in - typical work environment
-           -  -  + = auto, a = average, m = dim, d = dark,
+                +  +    @@ -1231,29 +1326,6 @@ either - 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 @@ -1263,6 +1335,11 @@ n + c = transparency (default average)
+           +w:X:Y:Z       +Adapted @@ -1292,11 +1369,6 @@ n - = auto, a = average, m = dim, d = dark,
-                -  -    @@ -1309,6 +1381,11 @@ n + white point as XYZ (default media white)
+           +w:x:y         +Adapted @@ -1335,11 +1412,6 @@ n - c = transparency (default average)
-           -w:X:Y:Z       -Adapted @@ -1355,6 +1427,10 @@ Adapted + white point as x, y
+           +a:adaptation  +Adaptatation @@ -1378,11 +1454,6 @@ Adapted - white point as XYZ (default media white)
-           -w:x:y         -Adapted @@ -1401,6 +1472,12 @@ Adapted + luminance in cd.m^2 (default 50.0)
+           +b:background  +Background +% @@ -1421,10 +1498,6 @@ Adapted - white point as x, y
-           -a:adaptation  -Adaptatation @@ -1446,6 +1519,15 @@ Adaptatation + of image luminance (default 20)
+           l:imagewhite  + Image white in cd.m^2 if surround = auto (default 250)
+           +f:flare       +Flare +light @@ -1463,12 +1545,6 @@ Adaptatation - luminance in cd.m^2 (default 50.0)
-           -b:background  -Background -% @@ -1493,7 +1569,12 @@ Background + % of image luminance (default 0)
+           + g:glare       Glare light % of + ambient (default 5)
+           @@ -1507,15 +1588,6 @@ Background - of image luminance (default 20)
-           l:imagewhite  - Image white in cd.m^2 if surround = auto (default 250)
-           -f:flare       -Flare -light @@ -1533,6 +1605,9 @@ light + g:X:Y:Z       Glare color as XYZ + (default media white)
+           @@ -1554,12 +1629,6 @@ light - % of image luminance (default 0)
-           - g:glare       Glare light % of - ambient (default 5)
-           @@ -1569,10 +1638,34 @@ light + g:x:y         Glare color + as x, y
+           + h:hkscale     Helmholtz-Kohlrausch + effect scale factor (default 1.0)
+           + m:mtaf        Mid-tone + partial adaptation factor (default 0.0)
+           + m:X:Y:Z       Mid-tone + Adaptation white as XYZ (default D50)
+   +         + m:x:y         + Mid-tone Adaptation white as x, y
+   -t + tlimit          +set +source @@ -1587,9 +1680,6 @@ light - g:X:Y:Z       Glare color as XYZ - (default media white)
-           @@ -1617,11 +1707,11 @@ light - g:x:y         Glare - color as x, y
-  -t tlimit          + total ink limit, 0 - 400% (estimate by default)
+  -T klimit          set source @@ -1662,19 +1752,23 @@ 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 @@ -1707,20 +1801,6 @@ source - total ink limit, 0 - 100% (estimate by default)
-
-        Inverse outprofile A2B Options:
-  -k tezhxr   -      CMYK Black generation
-                -   -t @@ -1730,6 +1810,11 @@ t + = transfer K from source to destination, e = retain K of + destination B2A table
+                +   +z @@ -1759,11 +1844,6 @@ t - = transfer K from source to destination, e = retain K of - destination B2A table
-                -   -z @@ -1776,6 +1856,14 @@ z + = zero K, h = 0.5 K, x = maximum K, r = ramp K (default)
+  -k p stle stpo enpo + enle shape
+                +   +p @@ -1802,14 +1890,6 @@ z - = zero K, h = 0.5 K, x = maximum K, r = ramp K (default)
-  -k p stle stpo enpo - enle shape
-                -   -p @@ -1825,6 +1905,15 @@ p + = black level generation curve parameters
+  -k q stle0 stpo0 enpo0 + enle0 shape0 stle2 stpo2 enpo2 enle2 shape2
+                +   +q @@ -1848,15 +1937,6 @@ p - = black level generation curve parameters
-  -k q stle0 stpo0 - enpo0 enle0 shape0 stle2 stpo2 enpo2 enle2 shape2
-                -   -q @@ -1875,6 +1955,18 @@ 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 @@ -1895,18 +1987,6 @@ 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 @@ -1928,6 +2008,13 @@ destination + total ink limit, 0 - 400% (estimate by default)
+  -L klimit          +set +destination @@ -1945,13 +2032,6 @@ destination - total ink limit, 0 - 400% (estimate by default)
-  -L klimit          -set -destination @@ -1976,6 +2056,8 @@ destination + total ink limit, 0 - 100% (estimate by default)
+  -3 flag            @@ -1990,8 +2072,6 @@ destination - total ink limit, 0 - 100% (estimate by default)
-  -3 flag            @@ -2013,6 +2093,9 @@ destination + Create "3DLut" output file as well as devlink
+      + e               @@ -2024,9 +2107,6 @@ destination - Create "3DLut" output file as well as devlink
-      - e               @@ -2051,6 +2131,9 @@ destination + eeColor .txt file
+      + m               @@ -2059,9 +2142,6 @@ destination - eeColor .txt file
-      - m               @@ -2077,13 +2157,16 @@ destination + MadVR .3dlut   file
+      + c               + IRIDAS .cube file
+  -I B               - MadVR .3dlut   file
-  -I B               @@ -2100,17 +2183,15 @@ destination BT.1886-like source EOTF with effective gamma g.g
 -I b:p.p:g.g       Use effective gamma g.g source EOTF - with p.p prop. output black point offset
-  -I - g:g.g -           Use - effective gamma g.g source EOTF with all output black - point offset
-  -e flag            + with p.p prop. output black point offset
+  -I g:g.g +           Use + effective gamma g.g source EOTF with all output black point + offset
+  -e flag            @@ -2143,11 +2224,11 @@ destination - Video encode input as:
-  -E flag            + Video encode input as:
+  -E flag            @@ -2177,17 +2258,16 @@ destination - Video encode output as:
-      - n                + Video encode output as:
+      + n                @@ -2203,9 +2283,6 @@ destination - normal RGB 0..1 levels (default)
-      - t                @@ -2215,6 +2292,9 @@ destination + normal RGB 0..1 levels (default)
+      + t                @@ -2227,16 +2307,9 @@ destination - RGB (16-235)/255 "TV" levels
-      - T -                @@ -2246,6 +2319,11 @@ destination + RGB (16-235)/255 "TV" levels
+      T +                @@ -2258,9 +2336,6 @@ destination - RGB (16-235)/255 "TV" levels, clip WTW [Input Only]
-      - 6                @@ -2273,6 +2348,9 @@ destination + RGB (16-235)/255 "TV" levels, clip WTW [Input Only]
+      + 6                @@ -2282,9 +2360,6 @@ destination - Rec601 YCbCr SD (16-235,240)/255 "TV" levels
-      - 7                @@ -2300,15 +2375,15 @@ destination + Rec601 YCbCr SD (16-235,240)/255 "TV" levels
+      + 7                - Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels
-      - 5                @@ -2327,12 +2402,12 @@ destination + Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels
+      + 5                - Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels
-      - 2                @@ -2354,9 +2429,9 @@ destination - Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels
-      - C                + Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels
+      + 2                @@ -2378,13 +2453,12 @@ destination - Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV" - levels
-      - x                + Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels
+      + C                @@ -2403,16 +2477,16 @@ destination - xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV" - levels
-      - X                + Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV" + levels
+      + x                @@ -2428,13 +2502,6 @@ destination - xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV" - levels
-    -P -                 -Create -gamut @@ -2444,6 +2511,9 @@ gamut + xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV" levels
+      + X                @@ -2468,20 +2538,17 @@ gamut + xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV" levels
+    -P +                 +Create +gamut - gammap_p.x3d.html and gammap_s.x3d.html diagostics
-  srcprofile         -source -ICC @@ -2518,9 +2585,17 @@ ICC + gammap_p.x3d.html and gammap_s.x3d.html diagostics
+  srcprofile         +source +ICC - profile. A TIFF @@ -2559,7 +2634,9 @@ ICC - or JPEG file with embedded profile may be used here.
TIFF or + JPEG file with embedded profile may be used here.
  A TIFF or JPEG file with embedded - profile may be used here.
A TIFF or JPEG file with embedded + profile may be used here.
 linkedprofileNormally the per channel device curves in the source and destination profiles are preserved in the resulting device link profile, but the -n option disables this. This can be useful - if the device linearisation curves are inappropriate in nature.
+ 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.

The -f option is a special purpose flag useful only for 3 or 4 component (RGB, CMY or CMYK) source to CMYK @@ -2831,10 +2916,12 @@ ICC 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 slightly better results that gamut mapping from the - gamut of the source colorspace. Such a source image gamut can be - created using the tiffgamut tool. - More  details about gamut mapping mode.
+ 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 tiffgamut tool. More  details about gamut mapping mode.

 -G  Use the gamut mapped, inverse AtoB table linking method. This is generally the most accurate, @@ -2844,11 +2931,13 @@ ICC and -l 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 - slightly better results that gamut mapping from the gamut of the - source colorspace. Such a source image gamut can be created using - the tiffgamut tool. More details about the gamut mapping, inverse AtoB mode.
+ 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 tiffgamut tool. More details + about the gamut mapping, inverse AtoB mode.

The gamut provided to the -g or -G flag is - not used, then such decisions are encoded in the B2A table in the - profile, and cannot be altered during linking).
+ not used, then such decisions are already encoded in the B2A table + in the profile, and cannot be altered during linking).

-k parameter sets the target level of black (K) when creating a B2A CMYK output tables. This is often called a @@ -3171,6 +3263,9 @@ ICC + + + @@ -3213,6 +3308,9 @@ ICC + + + @@ -3255,6 +3353,9 @@ ICC + + + @@ -3297,6 +3398,9 @@ ICC + + + @@ -3339,6 +3443,9 @@ ICC + + + @@ -3387,6 +3494,9 @@ White            &nb + + + @@ -3591,6 +3701,9 @@ White            &nb + + + Full output offset with effective gamma of 2.2
-I B                  @@ -3603,6 +3716,9 @@ White            &nb + + + Full input offset (BT.1886 like) with technical gamma of 2.4. This exactly implements the BT.1886 specification.
-I G                  @@ -3616,6 +3732,9 @@ White            &nb + + + Full output offset with technical gamma of 2.2

-I b:2.3             @@ -3629,6 +3748,9 @@ White            &nb + + + Full input offset (BT.1886 like) with effective gamma of 2.3
-I g:2.3             @@ -3642,6 +3764,9 @@ White            &nb + + + Full output offset with effective gamma of 2.3
 -I B:2.35           @@ -3654,6 +3779,9 @@ White            &nb + + + Full input offset (BT.1886 like) with technical gamma of 2.35
-I G:2.35           @@ -3666,6 +3794,9 @@ White            &nb + + + Full output offset with technical gamma of 2.35

-I b:0.4:2.3        @@ -3681,6 +3812,9 @@ White            &nb + + + Same as above.
 -I B:0.4:2.35      60% input offset, 40% output offset with technical gamma of 2.35
@@ -3701,6 +3835,9 @@ White            &nb + + + T                @@ -3720,6 +3857,9 @@ White            &nb + + + @@ -3731,6 +3871,9 @@ White            &nb + + + x                @@ -3749,6 +3892,9 @@ White            &nb + + + @@ -3774,6 +3920,9 @@ White            &nb + + + @@ -3793,10 +3942,10 @@ White            &nb
The -e T option uses the same encoding as -e t, but rather than handling WTW (Whiter Than White, or out of range values) - using extrapolation, it clips them to the valid range. 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.
+ 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.

The -E flag applies a Video encoding to the output. The possible encoding are:
@@ -3821,6 +3970,9 @@ White            &nb + + + @@ -3845,6 +3997,9 @@ White            &nb + + + @@ -3859,6 +4014,9 @@ White            &nb + + + 6                @@ -3877,6 +4035,9 @@ White            &nb + + + @@ -3901,6 +4062,9 @@ White            &nb + + + @@ -3925,6 +4089,9 @@ White            &nb + + + @@ -3949,6 +4116,9 @@ White            &nb + + + @@ -3973,6 +4143,9 @@ White            &nb + + + @@ -3981,7 +4154,13 @@ White            &nb levels

- The T
+ The -e t 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 -n option), which is + automatically the case if a 3dlut output format is + selected.
+
The -P option causes a diagnostic 3D X3DOM plots to be created that illustrate the gamut mapping generated.
@@ -4035,11 +4214,31 @@ White            &nb + + + Usage Scenarios page.
+

Discussion

+ The viewing condition parameter m: 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 + pm preset condition has mtaf value of 0.7, and Wxyz2 of D50.



-- cgit v1.2.3