\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamtopnm User Manual" 0 "10 May 2010" "netpbm documentation"

.UN name
.SH NAME

pamtopnm - convert PAM image to PBM, PGM, or PPM

.UN synopsis
.SH SYNOPSIS

\fBpamtopnm\fP

[\fB-assume\fP]

[\fIpnmfile\fP]
.PP
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.

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR Netpbm (1)
.
.PP
\fBpamtopnm\fP reads a PAM image as input and produces an
equivalent PBM, PGM, or PPM (i.e. PNM) image, whichever is most
appropriate, as output.
.PP
\fBpamtopnm\fP 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\fP fails.
.PP
However, you can override the tuple type requirement with the
\fB-assume\fP option.
.PP
\fBpamtopnm\fP produces a PPM image if the input PAM has depth 3 or 4; it
produces PGM or PBM if the input PAM has depth 1 or 2.  Whether it produced
PGM or PBM depends upon the maxval: PBM for 1, PGM for anything higher.  The
tuple type does not play a role in determining the output type.  You can
use Netpbm programs such as \fBpgmtopgm\fP to generate a different PNM
output, but remember that Netpbm program that expects PGM input will take
PBM and so on.
.PP
As with any Netpbm program that reads PAM images, \fBpamtopnm\fP
also reads PNM images as if they were PAM.  In that case,
\fBpamtopnm\fP'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.

.UN options
.SH OPTIONS


.TP
\fB-assume\fP
When you specify \fB-assume\fP, you tell \fBpamtopnm\fP 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\fP first.  But be careful with
\fB-assume\fP.  When you -assume, you make an -ass of u and me.



.UN seealso
.SH SEE ALSO
.BR pbmtopgm (1)
,
.BR pamditherbw (1)
,
.BR pgmtoppm (1)
,
.BR ppmtopgm (1)
,
.BR pam (5)
,
.BR pnm (5)
,
.BR pbm (5)
,
.BR pgm (5)
,
.BR ppm (5)



.UN history
.SH HISTORY
.PP
\fBpamtopnm\fP was new, along with the PAM format, in Netpbm
9.7 (August 2000).