1Ppmtoterm User Manual(0) Ppmtoterm User Manual(0)
2
6 ppmtoterm - convert a PPM image to a ANSI ISO 6429 ascii image
7
10 ppmtoterm
11 [ppmfile]
13 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
20 This program is part of Netpbm(1).
21 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 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 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 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 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 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 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 pbmto4425 does a similar thing for black and white images, using line
60 drawing characters, on some terminals.
61
64 There are no command line options defined specifically for ppmtoterm,
65 but it recognizes the options common to all programs based on libnetpbm
66 (See
67 Common Options ⟨index.html#commonoptions⟩ .)
68
71 pamscale(1), pamcut(1), ppmtoascii(1), pbmtoascii(1), pbmto4425(1),
72 ppm(1)
73
77 Copyright (C) 2002 by Ero Carrera.
78
82 This program was new in Netpbm 10.9 (August 2002).
83
85 This manual page was generated by the Netpbm tool 'makeman' from HTML
86 source. The master documentation is at
87 http://netpbm.sourceforge.net/doc/ppmtoterm.html
89netpbm documentation 17 June 2017 Ppmtoterm User Manual(0)