Who's The Winner
a Quake 3 Arena log analizer
written in Python.


Short documentation for WTW Version 1.0 release date 16-May-2000.

WTW is a new Quake 3 Arena log analizer written using Python scripting language.
WTW processes a Q3A log producing several HTML pages where you can find a lot of stats about your Q3A games.
Since Python is platform independent, WTW can be used several platform.
Note: at this time WTW is never been tested on Unix and Mac environment. It should works.
Following below there are installation on Windows platforms and usage instructions.


How to install:

Part 1: Installing.

1) Install Python 1.5.2 with additional Tcl/Tk support. The installer will prompt after installed Python
if you want to install Tcl/Tk support. Say yes, otherwise WTW will never work.
I suggest you to install Python in C:\Python and Tcl/Tk in C:\Tcl , you'll make easy a little job later.
I'll assume by now you've installed Python and Tcl/Tk in the paths above.
2) Extract the PIL archive where you want.You'll find 2 directories and 2 files. Simply copy them in Python installation path.
3) Extract WTW archive where you want.
Inside you'll find 4 directories (Bdf,templates,wtwimages,Docs) and 3 files (wtw.pyw,wtwcore.pyc,wtwsetup.bat).
When you open wtwsetup.bat with your preferred text editor you'll see the two first line:

set PYROOT=C:\Python
set TCLROOT=C:\Tcl


Simply replace these paths if you've chosen different installation paths and cat entire content to the end of
autoexec.bat.
Reboot Windows.

Part 2: Usage.

To execute WTW simply open the directory extracted from the installation archive and double click wtw.pyw
to execute WTW. You can make a shortcut if you prefer.
When WTW is started you'll see a gui like this:





First you had to select a Q3A log to process. Click the Browse button on the top right side and a file requester appear.
Search for the log usually inside baseq3 directory in your Q3A installation path.
After you selected the log can store this path clicking on the Save button on the bottom side, so the next time you'll restart
WTW will be shown on the entry field near the Browse button.
Now you should be ready for processing. Simply click the Go! button to start processing your log.
Note:
Remember that WTW destroy all HTML pages from a previous log processing, but never delete a Q3A log.
When WTW processing Q3A logs, makes a lot of stuffs, among other things drawing graphs for each games (major overhead).
On my Celeron 466 a 1.5Mb log containing 87 games is processed in 1 minute and 12 seconds.
You can see processing status on the middle bar of the gui in percentual measure.

After WTW processed a Q3A log, simply double click index.html inside WTW directory to view games stats.
The HTML pages produced are best viewed with Netscape Communicator.
To exit simply click the Quit button.
Enjoy.


Bugs:
Even WTW is been tested, some logs can reveal an hidden bug.
If so, WTW got stuck (i.e. the progress indicator show the same percentual number for a long time or the HD led is off etc.).
If this happen, click on the X button on the top right side of the titlebar to kill WTW.
Rename wtw.pyw to wtw.py and restart WTW. You'll see a Python console window and the gui opening togheter.
Restart WTW with the log caused the trouble. When WTW got stuck again some messages will be showned on the console
window. Cut & Paste all messages and send to me via email in a text file with the log in a zip file
so I can discover the problem.
Thanks.

Giampaolo "RainCloud" Russo.