Debian Codegraph @

upstream/debian-unstable/man1/ppmtoterm.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Ppmtoterm User Manual" 1 "17 June 2017" "netpbm documentation"
7
8 .SH NAME
9
10 ppmtoterm - convert a PPM image to a ANSI ISO 6429 ascii image
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBppmtoterm\fP
16
17 [\fIppmfile\fP]
18 .PP
19 All options can be abbreviated to their shortest unique prefix.
20 You may use two hyphens instead of one. You may separate an option
21 name and its value with white space instead of an equals sign.
22
23 .UN description
24 .SH DESCRIPTION
25 .PP
26 This program is part of
27 .BR "Netpbm" (1)\c
28 \&.
29 .PP
30 This program tries to produce an accurate representation of a PPM
31 image on an terminal that implements the ANSI ISO 6429 standard. It
32 approximates colors, finding the minimum Cartesian distance between the
33 input RGB vectors and the ones in the generated palette. As the
34 available color palette is somewhat restricted, you get the best
35 results when the colors in the original image are few and the RGB
36 intensities are close to zero, half of maximum, and maximum.
37 .PP
38 You can usually get good results with cartoons or images with
39 plain colors (no gradients). With photos, results can vary, but are
40 usually not very accurate.
41 .PP
42 The output image has one line for each row and one character for each
43 column of the input image. E.g. an 80 pixel by 25 pixel PPM image would
44 fill up an 80x25 terminal screen. Use \fBpamscale\fP or \fBpamcut\fP
45 to make your image fit properly on your screen.
46 .PP
47 Furthermore, use \fBpamscale\fP to recover the proper aspect ratio,
48 because a character on a terminal screen is rarely square. Typically, a
49 character is twice has high as it is wide, so in order for a 20x20 image to
50 appear square on your terminal, as it should, you'll want to squash it
51 vertically or stretch it horizontally by a factor of two (resulting int 10x20
52 characters are 20x40 characters).
53 .PP
54 The image starts at the current cursor position on the terminal
55 screen. Each successive row starts at Column 0 on the screen. If you want
56 to shift the image up or down, for example to center it, use
57 \fBpnmpad\fP on the input.
58 .PP
59 This program was born with the objective of displaying nice color
60 images on the Linux console, e.g. a proper logo at Linux boot.
61 .PP
62 \fBppmtoascii\fP does a similar things, but combines 2 or 8 pixels into
63 one character, where the character roughly represents those particular pixels,
64 whereas \fBppmtoterm\fP displays each character of the image as a single
65 pixel.
66 .PP
67 \fBpbmto4425\fP does a similar thing for black and white images, using
68 line drawing characters, on some terminals.
69
70 .UN options
71 .SH OPTIONS
72 .PP
73 There are no command line options defined specifically
74 for \fBppmtoterm\fP, but it recognizes the options common to all
75 programs based on libnetpbm (See
76 .UR index.html#commonoptions
77 Common Options
78 .UE
79 \&.)
80
81 .UN seealso
82 .SH SEE ALSO
83 .BR "pamscale" (1)\c
84 \&,
85 .BR "pamcut" (1)\c
86 \&,
87 .BR "ppmtoascii" (1)\c
88 \&,
89 .BR "pbmtoascii" (1)\c
90 \&,
91 .BR "pbmto4425" (1)\c
92 \&,
93 .BR "ppm" (1)\c
94 \&
95
96
97 .UN author
98 .SH AUTHOR
99
100 Copyright (C) 2002 by Ero Carrera.
101
102
103 .UN history
104 .SH HISTORY
105 .PP
106 This program was new in Netpbm 10.9 (August 2002).
107 .SH DOCUMENT SOURCE
108 This manual page was generated by the Netpbm tool 'makeman' from HTML
109 source. The master documentation is at
110 .IP
111 .B http://netpbm.sourceforge.net/doc/ppmtoterm.html
112 .PP