Debian Codegraph @

upstream/debian-unstable/man1/pnmalias.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 "Pnmalias User Manual" 1 "15 March 2004" "netpbm documentation"
7
8 .SH NAME
9
10 pnmalias - antialias a PNM image
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBpnmalias\fP
16
17 [\fB-bgcolor\fP \fIcolor\fP]
18
19 [\fB-fgcolor\fP \fIcolor\fP]
20
21 [\fB-bonly\fP]
22
23 [\fB-fonly\fP]
24
25 [\fB-balias\fP]
26
27 [\fB-falias\fP]
28
29 [\fB-weight\fP \fIw\fP]
30
31 [\fIpnmfile\fP]
32
33 .UN description
34 .SH DESCRIPTION
35 .PP
36 This program is part of
37 .BR "Netpbm" (1)\c
38 \&.
39 .PP
40 \fBpnmalias\fP reads a PNM image as input, and applies
41 anti-aliasing to background and foreground pixels. If the input file
42 is a PBM, \fBpnmalias\fP promotes the output anti-aliased image to a
43 PGM, and prints a message informing the user of the change in format.
44
45 .UN options
46 .SH OPTIONS
47 .PP
48 In addition to the options common to all programs based on libnetpbm
49 (most notably \fB-quiet\fP, see
50 .UR index.html#commonoptions
51 Common Options
52 .UE
53 \&), \fBpnmalias\fP recognizes the following
54 command line options:
55 .PP
56 \fB-bgcolor\fP \fIcolorb\fP sets the background color the
57 \fIcolorb\fP.
58 .PP
59 \fB-fgcolor\fP \fIcolorf\fP sets the foreground color to
60 \fIcolorf\fP.
61 .PP
62 Pixels with these values will be anti-aliased. By default,
63 \fBpnmalias\fP takes the background color to be black, and foreground
64 color to be white.
65 .PP
66 Specify the color (\fIcolor\fP) as described for the
67 .UR libnetpbm_image.html#colorname
68 argument of the \fBpnm_parsecolor()\fP library routine
69 .UE
70 \&.
71 .PP
72 Note that even when dealing with PGMs, background and foreground
73 colors need to be specified in the fashion described above. In this
74 case, \fBpnmalias\fP takes the background and foreground pixel values
75 to be the value of the red component for the specified color.
76 .PP
77 \fB-bonly\fP says to apply anti-aliasing only to the background pixels.
78 .PP
79 \fB-fonly\fP says to apply anti-aliasing only to the foreground pixels.
80 .PP
81 \fB-balias\fP says to apply anti-aliasing to all pixels surrounding
82 background pixels.
83 .PP
84 \fB-falias\fP says to apply anti-aliasing to all pixels surrounding
85 foreground pixels.
86 .PP
87 If you specify neither \fB-balias\fP nor \fB-falias\fP,
88 \fBpnmalias\fP applies anti-aliasing only among neighboring
89 background and foreground pixels.
90 .PP
91 \fB-weight\fP \fIw\fP says to use \fIw\fP as the central weight
92 for the aliasing filter. \fIw\fP must be a real number in the range
93 0 < \fIw\fP < 1. The lower the value of \fIw\fP is, the
94 "blurrier" the output image is. The default is w = 1/3.
95
96 .UN seealso
97 .SH SEE ALSO
98 .BR "pbmtext" (1)\c
99 \&,
100 .BR "pnmsmooth" (1)\c
101 \&,
102 .BR "pnm" (1)\c
103 \&
104
105 .UN author
106 .SH AUTHOR
107
108 Copyright (C) 1992 by Alberto Accomazzi, Smithsonian Astrophysical Observatory.
109 .SH DOCUMENT SOURCE
110 This manual page was generated by the Netpbm tool 'makeman' from HTML
111 source. The master documentation is at
112 .IP
113 .B http://netpbm.sourceforge.net/doc/pnmalias.html
114 .PP