Short:        Amiga port of DOSBox
Author:       NovaCoder
Uploader:     novacoder yahoo co uk
Type:         misc/emu
Version:      0.74.034
Replaces:     misc/emu/DOSBox_RTG_060.lha
Architecture: m68k-amigaos >= 3.1.0
Distribution: Aminet
Kurz:         Amiga Portierung von DOSBox

Overview:

Amiga 68k port of DosBox v0.74.

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 optimized 68k port is still very slow on real
classic hardware.


Requirements:

1) An RTG Amiga.
2) 68060 processor or better.
3) 64 MB of RAM.
4) AHI installed and configured (see links section below).
5) CAMD library installed and configured for native MIDI playback (see links
   section below).
6) Some old PC games or demos.


Features:

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

 
Configuration Options:

The 'closewb' setting can be used to close the Workbench.
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 (may be
different to the config setting).
Press ALT+ENTER to switch between fullscreen and windowed mode.
Press CTRL+m to toggle mouse capture when running in a window.


Performance Considerations:

1) The number of cycles you set for the CPU emulation is critical, too high
   will stall the emulation.
2) The fastest core to use is 'simple' but it's also the least compatible and
   may crash.
3) If you have a Blizzard you should really be using BlizKick, Apollo users
   should be using RemApollo.
4) Fast File System isn't, use PFS3 instead.
5) Use v4.18 of AHI as the later versions are too slow on real hardware
6) If you are using Paula, stick with the 'FAST' 8 bit Mono/Stereo++ modes for
   (AHI prefs).
7) A 16 bit sound card *might* be faster with a 16 bit mode (AHI prefs).
8) Running in a window with an 8 bit screen mode will be slower.


Limitations:

1) No network support.
2) No physical CDROM support.


Version History:

0.74.009 - Initial release.
0.74.010 - Added back support for 486/586 CPU emulation.
0.74.011 - Fixed up mouse handling (SDL fix).
0.74.012 - Fixed timing issue (SDL fix), added joystick support.
0.74.013 - Mouse handling updates (SDL fix).
0.74.014 - Fixed native MIDI support.
0.74.016 - Recompiled for 060, minor performance increase.
0.74.018 - Fixed window title.
0.74.019 - Stability fixes.
0.74.020 - Slight performance increase.
0.74.024 - Fixed mouse capture.
0.74.026 - Fixed keyboardlayout config option, added support for
           ISO images which can now be mounted.
0.74.027 - Updated mouse capture.
0.74.028 - Updated compiler optimizations.
0.74.029 - SDL fixes for 8 bit window mode.
0.74.030 - Updated window mode and input capture handling.
0.74.031 - Stack check added.
0.74.032 - Updated configuration file.
0.74.034 - Updated mouse capture.


Links:

http://eab.abime.net/showthread.php?t=96151 (DOSBox thread on EAB)
https://www.dosbox.com (DOSBox page)
http://aminet.net/package/driver/audio/ahiusr_4.18 (AHI Audio system)
http://aminet.net/package/mus/edit/camd (Commodore Amiga Midi Driver)


Thanks and acknowledgements:

The DOSBox team!