AVI animation creator

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.

This is animmaker-0.4.2.4
Copyright (C) 1992,2003 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)
    -a, --audio <filename>          Specify raw audio source (can be a pipe).
    -b, --byte                      Audio is 8-bit (default: 16-bit).
    -f, --fps <float>               Frame 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.

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

(See options for libavcodec in the previous section if you don't like divx4linux)
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.

• All input tga files must be the same resolution.
• Only uncompressed bgr24/bgr16/bgr15 tga files are accepted.
• The resulting avi will not contain index.
• Resulting avi may not be bigger than 2 GB.
• Only raw audio is accepted, and the soundtrack can only have 1 or 2 channels and can only be 8-bit or 16-bit.

If you have jpeg files instead of tga, no problem!
Have ImageMagick installed, and do this:

for s in *.jpeg;do convert ./"$s" tmp.tga;cat tmp.tga;done | animmaker -Y -o tmp.avi -

This will produce an avi from jpeg files.

• Any frame rate can be selected between 0.00023 and 1000000 fps.
• Any number of frames is accepted (though the OS may limit the number of parameters).
• tga files can be read from stdin too.

This is my program! I make what I want! :)
So these features are mostly for my own use, but it might be worth documenting them. Here goes...

I'm working on streamability.
This works:

cat *.tga \
| animmaker -o- -f25 - \
| mencoder - -o tmptmp.avi -ovc lavc -lavcopts vbitrate=400:vhq

What use can this be for?
Well, now programmers have a nice way to produce compressed video clips by simply popen'ing that kind of command.
Now, as mencoder doesn't support named pipes or multiple stdins, see the next item.

So if you want to give the tga stream and audio both from stdin, try this:

cat *.tga | animmaker -otest.avi -f25 - '-a-#3' 3<test.raw

Okay, the syntax isn't pretty, but it works :)
-a-#3 here means "read audio from file #3", and 3<test.raw tells the shell that test.raw should be redirected into file #3 of animmaker.
The same syntax also works for the tga stream fd and output filename.
What use can this be for?
Well, you can use this feature to stream audio and video simultaneously, if you are a developer.

These features might be implemented some day:

• Runtime conversion of any image format (using ImageMagick, obsoletes the requirement of tga files)
• libavcodec support
• mp3 audio input support

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.

You can contribute!

• Add new features, fix bugs! Modify the program (the source code!) and send me the patches.
• If you have a nice short (6-8 lines) povray animation scene to replace that crappy one of mine here on this page, you can send it to me too :)
• Tell me what you do with this program. I am interested.

My email address:

Joel Y

lilu

oma <

bisq

wit@

iki.

fi>

GNU make is probably required.

$ 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.

The official home page of animmaker is at http://iki.fi/bisqwit/source/animmaker.html.
Check there for new versions.