.TL
Pnmpaste User Manual
.SH 1
pnmpaste
.LP
Updated: 21 February 1991
.br
Table Of Contents
.SH 2
NAME
.LP
pnmpaste - paste a rectangle into a PNM image
.SH 2
SYNOPSIS
.LP
\fBpnmpaste\fR
[\fB-replace\fR|\fB-or\fR|\fB-and\fR|\fB-xor\fR]
\fIfrompnmfile x y\fR
[\fIintopnmfile\fR]
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBpnmpaste\fR reads two PNM images as input and inserts the first
image (the "pasted image") into the second (the "base image") at the
specified location, and produces a PNM image the same size and type as
the base image as output.  If you don't specify the second file,
\fBpnmpaste\fR reads the base image from Standard Input.
.LP
\fIx\fR and \fIy\fR specify the location in the base image at
which to put the top left corner of the pasted image, \fIx\fR giving
the horizontal position and \fIx\fR giving the vertical position.  A
nonnegative value indicates the number of pixels right of the right
edge or below the top edge of the base image, while a negative value
indicates the number of pixels right of the right edge or below the
bottom edge (so x = -5 means 5 pixels left of the right edge).
.LP
If any part of the pasted image does not fit within the base image,
\fBpnmpaste\fR fails.
.LP
This tool is most useful in combination with \fIpamcut\fR.  For
instance, if you want to edit a small segment of a large image, and
your image editor cannot edit the large image, you can cut out the
segment you are interested in, edit it, and then paste it back in.
.LP
Another useful companion tool is \fBpbmmask\fR.
.LP
\fBpamcomp\fR is a more general tool, except that it lacks the
"or," "and," and "xor" functions.
\fBpamcomp\fR allows you to specify an alpha mask in order to have
only part of the inserted image get inserted.  So the inserted pixels
need not be a rectangle.  You can also have the inserted image be
translucent, so the resulting image is a mixture of the inserted image
and the base image.
.SH 2
OPTIONS
.LP
.LP
The option specifies the operation to use when doing the
paste.  The default is \fB-replace\fR.  The other logical operations
are only allowed if both input images are PBM images.  These operations
act as if white is TRUE and black is FALSE.
.LP
You can abbreviate all options to their shortest unique prefix.
.SH 2
SEE ALSO
.LP
\fBpamcomp\fR,
\fBpamcut\fR,
\fBpnminvert\fR,
\fBpnmarith\fR,
\fBpbmmask\fR,
\fBpnm\fR
.SH 2
AUTHOR
.LP
Copyright (C) 1989, 1991 by Jef Poskanzer.
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
SEE ALSO
.IP \(bu
AUTHOR
.LP