H2Seq - by Baritonomarchetto

Please read the License.txt before using this program

=========================================================
Index:
=========================================================
1. Notes
2. Usage
3. FAQ
4. Change Log
5. Contacts

================================================================
1. Notes
================================================================
Thank you for downloading this program.

This software allows you to use two keyboard keys (arrow up and
arrow down by default) to sequentially send inputs to supported 
driving games requiring 4 buttons, one for each gear.

Since v1.8 also view changes are handled.

Supported games and emu's:

RacerMAME: Hard Drivin' and Race Drivin'
Elsemi Model 2 Emulator: any game
MAME: Hard Drivin',Race Drivin', Cruisn' USA, Cruisn' World

================================================================
2. Usage
================================================================
Run the program the first time to create a config.ini file. 
H2Seq will then close itself.

Assign in "config.ini" your preferred values for the 4 gears 
and the 4 views. 
Default values are:

1st gear ---> i
2nd gear ---> k
3rd gear ---> o
4th gear ---> l

view 1 ---> c
view 2 ---> v
view 3 ---> b
view 4 ---> n

THE SAME GEARS/VIEWS MUST BE ASSIGNED IN YOUR EMULATOR TO WORK!

If you are using RacerMAME, they are correctly mapped by default.

Define your preferred values for your actual inputs. 
Default values are:

Gear increase ---> Down Arrow
Gear decrease ---> Up Arrow
View change ---> z


After defining your preferred key values (optional) , run H2Seq, 
then your emu ... that's all.

By pressing sequentially "arrow up" or "arrow down" (default) 
you will cycle between your gears in the following sequences 
(assuming default values):

arrow down: i->k->o->l
arrow up:   i<-k<-o<-l

By pressing "z" (default) you will cycle between supported 
games views.

================================================================
3. FAQ
================================================================

Q - H2Seq doesn't work for me (or acts in a strange way...)!

A - check: are the gears equally mapped in both the emulator and 
H2seq (check config.ini)? This is true for the default 
configuration of both RacerMAME and H2Seq, but it's not for other 
MAME versions or Model 2 or other emu's. In addition, check if 
the default inputs for gear change are the actual buttons you 
are pressing! Are you actually running H2Seq before your emulator? 
The emulator (RacerMAME included) doesn't run it automatically! 
If you are experiencing a "strange" behaviour of your sent inputs 
(no or delayed inputs sent) try setting to "3" the "priority" 
option in config.ini (this is normally needed when a game is 
heavily stressing the CPU).

================================================================
4. Change Log
================================================================

v1.8 120723 - Added view cycling

v1.7 120713 - Main rewriting of the script.
	        Renamed "h2seq.ini" in "config.ini"
	        Now "config.ini" is created by the script. 	        

v1.6 120705 - Loop speed is now tunable with "sleeptime" option

v1.5 120704 - introduced prioritizing option

v1.4 120630 - auto clutch option is there!

v1.3 120629 - hard/race drivin' "hold" gears supported 

v1.2 120626 - some minor improvement and trial and error

v1.1 120624 - introduced "h2seq.ini"

v1.0 120623 - first private release

================================================================
5. Contacts
================================================================
For comments or suggestions please go to the site:
http://racermame.altervista.org
