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 / asciitopgm.1 < prev    next >
Text File  |  1996-11-18  |  1KB  |  44 lines
  1. .TH asciitopgm 1 "26 December 1994"
  2. .IX asciitopgm
  3. .SH NAME
  4. asciitopgm - convert ASCII graphics into a portable graymap
  5. .SH SYNOPSIS
  6. .B asciitopgm
  7. .IR [ -d
  8. .RI divisor ]
  9. .I height width
  10. .RI [ asciifile ]
  11. .SH DESCRIPTION
  12. Reads ASCII data as input.
  13. Produces a portable graymap with pixel values which are an approximation
  14. of the "brightness" of the ASCII characters,
  15. assuming black-on-white printing.
  16. In other words, a capital M is very dark, a period is ver light,
  17. and a space is white.
  18. Input lines which are fewer than
  19. .I width
  20. characters are automatically padded with spaces.
  21. .PP
  22. The
  23. .I divisor
  24. argument is a floating-point number by which the output pixels are
  25. divided; the default value is 1.0.
  26. This can be used to adjust the brightness of the graymap:
  27. for example, if the image is too dim, reduce the divisor.
  28. .PP
  29. In keeping with (I believe) Fortran line-printer conventions,
  30. input lines beginning with a + (plus) character are assumed
  31. to "overstrike" the previous line, allowing a larger range of gray values.
  32. .PP
  33. This tool contradicts the message in the
  34. .I pbmtoascii
  35. manual: "Note that there is no asciitopbm tool - this
  36. transformation is one-way."
  37. .SH BUGS
  38. The table of ASCII-to-grey values is subject to interpretation,
  39. and, of course, depends on the typeface intended for the input.
  40. .SH "SEE ALSO"
  41. pbmtoascii(1), pgm(5)
  42. .SH AUTHOR
  43. Wilson H. Bent. Jr. (whb@usc.edu)
  44.