dwww Home | Manual pages | Find package

Ppmfade User Manual(1)      General Commands Manual      Ppmfade User Manual(1)

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

SYNOPSIS
       ppmfade  [-f  first.ppm]  [-l   last.ppm]   [-mix|-spread|-shift|   -re-
       lief|-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 gen-
       erated to show a smooth transition between segments of a movie.  The in-
       put 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 be-
       tween 0001 and 0030 and base is what you specify with via the -base  op-
       tion (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 ]8;;index.html#commonoptions\ Common Options]8;;\ ), ppmfade recognizes the fol-
       lowing 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  fi-
              nal  image  increasing from none to full.  The transition is qua-
              dratic 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 transi-
              tion.

       -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 fi-
              nal 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 pro-
       gram) 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

netpbm documentation             01 April 2000           Ppmfade User Manual(1)

Generated by dwww version 1.16 on Tue Dec 16 04:19:09 CET 2025.