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.