summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man1/pamstretch.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/pamstretch.1')
-rw-r--r--upstream/opensuse-leap-15-6/man1/pamstretch.1123
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