diff options
Diffstat (limited to 'doc/colprof.html')
| -rw-r--r-- | doc/colprof.html | 459 |
1 files changed, 437 insertions, 22 deletions
diff --git a/doc/colprof.html b/doc/colprof.html index 022f984..b3b6df2 100644 --- a/doc/colprof.html +++ b/doc/colprof.html @@ -38,6 +38,14 @@ + + + + + + + + Verbose mode<br> <a href="#A">-A "manufacturer"</a> Set the manufacturer description string<br> @@ -66,6 +74,14 @@ + + + + + + + + Default intent: Perceptual, Rel. Colorimetric, Saturation, Abs. Colorimetric</small></tt><tt><br> @@ -99,6 +115,14 @@ + + + + + + + + Don't create input (Device) shaper curves<br> </small></tt><tt><small> <a href="#np">-np</a> @@ -128,13 +152,22 @@ + + + + + + + + Don't create output (PCS) shaper curves<br> </small></tt><tt><small> <a href="#nc">-nc</a> Don't put the input .ti3 data in the profile</small></tt><tt><br> </tt><tt> </tt><tt><small> <a href="#k">-k zhxr</a> - Black generation: z = zero K,<br> + Black Ink generation: z = + zero K,<br> @@ -170,6 +203,14 @@ x + + + + + + + + max K, r = ramp K<br> <a href="#kp">-k p stle stpo enpo enle shape</a><br> @@ -206,6 +247,14 @@ White + + + + + + + + - 1.0<br> @@ -242,6 +291,14 @@ Wh + + + + + + + + 0.0 - Bk 1.0<br> @@ -278,6 +335,14 @@ Wh + + + + + + + + 0.0 - Bk 1.0<br> @@ -313,6 +378,14 @@ Black + + + + + + + + 0.0 - 1.0<br> @@ -349,6 +422,14 @@ concave, + + + + + + + + 1.0-2.0 convex<br> <a href="#K">-K parameters</a> @@ -365,6 +446,14 @@ concave, + + + + + + + + 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% @@ -408,6 +497,14 @@ cLUT + + + + + + + + x = XYZ cLUT, X = display XYZ cLUT + matrix<br> @@ -443,6 +540,14 @@ s + + + + + + + + shaper+matrix, m = matrix only,<br> @@ -479,6 +584,14 @@ S + + + + + + + + single shaper+matrix<br> <a href="#u">-u</a> @@ -500,6 +613,14 @@ 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> @@ -538,12 +659,36 @@ and + + + + + + + + primaries to be +ve</tt><tt><br> + <a href="#B">-B X,Y,Z</a> + + + + + + + Display Black Point override hack<br> <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> @@ -563,6 +708,14 @@ and + + + + + + + + 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="#i">-i <i>illum</i></a> @@ -579,6 +732,14 @@ and + + + + + + + + Choose illuminant for computation of CIE XYZ from spectral data & FWA:<br> @@ -605,6 +766,14 @@ 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> @@ -632,6 +801,14 @@ 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> @@ -671,6 +848,14 @@ for + + + + + + + + given source<br> <a href="#S">-S src.icc</a> @@ -696,6 +881,14 @@ for + + + + + + + + Apply gamut mapping to output profile perceptual and saturation B2A table<br> <a href="#nP">-nP</a> @@ -722,6 +915,14 @@ for + + + + + + + + Use colormetric source gamut to make output profile perceptual table<br> <a href="#nS">-nS</a> @@ -748,6 +949,14 @@ for + + + + + + + + Use colormetric source gamut to make output profile saturation table<br> <a href="#g">-g src.gam</a> @@ -782,6 +991,14 @@ for + + + + + + + + Override gamut mapping intent for output profile saturation table:<br> </small></tt><tt><small> @@ -824,6 +1041,14 @@ for + + + + + + + + pa - Perceptual Appearance</small></tt><tt><br> </tt><tt> </tt><tt><small> @@ -849,6 +1074,14 @@ for + + + + + + + + ms - Saturation<br> s - Enhanced Saturation [ICC @@ -867,6 +1100,14 @@ for + + + + + + + + rl - White Point Matched Colorimetric (Lab)<br> <a href="#c">-c viewcond</a> @@ -892,6 +1133,14 @@ for + + + + + + + + set input viewing conditions for output profile CIECAM02 gamut mapping,<br> @@ -918,6 +1167,14 @@ for + + + + + + + + either an enumerated choice, or a parameter<br> <a href="#d">-d viewcond</a> @@ -943,6 +1200,14 @@ for + + + + + + + + set output viewing conditions for output profile CIECAM02, gamut mapping<br> @@ -969,6 +1234,14 @@ for + + + + + + + + either an enumerated choice, or a parameter:value change<br> @@ -994,6 +1267,14 @@ for + + + + + + + + Also sets out of gamut clipping CAM space.<br> @@ -1019,6 +1300,14 @@ for + + + + + + + + Enumerated Viewing Conditions:<br> </small></tt><tt><small> pp - Practical Reflection Print (ISO-3664 @@ -1073,6 +1362,14 @@ for + + + + + + + + c = transparency (default average)<br> @@ -1111,6 +1408,14 @@ for + + + + + + + + g:glare Glare light % of ambient (default 1)</span><br style="font-family: monospace;"> @@ -1150,7 +1455,15 @@ for - Create gamut gammap_p.wrl and gammap_s.wrl diagostics<br> + + + + + + + + + Create gamut gammap_p.x3d.html and gammap_s.x3d.html diagostics<br> </small></tt><tt><small> <a href="#O">-O outputfile</a> Override @@ -1176,6 +1489,14 @@ 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 @@ -1322,6 +1643,14 @@ 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 @@ -1348,6 +1677,14 @@ 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 @@ -1409,6 +1746,14 @@ the + + + + + + + + | _______ enle<br> @@ -1435,6 +1780,14 @@ the + + + + + + + + | /<br> @@ -1460,6 +1813,14 @@ the + + + + + + + + | /<br> @@ -1485,6 +1846,14 @@ the + + + + + + + + | /<br> @@ -1510,6 +1879,14 @@ the + + + + + + + + | /<br> stle | ------/<br> @@ -1543,6 +1920,14 @@ White &nb + + + + + + + + Black<br> </tt> <br> For minimum sensitivity of printed output to the lighting spectrum, @@ -1708,6 +2093,26 @@ White &nb black and primary values, so as to work with these programs, but this will reduce the accuracy of the profile.<br> <br> + <b><a name="B"></a>-B X,Y,Z</b> This option is for display profiles + only, and allows overriding the black point of the resulting + profile. The XYZ value is in absolute instrument measurement units. + This option should be used only in special circumstances, for + instance if the display has a very low black point and the + instrument is not capable of measuring the black point accurately or + consistently. In this case a manual estimate of the black point + could be made and provided as the argument to -B. It may also be + useful for displays with black points that approach perfect black + (ie. Plasma or OLED) where a value of 0,0,0 may be more accurate + than typical instrument measurements. A value that is too different + to the default computed black point will likely result in a profile + with strange behavior near black.<br> + <b>Note</b> that the default contents of the .ti3 created by <a + href="dispread.html">dispread</a> is normalised to be 100 for the + white point Y value, and similarly values returned by icclu -ia -px + are normalized to a white Y value of 1.0, which is not what the <b>-B</b> + option expects, so some care needs to be taken in specifying and + evaluating the resulting black point XYZ values.<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 @@ -1735,14 +2140,14 @@ White &nb Ultra Violet to the one the instrument actually used in the measurement. There are two ways this can be used:<br> <br> - The first and most common is to use the <b>-f</b> flag with the <b>-i</b> - illuminant parameter, to make the color values more accurately - reflect their appearance under the viewing illuminant. This will - work accurately if you specify the <span style="text-decoration: - underline;">actual illuminant spectrum you are using to view the - print</span>, using the <span style="font-weight: bold;"><span - style="font-weight: bold;">-i</span></span> flag. If you are - doing proofing, you need to apply this to <span + <b>The first and most useful</b> is to use the <b>-f</b> flag with + the <b>-i</b> illuminant parameter (i.e. "<b>-f -i D50"</b>), to + make the color values more accurately reflect their appearance under + the viewing illuminant. This will work accurately if you specify the + <span style="text-decoration: underline;">actual illuminant spectrum + you are using to view the print</span>, using the <span + style="font-weight: bold;"><span style="font-weight: bold;">-i</span></span> + flag. If you are doing proofing, you need to apply this to <span style="text-decoration: underline;">both your source profile, and your destination profile</span>. Note that it is not sufficient to specify an illuminant with the same white point as the one you are @@ -1772,6 +2177,14 @@ 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 @@ -1785,6 +2198,7 @@ White &nb ref/D50_X.X.sp set of illuminant spectra are the D50 spectrum with different levels of U.V. added or subtracted, ref/D50_1.0.sp being the standard D50 illuminant, and may be somewhere to start.<br> + <br> [Note: Generally using <span style="font-weight: bold;">-f</span> with the standard (<b>-i) </b>D50 illuminant spectrum will predict that the device will produce bluer output than the default of not @@ -1797,13 +2211,14 @@ White &nb result will be, as the overall color correction compensates for the blueness. The opposite will happen for an input profile.]<br> <br> - The second way of using the <b>-f</b> flag is to provide it with a - instrument simulation illuminant spectrum parameter, in addition to - the default D50 or <b>-i</b> parameter CIE XYZ - calculation illuminant<b></b>. This more complicated scenario - simulates the measurement of the spectral reflectance of the samples - under a particular instrument illuminant, then computes the CIE XYZ - values of that reflectance spectrum under the default D50 or <b>-i</b> + <b>The second way</b> of using the <b>-f</b> flag is to provide it + with a instrument simulation illuminant spectrum parameter, in + addition to the default D50 or <b>-i</b> parameter CIE XYZ + calculation illuminant (i.e. "<b>-f M1"</b>, or "<b>-f A -i D65"</b> + etc.). This more complicated scenario simulates the <u>measurement</u> + of the spectral reflectance of the samples under a particular + instrument illuminant, then <u>computes</u> the CIE XYZ values of + that reflectance spectrum under the default D50 or <b>-i</b> parameter illuminant. This is <u>not</u> used to give a more accurate real world result, but to provide simulations of various standardized measurement conditions. For instance, to reproduce ISO @@ -1817,10 +2232,10 @@ White &nb equivalent to<b> -f D50</b><br> <b>-f M2</b> equivalent to<b> -f D50M2</b><b><br> - </b><br> - Note that using <span style="font-weight: bold;">-f</span> <b>M2</b> - gives a result that is comparable to that of a U.V. cut filter - instrument. See also the discussion <a href="FWA.html">About + <br> + </b> Note that using <span style="font-weight: bold;">-f</span> + <b>M2</b> gives a result that is comparable to that of a U.V. cut + filter instrument. See also the discussion <a href="FWA.html">About Fluorescent Whitening Agent compensation</a>.<br> <br> <a name="i"></a> The <b>-i</b> parameter allows specifying a @@ -2064,7 +2479,7 @@ White &nb been applied) into the device gamut. <br> <br> <b><a name="P"></a></b>The <b>-P</b> option causes diagnostic 3D <a - href="File_Formats.html#VRML">VRML</a> plots to be created that + href="File_Formats.html#X3DOM">X3DOM</a> plots to be created that illustrate the gamut mappings generated for the perceptual and saturation intent tables.<br> <br> |