f1gp.library 35.2 (8.2.97)
Copyright  1995-1997 Oliver Roberts, All Rights Reserved.
This library and the developer files are freely distributable.

  If you use f1gp.library in your program, please give me credit by
  mentioning in the documentation that I wrote the library and retain
  the copyright.  Thank you.


DISTRIBUTION CONTENTS

  README        - this file
  test          - example program
  test.c        - C source for example program
  History.txt   - revision history
  libs/         - the library itself
  doc/          - autodoc
  include/	- C and assembler include files
  fd/		- .FD file


DESCRIPTION

  This library is currently used by add-on programs for MicroProse's F1GP
  game including F1GP-Ed, SplitTime, AGPPerf and AGPLapTime.

  f1gp.library is a small library which provides 4 interface functions which
  allows detection of F1GP and any program to be notified when F1GP quits.
  There is also a function which can calulate the correct file checksum.

  The functions can be used after a Exec OpenLibrary(), and before your
  program quits you MUST close the library.  F1GPBase must also be declared,
  and the library base also has a few fields that can be read by your
  program (see include/libraries/f1gp.h).

  EXAMPLE (see test.c for longer example)

     struct F1GPBase *F1GPBase;
     if (F1GPBase = (struct F1GPBase *)OpenLibrary("f1gp.library",35))
        CloseLibrary((struct Library *)F1GPBase);


  In addition to detecting F1GP the f1gpDetect() function will patch the
  following in F1GP (offsets refer to standard version):

    Offset     Bytes replaced        Description
    ------     --------------        ------------
    $8dc        4                    JSR before quit
    $9cc        4                    JSR before quit
    $a7e        4                    JSR before quit
    $26dd1      11 (permanent)       Lap time calulation fix (Grant's)
    $76d1e      4  (permanent)       JSR _LVOScreenToFront(A6) => NOPs
    $76d82      4  (permanent)       JSR _LVOScreenToFront(A6) => NOPs

  Replacements marked with "permanent" are not restored when the library
  is expunged.

  See f1gp.doc for descriptions of each function.  Include files for C and
  Assembler are supplied, and need to be used.  The proto/f1gp.h file was
  created for use with DICE C, and the pragmas/f1gp_pragmas.h file was
  generated with DICE's fdtopragma, but should be compatible with other
  C compilers.


AUTHOR

  f1gp.library was programmed by F1GP-Ed author, Oliver Roberts.

   E-mail: Oliver@POBoxes.com
      WWW: http://www.nanunanu.org/~oliver/

  Address: 30 Tillett Road
           Norwich
           NR3 4BJ
           England
