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 / pnmshear.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  63 lines
  1. .TH pnmshear 1 "12 January 1991"
  2. .IX pnmshear
  3. .SH NAME
  4. pnmshear - shear a portable anymap by some angle
  5. .SH SYNOPSIS
  6. .B pnmshear
  7. .RB [ -noantialias ]
  8. .I angle
  9. .RI [ pnmfile ]
  10. .SH DESCRIPTION
  11. Reads a portable anymap as input.
  12. Shears it by the specified angle and produces a portable
  13. anymap as output.
  14. .IX shearing
  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), and measures this:
  18. .nf
  19.     +-------+  +-------+
  20.     |       |  |\\       \\
  21.     |  OLD  |  | \\  NEW  \\
  22.     |       |  |an\\       \\
  23.     +-------+  |gle+-------+
  24. .fi
  25. If the angle is negative, it shears the other way:
  26. .nf
  27.     +-------+  |-an+-------+
  28.     |       |  |gl/       /
  29.     |  OLD  |  |e/  NEW  /
  30.     |       |  |/       /
  31.     +-------+  +-------+
  32. .fi
  33. The angle should not get too close to 90 or -90, or the resulting
  34. anymap will be unreasonably wide.
  35. .PP
  36. The shearing is implemented by looping over the source pixels and distributing
  37. fractions to each of the destination pixels.
  38. This has an "anti-aliasing" effect - it avoids jagged edges and similar
  39. artifacts.
  40. .IX anti-aliasing
  41. However, it also means that the original colors or gray levels in the image
  42. are modified.
  43. If you need to keep precisely the same set of colors, you can use
  44. the
  45. .B -noantialias
  46. flag.  This does the shearing by moving pixels without changing their values.
  47. If you want anti-aliasing and don't care about the precise colors, but
  48. still need a limited *number* of colors, you can run the result through
  49. .IR ppmquant .
  50. .IX ppmquant
  51. .PP
  52. All flags can be abbreviated to their shortest unique prefix.
  53. .SH "SEE ALSO"
  54. pnmrotate(1), pnmflip(1), pnm(5), ppmquant(1)
  55. .SH AUTHOR
  56. Copyright (C) 1989, 1991 by Jef Poskanzer.
  57. .\" Permission to use, copy, modify, and distribute this software and its
  58. .\" documentation for any purpose and without fee is hereby granted, provided
  59. .\" that the above copyright notice appear in all copies and that both that
  60. .\" copyright notice and this permission notice appear in supporting
  61. .\" documentation.  This software is provided "as is" without express or
  62. .\" implied warranty.
  63.