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.

                                                21 February 1991                                     pnmpaste(1)