summaryrefslogtreecommitdiffstats
path: root/upstream/debian-bookworm/man1/pnmalias.1
blob: 9248b72d627dc903ffa6698cc89072958caa1558 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pnmalias User Manual" 1 "15 March 2004" "netpbm documentation"

.SH NAME

pnmalias - antialias a PNM image

.UN synopsis
.SH SYNOPSIS

\fBpnmalias\fP

[\fB-bgcolor\fP \fIcolor\fP]

[\fB-fgcolor\fP \fIcolor\fP]

[\fB-bonly\fP]

[\fB-fonly\fP]

[\fB-balias\fP]

[\fB-falias\fP]

[\fB-weight\fP \fIw\fP]

[\fIpnmfile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpnmalias\fP reads a PNM image as input, and applies
anti-aliasing to background and foreground pixels.  If the input file
is a PBM, \fBpnmalias\fP promotes the output anti-aliased image to a
PGM, and prints a message informing the user of the change in format.

.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBpnmalias\fP recognizes the following
command line options:
.PP
\fB-bgcolor\fP \fIcolorb\fP sets the background color the
\fIcolorb\fP.
.PP
\fB-fgcolor\fP \fIcolorf\fP sets the foreground color to
\fIcolorf\fP.
.PP
Pixels with these values will be anti-aliased.  By default,
\fBpnmalias\fP takes the background color to be black, and foreground
color to be white.
.PP
Specify the color (\fIcolor\fP) as described for the 
.UR libnetpbm_image.html#colorname
argument of the \fBpnm_parsecolor()\fP library routine
.UE
\&.
.PP
Note that even when dealing with PGMs, background and foreground
colors need to be specified in the fashion described above.  In this
case, \fBpnmalias\fP takes the background and foreground pixel values
to be the value of the red component for the specified color.
.PP
\fB-bonly\fP says to apply anti-aliasing only to the background pixels.
.PP
\fB-fonly\fP says to apply anti-aliasing only to the foreground pixels.
.PP
\fB-balias\fP says to apply anti-aliasing to all pixels surrounding
background pixels.
.PP
\fB-falias\fP says to apply anti-aliasing to all pixels surrounding
foreground pixels.
.PP
If you specify neither \fB-balias\fP nor \fB-falias\fP,
\fBpnmalias\fP applies anti-aliasing only among neighboring
background and foreground pixels.
.PP
\fB-weight\fP \fIw\fP says to use \fIw\fP as the central weight
for the aliasing filter.  \fIw\fP must be a real number in the range
0 < \fIw\fP < 1.  The lower the value of \fIw\fP is, the
"blurrier" the output image is.  The default is w = 1/3.

.UN seealso
.SH SEE ALSO
.BR "pbmtext" (1)\c
\&,
.BR "pnmsmooth" (1)\c
\&,
.BR "pnm" (1)\c
\&

.UN author
.SH AUTHOR

Copyright (C) 1992 by Alberto Accomazzi, Smithsonian Astrophysical Observatory.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pnmalias.html
.PP