download : svn :: features :: sf.net project - bug tracker :: news archive

libmpg123 API :: testing :: benchmarking :: faq :: links :: contact

Note: This API doc is automatically generated from the current development version that you can get via Subversion or as a daily snapshot from http://mpg123.org/snapshot. There may be differences (additions) compared to the latest stable release. See NEWS.libmpg123 and the overall NEWS file on libmpg123 versions and important changes between them.
Let me emphasize that the policy for libmpg123 is to always stay backwards compatible -- only additions are planned (and it's not yet planned to change the plans;-).

mpg123 decoder selection

Functions
const char **	mpg123_decoders ()
const char **	mpg123_supported_decoders ()
int	mpg123_decoder (mpg123_handle *mh, const char *decoder_name)
const char *	mpg123_current_decoder (mpg123_handle *mh)

---

Detailed Description

Functions to list and select the available decoders. Perhaps the most prominent feature of mpg123: You have several (optimized) decoders to choose from (on x86 and PPC (MacOS) systems, that is).

---

Function Documentation

const char** mpg123_decoders

(

)

Return a NULL-terminated array of generally available decoder names (plain 8bit ASCII).

const char** mpg123_supported_decoders

(

)

Return a NULL-terminated array of the decoders supported by the CPU (plain 8bit ASCII).

int mpg123_decoder	(	mpg123_handle *	mh,
		const char *	decoder_name
	)

Set the chosen decoder to 'decoder_name'

const char* mpg123_current_decoder

(

mpg123_handle *

mh

)

Get the currently active decoder engine name. The active decoder engine can vary depening on output constraints, mostly non-resampling, integer output is accelerated via 3DNow & Co. but for other modes a fallback engine kicks in. Note that this can return a decoder that is ony active in the hidden and not available as decoder choice from the outside.

Returns:

The decoder name or NULL on error.

---