Debian Codegraph @

upstream/debian-unstable/man1/pbmtopgm.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 "Pbmtopgm User Manual" 1 "05 Feb 2003" "netpbm documentation"
7
8 .SH NAME
9
10 pbmtopgm - convert PBM image to PGM by averaging areas
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBpbmtopgm \fP
16 \fIwidth\fP
17 \fIheight\fP
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 \fBpbmtopgm\fP reads a PBM image as input. It outputs a PGM image
28 in which each pixel's gray level is the average of the surrounding
29 black and white input pixels. The surrounding area is a rectangle of
30 \fIwidth\fP by \fIheight\fP pixels.
31 .PP
32 In other words, this is a convolution. \fBpbmtopgm\fP is similar
33 to a special case of \fBpnmconvol\fP.
34 .PP
35 You may need a \fBpnmsmooth\fP step after \fBpbmtopgm\fP.
36 .PP
37 \fBpbmtopgm\fP has the effect of anti-aliasing bitmaps which
38 contain distinct line features.
39 .PP
40 \fBpbmtopgm\fP works best with odd sample width and heights.
41 .PP
42 You don't need \fBpbmtopgm\fP just to use a PGM program on a PBM
43 image. Any PGM program (assuming it uses the Netpbm libraries to read
44 the PGM input) takes PBM input as if it were PGM, with only the
45 minimum and maximum gray levels. So unless your convolution rectangle
46 is bigger than one pixel, you're not gaining anything with a
47 \fBpbmtopgm\fP step.
48 .PP
49 The opposite transformation (which would turn a PGM into a PBM) is
50 dithering. See \fBpamditherbw\fP.
51
52 .UN options
53 .SH OPTIONS
54 .PP
55 There are no command line options defined specifically
56 for \fBpbmtopgm\fP, but it recognizes the options common to all
57 programs based on libnetpbm (See
58 .UR index.html#commonoptions
59 Common Options
60 .UE
61 \&.)
62
63 .UN seealso
64 .SH SEE ALSO
65 .BR "pamditherbw" (1)\c
66 \&,
67 .BR "pnmconvol" (1)\c
68 \&,
69 .BR "pbm" (1)\c
70 \&,
71 .BR "pgm" (1)\c
72 \&
73
74 .UN author
75 .SH AUTHOR
76 .PP
77 Copyright (C) 1990 by Angus Duggan.
78 .PP
79 Copyright (C) 1989 by Jef Poskanzer.
80 .PP
81 Permission to use, copy, modify, and distribute this software and
82 its documentation for any purpose and without fee is hereby granted,
83 provided that the above copyright notice appear in all copies and that
84 both that copyright notice and this permission notice appear in
85 supporting documentation. This software is provided "as is"
86 without express or implied warranty.
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/pbmtopgm.html
92 .PP