<!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>