rockbox/apps/codecs/libasap
Nils Wallménius b086458e4e FS#12231
Centralize the selection of codec compilation flags to codec.make
to avoid having to duplicate the per cpu selection logic and the
build rule in the individual codec lib make files and make tweaking
easier.

The two special cases, libmad and libspeex were left alone.

I plan to introduce a var for arm generation so that appropriate flags
can be selected per generation as benchmarking results have shown that
different arm arches might have different optimal flags.



git-svn-id: svn://svn.rockbox.org/rockbox/trunk@30330 a1c6a512-1295-4272-9138-f99709370657
2011-08-18 16:33:41 +00:00
..
acpu.c
anylang.h
apokeysnd.c
asap.c
asap.h
asap_internal.h
CREDITS
libasap.make FS#12231 2011-08-18 16:33:41 +00:00
players.h
README
README.rockbox
SOURCES

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[]