			UT 2003 Benchmark Readme file


Table of Contents
I. 	Introduction
II.	Installation
III.	Usage Instructions
IV.	Credits


Version Changes
1.31
-Fixed bug where loading a csv made by epic's batch file would cause a crash


1.30
-Initial public release



I.  Introduction
Ut2k3bench is a program written to help boost the rather limited benchmarking 
capabilities of Unreal Tournament 2003. It allow the user to create custom benchmark
scripts, view the results in text or graph form, as well as more advanced features. 
It works under windows 98/ME/2000/XP, and can work with the demo version of ut2k3 as
well as the full version. Ut2k3 bench reads its information directly out of the .csv
files created by the game.


II. Installation is very easy. Just run the ut2k3bench.exe file, it does not have to be
in any special location as it will find your installation of ut2k3 from the registry.  
.ubx files are benchmark scripts and can also be run from anywhere but it is best if you
put them in your ut2003/benchmark directory.

III.  For an easy graphical guide go to www.benscustomcases.com. However I will explain it briefly
here.  Creating and editing a script is very straight forward,  just click the new button
and it will open a new box.  Choose the ini files to use, choose some maps, choose the number
of seconds to run for each map (77 is default for botmatch for flyby just leave the number as 
default).  Note that if you are editing a script you can change the number of seconds by
double clicking on the map in the list box.  Also note that only certain maps actually have
flyby paths, so if you select flyby for a map that has no path, the game will just sit there
till the time expires. Flyby is more of a video card test as it just fly around the map.  
Botmatch is more cpu intensive as the computer has to calculate the AI for all the bots.  However
botmatch scores will vary slightly from machine to machine as the AI is calculated on the fly. 
    Running a script is also simple.  Just select the script from the listbox or browse for one.
The scripts in the listbox are located in the ut2003/benchmark directory.  Then select the resolution
you want to run at and hit the benchmark button.  After the game has finished benchmarking
you will be automatically taken to the results screen. 
    In the main results page you will see the text results of the benchmark.  First off it 
will list the system specs every time they change, so if you run 4 benchmarks on the same
system it will only list the system specs once (unless you change drivers).  The maps are
then displayed in the order in which they were run.  The maps are listed  with the most 
recent being at the top.  You can change the number of results you see by 
selecting the maximum results in the settings page.  The frames per second are listed 
minimum/average/highest.  The graphs are fairly self explanitory.  The bar graph lists high/average/low
framerates for the maps benchmarked. In graphs as well the results are listed from most recent
to oldest left to right.   The line graph lists the framespersecond for each second the benchmark
was running. The results are also listed here from most resent to oldest.  The two graphs are also 
color coordinated. The save results button just saves the results to a text file so you can
see them later.
   The settings page has some fun/interesting stuff on it.  1) Max results sets how many results will
be diplayed in the results page.  2) Setting the starting subframe simply sets when you want the 
benchmark to start counting results (default value is 10).  This allows you to cut out the beggining of the
benchmark when the fps is very low due to the game loading. (the default ut2003 benchmark cuts off
the first few subframes as well).  Minimum value for this is 1 and the max is 100.  Remember 30subframes = 1 second.
3)  The check box for average results by second is a very usefull thing.  By default ut2003 benchmark
checks the fps every 30th of a second.  So when you look at the results you will get greater highs and lower lows
because for a 30th of a second the game may be a bit slow/fast in redering the frame but for the rest of the
second it is ok.  Checking this box averages the 30 results per second and looks at those averages
for the highs and lows (this is more like fraps).  4) Managing results is pretty straightforward.  It allows
you to delete or load csv files on an individual or group basis. 5) Please note that every time you load
the benchmark the settings page is set back to defaults.

IV.  Credits
Programmed by the Slightly Lucid Association of Game Programmers or S.L.A.G.D
Main programmer = Nicao   email nicao@telus.net or grim_guenter@hotmail.com
website = www.telusplanet.net/public/grimreap 

+++My sponsor
www.benscustomcases.com
please visit his website.

+++Beta testers
Eldon "BoneRak" Kieper
Ben "Zeus" Heide
Gerry "LU" Dubinski

I would like to thank my beta testers for a job well done in helping me squash bugs.

+++Classes
CHScrollListBox   by Alen Talibov
This class helps to fix the bad horizontal scroll in normal listboxes

CIniEx by  Oscar Kogosov
Great class for writing and reading ini files

CGraph by Brian Convery
Cool class for drawing bar graphs (and others as well)

CGraphWnd by Paul Barvinko
Easy to use class for drawing complex line graphs

In case some of you don't know a class is a piece of computer code that helps to 
make programming jobs easier.

+++God
I know I couldn't have completed this benchmark without my Heavenly Father's help.

