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

NAME

6       ppmtoascii  -  convert a PPM image to ASCII graphics with ANSI terminal
7       color
8
9

SYNOPSIS

11       ppmtoascii
12
13       [-1x2|-2x4]
14
15       [ppmfile]
16
17

DESCRIPTION

19       This program is part of Netpbm(1).
20
21       ppmtoascii reads a PPM image as input and  produces  a  somewhat  crude
22       ASCII graphic image as output, with ANSI terminal control characters so
23       it has crude color when sent to a color text terminal.
24
25       There is no converter for the other direction.
26
27       ppmtoterm does a similar thing, but  displays  each  character  of  the
28       image  as  a  single  pixel  (using  the same dense character for every
29       pixel), whereas ppmtoascii combines 2 or 8 pixels into  one  character,
30       where the character roughly represents those particular pixels.
31
32       Note  that  ANSI  provides  for  only eight colors (including black and
33       white).
34
35       Note that an ANSI terminal can't display a single character in multiple
36       colors,  so  where a character represents 8 pixels of differing colors,
37       the color of the character is one that is the average of the colors  of
38       those pixels.
39
40       pbmtoascii does the same thing for PBM images, with no terminal control
41       characters (because none are needed for  a  strictly  black  and  white
42       image).
43
44
45

OPTIONS

47       The -1x2 and -2x4 options give you two alternate ways for the pixels to
48       get mapped to characters.  With 1x2, the default, each character repre‐
49       sents  a  group  of  1  pixel across by 2 pixels down.  With -2x4, each
50       character represents 2 pixels across by 4 pixels down.
51
52

SEE ALSO

54       pbmtoascii(1) ppmtoterm(1) ppm(1)
55
56
57

HISTORY

59       ppmtoascii was new in Netpbm  10.51  (June  2010).   Frank  Ch.  Eigler
60       derived it from pbmtoascii.
61
62
63

AUTHOR

65       Copyright (C) 2010 by Frank Ch. Eigler.
66
67
68
69netpbm documentation             09 April 2010       Ppmtoascii User Manual(0)