diff options
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/pamstretch.1')
-rw-r--r-- | upstream/opensuse-leap-15-6/man1/pamstretch.1 | 123 |
1 files changed, 123 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/pamstretch.1 b/upstream/opensuse-leap-15-6/man1/pamstretch.1 new file mode 100644 index 00000000..8e9cf5c5 --- /dev/null +++ b/upstream/opensuse-leap-15-6/man1/pamstretch.1 @@ -0,0 +1,123 @@ +\ +.\" 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 "Pamstretch User Manual" 0 "11 November 2001" "netpbm documentation" + +.UN lbAB +.SH NAME + +pamstretch - scale up a PNM or PAM image by interpolating between pixels. + +.UN lbAC +.SH SYNOPSIS + +\fBpamstretch\fP + +[\fB-xscale=\fP\fIX\fP] + +[\fB-yscale=\fP\fIY\fP] +[\fB-blackedge\fP] + +[\fB-dropedge\fP] + +\fIN\fP + +[\fIinfile\fP] +.PP +You can use the minimum unique abbreviation of the options. You can use +two hyphens instead of one. You can separate an option name from its value +with white space instead of an equals sign. + +.UN lbAD +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBpamstretch \fP scales up pictures by integer values, either +vertically, horizontally, or both. \fBpamstretch \fP differs from +\fBpamscale\fP and \fBpamenlarge\fP in that when it inserts the +additional rows and columns, instead of making the new row or column a +copy of its neighbor, \fBpamstretch\fP makes the new row or column an +interpolation between its neighbors. In some images, this produces +better looking output. +.PP +To scale up to non-integer pixel sizes, e.g. 2.5, try +.BR "pamstretch-gen" (1)\c +\& instead. +.PP +Options let you select alternative methods of dealing with the +right/bottom edges of the picture. Since the interpolation is done +between the top-left corners of the scaled-up pixels, it's not obvious +what to do with the right/bottom edges. The default behaviour is to +scale those up without interpolation (more precisely, the right edge +is only interpolated vertically, and the bottom edge is only +interpolated horizontally), but there are two other possibilities, +selected by the \fBblackedge\fP and \fBdropedge\fP options. + +.UN lbAE +.SH PARAMETERS +.PP +The \fIN\fP parameter is the scale factor. It is valid only if +you \fIdon't\fP specify \fB-xscale\fP or \fB-yscale\fP. In that +case, \fBpamstretch\fP scales in both dimensions and by the scale +factor \fIN\fP. + +.UN lbAF +.SH OPTIONS + + +.TP +\fB-xscale=\fP\fIX\fP +This is the horizontal scale factor. If you don't specify this, but do +specify a vertical scale factor, the horizontal scale factor is 1. + +.TP +\fB-yscale=\fP\fIY\fP +This is the vertical scale factor. If you don't specify this, but +do specify a horizontal scale factor, the vertical scale factor is 1. + +.TP +\fB-blackedge\fP +interpolate to black at right/bottom edges. + +.TP +\fB-dropedge\fP +drop one (source) pixel at right/bottom edges. This is arguably +more logical than the default behaviour, but it means producing output +which is a slightly odd size. + + + +.UN lbAG +.SH BUGS +.PP +Usually produces fairly ugly output for PBMs. For most PBM input +you'll probably want to reduce the `noise' first using something like +.BR "pnmnlfilt" (1)\c +\&. + +.UN lbAH +.SH SEE ALSO +.BR "pamstretch-gen" (1)\c +\&, +.BR "pamenlarge" (1)\c +\&, +.BR "pamscale" (1)\c +\&, +.BR "pnmnlfilt" (1)\c +\& + +.UN lbAI +.SH AUTHOR +.PP +Russell Marks (\fIrussell.marks@ntlworld.com\fP). +.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/pamstretch.html +.PP
\ No newline at end of file |