DOSXBox 286/386 PC Emulator port for XBox v2

http://xport.xbox-scene.com

http://dosbox.sourceforge.net

http://www.lantus-x.com/SDLx/

What's New :

 - ISO9660 support (read regular data CDs in XBox DVD-ROM drive)

 - Map keyboard keys to joypad buttons

 - Control mouse via joypad analog stick

 - Flip X/Y axis direction on joypad and mouse controls

 - Flip analog stick control (default is joystick on left analog, mouse on right ;
   flipping means joystick controler on right analog and mouse control on left)

 - Change mouse sensitivity on-the-fly

 - Re-scan CD after inserting another

 - Read/write config files on-the-fly



Usage Notes :  

Almost all of the keyboard commands to do things like resizing the screen, etc are now
locked until you toggle the locking mode.  This is done via

CTRL-ALT-BACKSPACE ( locks config, unlocks config )

Once the locking mode is unlocked, you can execute the following keyboard commands:

CTRL-UP_ARROW    - Move Screen Up
CTRL-DOWN_ARROW  - Move Screen Down
CTRL-LEFT_ARROW  - Move Screen Left
CTRL-RIGHT_ARROW - Move Screen Right

ALT-UP_ARROW    - Strech Screen Up
ALT-DOWN_ARROW  - Strech Screen Down
ALT-LEFT_ARROW  - Strech Screen Left
ALT-RIGHT_ARROW - Strech Screen Right


CTRL-ALT-1 - Flip Joystick X axis direction
CTRL-ALT-2 - Flip Joystick Y axis direction
CTRL-ALT-3 - Flip Mouse X axis direction
CTRL-ALT-4 - Flip Mouse Y axis direction
CTRL-ALT-5 - Flip joystick/mouse controls on left/right analog sticks
CTRL-ALT-6 - Decrease Mouse Sensitivity
CTRL-ALT-7 - Increase Mouse Sensitivity


The following key commands will always work, regardless of whether you are in locked mode
or not:

CTRL-ALT-W - Write the currently defined config file (default is E:\GAMES\DOSXBOX\DEFAULT.CFG )
             When you read in a config file, that file becomes the new currently defined
             config file and will be written to when you press CTRL-ALT-W

CTRL-ALT-C - Re-scan inserted ISO9660 CD



There is a new option to the command-line "CONFIG" command called -readconf.  Use it 
the same way as you use -writeconf :

config -readconf d:\spacequest4.cfg

When you use the "config -readconf" command, your default config file is set to the value
you specified.  In the above example, "d:\spacequest4.cfg" becomes your new default config file.



In order to assign keyboard keys to your XBox controllers, you have to hand-edit the config
files.  Let's say that you have written a config file to d:\spacequest4.cfg and you want to 
remap the "Escape" key to the "A" button.  First, load up d:\spacequest4.cfg into a text
editor (e.g. notepad ) and look for the line with "xbox_1_BUTTON_A".  This identifies the
"A" button on XBox controller #1.  Now look up the value for the "Escape" key in the 
"keyboard_defs.txt" (included in the package).  The names should be self-explanatory.  
In this example, we find the "SDLK_ESCAPE" key is mapped to value 27.  So we change the 
line in d:\spacequest4.cfg to read "xbox_1_BUTTON_A=27".  Simple.

There are two special key definitions for the left and right mouse buttons.  They are:

SDLK_KP_DIVIDE		= 267 ( Left Mouse Button )
SDLK_KP_MULTIPLY	= 268 ( Right Mouse Button )

You can assign those values to an XBox controller button via the above manner.


When DOSXBox is started, the last thing it will do is try to execute a file called
"MYSTUFF".  You can use this as your own personal "autoexec.bat".  "MYSTUFF" can be
a BAT, EXE, or COM file.  


Sometimes when you run a program it will put the emulator into an undefined state and other
programs may fail to load correctly.  For example, on the "Goblins 3" cd, if you were to
run "INSTALL.COM" first, it will fail.  Then if you try to execute GOB3.EXE, it will also fail.
However, if you restart DOSXBox and try loading GOB3.EXE first, it will succeed.  


The syntax of the mount command to mount the XBox DVD-ROM player as a CDROM drive is:

MOUNT D -t cdrom d:\ -usecd 0

The above will mount the XBOx DVD-ROM drive as a virtual CD-ROM drive (in ISO9660 mode)
onto the DOSXBox D: drive.  



===================================
Real-world example of configuration
===================================

For this example, I will be using the CD game called "Goblins 3".  

Insert Goblins 3 cd into XBox, load up DOSXBox.

The first thing I do is :

config -writeconf e:\games\dosxbox\goblins3.cfg

This writes the current configuration settings to the XBox e:\games\dosxbox\goblins3.cfg
file.  Now I execute:

config -readconf e:\games\dosxbox\goblins3.cfg

This is an important step.  Even though no settings have changed, the above command
will set the name of the default configuration file so that when you press CTRL-ALT-W
it will write the currently defined settings to the file you specified via the 
"config -readconf" command.

Now, at the D: drive, I type in "GOB3" to start the installation.  I follow the steps
and after it is installed, I start it up.

Now that it is playing, I hear the sound stuttering and things seem choppy.  I press
CTRL-F12 a few times to bump up the CPU cycles and I press CTRL-F7 once to increase the
frameskip by one.  Now everything plays/sounds wonderfully.  The screen is a little off,
though, so I first press CTRL-ALT-BACKSPACE to unlock the movement keys.  Then
I adjust the screen using CTRL+Arrows and ALT+Arrows.  

I also notice that the mouse is the primary input, but it's currently being controlled 
by the right analog stick.  I want my mouse to be controlled by the left analog stick, 
so I press CTRL-ALT-5 to flip the sticks.

The mouse movement is also out of whack on the Y axis.  When I move up, the mouse goes
down and vice-versa.  Therefore, I press CTRL-ALT-4 to correct that problem.  Now
everything is great except I have no way to press mouse buttons on the XBox controller.
This will require some hand-editing of the configuration file.  

Before exiting the program, I press CTRL-ALT-W to write the configuration to the
last-defined configuration file.  Since we did the "config -readconf e:\games\dosxbox\goblins3.cfg"
above, the configuration data will be written to e:\games\dosxbox\goblins3.cfg.

Now we can exit the program and edit the e:\games\dosxbox\goblins3.cfg file.

Download/edit the e:\games\dosxbox\goblins3.cfg file and open it up in notepad (or use
an XBox text-editing utility.)  I want the A and B buttons on XBOx controller #1 to control
the left and right mouse buttons.  So I make the following 2 line changes in the configuration
file:

xbox_1_BUTTON_A=267
xbox_1_BUTTON_B=268

267 is the code for SDLK_KP_DIVIDE which was explained above to control the left mouse button.
268 is the code for SDLK_KP_MULTIPLY which was explained above to control the right mouse button.

Now I save the file and overwrite the existing one on my XBox.

I restart DOSXBox and at the command prompt I type:

config -readconf e:\games\dosxbox\goblins3.cfg 

to load in the newly changed configuration file with the key mappings.

I load up Goblins 3 again and voila - everything is exactly the way I want it.  



Stella, Gnuboy, SMSPlus, FCEUltra, HUGO, NeoPop, DGen, Bochs, HUGO-CD, FMSXBox,
Bliss, WinSTon, Gens, Z26X, StepmaniaX, PCSXBox, XBoyAdvance, DOSXBox, AtariXLBox...
what's next?


Enjoy!


-----------------------------------------------------




DOSXBox 286/386 PC Emulator port for XBox v1

http://xport.xbox-scene.com

http://dosbox.sourceforge.net

http://www.lantus-x.com/SDLx/

Features :

 - Emulates 286/386 

 - Excellent compatibility - ported from DOSBOX


Super thanks to Lantus for his SDL-XBox libraries!


==========
How To Use
==========

(You really need a USB Keyboard to do anything interesting with this port.)

First, create a subdirectory called "GAMES" off of the directory where the DOSXBox XBE is located.
Put your old DOS games in this directory.

When DOSXBox starts, you'll be presented with a screen that looks a lot like an MSDOS
bootup screen.  Your XBox E: drive is set to the DOSXBox E: drive.  The XBox D:\GAMES 
directory is mapped to DOSXBox C: drive.  The XBox DVD-ROM drive is mapped to the DOSXBox
D: drive.  Currently, DOSXBox will only read XBox compatible DVD-Rs/CDRWs. (e.g. those
made with utilities like XISO.)

If you do a "dir" you should be presented with the list of items that you uploaded to D:\GAMES
on your XBox.  Simply type in the name of the game you wish to play and it should play it.

You will almost definitely have to do some fine-tuning to get games to play at the correct
speed and without jittery music.  Use the following keys to tune your game until it plays
the way you want:

CTRL-F7	        Decrease frameskip.
CTRL-F8	        Increase frameskip.
CTRL-F11        Slowdown emulation.
CTRL-F12        Speedup emulation.
ALT-F11         Slowdown emulation (smaller factor than CTRL-F11).
ALT-F12         Speedup emulation (smaller factor than CTRL-F12).


More useful keys:

CTRL-F9         Exit DOSXbox.
CTRL-ARROWS     Reposition screen
ALT-ARROWS      Resize screen

Please also consult the included, official DOSBOX README for more information on usage.
Note that some of what is included in that README is not applicable to the XBox version.


Stella, Gnuboy, SMSPlus, FCEUltra, HUGO, NeoPop, DGen, Bochs, HUGO-CD, FMSXBox,
Bliss, WinSTon, Gens, Z26X, StepmaniaX, PCSXBox, XBoyAdvance, DOSXBox....what's next?


Enjoy!

