pnmpaste(1) - phpMan

Pnmpaste User Manual(0) Pnmpaste User Manual(0)

NAME
pnmpaste - paste a rectangle into a PNM image

SYNOPSIS
pnmpaste

[-replace|-or|-and|-xor]

frompnmfile x y [intopnmfile]

You can abbreviate all options to their shortest unique prefix.

DESCRIPTION
This program is part of Netpbm(1).

pnmpaste 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.

Either file name argument (but not both) may be '-' to indicate Standard Input. If you
don't specify the second file argument at all, that's the same as '-'.

x and y specify the location in the base image at which to put the top left corner of the
pasted image, x giving the horizontal position and x giving the vertical position. A non-
negative 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).

If any part of the pasted image does not fit within the base image, pnmpaste fails.

This tool is most useful in combination with pamcut. 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.

pamcomp is a more general tool, except that it lacks the "or," "and," and "xor" functions.
pamcomp allows you to specify a transparency 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.

OPTIONS
The option specifies the operation to use when doing the paste. The default is -replace,
which means to do the obvious paste: replace pixels of the "into" image with those of the
"from" image.

-and, -or, and -xor are allowed only if both input images are PBM images. They say to
combine the "from" and "into" images by performing boolean operations: Each pixel of the
output image is the result of the boolean operation on the corresponding pixels of the two
input image, where white is TRUE and black is FALSE.

Note that this is different from what you would get by doing a bit arithmetic on the bits
in the PBM images, because in PBM, white is represented by a 0 bit, and 0 in bit arith-
metic corresponds to FALSE in boolean arithmetic.

SEE ALSO
pamcomp(1), pamcut(1), pnminvert(1), pnmarith(1), pbmmask(1), pnm(1)

DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML source. The master
documentation is at

http://netpbm.sourceforge.net/doc/pnmpaste.html

netpbm documentation 05 July 2017 Pnmpaste User Manual(0)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-04-26 00:43 @3.16.51.3 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)