
     ********	 **    ******  *******	       ********        **
     **        ****   **       **    **        **	       **
     ** 	 **  **        **    **        **	       **
     *****	 **  **  ****  *******	 ****  *****	  *******
     ** 	 **  **    **  **	       **	 **    **  V1.02
     ** 	 **   **   **  **	       **	 **    **
     ** 	 **    *****   **	       ********   *******


CONTENTS
--------
   - Introduction
   - Disclaimer
   - Copyright / Shareware
   - Distribution
   - Acknowledgements
   - Compatibility
   - Requirements
   - Getting Started
       From Workbench
       From Shell
   - Quickstart Guide
   - Known Problems
   - Reference
       Team Editor
       Driver Editor
       Swapping and Copying
       Colour Editor
       Level Button
       File Types
       Defaults
       Your Car
       Preferences
       F1GP Preferences
   - Contacting the author
   - History


INTRODUCTION
------------
   Welcome to the public release of the F1GP Editor for the Amiga.
   With this editor you can customize your copy of F1GP (or World Circuit)
   by designing cars, pit crews and helmets and by changing the way the
   computer drivers drive and respond, amongst other things.

   I have supplied an example datafile which will convert your copy of
   F1GP, so it plays like the real-life 1994 season at a more realistic
   speed!  It also contains my recent car setups.  Try it and see.


DISCLAIMER
----------
   I cannot be held liable if this program causes your copy of F1GP/World
   Circuit to become corrupt, nor can I be blamed if this program causes
   any other problems with your system.  Any problems are entirely the
   user's responsibility.  If you're binary becomes corrupt, then tough
   luck - don't go running to Microprose for a new copy!

   ***** IMPORTANT *****
   Please use a backup of the game, before you start altering the binary.
   Then you will have another copy of the game if it gets corrupted (ie
   power failure when saving).	F1GP-Ed is designed for original versions
   of F1GP, so go and buy the original now if you have not already done
   so.


COPYRIGHT / SHAREWARE
-------------------
   F1GP-Ed V1.02 - written in C on a humble A600 with no HD
   (c) Oliver Roberts, 1994
   [F1GP-Ed is not officially endorsed by Microprose]

   F1GP-Ed is SHAREWARE.  UK users are expected to send me at least 5 UK
   pounds (cheque or cash).  Non-UK users should send me an IMO
   (International Money Order) for 5 pounds sterling or $10 US.  If this
   is not viable then send me $10 US in notes.

   You are not entitled to any updates from me, the 5 UK pounds fee is
   purely there to guarantee newer versions (come on, 5 pounds is not
   very much is it?).  Please feel free to send me more than that if
   you think it appropriate.  Registered users will be put on a list, so
   they can send me more suggestions/bugs without having to pay again!

   The more money I get will determine if I shall release newer versions
   with more features.	This version has not been disabled in any way,
   but there are some more features that *could* be added.  Here are some
   of the possibilites:

   * Adjustment of the tyre grip of the cars
   * Setting the HP of your car
   * Altering the probability of a wet race

   So if you want to see more features added, make sure you send me the
   SHAREWARE fee.  Feel free to send me suggestions you might have, for
   future versions - along with your SHAREWARE fee, or I will ignore
   the suggestions, however good they are!

   Send the shareware fee to me at the following address:

      30 Tillett Road
      Norwich
      Norfolk
      NR3 4BJ
      ENGLAND


DISTRIBUTION
------------
   F1GP-Ed is freely distributable providing none of the distributed files
   are changed in any way,  F1GP-Ed is not sold for profit and it is not
   included on any disks that are sold solely for profit.  If F1GP-Ed is
   to be sold for profit, permission must be obtained from me, the author
   (Oliver Roberts).  Included in the above are magazine coverdisks.  You
   are reminded that F1GP-Ed is shareware (see above).

   For following files MUST be distributed together:

   F1GP-Ed	      (Main Program)
   F1GP-Ed.info
   F1GP-Ed.doc	      (Document)
   F1GP-Ed.doc.info
   1994.f1gp	      (Datafile for 1994 settings)
   1994.f1gp.info

   included in the original distribution are:

   reqtools.library
   gadtools13.library


ACKNOWLEDGEMENTS
----------------
   Formula One Grand Prix  (c) 1991,1992 Geoff Crammond
			   (c) 1991,1992 Microprose

   Reqtools.library	   (c) 1991-1994 Nico Francois

   Gadtools13.library	   (c) 1992-1993 Jaba Development


   Thanks to the these people for testing the beta versions of F1GP-Ed,
   and giving me new ideas:

   Glenn Durden, Anthony Holloway, Seppo Typpo, Jim Harmon, Dev,
   Gregory Gladwell, Lionel Vintenat, Robert Doyle, Geoff Seeley,
   Mathias Kegelmann, Mike Andrews, Neil Turner, Tero Turtiainen and
   Blair Yake.

   Thanks also go to Microprose (and Geoff Crammond) for creating a
   great game and giving me permission to release this editor.


COMPATIBILITY
-------------
   F1GP-Ed has been tested on the following machines:
   A500, A500+, A600, A1000, A1200, A2000, A3000, A4000/030

   With the following kickstarts being put to test:
   1.1, 1.2, 1.3, 2.04, 2.05, 3.0, 3.1

   A number of memory configurations, accelerators, HDs, etc, were also
   used.

   So, as F1GP-Ed is fully OS-Legal, it should work on ANY Amiga!


REQUIREMENTS
------------
   Any Amiga.  NTSC / PAL

   A copy of Formula One Grand Prix / World Circuit by Microprose - this
   must be version 1.02 (I think this is the only version available - if
   not then contact me, and I will add support for other versions).

   Kickstart 1.2/1.3:
      gadtools13.library
      reqtools.library (any version for 1.3)
      icon.library

   Kickstart 2.0 and above:
      asl.library (on workbench disk)
       OR
      reqtools.library (any version)


GETTING STARTED
---------------
From Workbench
--------------
   There are two ways of running F1GP-Ed from Workbench:

     (1) Double-click on the F1GP-Ed icon.  The default F1GP values will be
	 used if no prefs file exists.	If a prefs file does exist and the
	 autoload feature is enabled, the datafile of your choice will
	 loaded automatically.

     (2) Double-click on a F1GP-Ed datafile icon.  F1GP-Ed will be loaded
	 and the selected datafile will be loaded.

From the Shell
--------------
   Again there are two ways of running F1GP-Ed:

     (1) Type `F1GP-Ed' at the prompt to load F1GP-Ed the same way as the
	 Workbench (1), mentioned above.

     (2) Type `F1GP-Ed <filename>' where <filename> is the datafile of
	 your choice.  This file will then be loaded into F1GP-Ed.


QUICKSTART GUIDE
----------------
   If you want to convert your copy of F1GP so that it uses the 1994.f1gp
   datafile supplied with F1GP-Ed, then here is all you need to do:

   * Load F1GP-Ed as in the the above section

   * Select "Load" from the File menu

   * Select the "1994.f1gp" file and click on Load

   * Click on the "Write:" gadget so that it shows "F1GP Binary"

   * Select "Save" from the File menu

   * If you have an HD then select the "f1gp" file in the relevant drawer,
     otherwise just put F1GP disk 2 in any drive and click on Save

   * Read the message and click on OK

   * When disk activity is finished, reboot and load F1GP in the usual way

   This will provide you with an updated version of F1GP - you can also
   customize many other feature too.


KNOWN PROBLEMS
--------------
   * Race Lap Records do not seem to be registered when playing the game as
     Driver #40.  This is weird, as the Qualifying Records work fine, so
     don't play as Driver #40.

   * If F1GP-Ed crashes, especially after (or during) using any of the file
     requesters, try specifying a larger stack in the icon or from the CLI
     using the 'stack` command.  This should not happen, but if it does
     please contact me, telling my exactly what you did and what happened.


REFERENCE
---------
Team Editor
-----------
   Team Name: Name of the selected team

      Engine: Name of the team's engine.

	  HP: Horsepower setting for the team's cars.  This will determine
	      how quickly computer controlled cars can accelerate.  Values
	      between 0 and 1400 are accepted.	The higher the setting -
	      the faster the car will accelerate.

    Driver A: Use the slider to select a driver from the list of drivers
	      specified by you in the DRIVER EDITOR.  Legal values are
	      0-40 (0 means that the car will not participate in any
	      events).

    Driver B: Select the second driver - as above.

   Global HP: This will increase/decrease all the cars HP setting by 20.

   Max Teams: This determines how many of the teams will actually be used
	      by F1GP.	You can select between 13 and 20 teams, but you
	      must have at least 26 drivers allocated to your chosen teams.

   *** Keyboard Shortcuts ***
   You may use the 6 and 7 keys to select the team.
   Kickstart 2.0+ owners may use the left/right cursor keys instead.

Driver Editor
-------------
   Name:      Name of the selected driver.

   Initially: Allow you to determine if a driver should automatically be
   Selected   selected when you load F1GP.  You must select at least one
	      Driver!

   Qual    :  How well a driver performs in Qualifying sessions.  This will
   Perform    determine how fast the actual driver is (not taking the HP
	      setting of the car into account).  Low values will ensure
	      that the driver will driver reasonably well, and high values
	      will result in the driver spinning off too often.  This also
	      affects how quickly the driver accelerates.  Range: 0-255.

   Race    :  How well a driver performs in a Race.  Details as above.
   Perform

   Global  :  This will increase/decrease all the cars Qual and Race
   Perform    performances by 10.

   *** Keyboard Shortcuts ***
   You may use the Y and U keys to select the driver.
   Kickstart 2.0+ owners may use the up/down cursor keys instead.

Swapping and Copying
--------------------
   There is a facility to copy or swap drivers/teams.  To do this click
   on the one you want to copy/swap, then click the copy/swap button,
   then click on the second one, then click the copy/swap button again to
   perform the operation.

Colour Editor
-------------
   The colour editor allow you to change the colours of the cars, helmets
   and pit crews.  There is a separate editor for each of the above, but
   each works in the same way:

   Select the part you would like to change from the list on the left of
   the screen, and then change it to the desired colour by clicking on the
   respective colour in the palette gadget.

   You can also change the colour of all major parts by clicking the 'ALL'
   button.

   You can also tell the editor to Hilight the selected part, so you know
   where it is (there is a choice of 2 colours).  Turn it on and off using
   the appropriate gadget.

   *** Keyboad Shortcuts ***
   The editor has shortcuts for selecting parts and colours.  The
   up/down cursor keys will select a part, and the left/right will select
   the colour.

   *** Car Editor Note ***
   You should be aware that the style of the car of the first team is
   different from all the others.  The first team has a car with a
   different nose design (ie McLaren style nose).

   *** Please Note ***
   It is best not to change most of the attributes which are marked with
   a question mark.  Feel free to change these, but they will generally
   make the color scheme look ridiculous.  Some of the unknown values may
   represent something in the Ed, but not necessarily in the game!

Level Button
------------
   The text in the level button is what will appear instead of the "1991
   Levels" button on the Race Options menu in F1GP.

File Types
----------
   F1GP-Ed can currently save your settings in two ways.  You can either
   save the settings to an F1GP-Ed datafile (cannot be loaded by F1GP) or
   directly to the "f1gp" file on Disk 2 of the game.

   You can also load settings from a datafile and direct from
   the "f1gp" file on Disk 2.

   In addition, you can also read/write F1GP name files, read F1GP
   "Current Car Setups" files (ie global setups) and read F1GP lap records
   files.  Therefore, you can save your car setups and lap records directly
   to the binary.

   When you load a car setups file into F1GP-Ed, the "Separate Qual/Race
   Setups" flag will automatically be set depending on the format of
   the setup file (ie F1GP saves the position of the switch all setup
   files).

   *** HD Users ***
   Instead of using Disk 2, select the "f1gp" in the directory in which it
   is stored on your HD.

Defaults
--------
   There are 2 options on the extras menu which allow you to reset some
   of the settings to the default values.  The default values are the
   ones used in F1GP as normal.  You can reset the car setups and/or
   the speeds (HP and Performances).  You can set everything to default
   by switching off the Autoload feature on the Prefs menu.

Your Car
--------
   When humans are driving the cars, the car will always have a constant
   HP setting, regardless of the values specified in F1GP-Ed.

Preferences
-----------
   The preferences menu allows you to decide whether the Hilight mode of
   Colour Editor is automatically activated whenever you load the editor.

   You can also ask F1GP-Ed to save an icon with the datafiles you save.

   It also allows you to specify a datafile which you would like to be
   loaded automatically instead of using the default F1GP names and cars.
   This is called the AUTOLOAD feature.

   Select the "F1GP Preferences" option to access the F1GP prefs window.
   (see next section)

   Finally, you must select "Save Prefs" on the menu to save your choices
   to the configuration file.  Current directories and filenames will
   also be saved for added convenience.  The prefs file will be saved in
   s:

F1GP Preferences
----------------
   Default : This is the directory/volume that F1GP will use for save
   Dir	     games, etc.  The default is DF0: .  Very useful for HD users
	     whose drives are not called DH0: !

   Quick   : The circuit which F1GP will use for Quick Races and for the
   Race      default selection on the circuit select menu.

   Keyboard: There are 3 choices:

		A600: As the A600 does not have a numeric keypad you
		      can now use the 'BackSpace' key to return to
		      your cockpit (instead of the 'Home' key).
		      As yet, I have not worked out how to remap the
		      Other Action Replay key.

	       A1200: If you play F1GP with the keyboard (some people
		      do, you know!), then you will have discovered
		      that Commodore changed the way the keyboard works.
		      The computer will no longer recognise that you are
		      pressing 2 keys on the same row.	So, this option
		      will let you use the '2' key for accelerating,
		      the 'W' key for braking, the ':;' key for steering
		      left and the '@#' key for steering right.

	    STANDARD: As the name suggests, the default keys are used.

   Analogue: Determines whether the you wish to use an Analogue Joystick
   Joystick  by default.  If you "check" this option, then you must enter
	     the correct calibration figures for your joystick.  These
	     are displayed when you calibrate it in F1GP.  If you do
	     not enter the correct figures, then you will have to
	     calibrate in F1GP as usual.

   All the others are the same as the ones in F1GP itself.  The driver
   aid settings (ie Auto Brakes/Gears) correspond to the settings in the
   Help Options menu in F1GP - so they will still be deactivated when
   playing at higher levels.


CONTACTING THE AUTHOR
---------------------
   You can contact me via e-mail at this address:

      robeoy@essex.ac.uk

   Or via snail-mail, my permanent home address is:

      30 Tillett Road
      Norwich
      Norfolk
      NR3 4BJ
      ENGLAND


HISTORY
-------

V0.1 Beta - 15 April 1994

This version was not released, as it didn't support KS 1.x.
----------------------------------------------------------------------------
V0.2 Beta - 17 April 1994

First release of the Editor - for beta testers only.
Added reqtools support to enable 1.x users to load and save.  2.0+ users
can still use asl.library if they want.
----------------------------------------------------------------------------
V0.21 Beta - 18 April 1994

The editor now removes protection from the "f1gp" file automatically,
removing the need to use the protect command from AmigaDOS.
----------------------------------------------------------------------------
V0.3 Beta - 21 April 1994

Added Support for loading car setups into datafiles and an 'ALL' button
in the Colour Editors.	Alot of the code was also optimized.  The way
the graphics data is stored has now changed, saving 40K of memory which
was previously wasted!	Have now added keyboard shortcuts.  Also added
an option to change the level button and reset to default options.

Bug Fixes: No longer assumes topaz font is being used - layout adjusted
     accordingly.

     Failed to load the Autoload file specified in Prefs - fixed.

     File routines for Kickstart 1.x users now work 100% of the time.

     When using reqtools all the Confirmation requesters seemed to
     work (except when they caused the machine to lock!), but
     theorectically, whichever option the user clicked - it should
     always have selected Cancel - but it didn't (very strange!).
     I think this is why the machine crashed sometimes when quitting,
     saving, etc - should now be fixed.

     Fixed the current colour indicator under 1.x and also the
     'Selected on startup' checkbox is now displayed as well as
     possible under 1.x (there must be a bug in gadtools13.library)
----------------------------------------------------------------------------
V0.4 Beta - 6 May 1994

Changed the the max HP values to 2131 - this is the maximum F1GP can cope
with.  The minimum performance value has changed from 0 to 1, due to a few
problems the 0 causes.

Added Global Performance buttons.

Added a new prefs menu option which allows the user to preset the: default
dir, fast windows, animations, analogue joystick attributes and all the
other major options in the Help/Game/Race options menus in F1GP.  You can
now select the keyboard layout from 3 presets.

Bug Fixes: Found out why the busy pointer was not appearing on pre-2.0
     machines.	There is a bug in KS1.2/1.3 - F1GP-Ed now relizes
     this and the busy pointer is OK.

     Removed the problem of having to have driver #5 selected
     (English version).  They is now total control over what drivers
     are selected.
----------------------------------------------------------------------------
V1.0 - 22 May 1994

First public release of F1GP-Ed.  Found out how to use the whole 20 teams -
users can now have between 13-20 teams.  A few cosmetic changes.  Put the
minimum performance settings back to 0 again, and reset the maximum HP
to 1400, as higher values caused problems.  Added a "Save Icons" feature,
which saves an icon with datafiles.  Added an Iconify (Zoom) gadget to the
F1GP-Ed window (KS 2.0+).

Bug Fixes: The Analog Joystick setting did not initialize properly in the
	   bin.  It should do now.

	   Sorted out a few bugs in the keyboard routines for the GUI.

	   Imposed a limit of a minimum of 26 drivers, as F1GP crashes
	   if there are less.

	   Removed the necessity of having to have a stack of 8192, F1GP-Ed
	   now works fine on the default stack size (4096).

	   Changed the keyboard controls for the A1200 again, as they
	   still did not work 100% (due to C='s redesign of the keyboard
	   matrix on the A1200).

	   Serious bug in the load prefs routine - if autoload was not
	   enabled, the car setups did not initialize - meaning that all
	   the setup values (ie wings, gears) were 0, causing F1GP to
	   completely mess up!

	   Bug in the calls to draw the Bevel boxes, worked fine in early
	   versions - but now the call is completly legal.

	   Slight bug when first loading a file with no drivers in team 1,
	   now fixed.
----------------------------------------------------------------------------
V1.01 - 23 May 1994

Added dynamic stack allocation, so that the stack would never overflow
causing requesters to crash.
----------------------------------------------------------------------------
V1.02 - 30 May 1994

Discovered that F1GP-Ed did not work with World Circuit, so support is now
included.  Also added another confirmation requester to make sure users
don't overwrite the wrong files.  Altered the colour editor palette
slightly.

F1GP-Ed is now compiled as registerized, which means it is more efficient
and slightly faster.
