


asciitopgm(1)                                       asciitopgm(1)


NNAAMMEE
       asciitopgm  -  convert  ASCII  graphics  into  a  portable
       graymap

SSYYNNOOPPSSIISS
       aasscciiiittooppggmm _[-d divisor_] _h_e_i_g_h_t _w_i_d_t_h [_a_s_c_i_i_f_i_l_e]

DDEESSCCRRIIPPTTIIOONN
       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 _w_i_d_t_h characters are automatically
       padded with spaces.

       The _d_i_v_i_s_o_r 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 _p_b_m_t_o_a_s_c_i_i man-
       ual: "Note that there is no asciitopbm tool - this  trans-
       formation is one-way."

BBUUGGSS
       The  table of ASCII-to-grey values is subject to interpre-
       tation, and, of course, depends on the  typeface  intended
       for the input.

SSEEEE AALLSSOO
       pbmtoascii(1), pgm(5)

AAUUTTHHOORR
       Wilson H. Bent. Jr. (whb@usc.edu)

















                         26 December 1994                       1