Provided by: netpbm_10.0-12.2_i386 bug

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)