Online Documentation Amiga Formula One

HOFPoints by Michal Janak

              Wellcome to

         HOFPoints, Version 3.8
     (C) 1995-1998 Bc.  Michal Janak
           All Rights Reserved



               Important        Shareware & registering
              Introduction      About this program and distribution
               Disclaimer       Important note
              Requirements      What you need
             How it use it      How use program
                History         Past and future
               Greetings        Thanks to some persons
                 author         My address and something about me


   (I must apologize to all for my not very good english)


important

        HOFPOints is SHAREWARE.


    In this version isn't program cripled (all functions are working). But
there is requester with 10s delay on start and at the end of program.

  If you are using this program frequently or you want version without
waiting, please send shareware fee by snail mail to author

   UK pounds          2   (preffered)
   DM                 5
   CZK               90   

(I think,that this isn't too much for my spent time in developing this program)

  ( Or equivalent way is send me registered version of your program
    but after agreement with me )

   After you register I will send you last version and I will send to You
automaticaly new versions in future.

           !!! registered version  you can get only by E-mail !!!
           !!! DO NOT copy registered version to other people !!!

  You can freely distribute this
program, but you can not change any part of this package and this
package must contain this files:

   HOFPoints               main executable
   HOFPoints.info          info file for executable

   HOFPoints.guide         amigaguide document
   HOFPoints.guide.info    info file for this guide

   HOFPoints.dat           datafile for HOFPoints
                           (this file do not edit by hand (in word editors))


   HOFPoints.pic           document picture

   fonts draver containing  Ruby 15 & DBfont 8


Introduction

HOFPoints is a utility for competitors of the Amiga HOF
(Hall of Fame), that calculates and displays points, which you reach.

In first line is track info. There is track number, track
name and length of track in metres. On the next line is best time done
in the HOF (track record), your best time, your points and
time difference between record and your time. In next line is number called
"need points". I must explain this. When I want to be placed to 10th place
(for example), you can see in the last HOF results that on 10th place has
someone 224 points. then you need at least 224 points to be placed on 10th.
   I spent much time on looking for best method for calculating need points
for every track. But I found it and it works well. There is calculation:

                                 /   Px                      \
need points for track = points + |  ---- * (need points-SUM) |
                                 \    S                      /

        where   points.....your current track points
                Px.........( 1 - (points/20) )
                S..........Sum of P1 to P16

  From these need points for tracks are calculated time which you need for 
this number of points and time difference between needed time and your time.
In the next row is points difference between needed points and your current
number of points (your score) and the total number of points that you get in
the HOF (but only if record stay unchanged). In last line are positions on
tracks and position in HOF in all.
    Your times and score can be printed on printer too.


      This program is available from me, newest version
is available on my home page: 

      http://www.geocities.com/MotorCity/Garage/2064/

or at Oliver Roberts web pages:

        http://defstar.gre.ac.uk/~oliver/AmigaF1.html

      (Amiga Formula One pages is place where you can find many
important informations an many useful programs)


Disclaimer

               DISCLAIMER
               ----------

   I AM NOT RESPONSIBLE FOR ANY DAMAGE OR LOSS OF
DATA, WHETHER OR NOT CAUSED BY USING THIS PROGRAM.
              USE THIS PROGRAM ON YOUR OWN RISK.


Requirements



    Any Amiga (In this time tested only on My A1200 2MB Chip, 130MB HD and
on A1200 +Blizzard IV +8MB FAST RAM
    and  +Blizzard 1240 T/ERC +16MB FAST RAM)

  Ruby 15 and DBFont 8 in
FONTS:directory (included in package), file called hofpoints.dat in S:
directory (or where you want if you use TOOLTYPE or CLI argument ).


Starting program



    This program can be started from WorkBench or from CLI

     from CLI
     --------

 If you start this program without
parameter (only HOFPOINTS and RETURN), program will be loading
datafile called hofpoints.dat from S:directory.

  If you want use file with your own name or placed on another place
  type:

     HOFPpints  

 (for examle  dh1:simulators/F1GP/HOFPoints dh1:data/hofpoints.dat
dh1:docs/hof2202.guide)

You can use both parameters or one of them.

     from WORKBENCH
     --------------

  Click on program icon.
 there are two TOOLTYPE's (for this time, something will
be added in near future) called

   DATAFILE

  (for examle DATAFILE=dh1:data/hofpoints.dat)

  GUIDEFILE

  (for examle GUIDEFILE=dh1:documents/hof2202.guide)


  If you do not determine the guide file, the ASL requester will be opened


Using

          Use of program
          --------------

       After start you can see the window ( doc picture ).


            There are some buttons

  +-------------------------------------------------+
  | Track info:  1 USA                   3668 m     |
  |                                                 |
  |  input:                      AMIGA HOF          |
  |-------------+------------+---------+------------|
  |  Best time | Your time |  Points | Time diff. |
  |   1:13.663  |  1:15.475  |  10.40  |  + 1.812   |
  |-------------+------------+---------+------------|
  |   Need Points  |  Need time       | Time diff. |
  |      224        |  1:14.785        |  + 0.690   |
  |                 |------------------|------------|
  |   Points diff.  |                               |
  |    + 83.08      |     SUM= 140.92 Points        |
  +-----------------+-------------------------------|
  | Track pos 15     HOF pos 15     positions      |
  +-------------------------------------------------|
  |                                                 |
  |  Track    1  2  3  4  5  6  7   8       | 
  |  select   9 10 11 12 13 14 15  16       | 
  |                                                 |
  |    LOAD       SAVE      PRINT       QUIT    |
  +-------------------------------------------------+


Best time

   After pressing this button you will be asked for input
new time in input gadget. In input gadget you write only
seconds (instead 1:13.333 only 13.333)


Your time

   After pressing this button you will be asked for input
new time in input gadget. (only seconds  instead 1:13.456  13.456) time
must be between 0 and 59.999. If this time is better than Best time, then
the best time will be set to this value too.

   If you have not done time for some tracks, please type time 59.998 in
input window for this tracks.


Need time

     After pressing this button you will be asked for
input of points you wat to have as score (posible value is between 0-minimum
and 320 - maximum number of points thats you can get ( 16*20=320 )).
     From this number are calculated times for each circuits.


Positions

   After this choice will be started reading of HOF.guide and from
your time and points in HOF will be calculated positions on every track
and position in HOF in all. The guide file must be original not altered
file, that every player of HOF obtain by E-mail from Edo. Place of this file
you can determine by TOOLTYPE or CLI argument. If is not this file
determined by one of way, then will be opened ASL requester. In time of
processing you can see in input window name of current processed circuit.

   This function is called before every printing to printer automaticaly


Track select

  this button is for selecting track, you want to see


  1  USA                      9  Germany
  2  Brazil                  10  Hungary
  3  San Marino              11  Belgium
  4  Monaco                  12  Italy
  5  Canada                  13  Portugal
  6  Mexico                  14  Spain
  7  France                  15  Japan
  8  Great Britain           16  Australia


LOAD

     By pressing this button will be reloaded
datafile from disk. This datafile must be placed in S: directory. Only if
you use TOOLTYPE in icon or CLI argument, you can place this file where you
want.


SAVE



     After pressing this button will be renamed originaldatafile to

  .bak and than will be saved last
data from program. This .bak file is for person who made some mistake and
want return back their data or for case of crash machine in time of saving
data. If you need data from .bak file, you must delete the datafile
and then raname datafile.bak do datafile (hofpoints.dat.bak to
hofpoints.dat)


PRINT


 After pressing this button and if you have printer conected and in ON state
       then w ill be printed somethig as this:



  HOFPoints output:   (Need points = 224)

 Your current HOF position is  15

 Nr.Track name Best time Your time Time dif. Points Need time Need dif. Pos
  1 USA        1:13.663  1:14.859  + 1.196   13.61  1:14.785 + 0.074    15
  2 BRAZIL     1:08.476  1:10.086  + 1.610   10.81  1:09.519 + 0.567    26
                               .
                               .
                               .
 16 AUSTRALIA  1:06.998  1:08.940   + 1.942    8.73  1:08.018 + 0.921    20
                                      /---------------------\
                                      | SUM = 172.49 Points |
                                      \---------------------/

                                    HOFPoints 3.8 by Michal Janak


QUIT



    This button will quit this program.

!!! Be sure, you saved changes before doing this operation !!!


History

   History:
   --------
   28-12-95  1.0  first version (in GFA-basic)
                  without mouse control
                  some bugs(font problem & problem with datafile)
   12-01-96  1.5  removed bug with datafile and added mouse control
   23-01-96  2.0  firt public version
                  rewiten to BlitzBasic2
   27-01-96  2.5  some graphics changes and added printings

   ??-02-96       lost source code due Harddisk failure.
   ??-02-96  2.6  not public released, rewriten from base
                  some cosmetics changes
   28-02-96  2.8  added printings of zeros in times(instead 1: 7.34
                  1:07.340), points (13.60 instead 13.6) (thanks to Alan
                  Strang for this idea)
                  added printing of differention between your score
                  and needed score.
                  From this version program using one TOOLTYPE
                  and one argument in cli.

                  not public released

   06-03-96   3.0 added calculation of your position on every
                  track and in HOF (only for registered users).
                  Some minor changes in code.

   09-11-96   3.7 changed calculation of points, because there is new rule
                  in HOF (107% rule)
                  New method of calculating needtime(for need points).
                  Before this change you coul get need time worse than
                  your actual record.


   10-04-98   3.8 Minor update. Only refflects changes of guidefile format
                  which caused HoFPoints fail on obtaining track positions
 


Greetings

   I thanks to following persons:

      Edo Nijmeier      -   for constructive critics

      Oliver Roberts    -   for placing my product on his web page
      &  Alan Strang    -   for some hints (addition of printig zeros
                            and positions in HOF feature)
      


Author

   If you have any suggestions, bug reports, some hints or money for me,
   let me know on my permanent home address:

                     Michal Janak
                     Vltavska 11
                     Brno   625 00
                     CZECH REPUBLIC

      You can contact me via E-mail at this address:

                chemont@chemont.anet.cz

    About me:

       I was studying 4 years on Electrotechnical University in my city. I am
living in Brno - Czech republic (small country in middle Europa). Most of my
free time I am playing F1GP and other simulators. I am watching all Formula
one races. My favourite driver was Damon Hill (and I am still hoping that
He will get another podium finish)

        Now I am working in factory as programmer.
        
       (I am too lazy for learning programming in assembler or C, this was my
first program made for use by other people)

  My other work:

    STRIPHTML
    =========
               
          Only CLI program which strips l html sequences from files. It
is good for DirectoryOpus or other configurable file managers. (Program can
handle multiple files)

    SendResults.rexx v2.5
    =====================

 Arexx script for participants of Amiga F1GP Internet Championship which are
sending results via YAM (freeware mail program).   


Converted on 07 Jun 1998 with RexxDoesAmigaGuide2HTML 2.1 by Michael Ranner.