rockbox/apps/codecs/libasap/README

ASAP - Another Slight Atari Player
==================================

// This file is in AsciiDoc format. It is converted to README.html.
:Compact-Option:

ifdef::asapwww[]
http://sourceforge.net/projects/asap/files/asap/[Download] |
http://asap.git.sourceforge.net/git/gitweb.cgi?p=asap/asap;a=summary[Browse source code (Git)] |
http://sourceforge.net/scm/?type=git&group_id=154391[Get latest source code (Git)] |
http://sourceforge.net/projects/asap/[SourceForge project page]
endif::asapwww[]

ASAP is a player of http://en.wikipedia.org/wiki/Atari_8-bit_family[8-bit Atari]
music for modern computers.
It emulates the http://en.wikipedia.org/wiki/POKEY[POKEY sound chip]
and the http://en.wikipedia.org/wiki/6502[6502 processor].
The project was initially based on the routines from the
http://atari800.sourceforge.net/[Atari800 emulator],
but the current version has a completely new original emulation core.

ASAP includes the following programs:

- asapconv - portable command-line converter {asapwin=}
- WASAP - tiny player for Windows {asapwin=}{asapwince=}
- plugin for http://koti.welho.com/hylinen/apollo/[Apollo] {asapwin=}
- plugin for http://audacious-media-player.org/[Audacious]
- plugin for http://foobar2000.org/[foobar2000] {asapwin=}
- plugin for http://hp.vector.co.jp/authors/VA032810/[GSPlayer] {asapwin=}{asapwince=}
- plugin for http://moc.daper.net/[MOC]
- plugin for http://www.winamp.com/[Winamp] {asapwin=}
- plugin for http://www.microsoft.com/windows/windowsmedia/player/[Windows Media Player] {asapwin=}
- plugin for http://xbmc.org/[XBMC] {asapwin=}
- plugin for http://xmms.org/[XMMS]
- plugin for http://www.un4seen.com/xmplay.html[XMPlay] {asapwin=}
- add-on for http://www.un4seen.com/bass.html[BASS] (for http://www.aimp.ru/[AIMP] and http://www.un4seen.com/bass_showcase.php[other players]) {asapwin=}
- POKEY sound emulation DLL for http://raster.infos.cz/atari/rmt/rmt.htm[Raster Music Tracker] {asapwin=}
- Windows Explorer extension - shows metadata {asapwin=}
- Java version of ASAP2WAV - command-line converter to WAV files {asapjava=}
- Java applet - for web pages {asapjava=}{asapwww?(see link:applet.html[online demo])}
- Java midlet - for mobile devices {asapjava=}
- C# version of ASAP2WAV
- JavaScript version of ASAP2WAV running in http://en.wikipedia.org/wiki/Windows_Script_Host[Windows Script Host], https://developer.mozilla.org/en/Rhino_Shell[Rhino Shell], http://code.google.com/p/v8/[V8 Shell], http://en.wikipedia.org/wiki/JScript_.NET[JScript .NET] and http://en.wikipedia.org/wiki/JaegerMonkey[JaegerMonkey] {asapjavascript=}
- experimental JavaScript version of ASAP2WAV running in Firefox {asapjavascript=}
- Flash player - for web pages {asapflash=}{asapwww?(see link:flash.html[online demo])}
- asapplay - simple command-line player in C#
- http://www.silverlight.net/[Silverlight] player - for web pages {asapwww?(see link:silverlight.html[online demo])}
- AndroidASAP - for mobile devices

{asapports}The summary of the differences between the above versions is in link:PORTS.xml[this table].

There are other projects which use ASAP:

- http://mmsap.sourceforge.net/[mmSAP 2] - standalone player for GNU/Linux with GTK+ user interface
- http://www.rockbox.org/[Rockbox] - open source firmware for MP3 players


Input file formats
------------------

ASAP supports the following file formats (determined by the filename extension):

SAP (Slight Atari Player)::
The format designed for playing 8-bit Atari music on modern computers.
All other formats can be converted to SAP.
http://asma.atari.org/[Atari SAP Music Archive (ASMA)]
is a single big collection of SAP files.

CMC (Chaos Music Composer)::
Atari music editor from early 1990s.

CM3 (CMC "3/4")::
CMC with modified pattern length.

CMR (CMC "Rzog")::
CMC with modified bass sounds.

CMS (Stereo Double CMC)::
Stereo CMC.

DMC (DoublePlay CMC)::
CMC with 6502 routine executed at double rate of the original CMC.

DLT (Delta Music Composer)::
Atari music editor from 1990s.

MPT (Music ProTracker)::
Atari music editor from 1990s.

MPD (MPT DoublePlay)::
MPT with 6502 routine executed at double rate of the original MPT.

RMT (http://raster.infos.cz/atari/rmt/rmt.htm[Raster Music Tracker])::
Modern Atari music editor running on Windows.

TMC, TM8 (http://jaskier.atari8.info/[Theta Music Composer] 1.x)::
Atari music editor from late 1990s.
The two file extensions are treated identically and played in stereo.
TM8 means it's stereo (8-channel) music while TMC can be either mono or stereo.

TM2 (http://jaskier.atari8.info/[Theta Music Composer] 2.x)::
Modern Atari music editor.


ifdef::asapsrc[]
include::INSTALL[]
endif::asapsrc[]

ifdef::asapflash[]
include::flash/USAGE[]
endif::asapflash[]

ifdef::asapjava[]
include::java/USAGE[]
endif::asapjava[]

ifdef::asapjavascript[]
include::javascript/USAGE[]
endif::asapjavascript[]

ifdef::asapwin[]
include::win32/USAGE[]
endif::asapwin[]

ifdef::asapwince[]
include::win32/wince/USAGE[]
endif::asapwince[]

include::NEWS[]

include::CREDITS[]


Feedback
--------

If you are interested in the ASAP project, please subscribe its
https://lists.sourceforge.net/lists/listinfo/asap-users[mailing list].
This list is for users and developers.
Once you subscribe, you can post comments, ideas and questions about ASAP.
They will be answered ASAP. ;-)

Use http://sourceforge.net/tracker/?group_id=154391[tracker]
to submit bug reports, feature requests and small code patches.

ifdef::asapwww[]
image::http://sflogo.sourceforge.net/sflogo.php?group_id=154391&type=13["Get ASAP - Another Slight Atari Player at SourceForge.net. Fast, secure and Free Open Source software downloads",width=120,height=30,link="http://sourceforge.net/projects/asap/"]
endif::asapwww[]