asciitopgm  -  convert  ASCII  graphics  into  a  portable
       graymap


SYNOPSIS

       asciitopgm [-d divisor] height width [asciifile]


DESCRIPTION

       Reads ASCII data as input.  Produces  a  portable  graymap
       with  pixel  values  which  are  an  approximation  of the
       "brightness" of the ASCII characters,  assuming  black-on-
       white printing.  In other words, a capital M is very dark,
       a period is ver light, and a space is white.  Input  lines
       which  are  fewer  than width characters are automatically
       padded with spaces.

       The divisor argument is a floating-point number  by  which
       the  output  pixels are divided; the default value is 1.0.
       This can be used to adjust the brightness of the  graymap:
       for  example, if the image is too dim, reduce the divisor.

       In keeping with (I believe) Fortran  line-printer  conven­
       tions, input lines beginning with a + (plus) character are
       assumed to "overstrike"  the  previous  line,  allowing  a
       larger range of gray values.

       This  tool  contradicts the message in the pbmtoascii man­
       ual: "Note that there is no asciitopbm tool - this  trans­
       formation is one-way."


BUGS

       The  table of ASCII-to-grey values is subject to interpre­
       tation, and, of course, depends on the  typeface  intended
       for the input.


SEE ALSO

       pbmtoascii(1), pgm(5)


AUTHOR

       Wilson H. Bent. Jr. (whb@usc.edu)


Man(1) output converted with man2html