1Asciitopgm User Manual(0)                            Asciitopgm User Manual(0)
2
3
4

NAME

6       asciitopgm - convert ASCII graphics into a PGM
7
8

SYNOPSIS

10       asciitopgm [-d divisor] height width [asciifile]
11
12

DESCRIPTION

14       This program is part of Netpbm(1).
15
16       asciitopgm  reads  ASCII  data  as  input and produces a PGM image with
17       pixel values which are an approximation  of  the  'brightness'  of  the
18       ASCII  characters, assuming black-on-white printing.  In other words, a
19       capital M is very dark, a period is very light, and a space is white.
20
21       Obviously, asciitopgm assumes a certain font in assigning a  brightness
22       value to a character.
23
24       asciitopgm  considers  ASCII  control  characters  to be all white.  It
25       assigns special brightnesses to lower case letters which  have  nothing
26       to  do  with  what  they look like printed.  asciitopgm takes the ASCII
27       character code from the lower 7 bits of each input byte.  But it  warns
28       you if the most signficant bit of any input byte is not zero.
29
30       Input  lines  which  are  fewer than width characters are automatically
31       padded with spaces.
32
33       The divisor value is an integer (decimal) by which the blackness of  an
34       input  character  is divided; the default value is 1.  You can use this
35       to adjust the brightness of the output: for example, if  the  image  is
36       too bright, increase the divisor.
37
38       In  keeping  with  (I  believe) Fortran line-printer conventions, input
39       lines beginning with a + (plus) character are assumed  to  'overstrike'
40       the previous line, allowing a larger range of gray values.
41
42       If  you're  looking  for  something that creates an image of text, with
43       that text specified in ASCII, that is something quite  different.   Use
44       pbmtext for that.
45
46

SEE ALSO

48       pbmtoascii(1), pbmtext(1), pgm(1)
49
50

AUTHOR

52       Wilson H. Bent. Jr. (whb@usc.edu)
53
54
55
56netpbm documentation           05 September 2003     Asciitopgm User Manual(0)
Impressum