PNMPASTE

NAME

      pnmpaste - paste a rectangle into a portable anymap

SYNOPSIS

      pnmpaste 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(1).  For instance,
      if you want to edit a small segment of a large anymap, and your anymap
      editor is TOO STUPID to edit the large anymap, you can cut out the
      segment you are interested in, edit it, and then paste it back in.
      The pbmpaste(1) tool is like this one, except that since it only has
      to work with bitmaps, it implements bitblt-style logical operations.

DEMONSTRATION

      Let a.pnm and b.pnm be two portable anymaps.
      The following command will paste a in b at the position 100,200
	pnmmerge pnmpaste a.pnm 100 200 b.pnm > c.pnm
      In the following example, we want to put text in an image:

BEFORE

AFTER

SEE ALSO

      pbmpaste(1), pnmcut(1), pnm(5)

AUTHOR

      Copyright (C) 1989 by Jef Poskanzer.
      Permission to use, copy, modify, and distribute this software and its
      documentation for any purpose and without fee is hereby granted,
      provided that the above copyright notice appear in all copies and that
      both that copyright notice and this permission notice appear in
      supporting documentation.  This software is provided "as is" without
      express or implied warranty.