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

NAME

6       pbmtoascii - convert a PBM image to ASCII graphics
7
8

SYNOPSIS

10       pbmtoascii
11
12       [-1x2|-2x4]
13
14       [pbmfile]
15
16

DESCRIPTION

18       This program is part of Netpbm(1).
19
20       pbmtoascii  reads  a  PBM  image as input and produces a somewhat crude
21       ASCII graphic image as output.
22
23       To convert back, use asciitopgm(1).
24
25       ppmtoterm does a similar thing for color  images  to  be  displayed  on
26       color text terminals.
27
28
29

OPTIONS

31       In  addition  to  the options common to all programs based on libnetpbm
32       (most notably -quiet, see
33        Common Options ⟨index.html#commonoptions⟩ ), pbmtoascii recognizes the
34       following command line options:
35
36       The -1x2 and -2x4 options give you two alternate ways for the pixels to
37       get mapped to characters.  With 1x2, the default, each character repre‐
38       sents  a  group  of  1  pixel across by 2 pixels down.  With -2x4, each
39       character represents 2 pixels across by 4 pixels down.   With  the  1x2
40       mode  you  can see the individual pixels, so it's useful for previewing
41       small images on a non-graphics terminal.  The 2x4 mode lets you display
42       larger  images on a small display, but it obscures pixel-level details.
43       2x4 mode is also good for displaying PGM images:
44
45       pamscale -width 158 | pnmnorm | pamditherbw -threshold | pbmtoascii -2x4
46
47       should give good results.
48
49

SEE ALSO

51       asciitopgm(1) ppmtoascii(1) ppmtoterm(1) pbm(1)
52
53

AUTHOR

55       Copyright (C) 1988, 1992 by Jef Poskanzer.
56

DOCUMENT SOURCE

58       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
59       source.  The master documentation is at
60
61              http://netpbm.sourceforge.net/doc/pbmtoascii.html
62
63netpbm documentation             02 April 2010       Pbmtoascii User Manual(0)