pnmpaste - paste a rectangle into a portable anymap
SYNOPSIS
pnmpaste [-replace|-or|-and |-xor] frompnmfile x y [intop
nmfile]
DESCRIPTION
Reads two portable anymaps as input. Inserts the first
anymap into the second at the specified location, and pro
duces a portable anymap the same size as the second as
output. If the second anymap is not specified, it is read
from stdin. The x and y can be negative, in which case
they are interpreted relative to the right and bottom of
the anymap, respectively.
This tool is most useful in combination with pnmcut. 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.
Another useful companion tool is pbmmask.
pnmcomp is, a more general tool, except that it lacks the
"or," "and," and "xor" functions. pnmcomp 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.
The optional flag specifies the operation to use when
doing the paste. The default is -replace. The other,
logical operations are only allowed if both input images
are bitmaps. These operations act as if white is TRUE and
black is FALSE.
All flags can be abbreviated to their shortest unique pre
fix.
SEE ALSO
pnmcomp(1), pnmcut(1), pnminvert(1), pnmarith(1), pbm
mask(1), pnm(5)
AUTHOR
Copyright (C) 1989, 1991 by Jef Poskanzer.
Man(1) output converted with
man2html