Slutte! (Bligh version)
By Steven Frew (steven.frew@howden.com)
Official Slutte! website: http://www.geocities.com/SiliconValley/Haven/9015/
----------------------------------------------------------------------------

What's New
----------
Bligh version.
Scroll layer priority is now nigh-on perfect.
Game resolution is more accurate.
Added another screen mode (clipped 320x200).
Frameskip option implemented.
Palette intensity emulation altered a little. Still not perfect, though.
Fixed some graphics clipping bugs.

History
-------
31/03/98  Bligh
18/03/98  Beefheart
12/03/98  America
10/03/98  Ahab
04/03/98  Initial release

Disclaimer
----------
If Slutte! gives you any grief, don't blame me. It's free, please don't sell
it for cash, please don't distribute the ROMs with it, thou shalt not covet
thy neighbours ass, etc ... In short, I assume no responsibility for
anything. I am quite literally irresponsible.

What Slutte! does
-----------------
Slutte! emulates the 1987 Capcom arcade game, "Bionic Commando".

What Slutte! doesn't
--------------------
At this point, there are two known problems:

1.  No sound or music.
2.  Currently, Slutte! runs in a 256-colour display mode. Bionic Commando
    has a larger palette, so some graphics don't look right. This really
    only affects the text and small sections of levels 3 and 5.

How to use Slutte!
------------------
First of all, you need a set of Bionic Commando ROMs. These should exist in
a directory called "BionicC". The ROMs you need are:

Name             Size
TSU_01B.ROM      32,768      Z80 code (for YM2151). Currently not emulated.
TSU_02B.ROM      65,536      68000 code
TSU_03B.ROM      65,536
TSU_04B.ROM      65,536
TSU_05B.ROM      65,536
TSU_08.ROM       32,768      Character set
TS_11.ROM        32,768      SCROLL1 tiles
TS_12.ROM        32,768
TS_13.ROM        32,768
TS_16.ROM        32,768
TS_17.ROM        32,768
TS_18.ROM        32,768
TS_23.ROM        32,768
TS_24.ROM        32,768
TSU_06.ROM       32,768      SCROLL2 tiles
TSU_07.ROM       32,768
TSU_09.ROM       32,768      Sprites
TSU_10.ROM       32,768
TSU_14.ROM       32,768
TSU_15.ROM       32,768
TSU_19.ROM       32,768
TSU_20.ROM       32,768
TSU_21.ROM       32,768
TSU_22.ROM       32,768

Then you can run Slutte! with some options:

-? or /?        Displays a quick bit of info about these options.
-res xxx yyy    Specifies a VESA 2.0 resolution to use. You MUST have a VESA
                2.0 driver (or compatible graphics card) in order to use this
                option. The only VESA driver I know of is "SciTech Display
                Doctor", and a trial version of this is available on the net
                from www.scitechsoft.com. Bionic Commando runs in a 256x224
                resolution, so use a resolution close to that if you can. If
                you get a "VBE 2.0 not available" error, then you DON'T HAVE
                A VESA 2.0 DRIVER.
-modex          Use a 320x240 ModeX display. This should work with all VGA
                graphics cards, but it's not perfect: there's a bit of
                "shearing", even with the vsync enabled. This might get
                better as I investigate ModeX a little more thoroughly.
-vga            Use a clipped 320x200 mode. This mode should be available on
                all VGA graphics cards, and should be a lot faster than
                ModeX, but the top and bottom 12 pixels are not visible. This
                doesn't really affect the game much, though.
-k              Use keyboard controls. If you haven't used keyboard before,
                it'll automatically ask you to define the keys you want to
                use. Keyboard is selected as default.
-j              Use joystick controls.
-frameskip n    Skip every nth frame. Only values in the range 1 to 5 are
                accepted. Values outwith this range will be set to the
                relevant minimum or maximum.
-v ON/OFF       Enable or disable vsync. Default is OFF. If vsync is
                disabled, Slutte! runs as fast as possible.
-definekeys     Allows you to redefine your keys before the emulator starts.
-calibrate      Allows you to calibrate your joystick if Slutte! is reading
                it incorrectly. Values are written to Slutte!.CLB, so you
                only need to do this once.
               
When you run the emulator, it'll save your options into Slutte!.CFG. If you
want to use the same options again next time, just run Slutte! without any
parameters. Slutte! automatically reads Slutte!.CFG when it starts up, and
then overrides any options that it finds in that file with command line
options.

IMPORTANT: If your old config causes newer versions to go a bit funny, delete
Slutte!.CFG and reconfigure.

While the emulator is running, the following keys do the following things:

1             Insert a coin in the player 1 slot
2             Insert a coin in the player 2 slot
3             Start a one player game.
4             Start a two player game. Player 2 uses the same controls as
              player 1.
F12           Grab the screen as a PCX file.
Tab           Go to the dipswitch menu. While in the menu, cursor keys change
              the settings, and TAB takes you back to the game. Dipswitch
              values are saved into Slutte!.CFG when you exit the emulator.
Pause         Pause the game. Any key to restart.
Escape        Quit the emulator.

Credits
-------
Thanks to everyone who has sent me messages of encouragement since Slutte!
started.

Thanks to Jason Sizemore and Jason Fourier for betatesting.

Incredible amounts of gratitude to Shawn Hargreaves for the Allegro library.

Biggest thanks of all to Neill Corlett for his outstanding StarScream 68000
emulator.
