Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TIFFDITHER(1)			    LibTIFF			 TIFFDITHER(1)

NAME
       tiffdither - convert a greyscale	TIFF image to bilevel using dithering

SYNOPSIS
       tiffdither [ options ] input.tif	output.tif

DESCRIPTION
       tiffdither converts a single channel 8-bit greyscale image to a bilevel
       image using Floyd-Steinberg error propagation with thresholding.

OPTIONS
       -c compress
	      Specify  the  compression	 to use	for data written to the	output
	      file:
		       +-------------+----------------------------+
		       | Compression | Description		  |
		       +-------------+----------------------------+
		       | none	     | no compression		  |
		       +-------------+----------------------------+
		       | packbits    | PackBits	compression	  |
		       +-------------+----------------------------+
		       | lzw	     | Lempel-Ziv  &  Welch  com- |
		       |	     | pression			  |
		       +-------------+----------------------------+
		       | zip	     | Deflate compression	  |
		       +-------------+----------------------------+
		       | g3	     | CCITT  Group  3 (T.4) com- |
		       |	     | pression			  |
		       +-------------+----------------------------+
		       | g4	     | for CCITT  Group	 4  (T.6) |
		       |	     | compression		  |
		       +-------------+----------------------------+

	      By  default tiffdither will compress data	according to the value
	      of the Compression tag found in the source file.

	      The CCITT	Group 3	and Group 4 compression	algorithms can only be
	      used with	bilevel	data.

	      Group 3 compression  can	be  specified  together	 with  several
	      T.4-specific  options:  1d  for  1-dimensional  encoding,	2d for
	      2-dimensional encoding, and fill to force	each encoded  scanline
	      to  be  zero-filled  so  that the	terminating EOL	code lies on a
	      byte boundary.  Group 3-specific options are  specified  by  ap-
	      pending  a :-separated list to the g3 option; e.g. -c g3:2d:fill
	      to get 2D-encoded	data with byte-aligned EOL codes.

	      LZW compression can  be  specified  together  with  a  predictor
	      value.   A predictor value of 2 causes each scanline of the out-
	      put image	to undergo horizontal differencing before  it  is  en-
	      coded;  a	 value of 1 forces each	scanline to be encoded without
	      differencing.  LZW-specific options are specified	by appending a
	      :-separated list to the lzw option; e.g. -c lzw:2	for  LZW  com-
	      pression with horizontal differencing.

       -f     Specify  the  bit	 fill order to use in writing output data.  By
	      default, tiffdither will create a	new file with  the  same  fill
	      order as the original.  Specifying -f lsb2msb will force data to
	      be  written  with	 the  FillOrder	 tag  set to LSB2MSB, while -f
	      msb2lsb will force data to be written with the FillOrder tag set
	      to MSB2LSB.

       -r     Make each	strip have no more than	the given number of rows.

       -t     Set the threshold	value for dithering.  By default the threshold
	      value is 128.

NOTES
       The dither algorithm is taken from the tiffmedian program  (written  by
       Paul Heckbert).

SEE ALSO
       pal2rgb (1), fax2tiff (1), tiffinfo (1),	tiffcp (1), tiff2bw (3tiff)

AUTHOR
       LibTIFF contributors

COPYRIGHT
       1988-2022, LibTIFF contributors

4.7				 Sep 11, 2024			 TIFFDITHER(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tiffdither&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help