diff options
Diffstat (limited to 'doc/cctiff.html')
| -rw-r--r-- | doc/cctiff.html | 351 |
1 files changed, 351 insertions, 0 deletions
diff --git a/doc/cctiff.html b/doc/cctiff.html new file mode 100644 index 0000000..c19d5c5 --- /dev/null +++ b/doc/cctiff.html @@ -0,0 +1,351 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> + <head> + <title>cctiff</title> + <meta http-equiv="content-type" content="text/html; + charset=ISO-8859-1"> + <meta name="author" content="Graeme Gill"> + </head> + <body> + <h2><b>imdi/cctiff</b></h2> + <h3>Summary</h3> + Color convert a TIFF or JPEG file using a sequence of compatible ICC + device profiles, abstract profiles, device link profiles and + calibration files. The sequence may be zero length, facilitating + format conversion and ICC profile embedding without otherwise + altering the pixel values.<br> + <h3>Usage<br> + </h3> + <small><span style="font-family: monospace;"></span> <span + style="font-family: monospace;"></span><span style="font-family: + monospace;">cctiff [-options] { [-i intent] <span + style="font-style: italic;">profile.icm</span> | [-d dir] + calibration.cal ...} <span style="font-style: italic;">infile.tif + + outfile.tif</span></span></small><small><span + style="font-family: monospace;"></span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"></span><span + style="font-family: monospace;"></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;"> + + + Verbose</span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#c">-c</a><span + style="font-family: monospace;"> + + + Combine linearisation curves into one transform</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#p">-p</a><span + style="font-family: monospace;"> + + + Use slow precise floating point conversion, rather + than fast integer routines.</span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#k">-k</a><span + style="font-family: monospace;"> + + + Check fast result against precise, and report + differences.<br> + </span></small><small><span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#r">-r n<span + style="font-style: italic;"></span></a><span + style="font-family: monospace;"> + Override + the default CLUT resolution</span></small><small><span + style="font-family: monospace;"></span><span style="font-family: + monospace;"><br> + </span></small><small><span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#t">-t n<span + style="font-style: italic;"></span></a><span + style="font-family: monospace;"> + Choose + output encoding from 1..n<br> + <a href="#f">-f [T|J]</a> + Set output format to Tiff or Jpeg (Default is same as input)<br> + <a href="#q">-q quality</a> + Set JPEG quality 1..100 (Default 80)<br> + </span></small><small><span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#a">-a</a><span + style="font-family: monospace;"> + + Read and Write planes > 4 as + alpha planes<br> + </span></small><small><span style="font-family: monospace;"> <a + href="#I">-I</a> +Ignore + + any file or profile colorspace mismatches<br> + <a href="#D">-D</a> +Don't + + append or set the output TIFF description<br> + <br> + </span></small><small><span style="font-family: monospace;"></span><span + style="font-family: monospace;"><br> + </span></small><small><a style="font-family: monospace;" + href="#e"><i>-e profile.[ic<span style="font-family: monospace;">m + | tiff | jpg]</span></i></a><span style="font-family: + monospace;"></span></small><small><span style="font-family: + monospace;"> Optionally embed a profile in the destination + TIFF or JPEG file.<br> + + + </span></small><small><span style="font-family: monospace;">This + may be an ICC file or TIFF or JPEG file with embedded profile.</span></small><br> + <small><span style="font-family: monospace;"><br> + +Then + + for each profile in the linked sequence:<br style="font-family: + monospace;"> + </span></small><small><span style="font-family: monospace;"></span></small><small><span + style="font-family: monospace;"></span><span style="font-family: + monospace;"> </span><a style="font-family: monospace;" + href="#i">-i <span style="font-style: italic;">intent</span></a><span + style="font-family: monospace;"> + Profile intent</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + p = + perceptual, r = relative colorimetric,</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + + + s = saturation, a = absolute colorimetric<br> + </span></small><small><span style="font-family: monospace;"> + </span><a style="font-family: monospace;" href="#o">-o order<span + style="font-style: italic;"></span></a><span + style="font-family: monospace;"> + n = normal (priority: lut + > matrix > monochrome)<br> + +r + + = reverse (priority: monochrome > matrix > lut)</span></small><small><span + style="font-family: monospace;"></span><br style="font-family: + monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#p1"><i>profile.[ic<span + style="font-family: monospace;">m | tiff | jpg]</span></i></a><span + style="font-family: monospace;"> A Device, Link or + Abstract profile. This may be an ICC file<br> + +(May + + be embedded profile in TIFF or JPEG file)<br> + </span></small><small><span style="font-family: monospace;"> +or + + each calibration file in sequence:<br style="font-family: + monospace;"> + </span></small><small><span style="font-family: monospace;"></span></small><small><span + style="font-family: monospace;"></span><span style="font-family: + monospace;"> </span><a style="font-family: monospace;" + href="#d">-d <span style="font-style: italic;"><span + style="font-family: monospace;">dir</span></span></a><span + style="font-family: monospace;"> + Calibration direction</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"> + f = + forward cal. (default), b = backwards cal.</span><span + style="font-family: monospace;"></span><span style="font-family: + monospace;"></span></small><small><span style="font-family: + monospace;"></span><br style="font-family: monospace;"> + <span style="font-family: monospace;"> </span><a + style="font-family: monospace;" href="#p2"><i>calibration.cal<span + style="font-family: monospace;"></span></i></a><span + style="font-family: monospace;"> + + A calibration file.</span></small><br> + <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> + + + + Then finally:<br style="font-family: + monospace;"> + <span style="font-family: monospace;"></span><a + style="font-family: monospace;" href="#p3"><i>infile.tif</i></a><span + style="font-family: monospace;"> + A </span><a style="font-family: monospace;" + href="File_Formats.html#TIFF">TIFF</a><span style="font-family: + monospace;"> + or <a href="File_Formats.html#JPEG">JPEG</a> Raster file that + will be the input raster to be transformed.</span><br + style="font-family: monospace;"> + <span style="font-family: monospace;"></span><a + style="font-family: monospace;" href="#p4"><i>outfile.tif</i></a><span + style="font-family: monospace;"> + A </span><a style="font-family: monospace;" + href="File_Formats.html#TIFF">TIFF</a><span style="font-family: + monospace;"> or <a href="File_Formats.html#JPEG">JPEG</a> + Raster file created from the input raster, using the given color + transform.</span></small><b><br> + </b><b><br> + Examples</b><br> + <br> + Convert an RGB file to a CMYK file using perceptual intent:<br> + <br> + cctiff -ip sRGB.icm -i cmyk.icm rgbinfile.tif + cmykoutfile.tif<br> + <br> + Same as above, but use the source file embedded profile, and embed + the resulting colorspace profile in the output:<br> + <br> + cctiff -e cmyk.icm -ip rgbfile.tif -ip + cmyk.icm rgbinfile.tif cmyout.tif<br> + <br> + Convert a raster file using a device link:<br> + <br> + cctiff devicelink.icm infile.tif outfile.tif<br> + <br> + Convert an RGB source to CMYK via an abstract adjustment, and then + convert the CMYK to CMYK using a device link, also apply CMYK + calibration:<br> + <br> + cctiff -ir sRGB.icm abstract.icm -ir CMYK.icm + devlink.icm CMYKcal.cal infile.tif outfile.tif<br> + <br> + Convert an RGB source file into a CIELab raster file:<br> + <br> + cctiff -t1 -ir sRGB.icm rgbfile.tif labfile.tif<br> + <h3>Comments<br> + </h3> + <a name="v"></a> The <span style="font-weight: bold;">-v</span> + flag reports extra information about the ICC profile.<br> + <br> + <a name="c"></a><a name="p"></a><a name="k"></a><a name="r"></a> The + <span style="font-weight: bold;">-c</span>, <span + style="font-weight: bold;">-p</span>, <span style="font-weight: + bold;">-k</span> and <span style="font-weight: bold;">-r</span> + options are intended to aid debugging.<br> + <br> + <a name="t"></a><span style="font-weight: bold;"></span><span + style="font-weight: bold;">-t </span>Some colorspaces can be + encoded in more than one way. If there is a choice, the choice + should be specified the <span style="font-weight: bold;">-t</span> + parameter. If this parameter is not given, then cctiff will print + the possible choices and choose the default. For TIFF LAB output + there are two choices <span style="font-weight: bold;">1</span> for + CIELab encoding (Default), and <span style="font-weight: bold;">2</span> + for ICCLab encoding. For JPEG RGB output there are two choices: <span + style="font-weight: bold;">1</span> for YCbCr encoding with + sub-sampled Cb and Cr (Default)\n", and <span style="font-weight: + bold;">2</span> RGB encoding which does not use sub sampling. For + JPEG CMYK output there are two choices: <span style="font-weight: + bold;">1</span> for YCCK encoding with sub-sampled C and C + (Default)\n", and <span style="font-weight: bold;">2</span> CMYK + encoding which does not use sub sampling<br> + <br> + <a name="f"></a><span style="font-weight: bold;"></span> <span + style="font-weight: bold;">-f</span> By default the output raster + file format will be the same as the input, and the <span + style="font-weight: bold;">-f</span> parameter will override this. + <span style="font-weight: bold;">-f T</span> will select <span + style="font-weight: bold;">TIFF</span> format output, and <span + style="font-weight: bold;">-f J</span> will select <span + style="font-weight: bold;">JPEG</span> format output.<span + style="font-weight: bold;"> </span><br> + <br> + <a name="q"></a><span style="font-weight: bold;"></span> <span + style="font-weight: bold;">-q</span> JPEG raster files use lossy + compression, and the <span style="font-weight: bold;">-q</span> + parameter controls how much compression is used in creating a JPEG + output file. The value can be between 1 and 100, with 1 being the + lowest quality and highest compression, and 100 being the highest + quality and lowest compression. The default value is 80.<br> + <br> + <a name="a"></a><span style="font-weight: bold;"></span> Normally + colorspaces that have more than 4 channels will be read and written + as multichannel TIFF files. These are not handled well by all + applications, so the <span style="font-weight: bold;">-a</span> + option causes extra channels above 4 to be stored as alpha planes, + providing more flexibility in using such files.<br> + <br> + <a name="I"></a>The <span style="font-weight: bold;">-I</span> flag + causes any mismatch between the color spaces of the image files and + each profile in the sequence to be ignored. The results might be + unpredictable unless you know exactly what you are doing.<br> + <br> + <a name="D"></a>The <span style="font-weight: bold;">-D</span> flag + stops the description tag being set or appended to by cctiff.<br> + <br> + <small><a name="e"></a></small><small>The <span style="font-weight: + bold;">-e profile.[icm | tiff | jpg]</span> option allows an ICC + profile to be embedded in the </small>destination TIFF or JPEG + file. The profile may either be an <small>ICC file or a TIFF or + JPEG file with embedded profile.</small><br> + <br> + Following these global options, you should specify the chain of + profiles and calibrations you want to apply. Each link of the chain + consists of the (optional) intent to be used for device profiles and + the filename of the profile, or the optional direction to be used + for the calibration and the filename of the calibration. The first + profile or calibrations input colorspace must be compatible with the + input TIFF file, and each profile or calibration output space must + be compatible with the next profile or calibrations input space. An + error will result if this is not the case.<br> + <br> + <div style="margin-left: 40px;"><a name="i"></a>The <span + style="font-weight: bold;">-i</span> parameters selects the + intent for the following device profile. Normally the same intent + should be used for all device profiles, but other combinations + allow special uses such as mixed proofing workflows.<br> + <br> + <a name="o"></a>The <span style="font-weight: bold;">-o</span> + parameter changes the order the profiles tags are searched in. A + profile is allowed to contain more than the minimum number of + elements or table needed to describe a certain transform, and may + contain redundant descriptions. By default, lut based table + information will be used first if present, followed by + matrix/shaper information, and only using monochrome information + if it is all that is present. <b>-o r</b> reverses this order. <br> + <br> + <a name="p1"></a>The file that will be the source of the ICC + profile. This can be either an ICC profile or a TIFF or JPEG file + that contains an embedded profile. Typically the first profile in + the chain might be taken from an embedded profile from the source + TIFF or JPEG file.<br> + <br> + <a name="d"></a>The <span style="font-weight: bold;">-d</span> + parameters selects the direction for the following calibration. + The default direction is the normal forward calibration, but if + -db is used, then a backwards (inverse) calibration will be + applied.<br> + <br> + <a name="p2"></a>The file that will be the source calibration. + This will be an Argyll <a href="File_Formats.html#.cal">.cal</a> + format file.<span style="font-weight: bold;"></span><br> + </div> + <br> + <a name="p3"></a>The second last argument should be the name of the + source TIFF or JPEG file that is to be processed.<br> + <br> + <a name="p4"></a>The last argument should be the name of the + destination TIFF or JPEG file to hold the results.<br> + <br> + <span style="font-weight: bold;">cctiff</span> uses very fast + integer conversion routines to process the raster. Both 8 and 16 bit + per component files can be handled, and up to 8 color channels (The + limit can be lifted to 15 re-compiling). JPEG files with no more + than 8 bit per component can be handled.<br> + <br> + <br> + <br> + <br> + <br> + </body> +</html> |