AVI animation creator

0. Contents

This is the documentation of animmaker-0.4.2pre1.
   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 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.

From Arpi <arpi@...>
Date: Mon, 11 Nov 2002 15:32:59 +0100
Subject: animmaker+mencoder
 
Hi,
 
did you notice that mencoder can encode from TGA sequence directly? :)
('-mf on *.tga' or even '-mf on file%03d.tga' too)
 
<..>
Oops. Didn't know that :P
1.1.2003 But I couldn't get it working anyway, so I still need animmaker.

2. Usage

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

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)
    -a, --audio <filename>          Specify raw audio source (can be a pipe).
    -b, --byte                      Audio is 8-bit (default: 16-bit).
    -f, --fps <float>               Frame audio.rate (default: 25).
    -h, --help                      This help.
    -n, --mono                      Audio is mono (default: stereo).
    -o, --outfile <filename>        Specify the output file.
    -r, --rate <rate>               Specify audio rate in hertz (default: 44100).
    -s, --audiochunksize <seconds>  Specify audio spacing.
    -u, --buffer <integer>          Specify the output buffer size in kB.

You can also give the tga files in stdin, example:
 cat *.tga | animmaker -ogruu.avi -

No warranty whatsoever.
The program uses the colour depth and pixel resolution of the first image in the sequence (autodetected) as the parameters of the whole animation.

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 (link removed due to bandwidth concerns).
(Time for render total: 357 seconds; time for encode total: 239 seconds.)

For an example of what you might achieve when using tga streaming (stdin mode), see this example: beladum.avi (1.4 MB, divx4+mp3) (recorded from Tales of Phantasia in snes9x using animmaker as a slave).

If you wish to include audio with your animation, you can either use --audio option in animmaker or 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: Wed, 1 Jan 2003 21:35:32 +0200)
with docmaker.php (last updated: Tue, 13 Aug 2002 14:17:29 +0300)
at Wed, 1 Jan 2003 21:50:17 +0200