diff options
Diffstat (limited to 'doc/collink.html')
| -rwxr-xr-x[-rw-r--r--] | doc/collink.html | 1067 |
1 files changed, 633 insertions, 434 deletions
diff --git a/doc/collink.html b/doc/collink.html index dc67463..b746c5d 100644..100755 --- a/doc/collink.html +++ b/doc/collink.html @@ -19,12 +19,12 @@ or to retain the source black characteristic from the source profile.<br> <h3>Usage Summary</h3> - <small><span style="font-family: monospace;">collink [-options] <span - style="font-style: italic;">srcprofile dstprofile - linkedprofile</span></span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#v">-v</a><span - style="font-family: monospace;"> + <span style="font-family: monospace;">collink [-options] <span + style="font-style: italic;">srcprofile dstprofile linkedprofile</span></span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#v">-v</a><span + style="font-family: monospace;"> @@ -63,32 +63,34 @@ - Verbose<br> - </span></small><small><span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#A">-A "manufacturer"</a><span - style="font-family: monospace;"> Set the manufacturer - description string</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#M">-M "model"</a><span - style="font-family: monospace;"> - Set the model - description string</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#D">-D "description"</a><span - style="font-family: monospace;"> Set the profile - Description string (Default "</span><span - style="font-style: italic; font-family: monospace;">inoutfile</span><span - style="font-family: monospace;">")</span><br style="font-family: - monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#C">-C "copyright"</a><span - style="font-family: monospace;"> Set the - copyright string</span></small><br style="font-family: + + + + Verbose<br> + </span><span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#A">-A "manufacturer"</a><span + style="font-family: monospace;"> Set the manufacturer + description string</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#M">-M "model"</a><span + style="font-family: monospace;"> + Set the model + description string</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#D">-D "description"</a><span + style="font-family: monospace;"> Set the profile + Description string (Default "</span><span style="font-style: + italic; font-family: monospace;">inoutfile</span><span + style="font-family: monospace;">")</span><br style="font-family: monospace;"> - <small><span style="font-family: monospace;"></span><span - style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#V">-V</a><span - style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#C">-C "copyright"</a><span + style="font-family: monospace;"> Set the + copyright string</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"></span><span + style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#V">-V</a><span + style="font-family: monospace;"> Verify existing @@ -129,16 +131,19 @@ existing - profile, rather than link (Debug option)</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#q">-q lmhu</a><span - style="font-family: monospace;"> - Quality - Low, Medium (def), - High, Ultra</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#r">-r <i>res</i></a><span - style="font-family: monospace;"> + + + + profile, rather than link (Debug option)</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#q">-q lmhu</a><span + style="font-family: monospace;"> + Quality - Low, Medium (def), High, + Ultra</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#r">-r <i>res</i></a><span + style="font-family: monospace;"> Override clut @@ -179,10 +184,13 @@ 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 - style="font-family: monospace;"> + + + + 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 + style="font-family: monospace;"> Don't preserve @@ -223,36 +231,38 @@ 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 - style="font-family: monospace;"> - - Special :- Force neutral colors - to be K only output.<br> - </span></small><small><span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#fk">-fk</a><span - style="font-family: monospace;"> - - Special :- Force K only neutral colors - to be K only output<br> - </span></small><small><span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#fcmy">-fcmy</a><span - style="font-family: monospace;"> - - Special :- Force 100% C,M or Y only to stay pure</span></small><br + + + + 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 style="font-family: monospace;"> - <small><span style="font-family: monospace;"></span><span - style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#F">-F</a><span - style="font-family: monospace;"> - - Special :- Force all colors to be - K only output.</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#p">-p aprof.icm</a><span - style="font-family: monospace;"> + + Special :- Force neutral colors to + be K only output.<br> + </span><span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#fk">-fk</a><span + style="font-family: monospace;"> + + Special :- Force K only neutral colors to + be K only output<br> + </span><span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#fcmy">-fcmy</a><span + style="font-family: monospace;"> + + Special :- Force 100% C,M or Y only to stay pure</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"></span><span + style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#F">-F</a><span + style="font-family: monospace;"> + + Special :- Force all colors to be K + only output.</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#p">-p aprof.icm</a><span + style="font-family: monospace;"> Include @@ -292,14 +302,16 @@ Include - abstract profile in link</span></small><br> - <small><span style="font-family: monospace;"><small><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></small> to link output and append linear<br> - <a href="H">-H file.cal</a> + + + + 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> @@ -314,11 +326,14 @@ Include - Append calibration curves to 3dlut<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;"> + + + + Append calibration curves to 3dlut<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;"> Simple Mode @@ -359,15 +374,18 @@ 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 - style="font-family: monospace;"> - Gamut Mapping Mode [optional source image gamut]</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#G">-G [src.gam]</a><span - style="font-family: monospace;"> + + + + (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 + style="font-family: monospace;"> + Gamut Mapping Mode [optional source image gamut]</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#G">-G [src.gam]</a><span + style="font-family: monospace;"> Gamut @@ -407,18 +425,21 @@ Gamut - Mapping Mode using inverse outprofile A2B [optional source - gamut]</span><br style="font-family: monospace;"> - <br style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><u - style="font-family: monospace;">Simple Mode Options:</u><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#si">-i <i>in_intent</i></a><span - style="font-family: monospace;"> p = - perceptual, r = relative colorimetric,</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> + + + + Mapping Mode using inverse outprofile A2B [optional source gamut]</span><br + style="font-family: monospace;"> + <br style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><u + style="font-family: monospace;">Simple Mode Options:</u><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#si">-i <i>in_intent</i></a><span + style="font-family: monospace;"> p = + perceptual, r = relative colorimetric,</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> s @@ -459,15 +480,18 @@ s - = saturation, a = absolute colorimetric</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#so">-o </a><i - style="font-family: monospace;"><a href="#so">out_intent</a> </i><span - style="font-family: monospace;"> p = - perceptual, r = relative colorimetric,</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> + + + + = saturation, a = absolute colorimetric</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#so">-o </a><i + style="font-family: monospace;"><a href="#so">out_intent</a> </i><span + style="font-family: monospace;"> p = perceptual, + r = relative colorimetric,</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> s @@ -508,18 +532,21 @@ s - = saturation, a = absolute colorimetric</span><br - style="font-family: monospace;"> - <br style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><u - style="font-family: monospace;">Mapping Mode Options:</u><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#i">-i <i>intent</i></a><span - style="font-family: monospace;"> - set linking intent from the following choice:</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> + + + + = saturation, a = absolute colorimetric</span><br + style="font-family: monospace;"> + <br style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><u + style="font-family: monospace;">Mapping Mode Options:</u><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#i">-i <i>intent</i></a><span + style="font-family: monospace;"> set + linking intent from the following choice:</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> a - @@ -560,8 +587,11 @@ a - Absolute Colorimetric (in Jab) [ICC Absolute Colorimetric]<br> - + + + + Absolute Colorimetric (in Jab) [ICC Absolute Colorimetric]<br> + aw - @@ -602,9 +632,12 @@ aw - Absolute Colorimetric (in Jab) with scaling to fit white point<br - style="font-family: monospace;"> - </span><span style="font-family: monospace;"> + + + + Absolute Colorimetric (in Jab) with scaling to fit white point<br + style="font-family: monospace;"> + </span><span style="font-family: monospace;"> aa - @@ -645,8 +678,11 @@ aa - Absolute Appearance</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> + + + + Absolute Appearance</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> r - @@ -687,9 +723,12 @@ r - White Point Matched Appearance [ICC Relative Colorimetric]</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> + + + + White Point Matched Appearance [ICC Relative Colorimetric]</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> la - @@ -730,9 +769,12 @@ la - Luminance matched Appearance</span><br style="font-family: - monospace;"> - <span style="font-family: monospace;"> + + + + Luminance matched Appearance</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> p - @@ -773,8 +815,11 @@ p - Perceptual (Preferred) [ICC Perceptual]<br> - </span></small><small><span style="font-family: monospace;"> + + + + Perceptual (Preferred) [ICC Perceptual]<br> + </span><span style="font-family: monospace;"> pa @@ -814,12 +859,18 @@ pa - - Perceptual Appearance</span></small><br> + + + + - Perceptual Appearance</span><br> <tt> + + + lp - Luminance Preserving Perceptual</tt><br style="font-family: monospace;"> - <small><span style="font-family: monospace;"></span><span - style="font-family: monospace;"> + <span style="font-family: monospace;"></span><span + style="font-family: monospace;"> ms - @@ -860,8 +911,11 @@ ms - Saturation</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> + + + + Saturation</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> s - @@ -902,9 +956,12 @@ s - Enhanced Saturation [ICC Saturation]</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> + + + + Enhanced Saturation [ICC Saturation]</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> al - @@ -945,11 +1002,11 @@ al - Absolute Colorimetric (Lab)<br> - + Absolute Colorimetric (Lab)<br> + @@ -980,14 +1037,23 @@ al - rl - White Point Matched Colorimetric (Lab)</span><span - style="font-family: monospace;"></span><br style="font-family: - monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#w">-w [J,a,b]</a><span - style="font-family: monospace;"> Use forced - whitepoint hack [optional color to map the white to]<br> - <a href="#b">-b</a> + + + + + + + rl - White Point Matched Colorimetric (Lab)</span><span + style="font-family: monospace;"></span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#w">-w [J,a,b]</a><span + style="font-family: monospace;"> Use forced + whitepoint hack [optional color to map the white to]<br> + <a href="#b">-b</a> + + + @@ -997,14 +1063,13 @@ al - Use RGB->RGB forced black point hack<br style="font-family: - monospace;"> - </span> <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#c">-c <i>viewcond</i></a><span - style="font-family: monospace;"> set source viewing - conditions for CIECAM02,</span><br style="font-family: + Use RGB->RGB forced black point hack<br style="font-family: monospace;"> - <span style="font-family: monospace;"> + </span> <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#c">-c <i>viewcond</i></a><span + style="font-family: monospace;"> set source viewing + conditions for CIECAM02,</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> either @@ -1045,14 +1110,17 @@ either - an enumerated choice, or a parameter</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#d">-d <i>viewcond</i></a><span - style="font-family: monospace;"> set destination - viewing conditions for CIECAM02,</span><br style="font-family: - monospace;"> - <span style="font-family: monospace;"> + + + + an enumerated choice, or a parameter</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#d">-d <i>viewcond</i></a><span + style="font-family: monospace;"> set destination + viewing conditions for CIECAM02,</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> either @@ -1093,12 +1161,27 @@ either - an enumerated choice, or a parameter:value change<br> - </span></small><small><span style="font-family: monospace;"> - pp - Practical - Reflection Print (ISO-3664 P2)</span><br style="font-family: - monospace;"> - <span style="font-family: monospace;"> + + + + 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> + </tt><tt> + pm - Print evaluation with partial Mid-tone adapation</tt><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + mt - Monitor in + typical work environment</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> @@ -1139,13 +1222,32 @@ either - pe - Print evaluation environment (CIE 116-1995)<br> - </span></small><small><span style="font-family: monospace;"> - - + mb - Monitor in bright work environment</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + md - Monitor in darkened work + environment</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> + jm - Projector in dim environment</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + jd - Projector in dark + environment</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> + pcd - Photo CD - original scene outdoors</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + ob - Original scene - Bright + Outdoors</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> + cx - Cut Sheet Transparencies on + a viewing box</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> +s:surround +n @@ -1181,24 +1283,17 @@ either - pc - Critical print evaluation environment (ISO-3664 P1)</span></small><small><span - style="font-family: monospace;"></span><span style="font-family: - monospace;"></span><span style="font-family: monospace;"></span><span - style="font-family: monospace;"></span><br style="font-family: - monospace;"> - <span style="font-family: monospace;"> - mt - Monitor in - typical work environment</span><br style="font-family: - monospace;"> - <span style="font-family: monospace;"> - - + = auto, a = average, m = dim, d = dark,</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + + @@ -1231,29 +1326,6 @@ either - mb - Monitor in bright work environment</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> - md - Monitor in darkened work - environment</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> - jm - Projector in dim - environment</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> - jd - Projector in dark - environment</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> - pcd - Photo CD - original scene - outdoors</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> - ob - Original scene - Bright - Outdoors</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> - cx - Cut Sheet Transparencies - on a viewing box</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> -s:surround -n @@ -1263,6 +1335,11 @@ n + c = transparency (default average)</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> +w:X:Y:Z +Adapted @@ -1292,11 +1369,6 @@ n - = auto, a = average, m = dim, d = dark,</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> - - @@ -1309,6 +1381,11 @@ n + white point as XYZ (default media white)</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> +w:x:y +Adapted @@ -1335,11 +1412,6 @@ n - c = transparency (default average)</span><br style="font-family: - monospace;"> - <span style="font-family: monospace;"> -w:X:Y:Z -Adapted @@ -1355,6 +1427,10 @@ Adapted + white point as x, y</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> +a:adaptation +Adaptatation @@ -1378,11 +1454,6 @@ Adapted - white point as XYZ (default media white)</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> -w:x:y -Adapted @@ -1401,6 +1472,12 @@ Adapted + luminance in cd.m^2 (default 50.0)</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> +b:background +Background +% @@ -1421,10 +1498,6 @@ Adapted - white point as x, y</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> -a:adaptation -Adaptatation @@ -1446,6 +1519,15 @@ Adaptatation + of image luminance (default 20)<br> + l:imagewhite + Image white in cd.m^2 if surround = auto (default 250)</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"><span style="font-family: + monospace;"> +f:flare +Flare +light @@ -1463,12 +1545,6 @@ Adaptatation - luminance in cd.m^2 (default 50.0)</span><br style="font-family: - monospace;"> - <span style="font-family: monospace;"> -b:background -Background -% @@ -1493,7 +1569,12 @@ Background + % 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;"> @@ -1507,15 +1588,6 @@ Background - of image luminance (default 20)<br> - l:imagewhite - Image white in cd.m^2 if surround = auto (default 250)</span></small><br - style="font-family: monospace;"> - <small><span style="font-family: monospace;"><small><span - style="font-family: monospace;"> -f:flare -Flare -light @@ -1533,6 +1605,9 @@ light + g:X:Y:Z Glare color as XYZ + (default media white)</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> @@ -1554,12 +1629,6 @@ light - % of image luminance (default 0)<br> - </span></small> </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;"> @@ -1569,10 +1638,34 @@ light + g:x:y Glare color + as x, y</span><br style="font-family: monospace;"> + <tt><span style="font-family: monospace;"><tt><span + style="font-family: monospace;"><span style="font-family: + monospace;"> + h:hkscale Helmholtz-Kohlrausch + effect scale factor (default 1.0)<br> + </span> </span><span style="font-family: monospace;"> + 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;"> + <span style="font-family: monospace;"> + + m:x:y + Mid-tone Adaptation white as x, y<br> + </span></tt></span></tt> <span style="font-family: + monospace;"></span><a style="font-family: monospace;" href="#t">-t + <i>tlimit</i></a><span style="font-family: monospace;"> +set +source @@ -1587,9 +1680,6 @@ light - g:X:Y:Z Glare color as XYZ - (default media white)</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> @@ -1617,11 +1707,11 @@ light - g:x:y Glare - color as x, y</span><br style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#t">-t <i>tlimit</i></a><span - style="font-family: monospace;"> + total ink limit, 0 - 400% (estimate by default)</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#T">-T <i>klimit</i></a><span + style="font-family: monospace;"> set source @@ -1662,19 +1752,23 @@ source - total ink limit, 0 - 400% (estimate by default)</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#T">-T <i>klimit</i></a><span - style="font-family: monospace;"> -set -source - - - + total ink limit, 0 - 100% (estimate by default)</span><br + style="font-family: monospace;"> + <br style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><u + style="font-family: monospace;">Inverse outprofile A2B Options:</u><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#k">-k tezhxr</a><span + style="font-family: monospace;"> + CMYK Black generation</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + +t @@ -1707,20 +1801,6 @@ source - total ink limit, 0 - 100% (estimate by default)</span><br - style="font-family: monospace;"> - <br style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><u - style="font-family: monospace;">Inverse outprofile A2B Options:</u><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#k">-k tezhxr</a><span - style="font-family: monospace;"> - CMYK Black generation</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> - -t @@ -1730,6 +1810,11 @@ 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;"> + +z @@ -1759,11 +1844,6 @@ 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;"> - -z @@ -1776,6 +1856,14 @@ 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 + style="font-family: monospace;" href="#kp">-k p stle stpo enpo + enle shape</a><br style="font-family: monospace;"> + <span style="font-family: monospace;"> + +p @@ -1802,14 +1890,6 @@ 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 - style="font-family: monospace;" href="#kp">-k p stle stpo enpo - enle shape</a><br style="font-family: monospace;"> - <span style="font-family: monospace;"> - -p @@ -1825,6 +1905,15 @@ p + = black level generation curve parameters</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#kq">-k q stle0 stpo0 enpo0 + enle0 shape0 stle2 stpo2 enpo2 enle2 shape2</a><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + +q @@ -1848,15 +1937,6 @@ p - = black level generation curve parameters</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#kq">-k q stle0 stpo0 - enpo0 enle0 shape0 stle2 stpo2 enpo2 enle2 shape2</a><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> - -q @@ -1875,6 +1955,18 @@ q + = transfer source K to dual curve limits</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#K">-K parameters</a><span + style="font-family: monospace;"> + Same as -k, but target is K locus rather than K value itself</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#l">-l <i>tlimit</i></a><span + style="font-family: monospace;"> +set +destination @@ -1895,18 +1987,6 @@ q - = transfer source K to dual curve limits</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#K">-K parameters</a><span - style="font-family: monospace;"> - Same as -k, but target is K locus rather than K value itself</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#l">-l <i>tlimit</i></a><span - style="font-family: monospace;"> -set -destination @@ -1928,6 +2008,13 @@ destination + total ink limit, 0 - 400% (estimate by default)</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#L">-L <i>klimit</i></a><span + style="font-family: monospace;"> +set +destination @@ -1945,13 +2032,6 @@ destination - total ink limit, 0 - 400% (estimate by default)</span><br - style="font-family: monospace;"> - <span style="font-family: monospace;"> </span><a - style="font-family: monospace;" href="#L">-L <i>klimit</i></a><span - style="font-family: monospace;"> -set -destination @@ -1976,6 +2056,8 @@ destination + total ink limit, 0 - 100% (estimate by default)<br> + <a href="#3">-3 flag</a> @@ -1990,8 +2072,6 @@ destination - total ink limit, 0 - 100% (estimate by default)<br> - <a href="#3">-3 flag</a> @@ -2013,6 +2093,9 @@ destination + Create "3DLut" output file as well as devlink<br> + + e @@ -2024,9 +2107,6 @@ destination - Create "3DLut" output file as well as devlink<br> - - e @@ -2051,6 +2131,9 @@ destination + eeColor .txt file</span><br> + <tt> + m @@ -2059,9 +2142,6 @@ destination - eeColor .txt file</span></small><br> - <tt> - m @@ -2077,13 +2157,16 @@ destination + MadVR .3dlut file<br> + + c + IRIDAS .cube file<br> + </tt> <tt> <a href="#Ib">-I B</a> - MadVR .3dlut file</tt><br> - <tt> <a href="#Ib">-I B</a> @@ -2100,17 +2183,15 @@ destination BT.1886-like source EOTF with effective gamma g.g</tt><tt><br> </tt><tt><a href="#Ib">-I b:p.p:g.g</a> Use effective gamma g.g source EOTF - with p.p prop. output black point offset</tt><small><span - style="font-family: monospace;"><small><span style="font-family: - monospace;"></span></small></span></small><br> - <small><span style="font-family: monospace;"><small><span - style="font-family: monospace;"><tt> <a - href="collink.html#Ib">-I - g:g.g</a> - Use - effective gamma g.g source EOTF with all output black - point offset</tt><br> - </span></small> <a href="#e">-e flag</a> + with p.p prop. output black point offset</tt><span + style="font-family: monospace;"><span style="font-family: + monospace;"></span></span><br> + <span style="font-family: monospace;"><span style="font-family: + monospace;"><tt> <a href="collink.html#Ib">-I g:g.g</a> + Use + effective gamma g.g source EOTF with all output black point + offset</tt><br> + </span> <a href="#e">-e flag</a> @@ -2143,11 +2224,11 @@ destination - Video encode input as:<br> - <a href="#E">-E flag</a> + Video encode input as:<br> + <a href="#E">-E flag</a> @@ -2177,17 +2258,16 @@ destination - Video encode output as:</span></small><small><span - style="font-family: monospace;"><small><span style="font-family: - monospace;"><br> - - n + Video encode output as:</span><span style="font-family: + monospace;"><span style="font-family: monospace;"><br> + + n @@ -2203,9 +2283,6 @@ destination - normal RGB 0..1 levels (default)<br> - - t @@ -2215,6 +2292,9 @@ destination + normal RGB 0..1 levels (default)<br> + + t @@ -2227,16 +2307,9 @@ destination - RGB (16-235)/255 "TV" levels</span></small></span></small><br> - <small><span style="font-family: monospace;"><small><span - style="font-family: monospace;"><small><span - style="font-family: monospace;"><small><span - style="font-family: monospace;"> - T - @@ -2246,6 +2319,11 @@ 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 + style="font-family: monospace;"> T + @@ -2258,9 +2336,6 @@ destination - RGB (16-235)/255 "TV" levels, clip WTW [Input Only]</span></small></span></small><br> - - 6 @@ -2273,6 +2348,9 @@ destination + RGB (16-235)/255 "TV" levels, clip WTW [Input Only]</span></span><br> + + 6 @@ -2282,9 +2360,6 @@ destination - Rec601 YCbCr SD (16-235,240)/255 "TV" levels<br> - - 7 @@ -2300,15 +2375,15 @@ destination + Rec601 YCbCr SD (16-235,240)/255 "TV" levels<br> + + 7 - Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels<br> - - 5 @@ -2327,12 +2402,12 @@ destination + Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels<br> + + 5 - Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels<br> - - 2 @@ -2354,9 +2429,9 @@ destination - Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels<br> - - C + Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels<br> + + 2 @@ -2378,13 +2453,12 @@ destination - Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV" - levels<br> - - x + Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels<br> + + C @@ -2403,16 +2477,16 @@ destination - xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV" - levels<br> - - X + Rec2020 Constant Luminance YCbCr UHD (16-235,240)/255 "TV" + levels<br> + + x @@ -2428,13 +2502,6 @@ destination - xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV" - levels<br> - </span></small> </span></small> <small><span - style="font-family: monospace;"><a href="#P">-P</a> - -Create -gamut @@ -2444,6 +2511,9 @@ gamut + xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV" levels<br> + + X @@ -2468,20 +2538,17 @@ gamut + 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> + +Create +gamut - gammap_p.x3d.html and gammap_s.x3d.html diagostics</span></small><small><br> - <span style="font-family: monospace;"></span></small><span - style="font-family: monospace;"> <span - style="text-decoration: underline;"><span style="font-style: - italic;"></span></span></span><a href="#p1"><i - style="font-family: monospace;">srcprofile</i></a><span - style="font-family: monospace;"> -source -ICC @@ -2518,9 +2585,17 @@ ICC + gammap_p.x3d.html and gammap_s.x3d.html diagostics</span><br> + <span style="font-family: monospace;"></span><span + style="font-family: monospace;"> <span + style="text-decoration: underline;"><span style="font-style: + italic;"></span></span></span><a href="#p1"><i + style="font-family: monospace;">srcprofile</i></a><span + style="font-family: monospace;"> +source +ICC - profile. A </span><small><span style="font-family: monospace;">TIFF @@ -2559,7 +2634,9 @@ ICC - or JPEG file with embedded profile may be used here.</span></small><br + + 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;"> <span style="font-family: monospace;"><span style="text-decoration: underline;"><span style="font-style: @@ -2606,9 +2683,12 @@ ICC - profile. </span><span style="font-family: monospace;">A </span><small><span - style="font-family: monospace;">TIFF or JPEG file with embedded - profile may be used here.</span></small><br style="font-family: + + + + 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: monospace;"> <span style="font-family: monospace;"> </span><a href="#p3"><i style="font-family: monospace;">linkedprofile</i></a><span @@ -2714,6 +2794,9 @@ ICC + + + Override clut res. set by <b>-q</b><br> <br> This sets the basic quality of the resulting link, by choosing the @@ -2730,7 +2813,9 @@ ICC <a name="n"></a>Normally the per channel device curves in the source and destination profiles are preserved in the resulting device link profile, but the <b>-n</b> option disables this. This can be useful - if the device linearisation curves are inappropriate in nature.<br> + if the device linearisation curves are inappropriate in nature. Note + that both input and output curves will not be preserved if a 3d LUT + output is selected.<br> <br> <a name="f"></a> The <b>-f</b> option is a special purpose flag useful only for 3 or 4 component (RGB, CMY or CMYK) source to CMYK @@ -2831,10 +2916,12 @@ ICC There is an optional argument, which is a source gamut to use instead of that of the source profile. This is to allow optimizing the gamut mapping to a source gamut of a particular image, - which can give slightly better results that gamut mapping from the - gamut of the source colorspace. Such a source image gamut can be - created using the <a href="tiffgamut.html"> tiffgamut</a> tool. - More <a href="#gg">details</a> about gamut mapping mode.<br> + which can give better results that gamut mapping from the gamut of + the source colorspace, particularly if the source colorspace (i.e. + ProPhoto etc.) has a gamut much larger than the images encoded in + that space. Such a source image gamut can be created using the <a + href="tiffgamut.html"> tiffgamut</a> tool. More <a + href="#gg">details</a> about gamut mapping mode.<br> <br> <a name="G"></a> <b>-G</b> Use the gamut mapped, inverse AtoB table linking method. This is generally the most accurate, @@ -2844,11 +2931,13 @@ ICC and <b>-l</b> are effective when this method is selected. There is an optional argument, which is a source gamut to use instead of that of the source profile. This is to allow optimizing the gamut mapping - to a source gamut of a particular image, which can give - slightly better results that gamut mapping from the gamut of the - source colorspace. Such a source image gamut can be created using - the <a href="tiffgamut.html"> tiffgamut</a> tool. More <a - href="#GG">details</a> about the gamut mapping, inverse AtoB mode.<br> + to a source gamut of a particular image, which can give better + results that gamut mapping from the gamut of the source colorspace, + particularly if the source colorspace (i.e. ProPhoto etc.) has a + gamut much larger than the images encoded in that space. Such a + source image gamut can be created using the <a + href="tiffgamut.html"> tiffgamut</a> tool. More <a href="#GG">details</a> + about the gamut mapping, inverse AtoB mode.<br> <br> <a name="Gp"></a>The gamut provided to the <span style="font-weight: bold;">-g</span> or <span style="font-weight: @@ -2904,6 +2993,9 @@ ICC + + + <b>p</b> = perceptual, <b>r</b> = relative colorimetric,<br> <b>s</b> @@ -3091,8 +3183,8 @@ ICC When the <b>-G</b> flag is used, the A2B table is inverted "on the fly", allowing various additional choices as to what device values are used to reproduce a particular color. (If the <b>-G</b> flag is - not used, then such decisions are encoded in the B2A table in the - profile, and cannot be altered during linking).<br> + not used, then such decisions are already encoded in the B2A table + in the profile, and cannot be altered during linking).<br> <br> <a name="k"></a> -<b>k</b> parameter sets the target level of black (K) when creating a B2A CMYK output tables. This is often called a @@ -3175,6 +3267,9 @@ ICC + + + _______ enle<br> | @@ -3217,6 +3312,9 @@ ICC + + + /<br> | @@ -3259,6 +3357,9 @@ ICC + + + /<br> | @@ -3301,6 +3402,9 @@ ICC + + + /<br> | @@ -3343,6 +3447,9 @@ ICC + + + /<br> stle | ------/<br> @@ -3391,6 +3498,9 @@ White &nb + + + Black<br> <br> </tt>For minimum sensitivity of printed output to the lighting @@ -3591,6 +3701,9 @@ White &nb + + + </b>Full output offset with effective gamma of 2.2<b><br> </b><b></b><b>-I B</b><b> @@ -3603,6 +3716,9 @@ 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> @@ -3616,6 +3732,9 @@ White &nb + + + Full output offset with technical gamma of 2.2<br> <br> <b>-I b</b><b>:2.3</b><b> @@ -3629,6 +3748,9 @@ 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> @@ -3642,6 +3764,9 @@ White &nb + + + </b>Full output offset with effective gamma of 2.3<b><br> </b><b> -I B:2.35</b><b> @@ -3654,6 +3779,9 @@ White &nb + + + </b>Full input offset (BT.1886 like) with technical gamma of 2.35<br> <b> -I G:2.35</b> @@ -3666,6 +3794,9 @@ White &nb + + + Full output offset with technical gamma of 2.35<br> <br> <b>-I b</b><b>:0.4:2.3</b> @@ -3681,6 +3812,9 @@ 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> @@ -3701,6 +3835,9 @@ White &nb + + + T @@ -3724,6 +3861,9 @@ White &nb + + + RGB (16-235)/255 "TV" levels, clip WTW [Input Only]<br> </span></small></span></small></span></small></span></small> @@ -3731,6 +3871,9 @@ White &nb + + + x @@ -3753,6 +3896,9 @@ White &nb + + + xvYCC Rec601 YCbCr Rec709 Prims. SD (16-235,240)/255 "TV" levels<br> @@ -3778,6 +3924,9 @@ White &nb + + + xvYCC Rec709 YCbCr Rec709 Prims. HD (16-235,240)/255 "TV" levels</span></small></span></small><br> <br> @@ -3793,10 +3942,10 @@ White &nb <br> The <b>-e T</b> option uses the same encoding as <b>-e t</b>, but rather than handling WTW (Whiter Than White, or out of range values) - using extrapolation, it clips them to the valid range. This can be - useful if you are dealing with source material that has WTW values, - but your TV or Video display clips these out of range values in a - way that alters the hue.<br> + using extrapolation, it clips them to the valid range by scaling + them, to preserve hue. This can be useful if you are dealing with + source material that has WTW values, but your TV or Video display + clips these out of range values in a way that alters the hue.<br> <br> <b><a name="E"></a></b>The <b>-E</b> <i>flag</i> applies a Video encoding to the output. The possible encoding are:<br> @@ -3825,6 +3974,9 @@ White &nb + + + normal RGB 0..1 full range levels (default)<br> t @@ -3849,6 +4001,9 @@ 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> @@ -3859,6 +4014,9 @@ White &nb + + + 6 @@ -3881,6 +4039,9 @@ White &nb + + + Rec601 YCbCr SD (16-235,240)/255 "TV" levels<br> 7 @@ -3905,6 +4066,9 @@ White &nb + + + Rec709 1125/60Hz YCbCr HD (16-235,240)/255 "TV" levels<br> 5 @@ -3929,6 +4093,9 @@ White &nb + + + Rec709 1250/50Hz YCbCr HD (16-235,240)/255 "TV" levels<br> 2 @@ -3953,6 +4120,9 @@ White &nb + + + Rec2020 YCbCr UHD (16-235,240)/255 "TV" levels<br> C @@ -3977,11 +4147,20 @@ 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 style="font-family: monospace;"></span></small></span></small><br> - The <b>T</b> <br> + The <b>-e t</b> option assumes TV encoding range 16-235, and + preserves WTW (Whiter Than White, or out of range values) using + extrapolation, as long as per channel input and output curves are + disabled (see the <a href="#n">-n</a> option), which is + automatically the case if a <a href="#3">3dlut</a> output format is + selected.<br> + <br> <b><a name="P"></a></b>The <b>-P</b> option causes a diagnostic 3D <a href="File_Formats.html#X3DOM">X3DOM</a> plots to be created that illustrate the gamut mapping generated.<br> @@ -4039,7 +4218,27 @@ White &nb + + + Usage Scenarios</a> page.<br> + <h3>Discussion</h3> + The viewing condition parameter <b>m:</b> 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 + <b>pm</b> preset condition has mtaf value of 0.7, and Wxyz2 of D50.<br> <br> <br> <br> |