
AMPlay 2.03 Source.
~~~~~~~~~~~~~~~~~~~

What is it?
~~~~~~~~~~~

It's a desktop player for MP3 music files, using the AMPlayer module.

It contains a number of features specifically aimed at dealing with
very large collections of MP3s ('Large' in this context is many
thousands or even tens of thousands).

This is the source code archive. If you were after the application
itself, you've probably just downloaded the wrong file.


Now What?
~~~~~~~~~

Up to you, really.

This archive contains the BASIC source materials used to build the
released AMPlay application. The released application is compiled
with the ABC compiler (available from Castle), but it works equally
well (although not as fast) directly or crunched with StrongBS or
similar.

Note that as well as BASIC source instead of a compiled runimage,
this archive also contains a slightly modified !Run file. This !Run
file allows easy switching between various runimage types (unlinked,
linked, crunched and compiled)

It's also worth noting that while the compiled version of AMPlay
that is made available has been compiled with the various debugging
code omitted. The source still has this debugging code present,
although it is inactive unless a file called 'Debug' is present
inside the !AMPlay directory. If debugging is active, a log file
will be created in the RAM disc (which is assumed to already exist).

The source documentation covers the process of building !AMPlay,
with or without the debugging included.

You will need to copy the DrWimp directory somewhere, and then run
the !RunMe file in it, before any of the other apps will work. They
need DrWimp$Dir to have been set, so that they all use the same
copy. 

Refer to the source documentation for notes on various internal
structures and formats, and for recommended build instructions.

The user documentation is supplied with AMPlay, and includes the
messaging API details.

This archive includes source for the following:

- AMPlay itself.
- AMPlayAPI - a tool for sending test API messages to AMPlay/AMPlayCfg
- AMPlayCfg - AMPlay's configuration interface.
- AMPlayRCG - a remote control gateway for AMPlay.

Note that AMPlayAPI and AMPlayRCG are unchanged from the earlier 2.00a
release.

AMPlayCMD, the command line tool for controlling AMPlay is not a full
blown application, but is inside !AMPlay.Resources. The version
supplied here is the same as that supplied with AMPlay itself.


License conditions:
~~~~~~~~~~~~~~~~~~~

See the Docs.Licence/txt file.

Note that the DrWimp library is covered by its own license conditions.

Also note that the copy of DrWimp supplied in this archive has been
modified from the one supplied with DrWimp (4.30). The changes
involved are small, and were done with the approval of Ray Favre (the
current maintainer of DrWimp). These changes have been submitted back
to him, and may appear in later DrWimp releases. Meanwhile, I have his
permission to distribute this modified version as part of the AMPlay
source materials. (NB, there are now later releases of DrWimp.)

The DrWimp directory also contains an updated version of the !Linker
application. This should be used when linking AMPlay with DrWimp - the
version supplied with DrWimp 4.30 does not cope with programs as big
as AMPlay.

My modifications within DrWimp are marked with comments starting ****.

AMPlay will not work correctly with the original 4.30 DrWimp library,
or earlier versions. The original 4.30 and earlier are also not
compileable in their unmodified state.


Web Resources:
~~~~~~~~~~~~~~

The latest version of AMPlay, together with anything else I may have
cobbled together in the meantime should be available from:

http://www.mikejs.com/

For DrWimp, refer to;

http://www.rayfavre.me.uk/


Mike
--
30.05.2008
Mike Sandells
mailto:mike@mikejs.com
http://www.mikejs.com/


 