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)