From f40bfc9267b13b54e6379dfe7539447662879d24 Mon Sep 17 00:00:00 2001 From: Sean Bartell Date: Sat, 25 Jun 2011 21:32:25 -0400 Subject: Add codecs to librbcodec. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change-Id: Id7f4717d51ed02d67cb9f9cb3c0ada4a81843f97 Reviewed-on: http://gerrit.rockbox.org/137 Reviewed-by: Nils Wallménius Tested-by: Nils Wallménius --- lib/rbcodec/codecs/libasap/README | 148 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 148 insertions(+) create mode 100644 lib/rbcodec/codecs/libasap/README (limited to 'lib/rbcodec/codecs/libasap/README') diff --git a/lib/rbcodec/codecs/libasap/README b/lib/rbcodec/codecs/libasap/README new file mode 100644 index 0000000000..d4fbfe6297 --- /dev/null +++ b/lib/rbcodec/codecs/libasap/README @@ -0,0 +1,148 @@ +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[] -- cgit v1.2.3