Debian Codegraph @

upstream/debian-unstable/man1/pbmtoascii.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 "Pbmtoascii User Manual" 1 "02 April 2010" "netpbm documentation"
7
8 .SH NAME
9 pbmtoascii - convert a PBM image to ASCII graphics
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpbmtoascii\fP
15
16 [\fB-1x2\fP|\fB-2x4\fP]
17
18 [\fIpbmfile\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 \fBpbmtoascii\fP reads a PBM image as input and produces a somewhat
28 crude ASCII graphic image as output.
29 .PP
30 To convert back, use
31 .BR "asciitopgm" (1)\c
32 \&.
33 .PP
34 \fBppmtoterm\fP does a similar thing for color images to be displayed
35 on color text terminals.
36
37
38 .UN options
39 .SH OPTIONS
40 .PP
41 In addition to the options common to all programs based on libnetpbm
42 (most notably \fB-quiet\fP, see
43 .UR index.html#commonoptions
44 Common Options
45 .UE
46 \&), \fBpbmtoascii\fP recognizes the following
47 command line options:
48 .PP
49 The \fB-1x2\fP and \fB-2x4\fP options give you two alternate ways for the
50 pixels to get mapped to characters. With \fB1x2\fP, the default, each
51 character represents a group of 1 pixel across by 2 pixels down. With
52 \fB-2x4\fP, each character represents 2 pixels across by 4 pixels down. With
53 the 1x2 mode you can see the individual pixels, so it's useful for previewing
54 small images on a non-graphics terminal. The 2x4 mode lets you display larger
55 images on a small display, but it obscures pixel-level details. 2x4 mode is
56 also good for displaying PGM images:
57
58 .nf
59 pamscale -width 158 | pnmnorm | pamditherbw -threshold | pbmtoascii -2x4
60
61 .fi
62
63 should give good results.
64
65 .UN seealso
66 .SH SEE ALSO
67 .BR "asciitopgm" (1)\c
68 \&,
69 .BR "ppmtoascii" (1)\c
70 \&,
71 .BR "ppmtoterm" (1)\c
72 \&,
73 .BR "pbm" (1)\c
74 \&
75
76 .UN author
77 .SH AUTHOR
78
79 Copyright (C) 1988, 1992 by Jef Poskanzer.
80 .SH DOCUMENT SOURCE
81 This manual page was generated by the Netpbm tool 'makeman' from HTML
82 source. The master documentation is at
83 .IP
84 .B http://netpbm.sourceforge.net/doc/pbmtoascii.html
85 .PP