.TH pnmtotiff 1 "13 January 1991"
.IX pnmtotiff
.SH NAME
pnmtotiff - convert a a portable anymap into a TIFF file
.SH SYNOPSIS
.B pnmtotiff
.RB [ -none | -packbits |
.BR -lzw | -g3 | -g4 ]
.RB [ -2d ]
.RB [ -fill ]
.RB [ -predictor
.IR n ]
.RB [ -msb2lsb | -lsb2msb ]
.RB [ -rowsperstrip
.IR n ]
.RI [ pnmfile ]
.SH DESCRIPTION
Reads a portable anymap as input.
Produces a TIFF file as output.
.IX TIFF
.SH OPTIONS
.PP
By default,
.I pnmtotiff
creates a TIFF file with LZW compression.
This is your best bet most of the time.
However, some TIFF readers can't deal with it.
If you want to try another compression scheme or tweak some of the
other even more obscure output options, there are a number of
flags to play with.
.PP
The
.BR -none ,
.BR -packbits ,
.BR -lzw ,
.BR -g3 ,
and
.BR -g4
options are used to override the default and set the compression
scheme used in creating the output file.  The CCITT Group 3 and Group
4 compression algorithms can only be used with bilevel data.  The
.B -2d
and
.B -fill
options are meaningful only with Group 3 compression:
.B -2d
requests 2-dimensional encoding, while
.B -fill
requests that each encoded scanline be zero-filled to a byte boundry.
The
.B -predictor
option is only meaningful with LZW compression: a predictor value of 2
causes each scanline of the output image to undergo horizontal
differencing before it is encoded; a value of 1 forces each scanline
to be encoded without differencing.
.P
By default,
.I pnmtotiff
creates a TIFF file with msb-to-lsb fill order.
The
.B -msb2lsb
and
.B -lsb2msb
options are used to override the default and set the fill order used
in creating the file.
.P
The
.B -rowsperstrip
option can be used to set the number of rows (scanlines) in each
strip of data in the output file.  By default, the output file has
the number of rows per strip set to a value that will ensure each
strip is no more than 8 kilobytes long.
.SH BUGS
This program is not self-contained.  To use it you must fetch the
TIFF Software package listed in the OTHER.SYSTEMS file and configure
PBMPLUS to use libtiff.  See PBMPLUS's Makefile for details on this
configuration.
.SH "SEE ALSO"
tifftopnm(1), pnm(5)
.SH AUTHOR
Derived by Jef Poskanzer from ras2tiff.c, which is
Copyright (c) 1990 by Sun Microsystems, Inc.
Author: Patrick J. Naughton (naughton@wind.sun.com).
.\" Permission to use, copy, modify, and distribute this software and its
.\" documentation for any purpose and without fee is hereby granted,
.\" provided that the above copyright notice appear in all copies and that
.\" both that copyright notice and this permission notice appear in
.\" supporting documentation.
.\" 
.\" This file is provided AS IS with no warranties of any kind.  The author
.\" shall have no liability with respect to the infringement of copyrights,
.\" trade secrets or any patents by this file or any part thereof.  In no
.\" event will the author be liable for any lost revenue or profits or
.\" other special, indirect and consequential damages.