Short:        Amiga port of DOSBox
Author:       NovaCoder
Uploader:     novacoder yahoo co uk
Type:         misc/emu
Version:      0.74-3.25
Architecture: m68k-amigaos >= 3.1.0
Distribution: Aminet

Overview:

Amiga 68k port of DosBox v0.74-3.

DOSBox is a DOS-emulator that uses the SDL-library which makes DOSBox very
easy to port to different platforms. 
DOSBox has already been ported to many different platforms, such as Windows,
BeOS, Linux, MacOS and AmigaOS.
Unfortunately this special 68k port is very slow on real classic hardware
but older PC games should be playable on a Storm.


Requirements:

1) An RTG Amiga.
2) Workbench must be using a 32-bit pixel format screen mode.
3) PiStorm 4.
4) AHI installed and configured.
5) CAMD library installed and configured.
6) Some old PC games or demos.


Features:

 * SDL based port
 * Native MIDI support (CAMD)
 * AHI Sound support
 * Fullscreen and window mode support
 * 32-bit scaler support


Configuration Options:

When running from the shell you must specify a stack of at least 300,000.
The AHI device used will be the one configured in your AHI Prefs (Unit 0).
You will need to install the CAMD library if you want to use an external MIDI
device.  The DOSBox log file will tell you which core it is actually using.
Read the DOSBox readme to figure out how to use it.
The 'love8bit' configuration option can be used to show some love for
8-bit display modes (cannot be used with the scalers).


Performance Considerations:

1) Fast File System isn't, use PFS3 instead.
2) Use v4.18 of AHI as the later versions are too slow on real hardware.
3) Stick with the 'FAST' 8 bit Mono/Stereo++ AHI modes.
4) Full screen 8-bit mode will be the fastest option (love8bit).
5) Image scaling will add an additional overhead, this includes enabling
   aspect ratio correction.


Limitations:

1) No network support.
2) No physical CDROM support but ISO images can be mounted.


Version History:

0.74-3.09 - New version based on the offical 0.74-3 release.
0.74-3.10 - Updated config to disable closewb by default.
0.74-3.12 - Updated the screen mode detection algorithm.
0.74-3.16 - Fixed bug with keyboard layouts when using a non-us keyboard.
0.74-3.17 - Fixed 32 bit color handling, updated hot keys.
0.74-3.18 - Fixed display handling.
0.74-3.19 - Slight performance increase.
0.74-3.20 - Fixed bugs with the screen mode handling.
0.74-3.21 - Added 32-bit pixel format configuration option.
0.74-3.22 - Updated with the latest graphics library.
0.74-3.23 - Added a 24-bit color fallback option.
0.74-3.24 - Updated file handling, slight performance increase.
0.74-3.25 - Updated to use the latest SDL library.


Links:

http://eab.abime.net/showthread.php?t=96151 (DOSBox thread on EAB)
https://www.dosbox.com (DOSBox page)
https://www.vogons.org/viewtopic.php?t=21824 (keyboard layout codes)
https://www.youtube.com/watch?v=NlkxvDx27sY (AHI setup guide)
https://www.youtube.com/watch?v=1RFbW4RRswM (PiStorm power!)


Thanks and acknowledgements:

The DOSBox team and Moe Wilder for the 68k testing.