Introduction
libmad is a powerful open source library written in C that decodes MP3 files to uncompressed PCM data. However, it compiles as a static library, limiting its access to C/C++. I have written code (based on the source madlld) that compiles to a DLL, enabling other languages (i.e., C#, Visual Basic etc.) to access the libmad library using the simple interface I've provided.
Programming the API
The DLL source is well documented, so I will concentrate on using the API, and allow the curious to poke around the guts on their own (it is likely that the API is of most interest to most people). However, a brief overview of the source is in order.
madlldlib is codified into a single, simple interface, consisting of just one function, CbMpegAudioDecoder()
, which takes the names of the input and output files, and a callback function as parameters. The callback function is passed information about the decoding process (such as total bytes converted and frame count) as it decodes, which in turn can be used to update decoding status in whatever interface the developer chooses.
There is a small file, test.cpp, included in the source which demonstrates the API. It is kept as simple as possible to make it easy to understand.
First, test.cpp defines a function called mycb()
. This function is the callback (function pointer) that madlldlib will send decoding status to. It is within this function that you will update status in your application. test.cpp merely formats the output and prints it to STDOUT.
void __stdcall mycb (unsigned long fcnt,
unsigned long bcnt, struct mad_header *mhdr) {
if (fcnt == 1) {
printf("frame:%d, tot. bytes:%d, layer:%d\n",fcnt,bcnt,mhdr->layer);
}
else {
printf("frame:%d, tot. bytes:%d\n",fcnt,bcnt);
}
}
As you can see, the output is very simple. You must define a function in your code with exactly the parameter types that mycb()
has defined above (the names of the parameters, obviously, are up to you).
Next, we move into the main()
function. After checking arguments and handling filenames, it calls the decoding function CbMpegAudioDecoder()
with the given parameters.
if (strcmp(argv[2], "pcm")==0) {
status = CbMpegAudioDecoder(argv[1], outf, 0, statmsg, mycb);
}
else {
status = CbMpegAudioDecoder(argv[1], outf, 1, statmsg, mycb);
}
Note that it passed our callback function mycb()
to CbMpegAudioDecoder()
, which will send it information every decoding loop. The other item of interest is the parameter statmsg
, which is used to relay any error messages our function may encounter. If, say, the MP3 file is corrupt, this message will end up in statmsg
, which you can use to pass on to the user of your application.
The two files, armslen.cpp and armslen_test.cpp, give an example of decoding while sending status via a named pipe. This way you do not have to use madlldlib as a DLL in your project if you don't desire to. armslen.cpp compiles to an executable that takes parameters similar to test.cpp (input filename, output filename, output format). It then generates a named pipe server, and waits until a client program connects (armslen_test.cpp). Once the client makes the connection, armslen.cpp sends the decoding update status to the named pipe while it decodes the MP3. The client can then pick up, parse, and use the status to update its interface.
Source and Contact
The most current code will always be here.
If you have comments or questions, you can direct them to the mailing list madlldlib-dev.
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.