# asciitopgm(1) - man - phpMan

[asciitopgm(1)](https://www.chedong.com/phpMan.php/man/asciitopgm/1/markdown)                          General Commands Manual                         [asciitopgm(1)](https://www.chedong.com/phpMan.php/man/asciitopgm/1/markdown)



## NAME
       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 ap‐
       proximation 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 conventions, 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_ manual: "Note that there is no asciitopbm
       tool - this transformation is one-way."

## BUGS
       The  table  of  ASCII-to-grey values is subject to interpretation, and, of course, depends on
       the typeface intended for the input.

## SEE ALSO
       [pbmtoascii(1)](https://www.chedong.com/phpMan.php/man/pbmtoascii/1/markdown), [pgm(5)](https://www.chedong.com/phpMan.php/man/pgm/5/markdown)

## AUTHOR
       Wilson H. Bent. Jr. (<whb@usc.edu>)



                                          26 December 1994                             [asciitopgm(1)](https://www.chedong.com/phpMan.php/man/asciitopgm/1/markdown)