NAME

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

SYNOPSIS

       pamstretch [-xscale=X] [-yscale=Y]
       [-blackedge] [-dropedge] N [infile]

       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.

DESCRIPTION

       pamstretch  scales  up  pictures by integer values, either vertically, horizontally, or both.  pamstretch
       differs from pnmscale and pnmenlarge in that when it inserts the additional rows and columns, instead  of
       making  the  new  row  or  column  a  copy  of  its  neighbor,  pamstretch makes the new row or column an
       interpolation between its neighbors.  In some images, this produces better looking output.

       To scale up to non-integer pixel sizes, e.g. 2.5, try pamstretch-gen(1) instead.

       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 blackedge and dropedge options.

PARAMETERS

       The N parameter is the scale factor.  It is valid only if you don't specify -xscale or -yscale.  In  that
       case, pamstretch scales in both dimensions and by the scale factor N.

OPTIONS

       -xscale=X
              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.

       -yscale=Y
              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.

       -blackedge
              interpolate to black at right/bottom edges.
       -dropedge
              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.

BUGS

       Usually produces fairly ugly output for PBMs. For most PBM input  you'll  probably  want  to  reduce  the
       `noise' first using something like pnmnlfilt(1).

SEE ALSO

       pamstretch-gen(1), pnmenlarge(1), pnmscale(1), pnmnlfilt(1)

AUTHOR

       Russell Marks (russell.marks@ntlworld.com).

                                                11 November 2001                                   pamstretch(1)