\
.\" 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 "Pnmcomp User Manual" 0 "15 February 2004" "netpbm documentation"

.SH NAME

pnmcomp - composite (overlay) two PNM images together

.UN synopsis
.SH SYNOPSIS

\fBpnmcomp\fP

[\fB-align=\fP{\fBleft\fP|\fBcenter\fP|\fBright\fP|
\fBbeyondleft\fP|\fBbeyondright\fP}]
[\fB-valign=\fP{\fBtop\fP|\fBmiddle\fP|\fBbottom\fP|
\fBabove\fP|\fBbelow\fP}]
[\fB-xoff=\fP\fIX\fP]
[\fB-yoff=\fP\fIY\fP]
[\fB-alpha=\fP\fIalpha-pgmfile\fP]
[\fB-invert\fP]
[\fB-opacity=\fIopacity\fP\fP]
\fIoverlay_file\fP
[\fIunderlying_file\fP [\fIoutput_file\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
\fBpnmcomp\fP was obsoleted by
.BR \fBpamcomp\fP (1)
, introduced with Netpbm 10.21
(March 2004).  \fBpamcomp\fP is backward compatible with
\fBpnmcomp\fP, plus adds many additional functions, including the
ability to process PAM images, and tends to produce better transparency
results.
.PP
\fBpnmcomp\fP remains in the Netpbm package because it may have
fewer bugs for now than \fBpamcomp\fP, and is in some environments faster
(but newer compilers have been seen to produce code for \fBpamcomp\fP
significantly faster than that for \fBpnmcomp\fP).  Some day,
\fBpnmcomp\fP will probably become an alias for \fBpamcomp\fP.
.PP
You can use the \fBpamcomp\fP documentation for \fBpnmcomp\fP,
considering the following differences:


.IP \(bu
\fBpnmcomp\fP options are a subset of \fBpamcomp\fP's, as
     documented above.
.IP \(bu
\fBpnmcomp\fP always assumes the input is linear, as \fBpamcomp\fP
     does when you specify its \fB-linear\fP option.
.IP \(bu
\fBpnmcomp\fP cannot process PAM images.