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/colprof.html | 810 +++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 695 insertions(+), 115 deletions(-) (limited to 'doc/colprof.html') diff --git a/doc/colprof.html b/doc/colprof.html index de9d5c2..022f984 100644 --- a/doc/colprof.html +++ b/doc/colprof.html @@ -3,7 +3,7 @@ colprof + charset=windows-1252"> @@ -23,6 +23,18 @@ + + + + + + + + + + + + @@ -42,6 +54,18 @@ Transparency, Matte, Negative, BlackAndWhite
 -Z prsa  + + + + + + + + + + + +           Default intent: Perceptual, Rel. Colorimetric, Saturation, Abs. Colorimetric
@@ -51,7 +75,8 @@  -b [lmhun]         Low quality B2A table - or specific B2A quality or none for input device
-  -y         +  -ni        + @@ -63,8 +88,6 @@ -         Verify A2B profile
-  -ni        @@ -90,6 +113,18 @@ + + + + + + + + + + + + @@ -120,6 +155,18 @@ x + + + + + + + + + + + + @@ -144,6 +191,18 @@ White + + + + + + + + + + + + @@ -168,6 +227,18 @@ Wh + + + + + + + + + + + + @@ -192,6 +263,18 @@ Wh + + + + + + + + + + + + @@ -215,6 +298,18 @@ Black + + + + + + + + + + + + @@ -239,6 +334,18 @@ concave, + + + + + + + + + + + + @@ -246,6 +353,18 @@ concave,  -K parameters      + + + + + + + + + + + + Same as -k, but target is K locus rather than K value itself
 -l tlimit          override CMYK total ink limit, 0 - 400% @@ -274,6 +393,18 @@ cLUT + + + + + + + + + + + + @@ -297,6 +428,18 @@ s + + + + + + + + + + + + @@ -321,6 +464,18 @@ S + + + + + + + + + + + + @@ -333,6 +488,18 @@ S + + + + + + + + + + + + If input profile, auto scale WP to allow extrapolation

 -uc             @@ -356,20 +523,61 @@ and + + + + + + + + + + + + primaries to be +ve
-
 -f [illum] +  -V demphasis       + + + + + Degree of dark region cLUT grid emphasis 1.0-3.0 (default 1.00 = + none)
+
 -f [illum]         Use Fluorescent Whitening Agent compensation [opt. simulated inst. illum.:
                      + + + + + + + + + + + + M0, M1, M2,
A, C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp ]
-
 -i illum   +  -i illum   + + + + + + + + + + + +         Choose illuminant for computation of CIE XYZ from spectral data & FWA:
@@ -385,6 +593,18 @@ D50 (def.), D50M2, + + + + + + + + + + + + D65, F5, F8, F10 or file.sp

 -o observ          Choose CIE Observer for spectral data:
@@ -400,22 +620,6 @@ D50M2, -           1931_2
(def.), - 1964_10, S&B 1955_2, shaw, J&V 1978_2
-  -r avgdev       -    Average deviation of device+instrument readings as - a percentage (default 0.5%)
-  -s src.icc         -Apply -gamut -mapping -to -output -profile -perceptual -B2A -table -for @@ -427,8 +631,249 @@ for - given source
-  -S src.icc         + +           1931_2
(def.), + 1964_10, S&B 1955_2, shaw, J&V 1978_2
+  -r avgdev       +    Average deviation of device+instrument readings as + a percentage (default 0.5%)
+  -s src.icc         +Apply +gamut +mapping +to +output +profile +perceptual +B2A +table +for + + + + + + + + + + + + + + + + + + + + + + + + given source
+  -S src.icc         + + + + + + + + + + + + + + + + + + + + + + + + Apply gamut mapping to output profile perceptual and saturation + B2A table
+  -nP                + + + + + + + + + + + + + + + + + + + + + + + + Use colormetric source gamut to make output profile perceptual + table
+  -nS                + + + + + + + + + + + + + + + + + + + + + + + + Use colormetric source gamut to make output profile saturation + table
+  -g src.gam +         Use source image + gamut as well for output profile gamut mapping
+  -p aprof.icm,...   Incorporate + abstract profile(s) into output tables
+  -t intent  +         Override gamut + mapping intent for output profile perceptual table:
+  -T intent          + + + + + + + + + + + + + + + + + + + + + + + + Override gamut mapping intent for output profile saturation + table:
+
      +             + 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]
+             +      al - Absolute Colorimetric (Lab)

+                  + + + + + + + + + + + + rl - White Point Matched Colorimetric (Lab)
+  -c viewcond        + + + + + @@ -440,9 +885,6 @@ for - Apply gamut mapping to output profile perceptual and saturation - B2A table
-  -nP                @@ -450,13 +892,13 @@ for + set input viewing conditions for output profile CIECAM02 gamut + mapping,
+                       - Use colormetric source gamut to make output profile perceptual - table
-  -nS                @@ -468,17 +910,6 @@ for - Use colormetric source gamut to make output profile saturation - table
-  -g src.gam -         Use source image - gamut as well for output profile gamut mapping
-  -p aprof.icm,...   Incorporate - abstract profile(s) into output tables
-  -t intent  -         Override gamut - mapping intent for output profile perceptual table:
-  -T intent          @@ -487,28 +918,11 @@ for + either an enumerated choice, or a parameter
+  -d viewcond        - Override gamut mapping intent for output profile saturation - table:
-
      -             - 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]
-
                 @@ -520,8 +934,6 @@ for - pa - Perceptual Appearance
-
        @@ -531,15 +943,11 @@ for + set output viewing conditions for output profile CIECAM02, gamut + mapping
+                       -          ms - Saturation
-            -        s - Enhanced Saturation [ICC - Saturation]
-             -      al - Absolute Colorimetric (Lab)

-  -c viewcond        @@ -551,9 +959,6 @@ for - set input viewing conditions for output profile CIECAM02 gamut - mapping,
-                       @@ -564,9 +969,9 @@ for + either an enumerated choice, or a parameter:value change
+                       - either an enumerated choice, or a parameter
-  -d viewcond        @@ -578,9 +983,6 @@ for - set output viewing conditions for output profile CIECAM02, gamut - mapping
-                       @@ -592,7 +994,7 @@ for - either an enumerated choice, or a parameter:value change
+ Also sets out of gamut clipping CAM space.
                      @@ -605,8 +1007,7 @@ for - Also sets out of gamut clipping CAM space.
-                       + @@ -657,6 +1058,18 @@ for + + + + + + + + + + + + @@ -677,20 +1090,41 @@ for       b:background  Background % 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
+            + l:imageewhite  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

 -P                   @@ -701,6 +1135,18 @@ for + + + + + + + + + + + + @@ -715,6 +1161,18 @@ Override + + + + + + + + + + + + @@ -824,13 +1282,6 @@ Override profiles and matrix profiles will only contain a colorimetric intent table or matrix.

- The -y flag does a verification check on - the AtoB profile. This is done by comparing what CIE colors the - profile predicts for the test chart test patches, and comparing them - to the actual values. A summary of the average and maximum Lab delta - E's will be printed out if this flag is set. If the -v flag - is also set, then information for each patch will also be printed.
-
Normally cLUT base profiles are generated with three major elements:- per device channel (shaper) input curves, the multi-dimensional lut table, and @@ -856,6 +1307,18 @@ the + + + + + + + + + + + + @@ -871,6 +1334,18 @@ the + + + + + + + + + + + + flag. Note that this @@ -919,6 +1394,18 @@ the + + + + + + + + + + + + @@ -933,6 +1420,18 @@ the + + + + + + + + + + + + @@ -946,6 +1445,18 @@ the + + + + + + + + + + + + @@ -959,6 +1470,18 @@ the + + + + + + + + + + + + @@ -972,6 +1495,18 @@ the + + + + + + + + + + + + @@ -993,6 +1528,18 @@ White            &nb + + + + + + + + + + + + @@ -1063,8 +1610,8 @@ White            &nb By default (equivalent to -al) profile creates a cLUT based table profile with a PCS (Profile Connection Space) of L*a*b*, which generally gives the - most accurate results, and allows for the four different rendering - intents that ICC profiles can support.
+ most robust and accurate results, and allows for the four different + rendering intents that ICC profiles can support.

A cLUT base table profile using a PCS of XYZ can be created if -ax is used, and this may have the advantage of better accuracy for @@ -1072,14 +1619,16 @@ White            &nb clipping for displays with a colorant chromaticity that can't be encoded in L*a*b* PCS space, and may give a more accurate white point for input devices by avoiding clipping of values above the - white point that can occur in L*a*b* based cLUT input profiles. By - default cLUT XYZ PCS Display profiles will also have a set of dummy - matrix tags included in them, for better compatibility with other - systems. The dummy matrix deliberately interchanges Red, Green and - Blue channels, so that it is obvious if the cLUT tables are not - being used. If it is important for both the cLUT and matrix be - accurate, use -aX, which - will create shaper/matrix tags.
+ white point that can occur in L*a*b* based cLUT input profiles. A disadvantage + of this type of profile is that it can be a lot less robust if given + a test patch set that is sparse, or too evenly spaced. By default + cLUT XYZ PCS Display profiles will also have a set of dummy matrix + tags included in them, for better compatibility with other systems. + The dummy matrix deliberately interchanges Red, Green and Blue + channels, so that it is obvious if the cLUT tables are not being + used. If it is important for both the cLUT and matrix be accurate, + use -aX, which will create + shaper/matrix tags.

For RGB input or display profiles, a simpler type of profile using either a gamma curves or a general shaper curves, combined with a @@ -1159,6 +1708,25 @@ White            &nb black and primary values, so as to work with these programs, but this will reduce the accuracy of the profile.

+ The -V demphasis parameter allows sets the + degree to which cLUT grid spacing should emphasize the accuracy of + modelling the device response in the dark regions, over that of the + lighter regions. By default this value will be a scaled down version + of the one set using the targen -V + parameter, and values in the range 1.3 - 1.6 are a good + place to start. Display devices used for video or film reproduction + are typically viewed in dark viewing environments with no strong + white reference, and typically employ a range of brightness levels + in different scenes. This often means that the devices dark region + response is of particular importance, so increasing the density of + cLUT grid points in the dark region may improved the balance of + accuracy of the resulting profile for video or film reproduction. + This is most valuable when used in concert with a set of test points + that more densely sample the dark regions, by use of the + corresponding targen -V parameter. Emphasizing the dark region + characterization will reduce the accuracy of  modelling the + lighter regions given a certain quality/grid resolution.
+
The -f flag enables Fluorescent Whitening Agent (FWA) compensation. This only works if spectral data is available and, the instrument is not UV filtered.  FWA @@ -1189,6 +1757,18 @@ White            &nb + + + + + + + + + + + + @@ -1500,7 +2080,7 @@ White            &nb profile (.icm extension on the MSWindows platform, .icc on Apple or Unix platforms). The -O parameter will override this default. -

Discussion

+

Discussion

Note that monochrome profiling isn't currently supported. It may be supported sometime in the future.

@@ -1512,7 +2092,7 @@ White            &nb readings, average errors of 5 or less, and maximum errors of 15 or less would normally be expected. If errors are grossly higher than this, then this is an indication that something is seriously wrong - with the device testing, or profile creation.
+ with the device measurement, or profile creation.

Given a .ti3 file from a display device that contains calibration curves (generated by dispcal, passed -- cgit v1.2.3