NAME¶
pnmpaste - paste a rectangle into a portable anymap
SYNOPSIS¶
pnmpaste [
-replace|
-or|
-and |
-xor]
frompnmfile x y [
intopnmfile]
DESCRIPTION¶
Reads two portable anymaps as input. Inserts the first anymap into the second at
the specified location, and produces 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 prefix.
SEE ALSO¶
pnmcomp(1),
pnmcut(1),
pnminvert(1),
pnmarith(1),
pbmmask(1),
pnm(5)
AUTHOR¶
Copyright (C) 1989, 1991 by Jef Poskanzer.