summaryrefslogtreecommitdiffstats
path: root/apps/codecs/libasap/README
blob: 4da0aa7b90280f0b7b493df1340ca3727f395bdd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
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=}
- plugin for http://koti.welho.com/hylinen/apollo/[Apollo] {asapwin=}
- 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] {asapwin=}
- POKEY sound emulation DLL for http://raster.infos.cz/atari/rmt/rmt.htm[Raster Music Tracker] {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
- experimental JScript version of ASAP2WAV running in Windows Script Host {asapjavascript=}
- experimental JavaScript version of ASAP2WAV running in Firefox {asapjavascript=}
- Flash player - for web pages {asapflash=}{asapwww?(see link:flash.html[online demo])}

{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::gsplayer/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[]