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/xicclu.html | 611 ++++++++++++++++++++++++++++++++------------------------ 1 file changed, 345 insertions(+), 266 deletions(-) mode change 100644 => 100755 doc/xicclu.html (limited to 'doc/xicclu.html') diff --git a/doc/xicclu.html b/doc/xicclu.html old mode 100644 new mode 100755 index bd98058..3233ca3 --- a/doc/xicclu.html +++ b/doc/xicclu.html @@ -22,34 +22,34 @@ although device value options such as -e or -E will work. To lookup inverted CAL values, use -f b.

Usage Summary

-  xicclu [-options] profile_or_cal
-  -v level       - Verbosity level 0 - 2 (default = 1)
-  -g         -     Plot slice instead of looking colors up. (Default - white to black)
-  -G s:L:a:b     - Override plot slice start with Lab or Jab co-ordinate
-  -G e:L:a:b     - Override plot slice end with Lab or Jab co-ordinate
-  -V             - - Use 'vcgt' calibration tag from profile
-  -f function    f = forward, - b = backwards, g = gamut, p = preview
xicclu [-options] profile_or_cal
+  -v level       + Verbosity level 0 - 2 (default = 1)
+  -g         +     Plot slice instead of looking colors up. (Default + white to black)
+  -G s:L:a:b     + Override plot slice start with Lab or Jab co-ordinate
+  -G e:L:a:b     + Override plot slice end with Lab or Jab co-ordinate
+  -V             + + Lookup or plot the 'vcgt' calibration tag from profile
-                 +  -f function    f = forward, b + = backwards, g = gamut, p = preview
+                 if = @@ -59,39 +59,44 @@ if - inverted forward, ib = inverted backwards
-  -i intent      a - = absolute, r = relative colorimetric,
-                 + inverted forward, ib = inverted backwards
+  -i intent      a = + absolute, r = relative colorimetric,
+                 - p = - perceptual, s = saturation, A = disp. abs. measurements
-  -o order       + p = perceptual, s = saturation, A = disp. abs. + measurements
+  -o order       - n = normal (priority: lut > matrix > monochrome)
-                 + + + + + + + n = normal (priority: lut > matrix > monochrome)
+                 r = @@ -101,11 +106,13 @@ r - reverse (priority: monochrome > matrix > lut)
-  -p oride       + + + reverse (priority: monochrome > matrix > lut)
+  -p oride       @@ -113,12 +120,14 @@ r - x = XYZ_PCS, X = XYZ * 100, l = Lab_PCS, L = LCh, y = Yxy,
-                 j = - CIECAM02 Appearance Jab, J = CIECAM02 Appearance JCh
-  -s scale       + + + x = XYZ_PCS, X = XYZ * 100, l = Lab_PCS, L = LCh, y = Yxy,
+                 j = + CIECAM02 Appearance Jab, J = CIECAM02 Appearance JCh
+  -s scale       Scale @@ -127,51 +136,55 @@ Scale - device range 0.0 - scale rather than 0.0 - 1.0
-
-   -e flag        + device range 0.0 - scale rather than 0.0 - 1.0
+
+   -e flag        - Video encode device input as:
-  -E flag        - Video decode device output 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" - lev
-  -k [zhxrlv]    Black - generation: z = zero K,
-E flag        + + + + + + + Video decode device output 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" lev
-                +  -k [zhxrlv]    Black + generation: z = zero K,
+                   h @@ -181,9 +194,11 @@ h - = 0.5 K, x = max K, r = ramp K (def.)
-                + + + = 0.5 K, x = max K, r = ramp K (def.)
+                   l @@ -193,9 +208,11 @@ l - = extra PCS input is portion of K locus
-                + + + = extra PCS input is portion of K locus
+                   v @@ -205,12 +222,14 @@ v - = extra PCS input is K target value
-  -k p stle stpo enpo - enle shape
-                + + + = extra PCS input is K target value
+  -k p stle stpo enpo + enle shape
+                   stle: @@ -220,9 +239,11 @@ stle: - K level at White 0.0 - 1.0
-                + + + K level at White 0.0 - 1.0
+                   stpo: @@ -232,9 +253,11 @@ stpo: - start point of transition Wh 0.0 - Bk 1.0
-                + + + start point of transition Wh 0.0 - Bk 1.0
+                   enpo: @@ -244,9 +267,11 @@ enpo: - End point of transition Wh 0.0 - Bk 1.0
-                + + + End point of transition Wh 0.0 - Bk 1.0
+                   enle: @@ -256,9 +281,11 @@ enle: - K level at Black 0.0 - 1.0
-                + + + K level at Black 0.0 - 1.0
+                   shape: @@ -268,13 +295,15 @@ shape: - 1.0 = straight, 0.0-1.0 concave, 1.0-2.0 convex
-  -k q stle0 stpo0 - enpo0 enle0 shape0 stle2 stpo2 enpo2 enle2 shape2
-                 + + + 1.0 = straight, 0.0-1.0 concave, 1.0-2.0 convex
+  -k q stle0 stpo0 enpo0 + enle0 shape0 stle2 stpo2 enpo2 enle2 shape2
+                 Transfer extra @@ -284,63 +313,45 @@ extra - PCS input to dual curve limits
-  -K parameters  Same as -k, but target is - K locus rather than K value itself
-  -l tlimit      - set total ink limit, 0 - 400% (estimate by default)
-  -L klimit      - set black ink limit, 0 - 100% (estimate by default)
-  -a             -show -actual - + PCS input to dual curve limits
+  -K parameters  Same as -k, but target is K + locus rather than K value itself
+  -l tlimit      set + total ink limit, 0 - 400% (estimate by default)
+  -L klimit      set + black ink limit, 0 - 100% (estimate by default)
+  -a             +show +actual - target values if clipped
-  -b             -use -CAM + target values if clipped
+  -b             +use +CAM - Jab for clipping
-  -m -             - merge output processing into clut
-  -c viewcond    set viewing - conditions for CIECAM02,
-               -   -either @@ -348,41 +359,47 @@ either - an enumerated choice, or a parameter:value change
-         -    pp - Practical Reflection Print (ISO-3664 P2)
-         + Jab for clipping
+  -m +             + merge output processing into clut
+  -c viewcond    set viewing + conditions for CIECAM02,
+                  -pe - - - - +either - - Print evaluation environment (CIE 116-1995)
-         -   -pc - - - Critical print evaluation environment (ISO-3664 P1)
-      -       mt - Monitor in typical work environment
-        + 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 adaptation
+      +       mt - Monitor in typical work environment
+            @@ -392,29 +409,31 @@ pc - 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
-           + + + 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 @@ -424,9 +443,11 @@ n - = auto, a = average, m = dim, d = dark,
-                + + + = auto, a = average, m = dim, d = dark,
+                    @@ -436,9 +457,11 @@ n -     c = transparency (default average)
-           + + +     c = transparency (default average)
+           w:X:Y:Z      Adapted @@ -448,9 +471,11 @@ Adapted - white point as XYZ (default media white, Abs: D50)
-           + + + white point as XYZ (default media white, Abs: D50)
+           w:x:y        Adapted @@ -460,8 +485,10 @@ Adapted - white point as x, y
-           + + + white point as x, y
+           a:adaptation Adaptation @@ -471,15 +498,16 @@ Adaptation - luminance in cd.m^2 (default 50.0)
-     -       b:background Background % of - image luminance (default 20)
-           + + + luminance in cd.m^2 (default 50.0)
+     +       b:background Background % of image + luminance (default 20)
+           f:flare      Flare light @@ -490,48 +518,69 @@ light - % of image luminance (default 1)
-           + % of image luminance (default 1)
+           + g:glare      Glare light % of ambient + (default 2)
+       +     g:X:Y:Z      Glare color as + XYZ (default media white, Abs: D50)
+           - g:glare      Glare light % of ambient - (default 2)
-       -     g:X:Y:Z      Glare color - as XYZ (default media white, Abs: D50)
-           + g:x:y        FGare color as x, + y
+           + h:hkscale    Helmholtz-Kohlrausch effect + scale factor (default 1.0)
+           - g:x:y        FGare color as - x, y
-
-   inoutfile       The - input ICC profile or CAL file.
-
-     The - colors to be translated should be fed into standard in,
-     one input - color per line, white space separated.
-     A line - starting with a # will be ignored.
-     A line - not starting with a number will terminate the program. -
+ + + + + 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
+   inoutfile       The + input ICC profile or CAL file.
+
+     The colors + to be translated should be fed into standard in,
+     one input + color per line, white space separated.
+     A line + starting with a # will be ignored.
+     A line not + starting with a number will terminate the program.

Flags and Parameters

The -v parameter sets the level of verbosity. Default is level 1, which repeats each input value, the @@ -565,6 +614,8 @@ light + + b.

The -G      t                @@ -666,6 +719,8 @@ light + + RGB (16-235)/255 "TV" levels
     6                @@ -675,6 +730,8 @@ light + + Rec601 YCbCr SD (16-235,240)/255 "TV" levels
     7                @@ -684,6 +741,8 @@ light + + Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels
     5                @@ -693,6 +752,8 @@ light + + Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels
     2                @@ -702,6 +763,8 @@ light + + Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels
     C                @@ -711,6 +774,8 @@ light + + Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV" levels

@@ -726,6 +791,8 @@ light + + with the addition of two extra options.

 Possible arguments to the -k option are:
@@ -768,6 +835,8 @@ light + +    _______  enle
                 |      @@ -779,6 +848,8 @@ light + +    /
                 |     @@ -790,6 +861,8 @@ light + +   /
                 |      @@ -801,6 +874,8 @@ light + +  /
                 |      @@ -812,6 +887,8 @@ light + + /
           stle  | ------/
@@ -829,6 +906,8 @@ White            &nb + + Black

-k q stle0 stpo0 enpo0 enle0 shape0 stle2 stpo2 -- cgit v1.2.3