rockbox/lib/rbcodec/codecs/libasap
Amaury Pouly 16d1788356 Fix codecs in simulator builds on Windows
The mingw linker uses strlen() in some cases, and codeclib.c redefines it, that
leads to mingw runtime init to call into our strlen() and then ci->strlen() which
of course crashes. Apply the same fix as for malloc and friends: rename the symbol.

The codeclib.h include is necessary for normal builds.

Change-Id: Ifa85901a3e4a31cc0e10b4b905df348a239d5c99
2017-01-15 21:46:19 +01:00
..
acpu.c
anylang.h
apokeysnd.c
asap.c Fix codecs in simulator builds on Windows 2017-01-15 21:46:19 +01:00
asap.h
asap_internal.h
CREDITS
libasap.make
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[]