POV-Ray Push-Ball v1.0
**********************

Files in this package:

pushball.pov   - Run a game from here
pushball.inc   - The Push-Ball "engine"
pushball.txt   - This file
botinfo.txt    - File describing how to make your own bots
bot0.inc       - Example bot
bot1.inc       - Example bot
bot2.inc       - Example bot
bot3.inc       - Example bot
bot4.inc       - Example bot
bot5.inc       - Example bot
replay.pov     - File that renders final animations from data made by pushball.inc
match2data.inc - Example data that can be used by replay.pov

HOW TO USE PUSHBALL.POV
***********************

Start a render using the following command line option:

+kff500

That will start a match of 500 frames. You can't know how long the match will take,
but usually 500 frames is plenty. You can end the match at any time, for example
20 frames after there has been scored goal. The remaining frames are useless anyway.

You only need to use a very low output resololution, because it is a preview only.

+w160 +h120 -a

...is plenty.

Every time you want to start render a new match, you must first delete the file
"#pb_data.inc". It is only used for carrying data between frames, and can safely
be deleted.

Try using different settings for the game, and see the results.

When you have rendered a match that looks nice and interesting, you can render
the match as a final animation that looks much better graphically. Read on...

HOW TO USE REPLAY.POV
*********************

When you have rendered a nice match using pushball.pov, it is time to render it
as a final animation. You need the file "pb_output.inc" created by pushball.pov.

Open "pb_output.inc" in a text editor. In the very end of the file, add a " } "
(without the quotes).
Also, at the end of one of the last lines, there's a comment with a number.
That number you must copy, and paste it in place of the "XXX" in line 10.

Now your data file is ready! You may want to save it under a different name,
so it won't be overwritten next time you render a match.

Open "replay.pov". Include the file with your game data.

You can also try to use the datafile "match2data.inc", which is included
in this package.

Now you can start to render your animation!
Typical command line settings would be something like:

+kff200 +w320 +h240 +a0.3

...but you can adjust everything just as you like! You don't have to use
the same number of frames you used when you made your data file.

MAKING YOU OWN BOT
******************

See botinfo.txt

When you have made your own bot, you can test it against other bots by
modifying the settings in "pushball.pov". Have fun!

**************************************************

POV-Ray Push-Ball copyright 2000 Rune S. Johansen.

rune.johansen@iname.com - http://rsj.mobilixnet.dk