\
.\" 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" 1 "02 February 2019" "netpbm documentation"

.SH NAME
pamstretch - scale up a PNM or PAM image by interpolating between pixels.

.UN synopsis
.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 description
.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 \fB-blackedge\fP and \fB-dropedge\fP options.
.PP
In the special case that the stretch factor is 1, there is no issue with
the right and bottom edges, the edges of the output are identical to the edges
of the input regardless of \fB-blackedge\fP and \fB-dropedge\fP.  However,
before Netpbm 10.86 (March 2019), \fB-dropedge\fP would cause the edge to be
dropped even where the stretch factor was 1.
  
  
.UN parameters
.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.
.PP
Before Netpbm 10.86 (March 2019), 1 was not a valid value.
  

.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
\&), \fBpamstretch\fP recognizes the following
command line 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.
.sp
This option was new in Netpbm 9.21 (December 2001).
  
.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.
.sp
This option was new in Netpbm 9.21 (December 2001).

.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 limitations
.SH LIMITATIONS
.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 seealso
.SH SEE ALSO
.BR "pamstretch-gen" (1)\c
\&,
.BR "pamenlarge" (1)\c
\&,
.BR "pamscale" (1)\c
\&,
.BR "pnmnlfilt" (1)\c
\&

.UN author
.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