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.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                   7229    7424  97.4% -lh5- 4ce0 May 29 09:56 DOSBox.info
[Amiga]                    208     276  75.4% -lh5- d97e May 10  2010 DOSBox/authors
[Amiga]                   7118   18332  38.8% -lh5- d1a6 May 10  2010 DOSBox/copying
[Amiga]                1038497 8131448  12.8% -lh5- e1f4 Aug 21 13:18 DOSBox/DOSBox
[Amiga]                  23185   64230  36.1% -lh5- f63a Jun 27  2019 DOSBox/DOSBox 0.74-3 Manual.txt
[Amiga]                    831    1316  63.1% -lh5- 0b74 May 29 09:56 DOSBox/DOSBox 0.74-3 Manual.txt.info
[Amiga]                   4368   11605  37.6% -lh5- 543b Aug 22 09:45 DOSBox/dosbox-0.74.conf
[Amiga]                    825    1311  62.9% -lh5- 5f8a May 29 09:56 DOSBox/dosbox-0.74.conf.info
[Amiga]                   5071    6466  78.4% -lh5- 5ebb Aug 22 09:44 DOSBox/DOSBox.info
[Amiga]                   1523    3084  49.4% -lh5- f8c1 Aug 21 23:39 DOSBox/DOSBox.readme
[Amiga]                   1830    2768  66.1% -lh5- 7517 Aug 22 09:44 DOSBox/DOSBox.readme.info
[Amiga]                    265     417  63.5% -lh5- 09fc May 28 23:20 DOSBox/DOSBox_INFO.TXT
[Amiga]                   1377    1915  71.9% -lh5- 6bb0 May 29 09:56 DOSBox/DOSBox_INFO.TXT.info
[Amiga]                    730    2528  28.9% -lh5- 8845 Jan 14  1980 DOSBox/mapper-0.74.map
[Amiga]                  11819   32130  36.8% -lh5- f56b May 10  2010 DOSBox/news
[Amiga]                  22765   63204  36.0% -lh5- fced May 10  2010 DOSBox/readme
[Amiga]                   1820    2756  66.0% -lh5- c30a May 29 09:56 DOSBox/readme.info
[Amiga]                 777634  777634 100.0% -lh0- 6441 Dec 12  2025 DOSBox/src.zip
[Amiga]                    542    1001  54.1% -lh5- 9d42 May 10  2010 DOSBox/thanks
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        19 files 1907637 9129845  20.9%            Aug 22 23:14