introduction

============

congratulations! you are about to experience exceptionally high-quality

mpeg audio.

this plug-in is a replacement for the default mpeg audio decoder that
comes with winamp. mad is a high-quality mpeg audio decoder with support
for output resolutions from 8 to 32 bits.

for more information about mad and the mad plug-in, please visit:

http://www.mars.org/home/rob/proj/mpeg/mad-plugin/

license
=======

this program is free software; you can redistribute it and/or modify it

under the terms of the gnu general public license as published by the free
software foundation; either version 2 of the license, or (at your option)
any later version.

this program is distributed in the hope that it will be useful, but

without any warranty; without even the implied warranty of merchantability
or fitness for a particular purpose. see the gnu general public license
for more details:

http://www.mars.org/home/rob/misc/gpl2.html

the source code for this plug-in is available from the same place you
obtained this plug-in. if you choose to redistribute this plug-in, you
must accompany it with the complete source code or an offer to obtain the
source in accordance with section 3 of the gpl.

recommendations
===============

in order to get the most from this plug-in, it is recommended that you
have a high-quality audio setup, including a nice sound card and good
speakers. you can still benefit from mad's high quality dithered output
with any sound card, but to best enjoy the fine detail in the sound mad
produces, a high-end sound card with a 24-bit dac is recommended.

configuration
=============

1. start winamp.

2. configure the plug-in from winamp's preferences panel under the

plug-ins/input section. choose the highest output resolution supported
by your sound card (usually 8 or 16 bits, but possibly 24 or 32 for
high-end cards.)

3. disable the nullsoft mpeg audio decoder plug-in by deleting the file
association extension list (version 2.7), unchecking the "use for mp1,
mp2, and mp3 files" option (version 2.666), or unchecking the "layer
iii", "layer ii", and "layer i" options (version 2.33 or 2.34) in its
configuration.
 alternatively, you could move the file in_mp3.dll out of your winamp
plugins directory (usually c:\program files\winamp\plugins) and restart
winamp.

4. play mp3, mp2, or mp1 files and enjoy high quality sound.

frequently asked questions

==========================

q. i can't get it to work. i get an error message whenever i try to play

something. what's wrong?

a. you have probably selected an output resolution unsupported by your

sound card. try 16 bits instead.

note: sb live! cards do not support 24- or 32-bit output.

q. on some files, winamp seems to play as normal except i hear no sound.

what's wrong?

a. the most likely cause for this is that the files were encoded with crc
protection, but the checksums are wrong. some early encoders were known
to create such files. mad has to assume the crcs are valid, so it
thinks every frame in the file is corrupt, and plays silence instead.

if you open the file info dialog and view the "statistics" tab, you
will probably see the number of crc errors accumulating at the same
rate as the number of decoded frames.

you will have to fix these files before mad will play them.

q. what is "auto clipping attenuation"?

a. this version of the mad plug-in has the ability to attenuate (weaken)
the digital signal reproduced from the mpeg audio data, so that it does
not experience distortion from clipping. clipping occurs when the
signal is so strong that it exceeds the maximum representable
amplitude, known as "full scale."

you can attenuate the signal manually from the file info dialog, or you
can have the signal attenuated automatically whenever clipping
occurs. if you choose to attenuate automatically, you can further
control how aggressively the signal is attenuated. the default setting
should be appropriate for most circumstances, but you can adjust it in
case the signal is attenuated too abruptly or not quickly enough.

changes
=======

changes since 0.14.1b:

- fixed a possible crash due to bad xing header information
- eliminated the error dialog when trying to open a (bad) file
- increased the size of the info dialog box in preparation for an id3v2
tag editor

changes since 0.14.0b:

- none visible; the plug-in is now linked with the new libid3tag
 library, which will eventually enable full id3v2 support

changes since 0.13.0b:

- a new, improved dithering algorithm has been implemented
- streaming can now be disabled (to use other plug-ins with better
streaming support)

changes since 0.12.5b:

- the last complete audio frame should now always be decoded
- xing vbr headers are now detected and read if "fast playing time
calculation" is enabled
- visuals for 24- and 32-bit output should now display correctly
- corrected a problem decoding mpeg-2 layer iii intensity stereo

changes since 0.12.4b:

- several more performance improvements

changes since 0.12.3b:

- many performance improvements
- alias reduction is now performed on mixed short blocks

changes since 0.12.2b:

- added decoding statistics to file info dialog
- title formatting is greatly enhanced, and includes the ability to
use conditional constructs
- output can now be attenuated to eliminate clipping
- mad now supports the mpeg 2.5 format

changes since 0.12.1b:

- several performance improvements

changes since 0.7.3b:

- fixed a potential problem related to a thread conflict
- changed the version numbering to coincide with the mad source releases
- created a pimp installer executable

changes since 0.7.2a:

- fixed a problem that could cause winamp to crash if the file info box
is dismissed before the mpeg audio length is calculated
- fixed some id3v2-induced problems related to determining the correct
sample rate, et al.

changes since 0.7.1a:

- a different method for packing stereo pcm samples is used which *may*
be somewhat faster than before
- fixed several seek-related issues; should no longer get a "blip" sound
- slightly improved error handling on bad frames

known issues
============

- there are buffering issues related to streaming support

- the id3v2 tag editor is missing
- using dsp effects (including the equalizer) will negate the effects of
dithering

acknowledgments
===============
 the author would like to thank the following individuals for their
support, suggestions, beta testing, debugging, and indeed for proposing
the idea to write this plug-in in the first place:

kaiwei
david shin

the following individuals have also made notable contributions:

matt parnell
john stewart

feedback
========

please send bug reports, comments, and suggestions to the author:

rob leslie <rob@mars.org>