.TL
Pamtopnm User Manual
.SH 1
pamtopnm
.LP
Updated: 03 August 2000
.br
Table Of Contents
.SH 2
NAME
.LP
pamtopnm - convert PAM image to PBM, PGM, or PPM
.SH 2
SYNOPSIS
.LP
\fBpamtopnm\fR
[\fB-assume\fR]
[\fIpnmfile\fR]
.LP
Minimum unique abbreviation of option is acceptable.  You may use double
hyphens instead of single hyphen to denote options.  You may use white
space in place of the equals sign to separate an option name from its value.
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBpamtopnm\fR reads a PAM image as input and produces an
equivalent PBM, PGM, or PPM (i.e. PNM) image, whichever is most
appropriate, as output.
.LP
\fBpamtopnm\fR assumes the PAM image represents the information
required for a PBM, PGM, or PPM image if its tuple type is
"BLACKANDWHITE", "GRAYSCALE", or "RGB"
and its depth and maxval are appropriate.  If this is not the case,
\fBpamtopnm\fR fails.
.LP
However, you can override the tuple type requirement with the
\fB-assume\fR option.
.LP
As with any Netpbm program that reads PAM images, \fBpamtopnm\fR
also reads PNM images as if they were PAM.  In that case,
\fBpamtopnm\fR's functions reduces to simply copying the input to the
output.  But this can be useful in a program that doesn't know whether
its input is PAM or PNM but needs to feed it to a program that only
recognizes PNM.
.SH 2
OPTIONS
.LP
.RS
.IP "\fB-assume\fR"
When you specify \fB-assume\fR, you tell \fBpamtopnm\fR that you
personally vouch for the fact that the tuples contain the same data as
belongs in the channels of a PBM, PGM, or PPM file.  The depth must
still conform, though, so to truly force a conversion, you may have to
run the input through \fBpamchannel\fR first.  But be careful with
\fB-assume\fR.  When you -assume, you make an -ass of u and me.
.RE
.SH 2
SEE ALSO
.LP
\fBpbmtopgm\fR,
\fBpamditherbw\fR,
\fBpgmtoppm\fR,
\fBppmtopgm\fR,
\fBpam\fR,
\fBpnm\fR,
\fBpbm\fR,
\fBpgm\fR,
\fBppm\fR
.SH 2
HISTORY
.LP
.LP
\fBpamtopnm\fR was new, along with the PAM format, in Netpbm
9.7 (August 2000).
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
SEE ALSO
.IP \(bu
HISTORY
.LP