diff options
Diffstat (limited to 'doc/colprof.html')
| -rw-r--r-- | doc/colprof.html | 662 |
1 files changed, 621 insertions, 41 deletions
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 @@ <head> <title>colprof</title> <meta http-equiv="content-type" content="text/html; - charset=ISO-8859-1"> + charset=windows-1252"> <meta name="author" content="Graeme Gill"> </head> <body> @@ -26,6 +26,18 @@ + + + + + + + + + + + + Verbose mode<br> <a href="#A">-A "manufacturer"</a> Set the manufacturer description string<br> @@ -42,6 +54,18 @@ Transparency, Matte, Negative, BlackAndWhite<br> </small></tt><tt><small> <a href="colprof.html#Zi">-Z prsa</a> + + + + + + + + + + + + Default intent: Perceptual, Rel. Colorimetric, Saturation, Abs. Colorimetric</small></tt><tt><br> @@ -51,7 +75,8 @@ <a href="#b">-b [lmhun]</a> Low quality B2A table - or specific B2A quality or none for input device<br> - <a href="#y">-y</a> + <a href="#ni">-ni</a> + @@ -63,8 +88,6 @@ - Verify A2B profile<br> - <a href="#ni">-ni</a> @@ -93,6 +116,18 @@ + + + + + + + + + + + + Don't create output (PCS) shaper curves<br> </small></tt><tt><small> <a href="#nc">-nc</a> @@ -123,6 +158,18 @@ x + + + + + + + + + + + + max K, r = ramp K<br> <a href="#kp">-k p stle stpo enpo enle shape</a><br> @@ -147,6 +194,18 @@ White + + + + + + + + + + + + - 1.0<br> @@ -171,6 +230,18 @@ Wh + + + + + + + + + + + + 0.0 - Bk 1.0<br> @@ -195,6 +266,18 @@ Wh + + + + + + + + + + + + 0.0 - Bk 1.0<br> @@ -218,6 +301,18 @@ Black + + + + + + + + + + + + 0.0 - 1.0<br> @@ -242,10 +337,34 @@ concave, + + + + + + + + + + + + 1.0-2.0 convex<br> <a href="#K">-K parameters</a> + + + + + + + + + + + + Same as -k, but target is K locus rather than K value itself<br> <a href="#l">-l <i>tlimit</i></a> override CMYK total ink limit, 0 - 400% @@ -277,6 +396,18 @@ cLUT + + + + + + + + + + + + x = XYZ cLUT, X = display XYZ cLUT + matrix<br> @@ -300,6 +431,18 @@ s + + + + + + + + + + + + shaper+matrix, m = matrix only,<br> @@ -324,6 +467,18 @@ S + + + + + + + + + + + + single shaper+matrix<br> <a href="#u">-u</a> @@ -333,6 +488,18 @@ S + + + + + + + + + + + + If input profile, auto scale WP to allow extrapolation</small></tt><tt><br> </tt><tt> </tt><tt><small><small> <a href="#uc">-uc</a> @@ -359,17 +526,58 @@ and + + + + + + + + + + + + primaries to be +ve</tt><tt><br> - </tt><tt> </tt><tt><small><small><a - href="file:///D:/src/argyll/doc/colprof.html#f">-f [<i>illum</i>]</a> + <a href="#V">-V demphasis</a> + + + + + Degree of dark region cLUT grid emphasis 1.0-3.0 (default 1.00 = + none)<br> + </tt><tt> </tt><tt><small><small><a href="#f">-f [<i>illum</i>]</a> Use Fluorescent Whitening Agent compensation [opt. simulated inst. illum.:<br> + + + + + + + + + + + + M0, M1, M2, </small></small></tt><tt><small><small><small>A, C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp ]</small></small></small></tt><tt><br> - </tt><tt><small><small><small><small> <a - href="file:///D:/src/argyll/doc/colprof.html#i">-i <i>illum</i></a> + </tt><tt><small><small><small><small> <a href="#i">-i <i>illum</i></a> + + + + + + + + + + + + Choose illuminant for computation of CIE XYZ from spectral data & FWA:<br> @@ -385,6 +593,18 @@ D50 (def.), D50M2, + + + + + + + + + + + + D65, F5, F8, F10 or file.sp</small></small></small><br> <a href="#o">-o <i>observ</i></a> Choose CIE Observer for spectral data:<br> @@ -400,6 +620,18 @@ D50M2, + + + + + + + + + + + + 1931_2 </small></tt><tt><small>(def.)</small></tt><tt><small>, 1964_10, S&B 1955_2, shaw, J&V 1978_2<br> <a href="#r">-r avgdev</a> @@ -427,6 +659,18 @@ for + + + + + + + + + + + + given source<br> <a href="#S">-S src.icc</a> @@ -440,6 +684,18 @@ for + + + + + + + + + + + + Apply gamut mapping to output profile perceptual and saturation B2A table<br> <a href="#nP">-nP</a> @@ -454,6 +710,18 @@ for + + + + + + + + + + + + Use colormetric source gamut to make output profile perceptual table<br> <a href="#nS">-nS</a> @@ -468,6 +736,18 @@ for + + + + + + + + + + + + Use colormetric source gamut to make output profile saturation table<br> <a href="#g">-g src.gam</a> @@ -490,6 +770,18 @@ for + + + + + + + + + + + + Override gamut mapping intent for output profile saturation table:<br> </small></tt><tt><small> @@ -520,6 +812,18 @@ for + + + + + + + + + + + + pa - Perceptual Appearance</small></tt><tt><br> </tt><tt> </tt><tt><small> @@ -533,12 +837,37 @@ for + + + + + + + + + + + + ms - Saturation<br> s - Enhanced Saturation [ICC Saturation]<br> al - Absolute Colorimetric (Lab)</small></tt><tt><small><br> + + + + + + + + + + + + + rl - White Point Matched Colorimetric (Lab)<br> <a href="#c">-c viewcond</a> @@ -551,6 +880,18 @@ for + + + + + + + + + + + + set input viewing conditions for output profile CIECAM02 gamut mapping,<br> @@ -565,6 +906,18 @@ for + + + + + + + + + + + + either an enumerated choice, or a parameter<br> <a href="#d">-d viewcond</a> @@ -578,6 +931,18 @@ for + + + + + + + + + + + + set output viewing conditions for output profile CIECAM02, gamut mapping<br> @@ -592,6 +957,18 @@ for + + + + + + + + + + + + either an enumerated choice, or a parameter:value change<br> @@ -605,6 +982,18 @@ for + + + + + + + + + + + + Also sets out of gamut clipping CAM space.<br> @@ -618,6 +1007,18 @@ for + + + + + + + + + + + + Enumerated Viewing Conditions:<br> </small></tt><tt><small> pp - Practical Reflection Print (ISO-3664 @@ -660,6 +1061,18 @@ for + + + + + + + + + + + + c = transparency (default average)<br> @@ -677,20 +1090,41 @@ for b:background Background % of image luminance (default 20)<br> - l:scenewhite - Scene white in cd.m^2 if surround = auto (default 250)<br> - - - f:flare Flare light % of - image luminance (default 1)<br> - - - f:X:Y:Z Flare color as XYZ - (default media white)<br> - - - f:x:y Flare - color as x, y<br> + + l:imageewhite Image white in cd.m^2 if surround = auto + (default 250)</small></tt><br> + <tt><small><small><span style="font-family: monospace;"><small><span + style="font-family: monospace;"> + + + f:flare Flare light + % of image luminance (default 0)<br> + </span></small> + </span><span style="font-family: monospace;"> + + + + + + + + + + + g:glare Glare light % of + ambient (default 1)</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> + + + g:X:Y:Z Glare color as + XYZ (default media white)</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> + + + g:x:y Glare + color as x, y</span></small> <br> <a href="#P">-P</a> @@ -704,6 +1138,18 @@ for + + + + + + + + + + + + Create gamut gammap_p.wrl and gammap_s.wrl diagostics<br> </small></tt><tt><small> <a href="#O">-O outputfile</a> Override @@ -718,6 +1164,18 @@ Override + + + + + + + + + + + + the default output filename & extension.</small></tt><tt><br> </tt><tt> </tt><tt><small> <a href="#p1"><i>inoutfile</i></a> Base name for @@ -824,13 +1282,6 @@ Override profiles and matrix profiles will only contain a colorimetric intent table or matrix.<br> <br> - <a name="y"></a> The <b>-y</b> 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 <b>-v</b> flag - is also set, then information for each patch will also be printed.<br> - <br> <a name="ni"></a><a name="np"></a><a name="no"></a>Normally cLUT base profiles are generated with three major elements:- per device channel (shaper) input curves, the multi-dimensional lut table, and @@ -859,6 +1310,18 @@ the + + + + + + + + + + + + device and CIE/spectral sample data and calibration curves used to create a profile is stored in the <span style="font-weight: bold;">'targ'</span> text tag in the resulting ICC profile. To suppress this and make the @@ -873,6 +1336,18 @@ the + + + + + + + + + + + + </span>flag. <span style="font-weight: bold;">Note</span> that this will then preclude final calibrated device value ink limits from being computed for the resulting profile in subsequent use (ie. <a @@ -922,6 +1397,18 @@ the + + + + + + + + + + + + | _______ enle<br> @@ -936,6 +1423,18 @@ the + + + + + + + + + + + + | /<br> @@ -949,6 +1448,18 @@ the + + + + + + + + + + + + | /<br> @@ -962,6 +1473,18 @@ the + + + + + + + + + + + + | /<br> @@ -975,6 +1498,18 @@ the + + + + + + + + + + + + | /<br> stle | ------/<br> @@ -996,6 +1531,18 @@ White &nb + + + + + + + + + + + + Black<br> </tt> <br> For minimum sensitivity of printed output to the lighting spectrum, @@ -1063,8 +1610,8 @@ White &nb By default (equivalent to <b>-al</b>) profile creates a <span style="font-weight: bold;">cLUT</span> 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.<br> + most robust and accurate results, and allows for the four different + rendering intents that ICC profiles can support.<br> <br> A cLUT base table profile using a PCS of XYZ can be created if <b>-ax</b> 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 <span style="font-weight: bold;">-aX</span>, which - will create shaper/matrix tags.<br> + white point that can occur in L*a*b* based cLUT input profiles. A <b>disadvantage</b> + 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 <span style="font-weight: bold;">-aX</span>, which will create + shaper/matrix tags.<br> <br> 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.<br> <br> + <a name="V"></a>The <b>-V demphasis</b> 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 <a href="targen.html#V">targen -V</a> + parameter, and values in the range <b>1.3 - 1.6</b> 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.<br> + <br> <a name="f"></a> The <b>-f</b> flag enables Fluorescent Whitening Agent (FWA) compensation. This only works if spectral data is available and, the instrument is not UV filtered. FWA @@ -1192,6 +1760,18 @@ White &nb + + + + + + + + + + + + Violet</span> spectral content, otherwise FWA compensation won't work properly. This means you ideally need to measure your illuminant spectrum using an instrument that can measure down to @@ -1500,7 +2080,7 @@ White &nb profile (.icm extension on the MSWindows platform, .icc on Apple or Unix platforms). The <span style="font-weight: bold;">-O</span> parameter will override this default. - <h3>Discussion</h3> + <h3><a name="Di"></a>Discussion</h3> Note that monochrome profiling isn't currently supported. It may be supported sometime in the future.<br> <br> @@ -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.<br> + with the device measurement, or profile creation.<br> <br> Given a .ti3 file from a display device that contains calibration curves (generated by <a href="dispcal.html">dispcal</a>, passed |