diff options
Diffstat (limited to 'ppmfade.html')
| -rw-r--r-- | ppmfade.html | 173 |
1 files changed, 173 insertions, 0 deletions
diff --git a/ppmfade.html b/ppmfade.html new file mode 100644 index 00000000..2d1c8eb6 --- /dev/null +++ b/ppmfade.html @@ -0,0 +1,173 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> +<HTML><HEAD><TITLE>Ppmfade User Manual</TITLE></HEAD> +<BODY> +<H1>PPMFADE</H1> +Updated: April 1, 2000 +<BR> +<A HREF="#index">Table Of Contents</A> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +ppmfade - generate a transition between two image files using special effects + +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>ppmfade</B> +[<B>-f</B> <I>first.ppm</I>] +[<B>-l</B> <I>last.ppm</I>] +[<B>-mix</B>|<B>-spread</B>|<B>-shift</B>| +<B>-relief</B>|<B>-oil</B>|<B>-edge</B>|<B>-bentley</B>|<B>-block</B>] +[<B>-base</B> <I>name</I>] + +<A NAME="lbAD"> </A> +<H2>DESCRIPTION</H2> + +<p>This program is part of <a href="index.html">Netpbm</a>. + +<p><b>ppmfade</b>generates 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. <B>ppmfade</B> names the resulting image files +<I>base</I><B>.</B><I>nnnn</I><B>.ppm</B>, where <I>nnnn</I> is a +number varying between 0001 and 0030 and <I>base</I> is what you +specify with via the <B>-base</B> option (default <B>fade</B>). + +<P>Another way to convert by steps from one image to another is +morphing. You can use <B>xmorph</B> to do that. + +<A NAME="lbAE"> </A> +<H2>OPTIONS</H2> + +<DL COMPACT> +<DT><B>-f</b> <i>first.ppm</i> + +<DD> +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. + +<DT><B>-l</b> <i>last.ppm</i> + +<DD> +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. + +<DT><B>-mix</B> + +<DD> +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. + +<DT><B>-spread</B> + +<DD> +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. + +<DT><B>-shift</B> + +<DD> +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. + +<DT><B>-relief</B> + +<DD> +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. + +<DT><B>-oil</B> + +<DD>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. + +<DT><B>-edge</B> + +<DD> +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. + +<DT><B>-bentley</B> + +<DD> 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. + +<DT><B>-block</B> + +<DD> +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. + +<DT><B>-base</B> <I>name</I> + +<DD> +This forms part of the output filenames, as described above. + +</DL> + +<A NAME="lbAF"> </A> +<H2>EXAMPLES</H2> + +<B>ppmfade -f teapot.ppm -l pyr.ppm</B> + +<P> +Fade from teapot.ppm to pyr.ppm generating fade.0001.ppm to fade.0030.ppm using +the "spread" transition. + +<P> +<B>ppmfade -l teapot.ppm</B> + +<P> +Fade from black to teapot.ppm generating fade.0001.ppm to fade.0030.ppm. + +<P> +<B>ppmfade -f teapot.ppm -base end</B> + +<P> +Fade from teapot.ppm to black generating end.0001.ppm to end.0030.ppm. + +<A NAME="lbAG"> </A> +<H2>SEE ALSO</H2> + +<B>tontsc</B> manual, +<B>sgifade</B> manual, +<B>smart_vfr</B> manual, +<B>xmorph</B> manual, +<B><A HREF="ppm.html">ppm</A></B> + +<A NAME="lbAH"> </A> +<H2>AUTHOR</H2> +Bryan Henderson, Olympia WA; April 2000 + +<p>Inspired by and intended as a replacement for <b>pbmfade</b> (not a +Netpbm program) by Wesley C. Barris. + +<HR> +<A NAME="index"> </A> +<H2>Table Of Contents</H2> +<UL> +<LI><A HREF="#lbAB">NAME</A> +<LI><A HREF="#lbAC">SYNOPSIS</A> +<LI><A HREF="#lbAD">DESCRIPTION</A> +<LI><A HREF="#lbAE">OPTIONS</A> +<LI><A HREF="#lbAF">EXAMPLES</A> +<LI><A HREF="#lbAG">SEE ALSO</A> +<LI><A HREF="#lbAH">AUTHOR</A> +</UL> +</BODY> +</HTML> |