apps/codecs/libasap/README

   1 ASAP - Another Slight Atari Player
   2 ==================================
   3
   4 // This file is in AsciiDoc format. It is converted to README.html.
   5 :Compact-Option:
   6
   7 ifdef::asapwww[]
   8 http://sourceforge.net/projects/asap/files/asap/[Download] |
   9 http://asap.git.sourceforge.net/git/gitweb.cgi?p=asap/asap;a=summary[Browse source code (Git)] |
  10 http://sourceforge.net/scm/?type=git&group_id=154391[Get latest source code (Git)] |
  11 http://sourceforge.net/projects/asap/[SourceForge project page]
  12 endif::asapwww[]
  13
  14 ASAP is a player of http://en.wikipedia.org/wiki/Atari_8-bit_family[8-bit Atari]
  15 music for modern computers.
  16 It emulates the http://en.wikipedia.org/wiki/POKEY[POKEY sound chip]
  17 and the http://en.wikipedia.org/wiki/6502[6502 processor].
  18 The project was initially based on the routines from the
  19 http://atari800.sourceforge.net/[Atari800 emulator],
  20 but the current version has a completely new original emulation core.
  21
  22 ASAP includes the following programs:
  23
  24 - asapconv - portable command-line converter {asapwin=}
  25 - WASAP - tiny player for Windows {asapwin=}
  26 - plugin for http://koti.welho.com/hylinen/apollo/[Apollo] {asapwin=}
  27 - plugin for http://foobar2000.org/[foobar2000] {asapwin=}
  28 - plugin for http://hp.vector.co.jp/authors/VA032810/[GSPlayer] {asapwin=}{asapwince=}
  29 - plugin for http://moc.daper.net/[MOC]
  30 - plugin for http://www.winamp.com/[Winamp] {asapwin=}
  31 - plugin for http://www.microsoft.com/windows/windowsmedia/player/[Windows Media Player] {asapwin=}
  32 - plugin for http://xbmc.org/[XBMC] {asapwin=}
  33 - plugin for http://xmms.org/[XMMS]
  34 - plugin for http://www.un4seen.com/[XMPlay] {asapwin=}
  35 - POKEY sound emulation DLL for http://raster.infos.cz/atari/rmt/rmt.htm[Raster Music Tracker] {asapwin=}
  36 - Java version of ASAP2WAV - command-line converter to WAV files {asapjava=}
  37 - Java applet - for web pages {asapjava=}{asapwww?(see link:applet.html[online demo])}
  38 - Java midlet - for mobile devices {asapjava=}
  39 - C# version of ASAP2WAV
  40 - experimental JScript version of ASAP2WAV running in Windows Script Host {asapjavascript=}
  41 - experimental JavaScript version of ASAP2WAV running in Firefox {asapjavascript=}
  42 - Flash player - for web pages {asapflash=}{asapwww?(see link:flash.html[online demo])}
  43
  44 {asapports}The summary of the differences between the above versions is in link:PORTS.xml[this table].
  45
  46 There are other projects which use ASAP:
  47
  48 - http://mmsap.sourceforge.net/[mmSAP 2] - standalone player for GNU/Linux with GTK+ user interface
  49 - http://www.rockbox.org/[Rockbox] - open source firmware for MP3 players
  50
  51
  52 Input file formats
  53 ------------------
  54
  55 ASAP supports the following file formats (determined by the filename extension):
  56
  57 SAP (Slight Atari Player)::
  58 The format designed for playing 8-bit Atari music on modern computers.
  59 All other formats can be converted to SAP.
  60 http://asma.atari.org/[Atari SAP Music Archive (ASMA)]
  61 is a single big collection of SAP files.
  62
  63 CMC (Chaos Music Composer)::
  64 Atari music editor from early 1990s.
  65
  66 CM3 (CMC "3/4")::
  67 CMC with modified pattern length.
  68
  69 CMR (CMC "Rzog")::
  70 CMC with modified bass sounds.
  71
  72 CMS (Stereo Double CMC)::
  73 Stereo CMC.
  74
  75 DMC (DoublePlay CMC)::
  76 CMC with 6502 routine executed at double rate of the original CMC.
  77
  78 DLT (Delta Music Composer)::
  79 Atari music editor from 1990s.
  80
  81 MPT (Music ProTracker)::
  82 Atari music editor from 1990s.
  83
  84 MPD (MPT DoublePlay)::
  85 MPT with 6502 routine executed at double rate of the original MPT.
  86
  87 RMT (http://raster.infos.cz/atari/rmt/rmt.htm[Raster Music Tracker])::
  88 Modern Atari music editor running on Windows.
  89
  90 TMC, TM8 (http://jaskier.atari8.info/[Theta Music Composer] 1.x)::
  91 Atari music editor from late 1990s.
  92 The two file extensions are treated identically and played in stereo.
  93 TM8 means it's stereo (8-channel) music while TMC can be either mono or stereo.
  94
  95 TM2 (http://jaskier.atari8.info/[Theta Music Composer] 2.x)::
  96 Modern Atari music editor.
  97
  98
  99 ifdef::asapsrc[]
 100 include::INSTALL[]
 101 endif::asapsrc[]
 102
 103 ifdef::asapflash[]
 104 include::flash/USAGE[]
 105 endif::asapflash[]
 106
 107 ifdef::asapjava[]
 108 include::java/USAGE[]
 109 endif::asapjava[]
 110
 111 ifdef::asapjavascript[]
 112 include::javascript/USAGE[]
 113 endif::asapjavascript[]
 114
 115 ifdef::asapwin[]
 116 include::win32/USAGE[]
 117 endif::asapwin[]
 118
 119 ifdef::asapwince[]
 120 include::gsplayer/USAGE[]
 121 endif::asapwince[]
 122
 123 include::NEWS[]
 124
 125 include::CREDITS[]
 126
 127
 128 Feedback
 129 --------
 130
 131 If you are interested in the ASAP project, please subscribe its
 132 https://lists.sourceforge.net/lists/listinfo/asap-users[mailing list].
 133 This list is for users and developers.
 134 Once you subscribe, you can post comments, ideas and questions about ASAP.
 135 They will be answered ASAP. ;-)
 136
 137 Use http://sourceforge.net/tracker/?group_id=154391[tracker]
 138 to submit bug reports, feature requests and small code patches.
 139
 140 ifdef::asapwww[]
 141 image::http://sflogo.sourceforge.net/sflogo.php?group_id=154391&amp;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/"]
 142 endif::asapwww[]