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       In  addition  to  the options common to all programs based on libnetpbm
48       (most notably -quiet, see
49        Common Options ⟨index.html#commonoptions⟩ ), ppmtoascii recognizes the
50       following command line options:
51
52       The -1x2 and -2x4 options give you two alternate ways for the pixels to
53       get mapped to characters.  With 1x2, the default, each character repre‐
54       sents  a  group  of  1  pixel across by 2 pixels down.  With -2x4, each
55       character represents 2 pixels across by 4 pixels down.
56
57

SEE ALSO

59       pbmtoascii(1) ppmtoterm(1) ppm(1)
60
61
62

HISTORY

64       ppmtoascii was new in Netpbm  10.51  (June  2010).   Frank  Ch.  Eigler
65       derived it from pbmtoascii.
66
67
68

AUTHOR

70       Copyright (C) 2010 by Frank Ch. Eigler.
71

DOCUMENT SOURCE

73       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
74       source.  The master documentation is at
75
76              http://netpbm.sourceforge.net/doc/ppmtoascii.html
77
78netpbm documentation             09 April 2010       Ppmtoascii User Manual(0)
Impressum