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

NAME

6       ppmtoterm - convert a PPM image to a ANSI ISO 6429 ascii image
7
8

SYNOPSIS

10       ppmtoterm
11
12       [ppmfile]
13
14       All  options  can  be abbreviated to their shortest unique prefix.  You
15       may use two hyphens instead of one.  You may separate  an  option  name
16       and its value with white space instead of an equals sign.
17
18

DESCRIPTION

20       This program is part of Netpbm(1).
21
22       This program tries to produce an accurate representation of a PPM image
23       on an terminal that implements the ANSI ISO 6429 standard.  It approxi‐
24       mates  colors, finding the minimum Cartesian distance between the input
25       RGB vectors and the ones in the generated palette.   As  the  available
26       color palette is somewhat restricted, you get the best results when the
27       colors in the original image are few and the RGB intensities are  close
28       to zero, half of maximum, and maximum.
29
30       You  can  usually  get  good results with cartoons or images with plain
31       colors (no gradients).  With photos, results can vary, but are  usually
32       not very accurate.
33
34       The  output  image has one line for each row and one character for each
35       column of the input image.  E.g. an 80 pixel  by  25  pixel  PPM  image
36       would fill up an 80x25 terminal screen.  Use pamscale or pamcut to make
37       your image fit properly on your screen.
38
39       Furthermore, use pamscale to recover the proper aspect ratio, because a
40       character  on a terminal screen is rarely square.  Typically, a charac‐
41       ter is twice has high as it is wide, so in order for a 20x20  image  to
42       appear  square on your terminal, as it should, you'll want to squash it
43       vertically or stretch it horizontally by a factor of two (resulting int
44       10x20 characters are 20x40 characters).
45
46       The image starts at the current cursor position on the terminal screen.
47       Each successive row starts at Column 0 on the screen.  If you  want  to
48       shift the image up or down, for example to center it, use pnmpad on the
49       input.
50
51       This program was born with  the  objective  of  displaying  nice  color
52       images on the Linux console, e.g. a proper logo at Linux boot.
53
54       ppmtoascii  does  a similar things, but combines 2 or 8 pixels into one
55       character, where the character roughly represents those particular pix‐
56       els, whereas ppmtoterm displays each character of the image as a single
57       pixel.
58
59       pbmto4425 does a similar thing for black and white images,  using  line
60       drawing characters, on some terminals.
61
62

OPTIONS

64       None.
65
66
67

SEE ALSO

69       pamscale(1),  pamcut(1),  ppmtoascii(1),  pbmtoascii(1),  pbmto4425(1),
70       ppm(1)
71
72
73

AUTHOR

75       Copyright (C) 2002 by Ero Carrera.
76
77
78

HISTORY

80       This program was new in Netpbm 10.9 (August 2002).
81

DOCUMENT SOURCE

83       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
84       source.  The master documentation is at
85
86              http://netpbm.sourceforge.net/doc/ppmtoterm.html
87
88netpbm documentation             17 June 2017         Ppmtoterm User Manual(0)