NAME

       ppmfade - generate a transition between two image files using special effects

SYNOPSIS

       ppmfade        [-f        first.ppm]       [-l       last.ppm]       [-mix|-spread|-shift|
       -relief|-oil|-edge|-bentley|-block] [-base name]

DESCRIPTION

       This program is part of Netpbm(1).

       ppmfadegenerates a transition between either two input images or between one  input  image
       and  black.   You can use the 30 intermediate images generated to show a smooth transition
       between segments of a movie.  The input and output images are in the PPM format.   If  you
       specify  both  input  images, they should both be the same size.  If you want to fade from
       black to an image, specify only the last image.  If you want to  fade  from  an  image  to
       black,   specify   only  the  first  image.   ppmfade  names  the  resulting  image  files
       base.nnnn.ppm, where nnnn is a number varying between 0001 and 0030 and base is  what  you
       specify with via the -base option (default fade).

       Another way to convert by steps from one image to another is morphing.  You can use xmorph
       to do that.

OPTIONS

       In addition to the options common to all programs based on libnetpbm (most notably -quiet,
       see
        Common  Options  ⟨index.html#commonoptions⟩  ),  ppmfade recognizes the following command
       line options:

       -f first.ppm
              This is the image file (PPM format) to be used at the beginning of the  transition.
              If you don't specify this, the fade will start from black.

       -l last.ppm
              This is the image file (PPM format) to be used at the ending of the transition.  If
              you don't specify this, the fade will end with black.

       -mix   The two images are superimposed with the brightness of the first  image  decreasing
              from  full  to  none  and the brightness of the final image increasing from none to
              full.  The transition is quadratic in brightness  with  faster  transition  in  the
              beginning and slower at the end.

       -spread
              The pixels in the first image will be moved (spread) further and further from their
              original location and then moved into the proper location in the final image.  This
              is the default transition.

       -shift The pixels in the first image will be shifted further and further horizontally from
              their original location and then moved into the proper location in the final image.

       -relief
              The first image is faded to a Laplacian relief filtered version of the first image.
              This  is  then faded to a Laplacian relief filtered version of the second image and
              finally faded to the final image.

       -oil   The first image is faded to an "oil transfer" version of the first image.  This  is
              then  faded  to  an "oil transfer" version of the second image and finally faded to
              the final image.

       -edge  The first image is faded to an edge detected version of the first image.   This  is
              then faded to an edge detected version of the second image and finally faded to the
              final image.

       -bentley
               The first image is faded to a "Bentley Effect" version of the first  image.   This
              is  then  faded to a "Bentley Effect" version of the second image and finally faded
              to the final image.

       -block The first image is defocused to small blocks.  The small blocks  are  converted  to
              match  a  defocused version of the last image.  The block version of the last image
              is then focused to the final image.

       -base name
              This forms part of the output filenames, as described above.

EXAMPLES

       ppmfade -f teapot.ppm -l pyr.ppm

       Fade from teapot.ppm to  pyr.ppm  generating  fade.0001.ppm  to  fade.0030.ppm  using  the
       "spread" transition.

       ppmfade -l teapot.ppm

       Fade from black to teapot.ppm generating fade.0001.ppm to fade.0030.ppm.

       ppmfade -f teapot.ppm -base end

       Fade from teapot.ppm to black generating end.0001.ppm to end.0030.ppm.

SEE ALSO

       tontsc manual, sgifade manual, smart_vfr manual, xmorph manual, ppm(1)

AUTHOR

       Bryan Henderson, Olympia WA; April 2000

       Inspired  by and intended as a replacement for pbmfade (not a Netpbm program) by Wesley C.
       Barris.

DOCUMENT SOURCE

       This manual page was generated by the Netpbm tool 'makeman' from HTML source.  The  master
       documentation is at

              http://netpbm.sourceforge.net/doc/ppmfade.html