AVI animation creator

0. Contents

This is the documentation of animmaker-0.2.6.
   1. Purpose
   2. Usage
   3. Povray example
   4. Limits
   5. Features
   6. To do
   7. Copying
   8. Contribute!
   9. Requirements
   10. Installation
   11. Downloading

1. Purpose

Creates an unindexed raw AVI from a stack of uncompressed RGB24 Targa files (the ones generated by POV-Ray are accepted perfectly).

After having a raw AVI file generated by animmaker, you can encode it to DivX with MPlayer, like this:

mencoder foo.avi -o foo2.avi -divx4opts br=800:q=5:key=25
Or if you prefer libavcodec instead of divx4linux and two-pass encoding (enhances the quality/size ratio), you can do it like this:
mencoder foo.avi -o foo2.avi -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=800:vhq:vpass=1
mencoder foo.avi -o foo2.avi -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=800:vhq:vpass=2
Refer to the mencoder documentation to see how you can add audio, use different codecs, tune the compression parameters etc. Note that not all codecs support two pass encoding, which is completely optional anyway.

2. Usage

This is animmaker-0.2.5
Copyright (C) 1992,2002 Bisqwit (http://iki.fi/bisqwit/)

Usage: animmaker [<option> [<...>]] <file> [<...>]

This software assumes the files are uncompressed rgb24 tga files.

Options:
    -@, --list <filename>     Read input file names from the given file.
    -V, --version             Displays version information.
    -X, --xflip               Flip horizontally (not default)
    -Y, --yflip               Flip vertically (default)
    -f, --fps <float>         Frame rate (default: 25).
    -h, --help                This help.
    -o, --outfile <filename>  Specify the output file.

No warranty whatsoever.

3. Povray example

This is an example of making an animation in povray as DivX.
$ cat >animmakerdemo.pov <<EOF
plane { y,-1 pigment { checker rgb 1, rgb .5 } }
sphere { 0,1 pigment { rgbf .8 } finish { specular 0.3 ambient 0.3 } interior { ior 1.3 } }
camera { location x*10 look_at 0 angle 35            rotate y*360*clock    }
light_source { 0, 1 fade_power 2 fade_distance 10
               looks_like { sphere { 0,0.2 pigment { rgb 1 } finish { ambient 1 } } }
               translate <6,1,0> rotate y*360*clock*-4
             }
EOF
$ povray +w320 +h200 +kff300 +ft +ianimmakerdemo.pov
$ animmaker -f20 -oanimmakerdemo.avi animmakerdemo???.tga
$ mencoder animmakerdemo.avi -o animmakerdemo1.avi -divx4opts br=400:q=5:key=100 -pass 1
$ mencoder animmakerdemo.avi -o animmakerdemo2.avi -divx4opts br=400:q=5:key=100 -pass 2
Result is a nice looping animation.
(Time for render total: 357 seconds; time for encode total: 239 seconds.)

If you wish to include audio with your animation, add -audiofile <filename> to your mencoder commandlines.
See the manual pages of each programs regarding the use of them.

4. Limits

5. Features

6. To do

These features might be implemented some day:

7. Copying

animmaker has been written by Joel Yliluoma, a.k.a. Bisqwit,
and is distributed under the terms of the General Public License (GPL).
Some features contributed by Warp.

If you happen to see this program useful for you, I'd appreciate if you tell me :) Perhaps it would motivate me to enhance the program.

8. Contribute!

You can contribute! My email address (sigh) is: bisqwit at iki dot fi.

9. Requirements

GNU make is probably required.

10. Installation

$ make
$ su
# make install
If you do not want to install libargh (included in the archive), do not use "make install" and edit Makefile and enable the STATIC linking instead of DYNAMIC.

11. Downloading

The official home page of animmaker is at http://oktober.stc.cx/source/animmaker.html.
Check there for new versions.

Generated from progdesc.php (last updated: Mon, 12 Aug 2002 17:33:20 +0300)
with docmaker.php (last updated: Fri, 19 Jul 2002 16:42:54 +0300)
at Mon, 12 Aug 2002 17:33:32 +0300