gmerlin-avdecoder Documentation


This is the API documentation for Gmerlin avdecoder, a general multimedia decoding library.

Click Modules (on top of the page) to get to the main API index. Here, you find just some general blabla :)

Why gmerlin-avdecoder?

The reasons for programming gmerlin-avdecoder lie in the history of the gmerlin project. The old gmerlin (the 0.1.x series) used 3rd party libraries for decoding multimedia formats. These were libmpeg3 (later libgmerlin_mpeg), avifile, quicktime4linux (later libquicktime), libsndfile, libvorbisfile etc. This method worked surprisingly well (from the users standpoint), but had some serious drawbacks (from the programmers standpoint):

Or put it this way: Writing a decoding library, which supports just a handful of filetypes, is nonsense. Multimedia programming is so complicated that every small module should be programmed exactly once and then right.

Of course, other people had similar ideas and came up with solutions:

A lot of brainload was spent on the matter. A decoding library should not only work for playback applications, but also for transcoding. Therefore, we must not make any asumptions about the final destination of the data we decode. Metadata should be read from the files and made available to the rest of the application. The application range should be from 8bit/8KHz Mono streams to high definition production environments. No high quality codec should be too insane to be supported.

What is gmerlin-avdecoder?

The solution, which was found, is the library, whose documentation you are reading right now. It lets you decode lots of fileformats with lots of codecs from lots of sources. It supports data sources with multiple tracks (e.g. VCD tracks, ALBW wrapped mp3s), each track can have an arbitrary number of audio/video streams. You can decode all streams at once, or switch unwanted streams off, so they are skipped. It is (with few limitations) thread save per instance and allows multiple decoding instances per process, which can be accessed from multiple threads. This is an important feature for editing applications.

Metadata (additional information about the material) are read whenever possible. The resulting strings are converted to UTF-8 for language independent display. MP3s with Arabic or Chinese ID3-Tags are therefore no problem at all.

Gmerlin-avdecoder is built upon gavl. Therefore, the codecs never do any implicit conversion of audio or video formats (like colorspace conversion, resampling, scaling etc.). Each codec sets the gavl_audio_format_t or gavl_video_format_t to what it can natively deliver. Format conversions are entirely up to the application.

Datasources, gmerlin-avdecoder can access, include:

Demultiplexers are present for the following formats:

(See for a complete list).

All these features make gmerlin-avdecoder ideal for playback and transcoding applications, where sequential decoding is needed.

When should I NOT use gmerlin-avdecoder?

There are a small number of reasons, why gmerlin_avdecoder might not be the method of choice:

Generated on Fri Jun 8 17:30:02 2012 for gmerlin-avdecoder by  doxygen 1.6.3