ElmaStat 1.1 - The program to admire your Elma times

Sample times are included, but are fictious :)

Installation:

Copy the program to a subfolder in the Elma folder, then create a save folder
inside.

General notes:

The program is absolutely hungary-oriented, some great features are only avialable
for hungarians, but that may change. The program currently supports up to 100
players, but the first two positions are reserved for WR and another record (for
Hungarian Records originally). The first 10 players are shown in a different color
in multiplayer mode, so you can check your times easily. Currently internal levels
and OLP is supported, but I'm working on another way to handle external levelpacks.
The program has two modes, single player and multiplayer, but let's see first the
common functions.

* Player name input is case sensitive (eg. PeXi and not pexi! :)

* Gaps between times are shown in various colors:

under 100%: Flashing white
100%-110%:  Bright green
110%-125%:  Dark green
126%-150%:  Yellow
151%-175%:  Red
176%-200%:  Bright blue
over 200%:  Dark blue (hey, you have such a time? :P)

By pressing 'D' you can switch coloring mode according to Elma Target Times:

World Class: Bright green
Professional: Dark green
Good: Yellow
OK: Red
Beginner: Bright blue
Lamer: Dark blue

* If you press ESC, the program saves and quits (if you do not wish to save,
  use Control-C instead)

* Press 'I' to read and process stats.txt. Only those players' times are processed
  who have a column in the program. If the player has a better time than in the
  current database, that time is updated. Then the program sorts the players
  between 10-100 by their totals. At last, the program updates the first two
  positions (WR and another R) by these times. (eg. if someone have a time that is
  better than the WR for that level in the database, that time is updated).

Single player mode:

In single player mode, there are 4 columns on the screen. The first three are player
or record times, in the fourth column you see the gap between two columns. At the
bottom of the screen you see the totals (Internal, OLP and the sum of these two).
You can navigate with the cursor keys and PgUp/PgDn. You can choose the two columns
to compare by selecting one with the cursor keys (totals are yellow in this column)
and selecting the other one by TAB/SHIFT-TAB (The player's name is yellow). Most of
the functions are only available in this mode.

* Press 'N' to give a name to the selected column (name is max. 16 chars long, but
  you can save it only in 8.3 format cause of DOS)

* Press ENTER to give a time manually (be warned, if you write something crazy, just
  like 2:94.00, the program will normalize it, in this case to 3:34.00). The biggest
  time you can enter is 9:59.98. Levels with no time are counted for 10 minutes in
  total (just like in Elma).

* Press 'S' to save a column (it is saved to the save folder with .tim extension)

* Press 'L' to load a column. If the program does not find name.tim, it tries to
  read name.pel (the format of ElmaTimes)

* Press 'R' to delete a players' times, or SHIFT-R to delete times and name.
  You have to enter the players' name to confirm.

* You can select the current player by pressing +/- or ALT and +/-.

* Press 'F' to find a player. Just give enough letters to find the player (eg. if
  you type M, the first name beginning with M will appear)

* Press 'X' to save the current column to an ElmaTimes .pel

* Press 'M' to switch to multiplayer mode. If you press SHIFT-M, the program will
  jump to the selected level.

The multiplayer mode is for comparing your times to masses of people. The program
displays all players (or not, but I'll talk on that later) who finished the current
level, of course sorted from the best to the worst. The first two positons (records)
are not numbered. The level number is shown in the uppermost row in the center.

* Press +/- or ALT and +/- to select the level to display.

* Press 'G' to quickjump to a level (1-54: Internal, 55-90: OLP levels)

* Press 'T' to jump to the Internal totals. Press + then for OLP totals.

* Press 'A' to enter the player display selection screen (phew :). You see there
  all players, and by pressing ENTER you can toggle whether they are displayed or
  not. Press 'I' to invert the whole list, 'S' to show all, 'H' to hide all players.
  You can choose from 10 different settings by pressing 1-0. Press ESC to exit this
  screen.

* Finally, press 'X' (if you wish) to save all times from current level to a file in
  the programs directory called xxlevel.txt (xx stands for the number of the level).
  You can use this file for example to make a nice graph in Excel.

That's for now, but this program improves continuously.

COPYRIGHT, Warranty and other stuff:

This program is freeware. You can freely copy, modify or delete it etc. If you use this
program (or any part of it) for any purpose, please give credit to me!
You use the program at your own risk, I am not responsible for any damage, loss of profit
etc. caused by the program.

ElmaStat (C)2001-2002 Joe Cool

Other info, bugs, plans etc.

* If you have Elmastat <1.0 (but I don't think you have), you can read .tim-s saved by
  that, but you cannot read elmastat.dat.

* Importing sometimes do not work at first, keep pressing 'I'. Another problem is that
  occasionally it screws up some new times with 1 second. You can manually fix it by
  removing the times ('R'), then press 'I' again, and it should be fine.

* I am planning to support another external level packs through levstats.txt.

Update, support, bugreport, ideas:

Elmastat has no homepage at all, send email to get contact.

E-mail: jc@mail.datanet.hu

If you want to report a bug, please send elmastat.dat and the description of the bug.
Importing should work fine, but if not, send stats.txt, too.

Play Elma, not just brag with your times!
