OSME library v0.92 (2007/06/28)
by SLiPPY/VeCTRONiX!, http://www.vectronixhq.de
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The Oldskool Musaxxs Engine (OSME or OSMEngine) is a static/dynamic
library written entirely in C/C++ by me, the main-emulation part by
Benjamin Gerard (Ben/Overlanders) which is based on the SC68 library.

The main intention to write such a library is, that I already looked
for something like this for years. Unfortunately nobody else did
something like this before for the needs to re-use oldskoolish
musaxxs in own productions (mainly Demos/Intros/BBS ads aso.).
So here we go with it. In short words you'll find a library which
emulates a Motorola 68000 CPU (found in machines like Amiga 500 and
Atari ST/E) as well as the specific Soundchip emulations of YM-2149,
MFP68901, Microwire (STE) and Shifter (Atari) and for the Amiga
complementation, the Paula soundchip. All these components are almost
accurately emulated within a library which compiles to (and of course
packed afterwards) around 40kb. That's what my main intention was -
reducing the size to a minimum.

The Oldskool Musics Engine is a tiny library which enables Win32/Linux
users to play all these old chippy sounds from the Amiga/Atari ST(E).
To let it sound as natural as it should be this library emulates a
whole bunch of these old hardware elements which are: MC68000 CPU,
Atari YM-2149, Atari MFP-68901, Atari Shifter, Atari Microwire and
Amiga Paula. All these Chipsets are emulated almost accurately within
this library. To make the usage of it as easy as possible I also
included a DirectSound-based sound subsystem which will be queried
by some background threads.

The core library is capable of replaying the following formats natively:

Atari SNDH(*), Amiga FutureComposer 1.3/1.4 and Amiga JamCrackerPro.

"Natively" means with their own 68k-asm based replayers as they are all
replayed within the emulated environment. Knowing this and also the fact
that its usage is really easy and the library itself is compiled and
packed not bigger than 40kb makes the OSMEngine somewhat outstanding
IMHO as I've been looking for something like that for years.

(*)SNDH:: This is a wrapper format which enables almost all different
chip-based replayers.

The core-emulation is based on a library called "SC68" which has been
written by Benjamin Gerard (Ben/Overlanders) back in the year 2003.
Its main idea was to replay these sounds - but it only existed as
Winamp-Plugin and XMMS-Plugin. Also the concept how it's been
realized wasn't suiteable to integrate this into own productions.

Anyway, without this SC68 library the OSMEngine would not exist!
So big thanks to Ben for this.