Solar Warrior/Xain'D Sleena Emulator v1.0 (April 5, 1998)
Written by Carlos A Lozano and Rob Rosenbrock

For information on the latest version, please see the
Official Web Page: http://www.parlorcity.com/bester/main.html/
=============================================================================


Introduction
============

This emulator allows you to play the original arcade version of Technos
Japan's Xain'D Sleena game on a MS-DOS or Windows 95 based PC.

There are two other versions of Xain'D Sleena: Solar Warrior and Soldier of
Light. Soldier of Light was released in the UK and appears to be identical
to Xain'D Sleena in all areas but the name on the cabinet. Solar Warrior
differs from the other two by changing the name on screen and removing the
players choice of which planet to go to.


Game Rules
==========

Your mission is to defend the solar system from the Empire invasion.

Pick up power pellet for additional fire power.

Damage gauge indicates strength of your shield, it is reduced when you are
hit by the empire's soldiers.


Development PC
==============

The emulator was developed on the following platform:
 * Cyrix P150 Pentium compatible Microprocessor
 * MS-DOS 6.2 and Windows 95
 * 32MB of RAM
 * Matrox Mystique video Card with 4MB SGRAM
 * Sound Blaster 16 sound card

At this time, requirements have not yet been determined.

The 15 bit video mode is designed according to VESA 2.0 standards. If your
video card is not supported, you can try Scitech's Display Doctor (see
http://www.scitechsoft.com)


ROM Image Files
===============

As with any other emulator, this emulator requires ROM images from the arcade
board. ROM images for these games cannot be distributed with the emulator
due to legal reasons.

For Xain'D Sleena, the following images should be in the XAIN subdirectory:
  1.ROM, 2.ROM, 3.ROM, 4.ROM, 5.ROM, 6.ROM, 7.ROM, 8.ROM, 9.ROM, 10.ROM
  11.ROM, 12.ROM, 13.ROM, 14.ROM, 15.ROM, 16.ROM, 17.ROM, 18.ROM, 19.ROM
  20.ROM, 21.ROM, 22.ROM, 23.ROM, 24.ROM

For Solar Warrior, the following images should be in the SOLAR subdirectory:
  P0-0.BIN, P1-0.BIN, P2-0.BIN, P3-0.BIN, P4-0.BIN, P5-0.BIN, P6-0.BIN
  P7-0.BIN, P8-0.BIN, P9-0.BIN, PA-0.BIN, PB-01.BIN, PC-0.BIN, PD-0.BIN
  PE-0.BIN, PF-0.BIN, PG-0.BIN, PH-0.BIN, PI-0.BIN, PJ-0.BIN, PK-0.BIN
  PL-0.BIN, PM-0.BIN, PN-0.BIN, PO-0.BIN, PP-0.BIN, PQ-0.BIN, PR-0.BIN
  PS-0.BIN

If you are in doubt about the files you have, I recommend Thierry Lescot's
ROMIDENT program. This program has the ability to identify many ROMs and
tell you the proper filename.

NOTE: Do not ask me for ROMs, or how/where to get them.

All of the above ROM images are copyrighted by Technos Japan, Taito, and/or
Memetron.


How to run the Emulator
=======================

Create a directory containing XS.EXE and XS.CFG

Make sure your ROMs are in the right sub-directory:
   XAIN    For Xain'D Sleena
   SOLAR   For Solar Warrior

Run XS with the -solar and/or -sound options.


Command Line Options
====================

Start the emulator by typing:
  XS [-solar] [-sound]

solar         Run Solar Warrior
sound         Enable sound emulation
15            Use 15-bit VESA graphics mode

Note: Entering XS without any parameter will start Xain'D Sleena without
sound by default.


XS.CFG
======

All of the options normally selected with switches on the board are selected
using the XS.CFG file.

The file is ASCII text and may be edited using any text editor from edlin to
a word processor. Each section in the file is fully commented.


Controls
========

There are three ways to control Xain: Keyboard, Joystick, and the V-Stick.
I recommend using the V-Stick for maximum playability (and preserving your
keyboard.)

+---------------+----------------------+--------------+--------------+
|               |       Movement       |     Fire     |    Thrust    |
+---------------+----------------------+--------------+--------------+
|   Keyboard    |      Arrow keys      |     CTRL     |      ALT     |
|               |    E, S, D, F keys   |      N       |       B      |
+---------------+----------------------+--------------+--------------+
|   Joystick    | move joystick around |   Button 1   |   Button 2   |
+---------------+----------------------+--------------+--------------+
|   V-Stick     |    Either Joystick   | Inner button | Outer button |
+---------------+----------------------+--------------+--------------+

The following keys can be used while the emulator is running:

ESC         Quit

1           Start button #1
2           Start button #2
3           Coin input #1
4           Coin input #2


Known Problems
==============

Text flashes green during the game, and the colors don't look exactly right.

    The Xain'D Sleena arcade machine is capable of showing 512 colors
    simultaneously, whereas the standard VGA card can only show 256.  To get
    around this, the emulator uses a scheme to reduce the number of colors
    used by referencing previously defined palette registers.

    Consequently, when the palettes are used up, an incorrect color gets
    substituted for the text.

    Use the 15-bit VESA mode for the best results.  (-15. See Command Line
    Options)


The game runs too fast/slow.

    The arcade game uses a hardware clock as a timebase, and we are
    currently ignoring it. This will be fixed in the future.


There is no sound.

    Sound is turned off by default. (See the next problem) To hear the sound,
    use the -sound command line option.


The sound doesn't sound quite right.

    The sound registers aren't being set correctly and speed of the sound
    emulation isn't correct.

    We are still working on sound. We just didn't want to hold this emulator
    back for something so minor. For now, sound is off by default.
    

The game freezes on occasion.
    
    This occurs when two of the microprocessors emulated fall out of synch
    and are waiting on each other. This may happen at any point, and it might
    not happen during the course of a game.  When this happens, you must exit
    the game.

    We are working to solve this problem, but it may involve a major rewrite
    of the emulator.


When running Solar Warrior, some of the scenery is missing.

    Solar Warrior uses an embedded microprocessor on the board as copy
    protection. I suspect that the missing scenery is coming from this
    microprocessor, which is not yet emulated by this emulator.


Miscellaneous Notes
===================

YM2203 routines were written originally by Ishmair.

This emulator started as a repair for a board! One thing led to another...

The emulator was developed using DJGPP by DJ Delorie.  This is a
freeware C/C++ compiler that is available from the Delorie Software web site
(http://www.delorie.com).


Distribution
============

This emulator is freeware: a gift. It was not written to provide anyone
with a product to sell. It should only be distributed in the original ZIP
file and not with any ROM images. It should not be included in any CD or
collection without prior consent.

Anyone using the emulator does so at their own risk.  We will not be held
liable for any loss or damage arising from its use.


Special Thanks
==============

I'd like to thank the following people for their advice, suggestions, and
information.

 Jonathon Dawes
 Thierry Lescot
 Lewin A R Edwards
 Ishmair

And a special thanks to Carlos. If it wasn't for Carlos, this emulator
would still be just an idea.


Update History
==============

Version 1 (April 5, 1998)
 * Correct Color
 * Partial Sound
 * Joystick Control
 * Support for Solar Warrior

Alpha (February 22, 1998)
 * Graphics Routines Implemented
 * Keyboard control
