Madlld

What is this?

This program is a “how to” about libmad's low-level API. The intended use of this program is to serve as tutorial or demonstration for programmers wiling to learn how the currently undocumented library API can be used. As a side effect the program can be used to decode MPEG audio streams to raw PCM samples.

What's new?

2004-03-19

Version 1.1 patch level 1 published. This patch fixes a little bug that triggers the spurious reporting of loss of synchronization on the guard bytes appended at the end of bit-streams. We also fixed a large number of typos.

2004-02-22

Version 1.1 published. New topics are covered: end of stream condition and MAD_BUFFER_GUARD; subband-domain samples alteration. The fixed point numbers to short integers conversion function was revised. (See the changes log in the documentation section.)

2002-01-08

Version 1.0p1 published. No changes were made to the code, only some comments were reworked to clarify the MAD_ERROR_BUFLEN error condition.

2001-11-13

First release available.

Download

The madlld program is available only in source-code form.

Since version 1.1 the distribution archives are OpenPGP signed. The key used has the A21DCE88 id, the public part of the key can be fetched from public keyrings such as the MIT PGP Public Key Server or directly here. Before using this key for verifying the posted signatures, please check that the key you fetched has the following fingerprint:

B010 27DF 9A6A 9977 F489  BA2F F98A ADC6 A21D CE88

The following versions can readily be downloaded:

• 1.1p1
  • Distribution archive: madlld-1.1p1.tar.gz (16,874 bytes); OpenPGP signature
    MD5 (madlld-1.1p1.tar.gz) = bf1b0eded231e62fbb6269b45ac3818d
  • Diffs against version 1.1: madlld-1.1-1.1p1.diff.gz (9,713 bytes); OpenPGP signature
    MD5 (madlld-1.1-1.1p1.diff.gz) = c4be0bc6bcd064f513127b01f14183ec
• 1.1
  • Distribution archive: madlld-1.1.tar.gz (16,408 bytes); OpenPGP signature
    MD5 (madlld-1.1.tar.gz) = 8743100945972ad34a3f468ff761a560
  • Diffs:
    • against version 1.0p1: madlld-1.0p1-1.1.diff.gz (14,124 bytes)
      MD5 (madlld-1.0p1-1.1.diff.gz) = 2414730c8d90a206249cdbdee820b1f2
    • against version 1.0: madlld-1.0-1.1.diff.gz (14,759 bytes)
      MD5 (madlld-1.0-1.1.diff.gz) = 4c96de61178553dba2d0e56acad3d78c
    Note that these diffs are not signed. The previous releases were not signed, it would thus be useless to sign diffs against unsigned distribution archives.
• 1.0p1
  • Distribution archive: madlld-1.0p1.tar.gz (9,468 bytes)
    MD5 (madlld-1.0p1.tar.gz) = 60901d4146285daaa6165f97b914f39e
  • Diffs against version 1.0: madlld-1.0-1.0p1.diff.gz (2,694 bytes)
    MD5 (madlld-1.0-1.0p1.diff.gz) = 043c991cb113a9e6197a2dfc3529b7f7
• 1.0
  • Distribution archive: madlld-1.0.tar.gz (9,019 bytes)
    MD5 (madlld-1.0.tar.gz) = fbc8895b83d837cdbb7c95e4102aa785

Supported platforms

The following table summarize the platforms on which madlld was reported to work on. Each platform name is associated with the latest reported version.

Your help is needed to check the good behavior of madlld on platforms not listed in the previous table. Please report your findings to the author.

Documentation

For the reader convenience, documentations bundled in the latest distribution archives are also available for on-line reading.

• Release notes (plain text, 7,636 bytes)
• Changes log (plain text, 1,798 bytes)
• User manual (gzipped postscript, A4 paper, 1 page, 4,065 bytes)
• User manual (gzipped postscript, letter paper, 1 page, 3,416 bytes)
• User manual (plain text, 1,493 bytes)
• Pretty-printed Source code (gzipped postscript, A4 paper, 13 pages 21,965 bytes)
• Pretty-printed Source code (gzipped postscript, letter paper, 13 pages 21,981 bytes)

Contact

Questions, bug reports, patches, etc. are welcome. Please mail your queries to < madlld at phoe dot frmug dot org >. Note that things such as HTML e-mails, word documents, etc. will be blindly discarded. Patches sent as unified diffs are preferred over any other format.

If you value your privacy you can send OpenPGP-encrypted mails, the author's key whose id is 0606CEF7 is available on public keyrings such as the MIT PGP Public Key Server or directly here. Be sure that the fetched the key you obtained has the following fingerprint:

79C9 10C8 9C3A 3F35 482F  06D6 150B A8BB 0606 CEF7

License

The madlld program is © 2001–2004 by Bertrand Petit, all rights reserved. It is distributed under the terms of the license similar to the Berkeley license reproduced below.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. Neither the name of the author nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

---

Bertrand Petit <madlld \at phoe \dot frmug \dot org>
2004-03-19