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/colprof.html | 1076 ++++++++++++++++++++++-------------------------------- 1 file changed, 435 insertions(+), 641 deletions(-) mode change 100644 => 100755 doc/colprof.html (limited to 'doc/colprof.html') diff --git a/doc/colprof.html b/doc/colprof.html old mode 100644 new mode 100755 index d5df56e..ac80c3b --- a/doc/colprof.html +++ b/doc/colprof.html @@ -15,8 +15,8 @@ [ Note that currently, Monochrome and N-Color profiles are not supported. ]

Usage Summary

-  colprof [-options] inoutfile
-  -v         +  colprof [-options] inoutfile
+  -v         @@ -54,21 +54,6 @@ -         Verbose mode
-  -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
-  -Z tmnb   -          Attributes: - Transparency, Matte, Negative, BlackAndWhite
-  -Z prsa  @@ -79,6 +64,30 @@ +         Verbose mode
+  -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
+  -Z tmnb   +          Attributes: + Transparency, Matte, Negative, BlackAndWhite
+  -Z prsa  +           Default intent: + Perceptual, Rel. Colorimetric, Saturation, Abs. Colorimetric
+  -q lmhu    +         Quality - Low, Medium (def), + High, Ultra
+  -b [lmhun]       +   Low quality B2A table - or specific B2A quality or none for + input device
+  -ni        @@ -96,16 +105,6 @@ -           Default - intent: Perceptual, Rel. Colorimetric, Saturation, Abs. - Colorimetric
-  -q lmhu -            Quality - Low, - Medium (def), High, Ultra
-  -b [lmhun]       -   Low quality B2A table - or specific B2A quality or none - for input device
-  -ni        @@ -136,6 +135,12 @@ +         Don't create input (Device) shaper + curves
+  -np +                + Don't create input (Device) grid position curves
+  -no        @@ -143,12 +148,6 @@ -         Don't create input (Device) shaper - curves
-  -np -                - Don't create input (Device) grid position curves
-  -no        @@ -176,52 +175,6 @@ - - - - - - - - - - -         Don't create output (PCS) shaper - curves
-  -nc -                - Don't put the input .ti3 data in the profile
-  -k zhxr  -           Black Ink generation: z = - zero K,
-             -  -  -  -    -h -= -0.5 -K -(def), -x -= - - - - - - - - - - - - - - - - @@ -235,251 +188,56 @@ x - - - - - - - - - max K, r = ramp K
-  -k p stle stpo enpo enle shape
-             -  -  -  -    -stle: -K -level -at -White -0.0 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1.0
-             +         Don't create output (PCS) shaper + curves
+  -nc +                + Don't put the input .ti3 data in the profile
+  -k zhxr    +         Black Ink generation: z = zero K,
+             +           h = 0.5 K (def), x = max + K, r = ramp K
+  -k p stle stpo enpo enle shape
+             +           stle: K level at White 0.0 + - 1.0
+             +           stpo: start point of transition + Wh 0.0 - Bk 1.0
+             +           enpo: End point of transition + Wh 0.0 - Bk 1.0
+             +           enle: K level at Black 0.0 - + 1.0
+             +           shape: 1.0 = straight, 0.0-1.0 + concave, 1.0-2.0 convex
+  -K parameters      + Same as -k, but target is K locus rather than K value itself
+  -l tlimit       +    override CMYK total ink limit, 0 - 400% (default from + .ti3)
+  -L klimit       +    override black ink limit, 0 - 100% (default from + .ti3)
+  -a lxXgsmGS        + Algorithm type override
+             +           l = Lab cLUT (def.), x = XYZ + cLUT, X = display XYZ cLUT + matrix
+             +           g = gamma+matrix, s = + shaper+matrix, m = matrix only,
+             +           G = single gamma+matrix, S = + single shaper+matrix
+  -u                 -  -stpo: -start -point -of -transition -Wh - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0.0 - Bk 1.0
-             -  -  -  -  -  -enpo: -End -point -of -transition -Wh - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0.0 - Bk 1.0
-             -  -  -  -  -  -enle: -K -level -at -Black - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0.0 - 1.0
-             -  -  -  -  -  -shape: -1.0 -= -straight, -0.0-1.0 -concave, - - - - - - - - - - - - - - - - - - - - - - - - - @@ -492,8 +250,6 @@ concave, - 1.0-2.0 convex
-  -K parameters      @@ -521,95 +277,24 @@ concave, - - Same as -k, but target is K locus rather than K value itself
-  -l tlimit     -      override CMYK total ink limit, 0 - 400% - (default from .ti3)
-  -L klimit     -      override black ink limit, 0 - 100% (default - from .ti3)
-  -a lxXgsmGS        - Algorithm type override
-             -  -  -  -  -  -l -= -Lab -cLUT -(def.), - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - x = XYZ cLUT, X = display XYZ cLUT + matrix
-             -  -  -  -  -  -g -= -gamma+matrix, -s -= - - - - - - - - - - - - - - - - - - - + If input profile, auto scale WP to allow extrapolation
+  -ua +             +    If input profile, force Absolute Colorimetric + intent
+  -uc +             +    If input profile, clip cLUT values above WP
+  -U scale +           If input + profile, scale media white point by scale
+  -R                 +Restrict +white +<= +1.0, +black +and @@ -628,19 +313,6 @@ s - shaper+matrix, m = matrix only,
-             -  -  -  -  -  -G -= -single -gamma+matrix, -S -= @@ -670,6 +342,8 @@ S + primaries to be +ve
+  -B X,Y,Z           @@ -678,14 +352,6 @@ S - single shaper+matrix
-  -u         -  -  -  -  - - @@ -700,6 +366,8 @@ S + Display Black Point override hack
+  -V demphasis       @@ -713,21 +381,6 @@ S - If input profile, auto scale WP to allow extrapolation
-  -uc -             -    If input profile, clip cLUT values above WP
-  -U scale -           If input - profile, scale media white point by scale
-  -R                 -Restrict -white -<= -1.0, -black -and @@ -743,6 +396,12 @@ and + 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.:
+                       @@ -765,8 +424,6 @@ and - primaries to be +ve
-  -B X,Y,Z           @@ -779,11 +436,33 @@ and - Display Black Point override hack
-  -V demphasis       + M0, M1, M2, A, C, D50 (def.), D50M2, D65, F5, F8, F10 or + file.sp ]
+  -i illum     +       Choose illuminant for computation of CIE XYZ + from spectral data & FWA:
+             +           A, C, D50 (def.), D50M2, D65, + F5, F8, F10 or file.sp
+  -o observ      +     Choose CIE Observer for spectral data:
+             +           1931_2 (def.), + 1964_10, 2012_2, 2012_10, S&B 1955_2, shaw, J&V 1978_2 or + file.cmf
+  -r avgdev          + Average deviation of device+instrument readings as a percentage + (default 0.5%)
+  -s src.icm|cperc   Apply gamut mapping + to output profile perceptual B2A table for given source, or + compression percentage
+  -S src.icm|experc  Apply gamut mapping + to output profile perceptual and saturation B2A table, or + expansion percentage
+  -nP                @@ -799,12 +478,6 @@ and - 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.:
-                       @@ -832,14 +505,14 @@ and - M0, M1, M2, A, - C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp ]
-  -i illum   + Use colormetric source gamut to make output profile perceptual + table
+  -nS                @@ -862,19 +535,6 @@ and -         Choose illuminant for - computation of CIE XYZ from spectral data & FWA:
-             -  -  -  -  -  -A, -C, -D50 -(def.), -D50M2, @@ -900,12 +560,19 @@ D50M2, + 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          - D65, F5, F8, F10 or file.sp
-  -o observ      -     Choose CIE Observer for spectral data:
-             @@ -943,18 +610,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.icm|cperc   Apply gamut - mapping to output profile perceptual B2A table for given source, - or compression percentage
-  -S src.icm|experc  Apply gamut - mapping to output profile perceptual and saturation B2A table, - or expansion percentage
-  -nP                @@ -963,6 +618,24 @@ D50M2, + 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]
+                  @@ -992,9 +665,6 @@ D50M2, - Use colormetric source gamut to make output profile perceptual - table
-  -nS                @@ -1013,6 +683,8 @@ D50M2, + pa - Perceptual Appearance
+                  @@ -1028,21 +700,19 @@ D50M2, + lp - Luminance Preserving Perceptual
+         +          ms - Saturation
+            +        s - Enhanced Saturation [ICC + Saturation]
+             +      al - Absolute Colorimetric (Lab)
+                  - 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          @@ -1074,31 +744,14 @@ D50M2, + rl - White Point Matched Colorimetric (Lab)
+  -c 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]
-                  @@ -1136,15 +789,14 @@ D50M2, - pa - Perceptual Appearance
-                  + set input viewing conditions for output profile CIECAM02 gamut + mapping,
+                       - lp - Luminance Preserving Perceptual
-         @@ -1182,13 +834,6 @@ D50M2, -          ms - Saturation
-            -        s - Enhanced Saturation [ICC - Saturation]
-             -      al - Absolute Colorimetric (Lab)
-                  @@ -1198,6 +843,8 @@ D50M2, + either an enumerated choice, or a parameter
+  -d viewcond        @@ -1214,8 +861,6 @@ D50M2, - rl - White Point Matched Colorimetric (Lab)
-  -c viewcond        @@ -1247,15 +892,15 @@ D50M2, + set output viewing conditions for output profile CIECAM02, gamut + mapping
+                       - set input viewing conditions for output profile CIECAM02 gamut - mapping,
-                       @@ -1293,12 +938,12 @@ D50M2, - either an enumerated choice, or a parameter
-  -d viewcond        + either an enumerated choice, or a parameter:value change
+                       @@ -1332,9 +977,6 @@ D50M2, - set output viewing conditions for output profile CIECAM02, gamut - mapping
-                       @@ -1349,6 +991,8 @@ D50M2, + Also sets out of gamut clipping CAM space.
+                       @@ -1372,8 +1016,6 @@ D50M2, - either an enumerated choice, or a parameter:value change
-                       @@ -1398,12 +1040,44 @@ D50M2, + Enumerated Viewing Conditions:
+                +   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
+                +   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,
+                  @@ -1411,8 +1085,6 @@ D50M2, - Also sets out of gamut clipping CAM space.
-                       @@ -1450,40 +1122,35 @@ D50M2, - Enumerated Viewing Conditions:
-             -      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:imageewhite Image + white in cd.m^2 if surround = auto (default 250)
+             +             + f:flare       Flare light % of + image luminance (default 0)
+                         @@ -1518,39 +1185,49 @@ D50M2, -                -    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: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 5)
+         +        +          + g:X:Y:Z       Glare color as XYZ + (default media white)
+         +         +         + 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
+  -P +                   + @@ -1570,22 +1247,6 @@ D50M2, - g:glare       Glare light % of - ambient (default 5)
-       -          -          - g:X:Y:Z       Glare color as - XYZ (default media white)
-       -           -         - g:x:y         Glare - color as x, y
-  -P -                   @@ -1613,6 +1274,9 @@ D50M2, + Create gamut gammap_p.x3d.html and gammap_s.x3d.html diagostics
+  -O outputfile        +Override @@ -1623,9 +1287,6 @@ D50M2, - Create gamut gammap_p.x3d.html and gammap_s.x3d.html diagostics
-  -O outputfile        -Override @@ -1663,10 +1324,10 @@ Override - the default output filename & extension.
-  inoutfile -            Base name for - input.ti3/output.icc file
+ the default output filename & extension.
+  inoutfile +            Base name for + input.ti3/output.icc file

Options

-v  Turn on verbose mode. Gives progress @@ -1813,6 +1474,16 @@ the + + + + + + + + + + @@ -1853,6 +1524,16 @@ the + + + + + + + + + + @@ -1928,6 +1609,16 @@ the + + + + + + + + + + @@ -1968,6 +1659,16 @@ the + + + + + + + + + + @@ -2007,6 +1708,16 @@ the + + + + + + + + + + @@ -2046,6 +1757,16 @@ the + + + + + + + + + + @@ -2085,6 +1806,16 @@ the + + + + + + + + + + @@ -2132,6 +1863,16 @@ White            &nb + + + + + + + + + + @@ -2261,19 +2002,28 @@ White            &nb lut table. Using the -u flag causes the media white point to be automatically scaled (using the same type of scaling as the -U scale option) to avoid - clipping values up to full device white. This flag can be useful - when an input profile is needed for using a scanner as a "poor mans" - colorimeter, or if the white point of the test chart doesn't - represent the white points of media that will be used in practice, - and that white point adjustment will be done individually in some - downstream application.
+ clipping values up to full device white, while still correcting the + hue. This flag can be useful when the white point of the test chart + doesn't represent the white points of media that will be used in + practice, and that white point adjustment will be done individually + in some downstream application.
+
+ -ua: For + input profiles, this flag forces the effective intent to be Absolute + Colorimetric even when used with Relative Colorimetric intent + selection in a CMM, by setting a D50 white point tag.  This + also has the effect of preserving the conversion of colors whiter + than the white patch of the test chart without clipping them + (similar to the -u flag), but does not hue correct white. + This flag can be useful when an input profile is needed for using a + scanner as a "poor mans" colorimeter.

-uc: For input profiles it is sometimes desirable that any highlights - brighter than the white point, map exactly to white, and this option - post processes the cLUT entries to ensure this is the case. Note - that due to the finite nature of the cLUT grid, this may affect the - accuracy of colors near the light surface of the device gamut.
+ brighter than the white point, map (clip) exactly to white, and this + option post processes the cLUT entries to ensure this is the case. + Note that due to the finite nature of the cLUT grid, this may affect + the accuracy of colors near the light surface of the device gamut.

-U scale: Input profiles @@ -2395,6 +2145,16 @@ White            &nb + + + + + + + + + + @@ -2505,13 +2265,18 @@ White            &nb   1931_2 selects the standard CIE 1931 2 degree observer. The default.
  1964_10 selects the standard CIE 1964 10 degree - observer.
+ observer
+   2012_2 selects the proposed CIE 2012 2 degree observer
+   2012_10 selects the proposed CIE 2012 10 degree + observer
  1955_2 selects the Stiles and Birch 1955 2 degree observer
  1978_2 selects the Judd and Voss 1978 2 degree observer
  shaw selects the Shaw and Fairchild 1997 2 degree observer
+   file.cmf selects an observer specified by the + given .cmf file.

Note that if an observer other than 1931 2 degree is chosen, the resulting ICC profile will not be standard, and cannot be freely @@ -2566,7 +2331,7 @@ White            &nb be compressed to fit into it. The same percentage is used for expansion if a saturation table is generated, or a separate percentage can be specified by including both a -s and -S - percentage. You can optionally specify both and input ICC + percentage. You can optionally specify both an input ICC profile and a general compression percentage by using the -S option twice, in which case the input profile determines just the luminance range mapping, with the percentage determining the gamut volume @@ -2596,6 +2361,14 @@ White            &nb Note that an input, output, display or device colororspace profile should be specified, not a non-device colorspace, device link, abstract or named color profile.
+ Note that specifying a very large gamut colorspace as the + source gamut (i.e. ProPhoto etc.) is probably NOT + what you want to do, since unless the source images have a similar + very large gamut to that of the colorspace, they will end up getting + over compressed and come out looking dull. Instead use a source + profile that has a gamut more representative of the images gamut, or + you should provide a gamut using the the -g parameter. +

-nP: Normally when a source profile is provided to define the source @@ -2740,7 +2513,11 @@ White            &nb the resulting ICC output profile (.icm extension on the MSWindows platform, .icc on Apple or Unix platforms). The -O - parameter will override this default. + parameter will override this default.
+
+ For information on typical usage, see the Typical + Usage Scenarios page.

Discussion

Note that monochrome profiling isn't currently supported. It may be supported sometime in the future.
@@ -2781,6 +2558,23 @@ White            &nb subsequent evaluation of ink limits can compute the final calibrated device values.

+ 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