Debian Codegraph @

upstream/debian-unstable/man1/pamenlarge.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 "Pamenlarge User Manual" 1 "07 January 2019" "netpbm documentation"
7
8 .SH NAME
9 pamenlarge - Enlarge a Netpbm image N times by duplicating pixels
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpamenlarge\fP
15 [\fB-scale=\fP\fIinteger\fP]
16 [\fB-xscale=\fP\fIinteger\fP]
17 [\fB-yscale=\fP\fIinteger\fP]
18 [\fIfilename\fP]
19
20 \fBpamenlarge\fP \fIN\fP [\fIpnmfile\fP]
21
22
23 .UN description
24 .SH DESCRIPTION
25 .PP
26 This program is part of
27 .BR "Netpbm" (1)\c
28 \&.
29 .PP
30 \fBpamenlarge\fP reads a Netpbm image as input, replicates its pixels
31 \fIN\fP times, and produces a Netpbm image as output. The output is
32 the same type of image as the input.
33 .PP
34 If you enlarge by a factor of 3 or more, you should probably add a
35 \fBpnmsmooth\fP step; otherwise, you can see the original pixels in
36 the resulting image.
37 .PP
38 For PBM images, \fBpamenlarge\fP uses special fast algorithms for scale
39 factors up to 10. For larger factors, it uses a simple but slow algorithm.
40 As a result, you can often get a significantly faster scale by running
41 \fBpamenlarge\fP multiple times. For example, enlarging by 3 and
42 then by 5 is faster than enlarging once by 15. And because the algorithms
43 are different for the different scale factors, some faster than others,
44 the order matters too. For example, the following examples all produce
45 the same output -- an image 15 times bigger on edge than the input --
46 but at different speeds, each being faster than the one before.
47
48 .nf
49 \f(CW
50 $ pamenlarge -scale=15 test.pbm
51 $ pamenlarge -scale=5 test.pbm | pamenlarge -scale=3
52 $ pamenlarge -scale=3 test.pbm | pamenlarge -scale=5
53 \fP
54
55 .fi
56 .PP
57 The special fast cases for factors up to 10 have existed since Release
58 10.50 (March 2010). The special cases for 1, 2, 3, and 5 go back to Release
59 10.41 (December 2007). Before 10.41, there are no special scale factors and
60 PBM enlargement is significantly slower than today for all scale factors.
61 .PP
62 \fBpamenlarge\fP can enlarge only by integer factors. The slower
63 but more general \fBpamscale\fP can enlarge or reduce by arbitrary
64 factors. \fBpamscale\fP allows you to enlarge by resampling, which
65 gives you smoother enlargements. But it is much slower.
66 .PP
67 \fBpamstretch\fP is another enlarging program that enlarges by
68 integer factors. It does a simple kind of resampling that gives you a
69 smoothed enlargement with less computational cost.
70 .PP
71 \fBpbmreduce\fP can reduce by integer factors, but only for PBM
72 images.
73
74 .UN arguments
75 .SH ARGUMENTS
76 .PP
77 As with most Netpbm programs, you can give the input file name as an
78 argument or omit that argument and have it come from Standard Input (and
79 you can specify '-' for the argument to specify Standard Input
80 explicitly).
81 .PP
82 You can also specify the scale factor as an argument, for backward
83 compatibility, but the preferred way to do that is with a \fB-scale\fP
84 option, because it is easier to remember and read that way. The scale factor
85 argument goes before the file name argument.
86
87
88
89
90 .UN options
91 .SH OPTIONS
92 .PP
93 In addition to the options common to all programs based on libnetpbm
94 (most notably \fB-quiet\fP, see
95 .UR index.html#commonoptions
96 Common Options
97 .UE
98 \&), \fBpamenlarge\fP recognizes the following
99 command line options:
100
101
102 .TP
103 \fB-scale=\fP\fIinteger\fP
104 .TP
105 \fB-xscale=\fP\fIinteger\fP
106 .TP
107 \fB-yscale=\fP\fIinteger\fP
108 These specify the scale factor. \fB-xscale\fP specifies the horizontal
109 scale factor; \fB-yscale\fP specifies the vertical scale factor
110 and \fB-scale\fP specifies both.
111 .sp
112 If you specify \fB-xscale\fP but not \fB-yscale\fP, \fBpamenlarge\fP
113 does not scale vertically (i.e. the vertical scale factor is 1). The converse
114 applies if you specify \fB-yscale\fP and not \fB-xscale\fP.
115 .sp
116 You cannot specify \fB-scale\fP and also \fB-xscale\fP or \fByscale\fP.
117 .sp
118 You must specify at least one of these options, unless you use the
119 deprecaated method of specifying the scale factor via argument.
120 .sp
121 These options were all new in Netpbm 10.86 (March 2019). Before that, use
122 the scale argument.
123
124
125
126
127 .UN history
128 .SH HISTORY
129 .PP
130 \fBpamenlarge\fP was new in Netpbm 10.25 (October 2004). It is
131 designed as a replacement for \fBpnmenlarge\fP by Jef Poskanzer,
132 which was in Pbmplus as far back as 1989. The major difference is that
133 \fBpamenlarge\fP can enlarge PAM format images in addition to PNM.
134
135
136 .UN seealso
137 .SH SEE ALSO
138 .BR "pbmreduce" (1)\c
139 \&,
140 .BR "pamscale" (1)\c
141 \&,
142 .BR "pamstretch" (1)\c
143 \&,
144 .BR "pbmpscale" (1)\c
145 \&,
146 .BR "pnmsmooth" (1)\c
147 \&,
148 .BR "pnm" (1)\c
149 \&
150
151 .UN author
152 .SH AUTHOR
153
154 Copyright (C) 1989 by Jef Poskanzer.
155 .SH DOCUMENT SOURCE
156 This manual page was generated by the Netpbm tool 'makeman' from HTML
157 source. The master documentation is at
158 .IP
159 .B http://netpbm.sourceforge.net/doc/pamenlarge.html
160 .PP