Debian Codegraph @

upstream/debian-unstable/man1/pamstretch.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 "Pamstretch User Manual" 1 "02 February 2019" "netpbm documentation"
7
8 .SH NAME
9 pamstretch - scale up a PNM or PAM image by interpolating between pixels.
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpamstretch\fP
15
16 [\fB-xscale=\fP\fIX\fP]
17
18 [\fB-yscale=\fP\fIY\fP]
19 [\fB-blackedge\fP]
20
21 [\fB-dropedge\fP]
22
23 \fIN\fP
24
25 [\fIinfile\fP]
26 .PP
27 You can use the minimum unique abbreviation of the options. You can use
28 two hyphens instead of one. You can separate an option name from its value
29 with white space instead of an equals sign.
30
31 .UN description
32 .SH DESCRIPTION
33 .PP
34 This program is part of
35 .BR "Netpbm" (1)\c
36 \&.
37 .PP
38 \fBpamstretch \fP scales up pictures by integer values, either
39 vertically, horizontally, or both. \fBpamstretch \fP differs from
40 \fBpamscale\fP and \fBpamenlarge\fP in that when it inserts the
41 additional rows and columns, instead of making the new row or column a
42 copy of its neighbor, \fBpamstretch\fP makes the new row or column an
43 interpolation between its neighbors. In some images, this produces
44 better looking output.
45 .PP
46 To scale up to non-integer pixel sizes, e.g. 2.5, try
47 .BR "pamstretch-gen" (1)\c
48 \& instead.
49 .PP
50 Options let you select alternative methods of dealing with the right/bottom
51 edges of the picture. Since the interpolation is done between the top-left
52 corners of the scaled-up pixels, it's not obvious what to do with the
53 right/bottom edges. The default behavior is to scale those up without
54 interpolation (more precisely, the right edge is interpolated only vertically,
55 and the bottom edge is interpolated only horizontally), but there are two
56 other possibilities, selected by the \fB-blackedge\fP and \fB-dropedge\fP
57 options.
58 .PP
59 In the special case that the stretch factor is 1, there is no issue with
60 the right and bottom edges, the edges of the output are identical to the edges
61 of the input regardless of \fB-blackedge\fP and \fB-dropedge\fP. However,
62 before Netpbm 10.86 (March 2019), \fB-dropedge\fP would cause the edge to be
63 dropped even where the stretch factor was 1.
64
65
66 .UN parameters
67 .SH PARAMETERS
68 .PP
69 The \fIN\fP parameter is the scale factor. It is valid only if
70 you \fIdon't\fP specify \fB-xscale\fP or \fB-yscale\fP. In that
71 case, \fBpamstretch\fP scales in both dimensions and by the scale
72 factor \fIN\fP.
73 .PP
74 Before Netpbm 10.86 (March 2019), 1 was not a valid value.
75
76
77 .UN options
78 .SH OPTIONS
79 .PP
80 In addition to the options common to all programs based on libnetpbm
81 (most notably \fB-quiet\fP, see
82 .UR index.html#commonoptions
83 Common Options
84 .UE
85 \&), \fBpamstretch\fP recognizes the following
86 command line options:
87
88
89 .TP
90 \fB-xscale=\fP\fIX\fP
91 This is the horizontal scale factor. If you don't specify this, but do
92 specify a vertical scale factor, the horizontal scale factor is 1.
93 .sp
94 This option was new in Netpbm 9.21 (December 2001).
95
96 .TP
97 \fB-yscale=\fP\fIY\fP
98 This is the vertical scale factor. If you don't specify this, but
99 do specify a horizontal scale factor, the vertical scale factor is 1.
100 .sp
101 This option was new in Netpbm 9.21 (December 2001).
102
103 .TP
104 \fB-blackedge\fP
105 interpolate to black at right/bottom edges.
106
107 .TP
108 \fB-dropedge\fP
109 drop one (source) pixel at right/bottom edges. This is arguably
110 more logical than the default behavior, but it means producing output
111 which is a slightly odd size.
112
113
114
115 .UN limitations
116 .SH LIMITATIONS
117 .PP
118 Usually produces fairly ugly output for PBMs. For most PBM input
119 you'll probably want to reduce the `noise' first using something like
120 .BR "pnmnlfilt" (1)\c
121 \&.
122
123 .UN seealso
124 .SH SEE ALSO
125 .BR "pamstretch-gen" (1)\c
126 \&,
127 .BR "pamenlarge" (1)\c
128 \&,
129 .BR "pamscale" (1)\c
130 \&,
131 .BR "pnmnlfilt" (1)\c
132 \&
133
134 .UN author
135 .SH AUTHOR
136 .PP
137 Russell Marks (\[email protected]\fP).
138 .SH DOCUMENT SOURCE
139 This manual page was generated by the Netpbm tool 'makeman' from HTML
140 source. The master documentation is at
141 .IP
142 .B http://netpbm.sourceforge.net/doc/pamstretch.html
143 .PP