Debian Codegraph @

upstream/debian-unstable/man1/ppmtoascii.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 "Ppmtoascii User Manual" 1 "09 April 2010" "netpbm documentation"
7
8 .SH NAME
9 ppmtoascii - convert a PPM image to ASCII graphics with ANSI terminal color
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBppmtoascii\fP
15
16 [\fB-1x2\fP|\fB-2x4\fP]
17
18 [\fIppmfile\fP]
19
20 .UN description
21 .SH DESCRIPTION
22 .PP
23 This program is part of
24 .BR "Netpbm" (1)\c
25 \&.
26 .PP
27 \fBppmtoascii\fP reads a PPM image as input and produces a somewhat
28 crude ASCII graphic image as output, with ANSI terminal control characters
29 so it has crude color when sent to a color text terminal.
30 .PP
31 There is no converter for the other direction.
32 .PP
33 \fBppmtoterm\fP does a similar thing, but displays each character of the
34 image as a single pixel (using the same dense character for every pixel),
35 whereas \fBppmtoascii\fP combines 2 or 8 pixels into one character, where
36 the character roughly represents those particular pixels.
37 .PP
38 Note that ANSI provides for only eight colors (including black and white).
39 .PP
40 Note that an ANSI terminal can't display a single character in multiple
41 colors, so where a character represents 8 pixels of differing colors, the
42 color of the character is one that is the average of the colors of those
43 pixels.
44 .PP
45 \fBpbmtoascii\fP does the same thing for PBM images, with no terminal
46 control characters (because none are needed for a strictly black and white
47 image).
48
49
50 .UN options
51 .SH OPTIONS
52 .PP
53 In addition to the options common to all programs based on libnetpbm
54 (most notably \fB-quiet\fP, see
55 .UR index.html#commonoptions
56 Common Options
57 .UE
58 \&), \fBppmtoascii\fP recognizes the following
59 command line options:
60 .PP
61 The \fB-1x2\fP and \fB-2x4\fP options give you two alternate ways for the
62 pixels to get mapped to characters. With \fB1x2\fP, the default, each
63 character represents a group of 1 pixel across by 2 pixels down. With
64 \fB-2x4\fP, each character represents 2 pixels across by 4 pixels down.
65
66 .UN seealso
67 .SH SEE ALSO
68 .BR "pbmtoascii" (1)\c
69 \&
70 .BR "ppmtoterm" (1)\c
71 \&
72 .BR "ppm" (1)\c
73 \&
74
75
76 .UN history
77 .SH HISTORY
78 .PP
79 \fBppmtoascii\fP was new in Netpbm 10.51 (June 2010). Frank Ch. Eigler
80 derived it from \fBpbmtoascii\fP.
81
82
83 .UN author
84 .SH AUTHOR
85
86 Copyright (C) 2010 by Frank Ch. Eigler.
87 .SH DOCUMENT SOURCE
88 This manual page was generated by the Netpbm tool 'makeman' from HTML
89 source. The master documentation is at
90 .IP
91 .B http://netpbm.sourceforge.net/doc/ppmtoascii.html
92 .PP