.TL
Asciitopgm User Manual
.SH 1
asciitopgm
.LP
Updated: 05 September 2003
.br
Table Of Contents
.SH 2
NAME
.LP
asciitopgm - convert ASCII graphics into a PGM
.SH 2
SYNOPSIS
.LP
\fBasciitopgm\fR
[\fB-d\fR \fIdivisor\fR]
\fIheight\fR
\fIwidth\fR
[\fIasciifile\fR]
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBasciitopgm\fR reads ASCII data as input and produces a PGM image
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 very light, and a space is white.
.LP
Obviously, \fBasciitopgm\fR assumes a certain font in assigning
a brightness value to a character.
.LP
\fBasciitopgm\fR considers ASCII control characters to be all
white.  It assigns special brightnesses to lower case letters which
have nothing to do with what they look like printed.
\fBasciitopgm\fR takes the ASCII character code from the lower 7 bits
of each input byte.  But it warns you if the most signficant bit of
any input byte is not zero.
.LP
Input lines which are fewer than \fIwidth\fR characters are
automatically padded with spaces.
.LP
The \fIdivisor\fR value is an integer (decimal) by which the
blackness of an input character is divided; the default value is 1.
You can use this to adjust the brightness of the output: for example,
if the image is too bright, increase the divisor.
.LP
In keeping with (I believe) Fortran line-printer conventions,
input lines beginning with a \fB+\fR (plus) character are assumed to
"overstrike" the previous line, allowing a larger range of
gray values.
.LP
If you're looking for something that creates an image of text,
with that text specified in ASCII, that is something quite different.
Use \fBpbmtext\fR for that.
.SH 2
SEE ALSO
.LP
pbmtoascii,
pbmtext,
pgm
.SH 2
AUTHOR
.LP
Wilson H. Bent. Jr. (whb@usc.edu)
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
SEE ALSO
.IP \(bu
AUTHOR
.LP