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 / pnmrotate.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  57 lines
  1. .TH pnmrotate 1 "12 January 1991"
  2. .IX pnmrotate
  3. .SH NAME
  4. pnmrotate - rotate a portable anymap by some angle
  5. .SH SYNOPSIS
  6. .B pnmrotate
  7. .RB [ -noantialias ]
  8. .I angle
  9. .RI [ pnmfile ]
  10. .SH DESCRIPTION
  11. Reads a portable anymap as input.
  12. Rotates it by the specified angle
  13. and produces a portable anymap as output.
  14. .IX rotation
  15. If the input file is in color, the output will be too,
  16. otherwise it will be grayscale.
  17. The angle is in degrees (floating point), measured counter-clockwise.
  18. It can be negative, but it should be between -90 and 90.
  19. Also, for rotations greater than 45 degrees you may get better results
  20. if you first use
  21. .I pnmflip
  22. .IX pnmflip
  23. to do a 90 degree rotation and then
  24. .I pnmrotate
  25. less than 45 degrees back the other direction
  26. .PP
  27. The rotation algorithm is Alan Paeth's three-shear method.
  28. Each shear is implemented by looping over the source pixels and distributing
  29. fractions to each of the destination pixels.
  30. This has an "anti-aliasing" effect - it avoids jagged edges and similar
  31. artifacts.
  32. .IX anti-aliasing
  33. However, it also means that the original colors or gray levels in the image
  34. are modified.
  35. If you need to keep precisely the same set of colors, you can use the
  36. .B -noantialias
  37. flag.  This does the shearing by moving pixels without changing their values.
  38. If you want anti-aliasing and don't care about the precise colors, but
  39. still need a limited *number* of colors, you can run the result through
  40. .IR ppmquant .
  41. .IX ppmquant
  42. .PP
  43. All flags can be abbreviated to their shortest unique prefix.
  44. .SH REFERENCES
  45. "A Fast Algorithm for General Raster Rotation" by Alan Paeth,
  46. Graphics Interface '86, pp. 77-81.
  47. .SH "SEE ALSO"
  48. pnmshear(1), pnmflip(1), pnm(5), ppmquant(1)
  49. .SH AUTHOR
  50. Copyright (C) 1989, 1991 by Jef Poskanzer.
  51. .\" Permission to use, copy, modify, and distribute this software and its
  52. .\" documentation for any purpose and without fee is hereby granted, provided
  53. .\" that the above copyright notice appear in all copies and that both that
  54. .\" copyright notice and this permission notice appear in supporting
  55. .\" documentation.  This software is provided "as is" without express or
  56. .\" implied warranty.
  57.