roentgen b75cab
.\" $Id: ppm2tiff.1,v 1.5 2006-03-01 11:20:33 dron Exp $
roentgen b75cab
.\"
roentgen b75cab
.\" Copyright (c) 1991-1997 Sam Leffler
roentgen b75cab
.\" Copyright (c) 1991-1997 Silicon Graphics, Inc.
roentgen b75cab
.\"
roentgen b75cab
.\" Permission to use, copy, modify, distribute, and sell this software and 
roentgen b75cab
.\" its documentation for any purpose is hereby granted without fee, provided
roentgen b75cab
.\" that (i) the above copyright notices and this permission notice appear in
roentgen b75cab
.\" all copies of the software and related documentation, and (ii) the names of
roentgen b75cab
.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
roentgen b75cab
.\" publicity relating to the software without the specific, prior written
roentgen b75cab
.\" permission of Sam Leffler and Silicon Graphics.
roentgen b75cab
.\" 
roentgen b75cab
.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
roentgen b75cab
.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
roentgen b75cab
.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
roentgen b75cab
.\" 
roentgen b75cab
.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
roentgen b75cab
.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
roentgen b75cab
.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
roentgen b75cab
.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
roentgen b75cab
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
roentgen b75cab
.\" OF THIS SOFTWARE.
roentgen b75cab
.\"
roentgen b75cab
.if n .po 0
roentgen b75cab
.TH PPM2TIFF 1 "March 1, 2006" "libtiff"
roentgen b75cab
.SH NAME
roentgen b75cab
ppm2tiff \- create a
roentgen b75cab
.SM TIFF
roentgen b75cab
file from 
roentgen b75cab
.SM PPM, PGM
roentgen b75cab
and
roentgen b75cab
.SM PBM
roentgen b75cab
image files
roentgen b75cab
.SH SYNOPSIS
roentgen b75cab
.B ppm2tiff
roentgen b75cab
[
roentgen b75cab
.I options
roentgen b75cab
] [
roentgen b75cab
.I input.ppm
roentgen b75cab
]
roentgen b75cab
.I output.tif
roentgen b75cab
.SH DESCRIPTION
roentgen b75cab
.I ppm2tiff
roentgen b75cab
converts a file in the 
roentgen b75cab
.SM PPM, PGM
roentgen b75cab
and
roentgen b75cab
.SM PBM
roentgen b75cab
image formats to
roentgen b75cab
.SM TIFF.
roentgen b75cab
By default, the
roentgen b75cab
.SM TIFF
roentgen b75cab
image is created with data samples packed (\c
roentgen b75cab
.IR PlanarConfiguration =1),
roentgen b75cab
compressed with the Packbits algorithm (\c
roentgen b75cab
.IR Compression =32773),
roentgen b75cab
and with each strip no more than 8 kilobytes. These characteristics can be
roentgen b75cab
overridden, or explicitly specified with the options described below
roentgen b75cab
.PP
roentgen b75cab
If the
roentgen b75cab
.SM PPM
roentgen b75cab
file contains greyscale data, then the
roentgen b75cab
.I PhotometricInterpretation
roentgen b75cab
tag is set to 1 (min-is-black), otherwise it is set to 2 (RGB).
roentgen b75cab
.PP
roentgen b75cab
If no
roentgen b75cab
.SM PPM
roentgen b75cab
file is specified on the command line,
roentgen b75cab
.I ppm2tiff
roentgen b75cab
will read from the standard input.
roentgen b75cab
.SH OPTIONS
roentgen b75cab
.TP
roentgen b75cab
.B \-c
roentgen b75cab
Specify a compression scheme to use when writing image data:
roentgen b75cab
.B none 
roentgen b75cab
for no compression,
roentgen b75cab
.B packbits
roentgen b75cab
for PackBits compression (will be used by default),
roentgen b75cab
.B lzw
roentgen b75cab
for Lempel-Ziv & Welch compression,
roentgen b75cab
.B jpeg
roentgen b75cab
for baseline JPEG compression,
roentgen b75cab
.B zip
roentgen b75cab
for Deflate compression,
roentgen b75cab
.B g3
roentgen b75cab
for CCITT Group 3 (T.4) compression,
roentgen b75cab
and
roentgen b75cab
.B g4
roentgen b75cab
for CCITT Group 4 (T.6) compression.
roentgen b75cab
.TP
roentgen b75cab
.B \-r
roentgen b75cab
Write data with a specified number of rows per strip; by default the number of
roentgen b75cab
rows/strip is selected so that each strip is approximately 8 kilobytes.
roentgen b75cab
.TP
roentgen b75cab
.B \-R
roentgen b75cab
Mark the resultant image to have the specified X and Y resolution (in
roentgen b75cab
dots/inch).
roentgen b75cab
.SH "SEE ALSO"
roentgen b75cab
.BR tiffinfo (1),
roentgen b75cab
.BR tiffcp (1),
roentgen b75cab
.BR tiffmedian (1),
roentgen b75cab
.BR libtiff (3)
roentgen b75cab
.PP
roentgen b75cab
Libtiff library home page:
roentgen b75cab
.BR http://www.remotesensing.org/libtiff/