diff options
Diffstat (limited to 'doc/collink.html')
| -rwxr-xr-x | doc/collink.html | 130 |
1 files changed, 121 insertions, 9 deletions
diff --git a/doc/collink.html b/doc/collink.html index b746c5d..fbb1aaa 100755 --- a/doc/collink.html +++ b/doc/collink.html @@ -18,6 +18,9 @@ inverting the forward profile, to allow black ink regeneration or to retain the source black characteristic from the source profile.<br> + <br> + <small>The <a href="#O">-O</a> option allows creation of a device + link that contains just per channel calibration curves.</small> <h3>Usage Summary</h3> <span style="font-family: monospace;">collink [-options] <span style="font-style: italic;">srcprofile dstprofile linkedprofile</span></span><br @@ -66,6 +69,7 @@ + Verbose<br> </span><span style="font-family: monospace;"> </span><a style="font-family: monospace;" href="#A">-A "manufacturer"</a><span @@ -134,6 +138,7 @@ existing + profile, rather than link (Debug option)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a @@ -187,6 +192,7 @@ clut + res. set by -q</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a style="font-family: monospace;" href="#n">-n</a><span @@ -234,6 +240,7 @@ preserve + device curves in result</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a style="font-family: monospace;" href="#f">-f</a><span @@ -305,13 +312,14 @@ Include + abstract profile in link</span><br> <span style="font-family: monospace;"><span style="font-family: monospace;"> </span><a style="font-family: monospace;" href="#a">-a file.cal</a><span style="font-family: monospace;"> Apply calibration curves</span> to link output and append linear<br> - <a href="H">-H file.cal</a> + <a href="#H">-H file.cal</a> @@ -329,8 +337,11 @@ Include - Append calibration curves to 3dlut<br style="font-family: - monospace;"> + + Append calibration curves to 3dlut<br> + <a href="#O">-O file.cal</a> + Use just calibration curves as link and append linear<br + style="font-family: monospace;"> </span> <span style="font-family: monospace;"> </span><a style="font-family: monospace;" href="#s">-s</a><span style="font-family: monospace;"> @@ -377,6 +388,7 @@ Mode + (default)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a style="font-family: monospace;" href="#g">-g [src.gam]</a><span @@ -428,6 +440,7 @@ Gamut + Mapping Mode using inverse outprofile A2B [optional source gamut]</span><br style="font-family: monospace;"> <br style="font-family: monospace;"> @@ -483,6 +496,7 @@ s + = saturation, a = absolute colorimetric</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a @@ -535,6 +549,7 @@ s + = saturation, a = absolute colorimetric</span><br style="font-family: monospace;"> <br style="font-family: monospace;"> @@ -590,6 +605,7 @@ a + Absolute Colorimetric (in Jab) [ICC Absolute Colorimetric]<br> aw @@ -635,6 +651,7 @@ aw + Absolute Colorimetric (in Jab) with scaling to fit white point<br style="font-family: monospace;"> </span><span style="font-family: monospace;"> @@ -681,6 +698,7 @@ aa + Absolute Appearance</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> r @@ -726,6 +744,7 @@ r + White Point Matched Appearance [ICC Relative Colorimetric]</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -772,6 +791,7 @@ la + Luminance matched Appearance</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -818,6 +838,7 @@ p + Perceptual (Preferred) [ICC Perceptual]<br> </span><span style="font-family: monospace;"> pa @@ -862,11 +883,13 @@ pa + - Perceptual Appearance</span><br> <tt> + lp - Luminance Preserving Perceptual</tt><br style="font-family: monospace;"> <span style="font-family: monospace;"></span><span @@ -914,6 +937,7 @@ ms + Saturation</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> s @@ -959,6 +983,7 @@ s + Enhanced Saturation [ICC Saturation]</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -1005,6 +1030,7 @@ al + Absolute Colorimetric (Lab)<br> @@ -1043,6 +1069,7 @@ al + rl - White Point Matched Colorimetric (Lab)</span><span style="font-family: monospace;"></span><br style="font-family: monospace;"> @@ -1063,6 +1090,7 @@ al + Use RGB->RGB forced black point hack<br style="font-family: monospace;"> </span> <span style="font-family: monospace;"> </span><a @@ -1113,6 +1141,7 @@ either + an enumerated choice, or a parameter</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a @@ -1164,14 +1193,17 @@ either + an enumerated choice, or a parameter:value change<br> </span><tt> </tt><tt><tt>pc + - Critical print evaluation environment (ISO-3664 P1)</tt><tt><br> + </tt>pp - Practical Reflection Print (ISO-3664 P2)<br> pe - Print evaluation environment (CIE 116-1995)<br> @@ -1225,6 +1257,7 @@ either + mb - Monitor in bright work environment</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -1289,6 +1322,7 @@ n + = auto, a = average, m = dim, d = dark,</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -1335,6 +1369,7 @@ n + c = transparency (default average)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -1381,6 +1416,7 @@ Adapted + white point as XYZ (default media white)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -1427,6 +1463,7 @@ Adapted + white point as x, y</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> a:adaptation @@ -1472,6 +1509,7 @@ Adaptatation + luminance in cd.m^2 (default 50.0)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -1519,6 +1557,7 @@ Background + of image luminance (default 20)<br> l:imagewhite Image white in cd.m^2 if surround = auto (default 250)</span><br @@ -1569,9 +1608,11 @@ light + % of image luminance (default 0)<br> </span> </span><span style="font-family: monospace;"> + g:glare Glare light % of ambient (default 5)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -1605,6 +1646,7 @@ light + g:X:Y:Z Glare color as XYZ (default media white)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -1638,6 +1680,7 @@ light + g:x:y Glare color as x, y</span><br style="font-family: monospace;"> <tt><span style="font-family: monospace;"><tt><span @@ -1649,11 +1692,13 @@ light + m:mtaf Mid-tone partial adaptation factor (default 0.0)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> + m:X:Y:Z Mid-tone Adaptation white as XYZ (default D50)</span><br style="font-family: monospace;"> @@ -1707,6 +1752,7 @@ source + total ink limit, 0 - 400% (estimate by default)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a @@ -1755,6 +1801,7 @@ source + total ink limit, 0 - 100% (estimate by default)</span><br style="font-family: monospace;"> <br style="font-family: monospace;"> @@ -1810,6 +1857,7 @@ t + = transfer K from source to destination, e = retain K of destination B2A table</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> @@ -1856,6 +1904,7 @@ z + = zero K, h = 0.5 K, x = maximum K, r = ramp K (default)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a @@ -1905,6 +1954,7 @@ p + = black level generation curve parameters</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a @@ -1955,6 +2005,7 @@ q + = transfer source K to dual curve limits</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a @@ -2008,6 +2059,7 @@ destination + total ink limit, 0 - 400% (estimate by default)</span><br style="font-family: monospace;"> <span style="font-family: monospace;"> </span><a @@ -2056,6 +2108,7 @@ destination + total ink limit, 0 - 100% (estimate by default)<br> <a href="#3">-3 flag</a> @@ -2093,6 +2146,7 @@ destination + Create "3DLut" output file as well as devlink<br> e @@ -2131,6 +2185,7 @@ destination + eeColor .txt file</span><br> <tt> m @@ -2157,11 +2212,13 @@ destination + MadVR .3dlut file<br> c + IRIDAS .cube file<br> </tt> <tt> <a href="#Ib">-I B</a> @@ -2177,6 +2234,7 @@ destination + Use BT.1886 source EOTF with technical gamma 2.4</tt><tt><br> </tt><tt> <a href="#Ib">-I b:g.g</a> Use @@ -2227,6 +2285,7 @@ destination + Video encode input as:<br> <a href="#E">-E flag</a> @@ -2264,6 +2323,7 @@ destination + Video encode output as:</span><span style="font-family: monospace;"><span style="font-family: monospace;"><br> @@ -2292,6 +2352,7 @@ destination + normal RGB 0..1 levels (default)<br> t @@ -2319,6 +2380,7 @@ destination + RGB (16-235)/255 "TV" levels</span></span><br> <span style="font-family: monospace;"><span style="font-family: monospace;"><span style="font-family: monospace;"><span @@ -2348,6 +2410,7 @@ destination + RGB (16-235)/255 "TV" levels, clip WTW [Input Only]</span></span><br> 6 @@ -2375,6 +2438,7 @@ destination + Rec601 YCbCr SD (16-235,240)/255 "TV" levels<br> 7 @@ -2402,6 +2466,7 @@ destination + Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels<br> 5 @@ -2429,6 +2494,7 @@ destination + Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels<br> 2 @@ -2456,6 +2522,7 @@ destination + Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels<br> C @@ -2483,6 +2550,7 @@ destination + Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV" levels<br> @@ -2511,6 +2579,7 @@ destination + xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV" levels<br> X @@ -2538,6 +2607,7 @@ destination + xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV" levels<br> </span> </span> <span style="font-family: monospace;"><a href="#P">-P</a> @@ -2585,6 +2655,7 @@ gamut + gammap_p.x3d.html and gammap_s.x3d.html diagostics</span><br> <span style="font-family: monospace;"></span><span style="font-family: monospace;"> <span @@ -2635,6 +2706,7 @@ ICC + profile. A </span><span style="font-family: monospace;">TIFF or JPEG file with embedded profile may be used here.</span><br style="font-family: monospace;"> @@ -2686,6 +2758,7 @@ ICC + profile. </span><span style="font-family: monospace;">A </span><span style="font-family: monospace;">TIFF or JPEG file with embedded profile may be used here.</span><br style="font-family: @@ -2797,6 +2870,7 @@ ICC + Override clut res. set by <b>-q</b><br> <br> This sets the basic quality of the resulting link, by choosing the @@ -2895,6 +2969,13 @@ ICC 3dLut is used by MadVR v0.86.9 or latter. By default no calibration curves are appended to a MadVR 3dLut.<br> <br> + <a name="O"></a> The <b>-O</b> parameter causes calibration curves + in the supplied file to be use to creat the link. ICC profiles are + not expectedt or used. This option allows a device link to be used + to apply just per channel calibraion curves. Note that many normal + options will be ignored or may cause unexpected results when used + with this option.<br> + <br> The basic linking style is chosen by using the <b>-s</b> (default), <b>-g</b> or <b>-G</b> flags. The three behaviors are:<br> <br> @@ -2996,6 +3077,7 @@ ICC + <b>p</b> = perceptual, <b>r</b> = relative colorimetric,<br> <b>s</b> @@ -3270,6 +3352,7 @@ ICC + _______ enle<br> | @@ -3315,6 +3398,7 @@ ICC + /<br> | @@ -3360,6 +3444,7 @@ ICC + /<br> | @@ -3405,6 +3490,7 @@ ICC + /<br> | @@ -3450,6 +3536,7 @@ ICC + /<br> stle | ------/<br> @@ -3501,6 +3588,7 @@ White &nb + Black<br> <br> </tt>For minimum sensitivity of printed output to the lighting @@ -3704,6 +3792,7 @@ White &nb + </b>Full output offset with effective gamma of 2.2<b><br> </b><b></b><b>-I B</b><b> @@ -3719,6 +3808,7 @@ White &nb + </b>Full input offset (BT.1886 like) with technical gamma of 2.4. This exactly implements the BT.1886 specification.<b><br> </b><b>-I G</b> @@ -3735,6 +3825,7 @@ White &nb + Full output offset with technical gamma of 2.2<br> <br> <b>-I b</b><b>:2.3</b><b> @@ -3751,6 +3842,7 @@ White &nb + </b>Full input offset (BT.1886 like) with effective gamma of 2.3<b> <br> </b><b> -I g:2.3</b><b> @@ -3767,6 +3859,7 @@ White &nb + </b>Full output offset with effective gamma of 2.3<b><br> </b><b> -I B:2.35</b><b> @@ -3782,6 +3875,7 @@ White &nb + </b>Full input offset (BT.1886 like) with technical gamma of 2.35<br> <b> -I G:2.35</b> @@ -3797,6 +3891,7 @@ White &nb + Full output offset with technical gamma of 2.35<br> <br> <b>-I b</b><b>:0.4:2.3</b> @@ -3815,6 +3910,7 @@ White &nb + Same as above.<b><br> </b><b> -I B:0.4:2.35</b> 60% input offset, 40% output offset with technical gamma of 2.35 <b><br> @@ -3838,6 +3934,7 @@ White &nb + T @@ -3864,6 +3961,7 @@ White &nb + RGB (16-235)/255 "TV" levels, clip WTW [Input Only]<br> </span></small></span></small></span></small></span></small> @@ -3874,6 +3972,7 @@ White &nb + x @@ -3899,6 +3998,7 @@ White &nb + xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV" levels<br> @@ -3927,6 +4027,7 @@ White &nb + xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV" levels</span></small></span></small><br> <br> @@ -3977,6 +4078,7 @@ White &nb + normal RGB 0..1 full range levels (default)<br> t @@ -4004,6 +4106,7 @@ White &nb + RGB (16-235)/255 "TV" levels</span></small></span></small><small><span style="font-family: monospace;"><small><span style="font-family: monospace;"></span></small></span></small><br> @@ -4017,6 +4120,7 @@ White &nb + 6 @@ -4042,6 +4146,7 @@ White &nb + Rec601 YCbCr SD (16-235,240)/255 "TV" levels<br> 7 @@ -4069,6 +4174,7 @@ White &nb + Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels<br> 5 @@ -4096,6 +4202,7 @@ White &nb + Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels<br> 2 @@ -4123,6 +4230,7 @@ White &nb + Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels<br> C @@ -4150,6 +4258,7 @@ White &nb + Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV" levels</span></small></span></small><br> <small><span style="font-family: monospace;"><small><span @@ -4165,15 +4274,17 @@ White &nb <a href="File_Formats.html#X3DOM">X3DOM</a> plots to be created that illustrate the gamut mapping generated.<br> <br> - <a name="p1"></a>The <i><b>inprofile</b></i> argument specifies the - source profile. This is the color space/device we are attempting to - emulate in the overall conversion. A <small>TIFF or JPEG file with - embedded profile may be used here.</small><br> + <a name="p1"></a>The <i><b>srcprofile</b></i> argument specifies + the source profile. This is the color space/device we are attempting + to emulate in the overall conversion. A <small>TIFF or JPEG file + with embedded profile may be used here. This argument must be + omitted if the <a href="#O">-O</a> option is used.</small><br> <br> - <a name="p2"></a>The<i><b> outprofile</b></i> argument specifies the + <a name="p2"></a>The<i><b> dstprofile</b></i> argument specifies the destination profile. This is the device we are actually displaying on or printing to. A <small>TIFF or JPEG file with embedded profile - may be used here.</small><br> + may be used here. </small><small>This argument must be omitted if + the <a href="#O">-O</a> option is used.</small><br> <br> <a name="p3"></a>The <i><b>linkedprofile</b></i> argument specifies the resulting device link profile. This profile will contain the @@ -4221,6 +4332,7 @@ White &nb + Usage Scenarios</a> page.<br> <h3>Discussion</h3> The viewing condition parameter <b>m:</b> is a hack, intended to |