 Ŀ               Ŀ
  XDRAGON 0.30- BAD DUDES ARCADE EMULATOR Ĵ 28 MARCH 1998 
 Ĵ DOCUMENTATION 
                                                  
                                                                   
   > by Nicolas Hamel & David Michel                              
    > http://purplesky.simplenet.com/emucamp/softs/xdragon.hts    
     > gouky@mygale.org                                           
                                                       Ŀ
                                                         I  N  D  E  X  
        
        
        > (1) INTRODUCTION ................  24
               (2) FEATURES ....................  48
               (3) COMMAND LINE ................  66          READĿ
               (4) ROMS LOCATIONS ..............  90          THE
               (5) CONFIGURING XDRAGON.INI ..... 102          DOCS
               (6) CONTROLS .................... 125
               (7) HISTORY ..................... 154
               (8) GREETS ...................... 167
               (9) CONTACT US .................. 186


        Ŀ
         (1) INTRODUCTION 
        

        This is our brand new emulator : xDragon. Our goal is to emulate
  as much Data East games as possible; for now 3 games are supported...

        xDragon is written in C and assembler, it uses the excellent
  Starscream 68000 engine of Neill Corlett and the great Allegro library
  of Shawn Hargreaves. All the rest has been written from scratch by us.

        New games has been added : Sly Spy and Midnight Resistance with
  the ADPCM sound FX.The music will  come  with the  next  version  :).
  As Robocop and Bad Dudes , just  the  second   FM chip    (YM2203) is
  not yet emulted, it can be noticed in Robocop    where they use it a
  lot to do sound FX.

        A little features is added too : the parallax scrolling( Take
a look at the Truck or Train level in Bad Dudes ). This scrolling
is used in many games, so we have added it just for your pleasure ;)

        xDragon saves now the joystick's calibration data. xDragon
  will run with every video card now ! But I think that you should
  use scitech display doctor who speed up the video function.
  A VSync and a double buffer has been added for more smooth scrolling.
  Finally there's now an auto frameskiper. And oh yeah xdragon now
  choose automaticly the correct video mode for your computer. If
  xDragon dont run then...buy a new computer ;)

        Remember that xDragon is not Window$ 95 friendly ! Run it under
  DOS to get full speed ! 

  NOTE: This emulator is totally FREEWARE, it cannot be sold.
  ----  It is provided as it, and we, the authors, are not responsible
        of ANY damages that can occur of the use of xDragon.

  NOTE: The stretch fonction eat a lot of time !
  -----

        Ŀ
         (2) FEATURES 
        

  * Games supported:
     - Bad Dudes VS Dragon Ninja
     - Dragon Ninja
     - Robocop
     - Sly Spy
     - Midnight Resistance
  * Full 68000 emulation, using Starscream
  * Full 6502 emulation (in ASM)
  * Horizontal and vertical scrolling supported
  * Background priorities supported
  * Players input (1 & 2) supported, using keyboard and joystick
  * ALL graphics parts coded in ASM.
  * Sprite supported at 99% (priority not perfect yet)
  * Sound FX supported. (ALL the games)
  * Music FM supported. (Not yet for Sly Spy&Midnight Resistance)

        Ŀ
         (3) COMMAND LINE 
        

  To run XDRAGON, use the following syntax:

      XDRAGON [options]

  Options are:

      -f x     : Set the frameskip to x.
      -calib   : Calibrate the joystick
      -demo    : Disable players inputs.
      -game x  : Run game x : 0 - Bad Dudes VS Dragon Ninja
                              1 - Dragon Ninja
                              2 - Robocop
                              3 - Sly Spy
                              4 - Midnight Resistance
      -?       : A little help.
      -test    : Set the "test mode" dipswitche.
      -vesa    : Use a 320*200*15k graphic mode
      -vesa2   : Use a 320*240*15k graphic mode.
      -vesa3   : Use a 400*300*15k graphic mode.
      -vesa4   : Use a 640*480*15k graphic mode.
      -stretch : Fit the image into screen (slow).


  NOTE: All these options can be preconfigured directly in the INI file.
  ---- 

        Ŀ
         (4) ROMS LOCATIONS 
        

  - Put "Bad Dudes VS Dragon Ninja" roms in /BADDUDES
  - Put "Dragon Ninja" roms in /DRGNINJA
  - Put "Robocop" roms in /ROBOCOP       * YOU NEED THE BOOTLEG VERSION *
  - put "Sly Spy" roms in /SLYSPY
  - put "Midnight Resistance" roms in /MIDRES

  NOTE: If you encounter a problem with Dragon Ninja or Bad Dudes,
  ----  try to get the new ROM sets, the old ones had a few corrupted
        ROMs.

        Ŀ
         (5) CONFIGURING XDRAGON.INI 
        

  When you run xDragon, it will read the XDRAGON.INI file first. Here's :

    GAME = #                    ; Use game #
    FRAMESKIP = #               ; Set frameskip rate to # (0-9)|AUTO
    TEST = 0/1                  ; Enable test mode (1=on | 0=off)
    PLAYER1 = 0/1               ; Use control 0 (keyboard) or 1 (joystick 1)
                                ; for the first player.
    PLAYER2 = 0/1               ; Use control 0 (keyboard) or 1 (joystick 1)
                                ; for the second player.
    CALIB = 0/1                 ; Calibrate the joystick (1=on | 0=off)
    STRETCH = 0/1               ; Fit the image into screen (1=on | 0=off)
    GRAPHICS_MODE = res,driver  :
                                ;  res: 0 = AUTO,   driver: AUTO
                                ;       1 = 320x240         VESA2L (linear)
                                ;       2 = 400x300         VESA2B (banked)
                                ;       3 = 512x384
                                ;       4 = 640x480
    VOLUME = x                  ; Set the sound FX volume (0 - 255)
    MUSIC = 0/1                 ; Enable music support (1=on | 0=off)


  Don't forget to type everything in uppercase (CAPITAL) letters, and
  to respect the spaceing. Add also END_INI at the end of the file.

        Ŀ
         (6) CONTROLS 
        

  Rotary Controller (Work only for the 1st player):
    W....................... Turn to the left
    X....................... Turn to the right

  Using Keyboard:

    Move your character .... Arrow Key
    Jump ................... Control
    Attack ................. Alternate

  Using a Joypad:

    Move your character .... Directionnal Pad
    Jump ................... Button 2
    Attack ................. Button 1

  Miscellaneous keys:

    Player 1 start ......... F1
    Player 2 start ......... F2
    Insert a coin .......... F3 or F4
    Set frame skip to 1/1 .. F5
    Set frame skip to 1/2 .. F6
    Set frame skip to 1/3 .. F7
    Set frame skip to 1/4 .. F8
    Rotate the screen ...... F10
    Snapshot(screen##.pcx).. F12
    Pause the emulator ..... P 

        Ŀ
         (7) HISTORY 
        

  XDRAGON 0.1  (03/16/98)
   - Initial release.
  XDRAGON 0.1A (03/16/98)
   - Minor bug fixed (in cpu timing)
  XDRAGON 0.2  (03/28/98)
   - Added Robocop
   - Added sound emulation (FX&Music)
   - Added the 6502 emulation, fully in ASM
  XDRAGON 0.25 (03/30/98)
   - Added two new video mode
   - Added a joystick calibration part
  XDRAGON 0.30 (04/07/98)
   - VSync
   - Autoframeskip
   - Choose the correct video mode
   - Double Buffer added        
   - Parallax scrolling
   - xDragon save the joystick's calibration part
   - Rotary Controller supported
   - Added Sly Spy
   - Added Midnight Resistance

        Ŀ
         (8) GREETS 
        

  Greetings go to:

   - Lewin A.R.W. Edwards (sysadm@zws.com) for the bootleg ROM of
     Robocop.
   - Richard Bush for the informations on Robocop and Heavy Barrel
   - Bryan McPhail for the informations on the name table, and Sly Spy/
     Midnight Resistance memory map.
   - Neill Corlett for his FABULOUS Starscream emulator
   - Shawn Hargreaves for his Allegro graphic library
   - Shaun Johnston for his english corrections of the documentation
   - DJ Delorie for DJGPP
   - Thierry Lescot for the dump of the BADDUDES.8 ROM which is now
     correct
   - All our beta testers

        Ŀ
         (9) CONTACT US 
        

  You can contact us at gouky@mygale.org.
  (PLEASE DONT ASK FOR ROMS)


-eof-

