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
48       should give good results.
49
50

SEE ALSO

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

AUTHOR

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

DOCUMENT SOURCE

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