xref: /libtiff-4.0.7/html/man/tiffdither.1.html (revision d4dd6ccc)
10dcb9ef1SAndrey Kiselev<!-- Creator     : groff version 1.18.1 -->
2f14d1a56SAndrey Kiselev<!-- CreationDate: Sat Feb 24 18:37:20 2007 -->
3fd935fb2SAndrey Kiselev<html>
4fd935fb2SAndrey Kiselev<head>
5fd935fb2SAndrey Kiselev<meta name="generator" content="groff -Thtml, see www.gnu.org">
6fd935fb2SAndrey Kiselev<meta name="Content-Style" content="text/css">
7fd935fb2SAndrey Kiselev<title>TIFFDITHER</title>
8fd935fb2SAndrey Kiselev</head>
9fd935fb2SAndrey Kiselev<body>
10e49fae91SMike Welles
11fd935fb2SAndrey Kiselev<h1 align=center>TIFFDITHER</h1>
12fd935fb2SAndrey Kiselev<a href="#NAME">NAME</a><br>
13fd935fb2SAndrey Kiselev<a href="#SYNOPSIS">SYNOPSIS</a><br>
14fd935fb2SAndrey Kiselev<a href="#DESCRIPTION">DESCRIPTION</a><br>
15fd935fb2SAndrey Kiselev<a href="#OPTIONS">OPTIONS</a><br>
16fd935fb2SAndrey Kiselev<a href="#NOTES">NOTES</a><br>
17fd935fb2SAndrey Kiselev<a href="#SEE ALSO">SEE ALSO</a><br>
18e49fae91SMike Welles
19fd935fb2SAndrey Kiselev<hr>
20fd935fb2SAndrey Kiselev<a name="NAME"></a>
21fd935fb2SAndrey Kiselev<h2>NAME</h2>
220dcb9ef1SAndrey Kiselev<!-- INDENTATION -->
230dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void"
240dcb9ef1SAndrey Kiselev       cols="2" cellspacing="0" cellpadding="0">
250dcb9ef1SAndrey Kiselev<tr valign="top" align="left">
260dcb9ef1SAndrey Kiselev<td width="8%"></td>
270dcb9ef1SAndrey Kiselev<td width="91%">
280dcb9ef1SAndrey Kiselev<p>tiffdither &minus; convert a greyscale image to bilevel
290dcb9ef1SAndrey Kiselevusing dithering</p>
300dcb9ef1SAndrey Kiselev</td>
310dcb9ef1SAndrey Kiselev</table>
32fd935fb2SAndrey Kiselev<a name="SYNOPSIS"></a>
33fd935fb2SAndrey Kiselev<h2>SYNOPSIS</h2>
340dcb9ef1SAndrey Kiselev<!-- INDENTATION -->
350dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void"
360dcb9ef1SAndrey Kiselev       cols="2" cellspacing="0" cellpadding="0">
370dcb9ef1SAndrey Kiselev<tr valign="top" align="left">
380dcb9ef1SAndrey Kiselev<td width="8%"></td>
390dcb9ef1SAndrey Kiselev<td width="91%">
400dcb9ef1SAndrey Kiselev<p><b>tiffdither</b> [ <i>options</i> ] <i>input.tif
410dcb9ef1SAndrey Kiselevoutput.tif</i></p>
420dcb9ef1SAndrey Kiselev</td>
430dcb9ef1SAndrey Kiselev</table>
44fd935fb2SAndrey Kiselev<a name="DESCRIPTION"></a>
45fd935fb2SAndrey Kiselev<h2>DESCRIPTION</h2>
460dcb9ef1SAndrey Kiselev<!-- INDENTATION -->
470dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void"
480dcb9ef1SAndrey Kiselev       cols="2" cellspacing="0" cellpadding="0">
490dcb9ef1SAndrey Kiselev<tr valign="top" align="left">
500dcb9ef1SAndrey Kiselev<td width="8%"></td>
510dcb9ef1SAndrey Kiselev<td width="91%">
520dcb9ef1SAndrey Kiselev<p><i>tiffdither</i> converts a single channel 8-bit
530dcb9ef1SAndrey Kiselevgreyscale image to a bilevel image using Floyd-Steinberg
540dcb9ef1SAndrey Kiseleverror propagation with thresholding.</p>
550dcb9ef1SAndrey Kiselev</td>
560dcb9ef1SAndrey Kiselev</table>
57fd935fb2SAndrey Kiselev<a name="OPTIONS"></a>
58fd935fb2SAndrey Kiselev<h2>OPTIONS</h2>
590dcb9ef1SAndrey Kiselev<!-- TABS -->
601255f5abSAndrey Kiselev<table width="100%" border=0 rules="none" frame="void"
610dcb9ef1SAndrey Kiselev       cols="5" cellspacing="0" cellpadding="0">
62fd935fb2SAndrey Kiselev<tr valign="top" align="left">
630dcb9ef1SAndrey Kiselev<td width="10%"></td>
640dcb9ef1SAndrey Kiselev<td width="2%">
65e49fae91SMike Welles
660dcb9ef1SAndrey Kiselev<p><b>&minus;c</b></p>
670dcb9ef1SAndrey Kiselev</td>
680dcb9ef1SAndrey Kiselev<td width="6%"></td>
690dcb9ef1SAndrey Kiselev<td width="80%">
7087c5da6fSAndrey Kiselev
710dcb9ef1SAndrey Kiselev<p>Specify the compression to use for data written to the
720dcb9ef1SAndrey Kiselevoutput file: <b>none</b> for no compression, <b>packbits</b>
730dcb9ef1SAndrey Kiselevfor PackBits compression, <b>lzw</b> for Lempel-Ziv &amp;
740dcb9ef1SAndrey KiselevWelch compression, <b>zip</b> for Deflate compression,
750dcb9ef1SAndrey Kiselev<b>g3</b> for CCITT Group 3 (T.4) compression, and <b>g4</b>
760dcb9ef1SAndrey Kiselevfor CCITT Group 4 (T.6) compression. By default
770dcb9ef1SAndrey Kiselev<i>tiffdither</i> will compress data according to the value
780dcb9ef1SAndrey Kiselevof the <i>Compression</i> tag found in the source file.</p>
790dcb9ef1SAndrey Kiselev</td>
800dcb9ef1SAndrey Kiselev<td width="0%">
810dcb9ef1SAndrey Kiselev</td>
8287c5da6fSAndrey Kiselev</table>
830dcb9ef1SAndrey Kiselev<!-- INDENTATION -->
840dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void"
850dcb9ef1SAndrey Kiselev       cols="2" cellspacing="0" cellpadding="0">
860dcb9ef1SAndrey Kiselev<tr valign="top" align="left">
870dcb9ef1SAndrey Kiselev<td width="17%"></td>
880dcb9ef1SAndrey Kiselev<td width="82%">
890dcb9ef1SAndrey Kiselev<p>The <small>CCITT</small> Group 3 and Group 4 compression
9087c5da6fSAndrey Kiselevalgorithms can only be used with bilevel data.</p>
910dcb9ef1SAndrey Kiselev<!-- INDENTATION -->
920dcb9ef1SAndrey Kiselev<p>Group 3 compression can be specified together with
930dcb9ef1SAndrey Kiselevseveral T.4-specific options: <b>1d</b> for 1-dimensional
940dcb9ef1SAndrey Kiselevencoding, <b>2d</b> for 2-dimensional encoding, and
950dcb9ef1SAndrey Kiselev<b>fill</b> to force each encoded scanline to be zero-filled
960dcb9ef1SAndrey Kiselevso that the terminating EOL code lies on a byte boundary.
970dcb9ef1SAndrey KiselevGroup 3-specific options are specified by appending a
9887c5da6fSAndrey Kiselev&lsquo;&lsquo;:&rsquo;&rsquo;-separated list to the
9987c5da6fSAndrey Kiselev&lsquo;&lsquo;g3&rsquo;&rsquo; option; e.g. <b>&minus;c
100fd935fb2SAndrey Kiselevg3:2d:fill</b> to get 2D-encoded data with byte-aligned EOL
10187c5da6fSAndrey Kiselevcodes.</p>
1020dcb9ef1SAndrey Kiselev<!-- INDENTATION -->
1030dcb9ef1SAndrey Kiselev<p><small>LZW</small> compression can be specified together
1040dcb9ef1SAndrey Kiselevwith a <i>predictor</i> value. A predictor value of 2 causes
1050dcb9ef1SAndrey Kiseleveach scanline of the output image to undergo horizontal
106fd935fb2SAndrey Kiselevdifferencing before it is encoded; a value of 1 forces each
107fd935fb2SAndrey Kiselevscanline to be encoded without differencing. LZW-specific
10887c5da6fSAndrey Kiselevoptions are specified by appending a
10987c5da6fSAndrey Kiselev&lsquo;&lsquo;:&rsquo;&rsquo;-separated list to the
11087c5da6fSAndrey Kiselev&lsquo;&lsquo;lzw&rsquo;&rsquo; option; e.g. <b>&minus;c
11187c5da6fSAndrey Kiselevlzw:2</b> for <small>LZW</small> compression with horizontal
11287c5da6fSAndrey Kiselevdifferencing.</p>
1130dcb9ef1SAndrey Kiselev</td>
11487c5da6fSAndrey Kiselev</table>
1150dcb9ef1SAndrey Kiselev<!-- TABS -->
1160dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void"
1170dcb9ef1SAndrey Kiselev       cols="5" cellspacing="0" cellpadding="0">
1180dcb9ef1SAndrey Kiselev<tr valign="top" align="left">
1190dcb9ef1SAndrey Kiselev<td width="10%"></td>
1200dcb9ef1SAndrey Kiselev<td width="3%">
121c3402403SBob Friesenhahn
1220dcb9ef1SAndrey Kiselev<p><b>&minus;f</b></p>
1230dcb9ef1SAndrey Kiselev</td>
1240dcb9ef1SAndrey Kiselev<td width="5%"></td>
1250dcb9ef1SAndrey Kiselev<td width="80%">
1260dcb9ef1SAndrey Kiselev
1270dcb9ef1SAndrey Kiselev<p>Specify the bit fill order to use in writing output
1280dcb9ef1SAndrey Kiselevdata. By default, <i>tiffdither</i> will create a new file
1290dcb9ef1SAndrey Kiselevwith the same fill order as the original. Specifying
1300dcb9ef1SAndrey Kiselev<b>&minus;f lsb2msb</b> will force data to be written with
131ef833c65SAndrey Kiselevthe <i>FillOrder</i> tag set to <small>LSB2MSB ,</small>
132ef833c65SAndrey Kiselevwhile <b>&minus;f msb2lsb</b> will force data to be written
133ef833c65SAndrey Kiselevwith the <i>Fill- Order</i> tag set to <small>MSB2LSB
134ef833c65SAndrey Kiselev.</small></p>
1350dcb9ef1SAndrey Kiselev</td>
1360dcb9ef1SAndrey Kiselev<td width="0%">
1370dcb9ef1SAndrey Kiselev</td>
1380dcb9ef1SAndrey Kiselev<tr valign="top" align="left">
1390dcb9ef1SAndrey Kiselev<td width="10%"></td>
1400dcb9ef1SAndrey Kiselev<td width="3%">
1410dcb9ef1SAndrey Kiselev
142feb6bd9fSTom Lane<p><b>&minus;r</b></p>
143feb6bd9fSTom Lane</td>
144feb6bd9fSTom Lane<td width="5%"></td>
145feb6bd9fSTom Lane<td width="80%">
146feb6bd9fSTom Lane
147feb6bd9fSTom Lane<p>Make each strip have no more than the given number of rows.</p>
148feb6bd9fSTom Lane</td>
149feb6bd9fSTom Lane<td width="0%">
150feb6bd9fSTom Lane</td>
151feb6bd9fSTom Lane<tr valign="top" align="left">
152feb6bd9fSTom Lane<td width="10%"></td>
153feb6bd9fSTom Lane<td width="3%">
154feb6bd9fSTom Lane
1550dcb9ef1SAndrey Kiselev<p><b>&minus;t</b></p>
1560dcb9ef1SAndrey Kiselev</td>
1570dcb9ef1SAndrey Kiselev<td width="5%"></td>
1580dcb9ef1SAndrey Kiselev<td width="80%">
1590dcb9ef1SAndrey Kiselev
1600dcb9ef1SAndrey Kiselev<p>Set the threshold value for dithering. By default the
1610dcb9ef1SAndrey Kiselevthreshold value is 128.</p>
1620dcb9ef1SAndrey Kiselev</td>
1630dcb9ef1SAndrey Kiselev<td width="0%">
1640dcb9ef1SAndrey Kiselev</td>
1650dcb9ef1SAndrey Kiselev</table>
166fd935fb2SAndrey Kiselev<a name="NOTES"></a>
167fd935fb2SAndrey Kiselev<h2>NOTES</h2>
1680dcb9ef1SAndrey Kiselev<!-- INDENTATION -->
1690dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void"
1700dcb9ef1SAndrey Kiselev       cols="2" cellspacing="0" cellpadding="0">
1710dcb9ef1SAndrey Kiselev<tr valign="top" align="left">
1720dcb9ef1SAndrey Kiselev<td width="8%"></td>
1730dcb9ef1SAndrey Kiselev<td width="91%">
1740dcb9ef1SAndrey Kiselev<p>The dither algorithm is taken from the
1750dcb9ef1SAndrey Kiselev<b>tiffmedian</b>(1) program (written by Paul Heckbert).</p>
1760dcb9ef1SAndrey Kiselev</td>
1770dcb9ef1SAndrey Kiselev</table>
178fd935fb2SAndrey Kiselev<a name="SEE ALSO"></a>
179fd935fb2SAndrey Kiselev<h2>SEE ALSO</h2>
1800dcb9ef1SAndrey Kiselev<!-- INDENTATION -->
1810dcb9ef1SAndrey Kiselev<table width="100%" border=0 rules="none" frame="void"
1820dcb9ef1SAndrey Kiselev       cols="2" cellspacing="0" cellpadding="0">
1830dcb9ef1SAndrey Kiselev<tr valign="top" align="left">
1840dcb9ef1SAndrey Kiselev<td width="8%"></td>
1850dcb9ef1SAndrey Kiselev<td width="91%">
1860dcb9ef1SAndrey Kiselev<p><b>pal2rgb</b>(1), <b>fax2tiff</b>(1),
1870dcb9ef1SAndrey Kiselev<b>tiffinfo</b>(1), <b>tiffcp</b>(1), <b>tiff2bw</b>(1),
1880dcb9ef1SAndrey Kiselev<b>libtiff</b>(3TIFF)</p>
1890dcb9ef1SAndrey Kiselev<!-- INDENTATION -->
1900dcb9ef1SAndrey Kiselev<p>Libtiff library home page:
191*d4dd6cccSBob Friesenhahn<b>http://www.simplesystems.org/libtiff/</b></p>
1920dcb9ef1SAndrey Kiselev</td>
1930dcb9ef1SAndrey Kiselev</table>
194fd935fb2SAndrey Kiselev<hr>
195fd935fb2SAndrey Kiselev</body>
196fd935fb2SAndrey Kiselev</html>
197