-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
160 lines (117 loc) · 4.53 KB
/
README
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
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
libacm - Library for InterPlay ACM Audio format.
================================================
Intro
-----
Decoder library for InterPlay ACM audio files.
Includes command line tool and plugins for Winamp, Audacious, XMMS2
and GStreamer 0.10.
The format was used for games Fallout, Fallout 2 and Baldur's Gate series.
It is less efficient than the more advanced MP3, Vorbis or AAC algorithms,
but it's main feature is very fast decoding speed.
NEWS
----
Version 1.2
~~~~~~~~~~~
* decoder: Fix error handling in load_bits() (Brian "Moses" Hall)
* acmtool: Show time instead number of samples.
* plugin-xmms2: New plugin for XMMS2
* plugin-audacious: Support Audacious up to 2.4
* plugin-gstreamer: Fix End-Of-Stream handling
* plugin-xmms: Drop it. XMMS is obsolete.
Version 1.1
~~~~~~~~~~~
* acmtool: play files with libao: acmtool -p FILE
* decoder: support WAVC files, which are ACM files with additional header.
* decoder: take mono ACM as stereo, as there are lot of badly tagged files.
Trust channel count on WAVC files, those seem to be correct,
and WAVC is mostly used for samples.
* decoder: avoid divide-by-zero in bitrate calculation.
* plugin-audacious: Keep up with API changes in Audacious 2.x branch.
It seems to be still compatible with 1.x, but I have not tested.
Version 1.0
~~~~~~~~~~~
* decoder: excpect EOF in more places - otherwise libacm
complained about "unexpected eof".
* decoder: on reading assume there is additional single zero byte
at the end of all files. Otherwise last block on some files was
skipped because last few bits could not be read.
Thanks to above 2 changes libacm now decodes all Fallout 1/2
files in full length and without complaining.
* License plugins under LGPL.
* New separate plugin for Audacious 1.5+
* Remove plugin for Beep Media Player
* Rewrite plugin-gstreamer.c for GStreamer "Hell On Earth" 0.10
* acmtool -d -o - writes to stdout.
Version 0.9.2
~~~~~~~~~~~~~
* License core libacm code under minimal BSD/ISC license.
Plugins continue to be under GPL.
* Fix acmtool crash. ([email protected])
Version 0.9.1 (unreleased)
~~~~~~~~~~~~~~~~~~~~~~~~~~
* Use autoconf/automake for build system
* Plugin for GStreamer 0.8. (alsasink seems to be buggy for 22050 Hz
audio. If you hear any cracks, try to use osssink.)
* Small cleanups.
Version 0.9
~~~~~~~~~~~
* First public release.
* Includes: decoder, acmtool, plugins for XMMS, BEEP and Winamp
Installation
------------
./configure
make
make install
By default no plugins are compiled. You must explicitly enable them:
--enable-xmms2 Enable plugin for XMMS2
--enable-audacious Enable plugin for Audacious
--enable-gstreamer Enable plugin for Gstreamer 0.10
By default the plugins are installed into player's main plugin directory.
To specify some other location, use following arguments:
--with-xmms2-plugindir=DIR
--with-audacious-plugindir=DIR
--with-gstreamer-plugindir=DIR
Local per-user plugin paths for GStreamer and Audacious:
--with-audacious-plugindir=$HOME/.local/share/audacious/Plugins
--with-gstreamer-plugindir=$HOME/.gstreamer-0.10/plugins
XMMS2 does not support per-user plugin directories.
To compile Windows binaries (needs mingw32):
make amp - creates in_libacm.dll
make exe - creates acmtool.exe
make zip - does both and zips
Command line tools usage
------------------------
$ acmtool -h
acmtool - libacm version 1.0
Decode: acmtool -d [-q][-m|-s] [-r|-n] -o outfile infile
acmtool -d [-q][-m|-s] [-r|-n] infile [infile ...]
Other: acmtool -i ACMFILE [ACMFILE ...]
acmtool -M|-S ACMFILE [ACMFILE ...]
Commands:
-d decode audio into WAV files
-p play audio
-i show info about ACM files
-M modify ACM header to have 1 channel
-S modify ACM header to have 2 channels
Switches:
-m force mono wav
-s force stereo wav
-r raw output - no wav header
-q be quiet
-n no output - for benchmarking
-o FN output to file, can be used if single source file
The mono/stereo options are necessary because for some ACM files
the number of channels in header in wrong. Usually those are
game samples, which contain mono audio but are tagger as stereo.
Status
------
* Decoder: stable
* WinAmp plugin: stable
* XMMS2 plugin: stable
* Audacity plugin: stable
* GStreamer 0.10 plugin: stable
* Encoder: when I have more time
Credits
-------
All the hard work of reverse engineering the format was done
by ABel from TeamX. I simply re-implemented it in C.