home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / NETWORK / netpbm_docs.lzh / NETPBM / DOCS / pnmpaste.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  56 lines
  1. .TH pnmpaste 1 "21 February 1991"
  2. .IX pnmpaste
  3. .SH NAME
  4. pnmpaste - paste a rectangle into a portable anymap
  5. .SH SYNOPSIS
  6. .B pnmpaste
  7. .RB [ -replace | -or | -and
  8. .RB | -xor ]
  9. .I frompnmfile x y
  10. .RI [ intopnmfile ]
  11. .SH DESCRIPTION
  12. Reads two portable anymaps as input.
  13. Inserts the first anymap into the second at the specified location,
  14. and produces a portable anymap the same size as the second as output.
  15. .IX paste
  16. If the second anymap is not specified, it is read from stdin.
  17. The
  18. .I x
  19. and
  20. .I y
  21. can be negative, in which case they are interpreted
  22. relative to the right and bottom of the anymap, respectively.
  23. .PP
  24. This tool is most useful in combination with
  25. .IR pnmcut .
  26. .IX pnmcut
  27. For instance, if you want to edit a small segment of a large
  28. image, and your image editor cannot edit the
  29. large image, you can cut out the segment you are interested in,
  30. edit it, and then paste it back in.
  31. .PP
  32. Another useful companion tool is
  33. .IR pbmmask .
  34. .IX pnmmask
  35. .OPTIONS
  36. .PP
  37. The optional flag specifies the operation to use when doing the paste.
  38. The default is
  39. .BR -replace .
  40. The other, logical operations are only allowed if both input images
  41. are bitmaps.
  42. .IX "logical operations"
  43. These operations act as if white is TRUE and black is FALSE.
  44. .PP
  45. All flags can be abbreviated to their shortest unique prefix.
  46. .SH "SEE ALSO"
  47. pnmcut(1), pnminvert(1), pnmarith(1), pnm(5), pbmmask(1)
  48. .SH AUTHOR
  49. Copyright (C) 1989, 1991 by Jef Poskanzer.
  50. .\" Permission to use, copy, modify, and distribute this software and its
  51. .\" documentation for any purpose and without fee is hereby granted, provided
  52. .\" that the above copyright notice appear in all copies and that both that
  53. .\" copyright notice and this permission notice appear in supporting
  54. .\" documentation.  This software is provided "as is" without express or
  55. .\" implied warranty.
  56.