1Asciitopgm User Manual(0) Asciitopgm User Manual(0)
2
6 asciitopgm - convert ASCII graphics into a PGM
7
10 asciitopgm [-d divisor] height width [asciifile]
11
14 This program is part of Netpbm(1).
15 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 Obviously, asciitopgm assumes a certain font in assigning a brightness
22 value to a character.
23 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 Input lines which are fewer than width characters are automatically
31 padded with spaces.
32 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 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 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
48 pbmtoascii(1), pbmtext(1), pgm(1)
49
52 Wilson H. Bent. Jr. (whb@usc.edu)
53netpbm documentation 05 September 2003 Asciitopgm User Manual(0)