mpg123.h File Reference

#include <stdlib.h>
#include <sys/types.h>

Go to the source code of this file.

Data Structures
struct	mpg123_frameinfo
struct	mpg123_string
struct	mpg123_text
struct	mpg123_id3v2
struct	mpg123_id3v1
Defines
#define	MPG123_API_VERSION   25
#define	EXPORT
#define	MPG123_ID3   0x3
#define	MPG123_NEW_ID3   0x1
#define	MPG123_ICY   0xc
#define	MPG123_NEW_ICY   0x4
Enumerations
enum	mpg123_parms {   MPG123_VERBOSE, MPG123_FLAGS, MPG123_ADD_FLAGS, MPG123_FORCE_RATE,   MPG123_DOWN_SAMPLE, MPG123_RVA, MPG123_DOWNSPEED, MPG123_UPSPEED,   MPG123_START_FRAME, MPG123_DECODE_FRAMES, MPG123_ICY_INTERVAL, MPG123_OUTSCALE,   MPG123_TIMEOUT, MPG123_REMOVE_FLAGS, MPG123_RESYNC_LIMIT, MPG123_INDEX_SIZE,   MPG123_PREFRAMES }
enum	mpg123_param_flags {   MPG123_FORCE_MONO = 0x7, MPG123_MONO_LEFT = 0x1, MPG123_MONO_RIGHT = 0x2, MPG123_MONO_MIX = 0x4,   MPG123_FORCE_STEREO = 0x8, MPG123_FORCE_8BIT = 0x10, MPG123_QUIET = 0x20, MPG123_GAPLESS = 0x40,   MPG123_NO_RESYNC = 0x80, MPG123_SEEKBUFFER = 0x100, MPG123_FUZZY = 0x200, MPG123_FORCE_FLOAT = 0x400,   MPG123_PLAIN_ID3TEXT = 0x800, MPG123_IGNORE_STREAMLENGTH = 0x1000 }
enum	mpg123_param_rva { MPG123_RVA_OFF = 0, MPG123_RVA_MIX = 1, MPG123_RVA_ALBUM = 2, MPG123_RVA_MAX = MPG123_RVA_ALBUM }
enum	mpg123_feature_set {   MPG123_FEATURE_ABI_UTF8OPEN = 0, MPG123_FEATURE_OUTPUT_8BIT, MPG123_FEATURE_OUTPUT_16BIT, MPG123_FEATURE_OUTPUT_32BIT,   MPG123_FEATURE_INDEX, MPG123_FEATURE_PARSE_ID3V2, MPG123_FEATURE_DECODE_LAYER1, MPG123_FEATURE_DECODE_LAYER2,   MPG123_FEATURE_DECODE_LAYER3, MPG123_FEATURE_DECODE_ACCURATE, MPG123_FEATURE_DECODE_DOWNSAMPLE, MPG123_FEATURE_DECODE_NTOM,   MPG123_FEATURE_PARSE_ICY, MPG123_FEATURE_TIMEOUT_READ }
enum	mpg123_errors {   MPG123_DONE = -12, MPG123_NEW_FORMAT = -11, MPG123_NEED_MORE = -10, MPG123_ERR = -1,   MPG123_OK = 0, MPG123_BAD_OUTFORMAT, MPG123_BAD_CHANNEL, MPG123_BAD_RATE,   MPG123_ERR_16TO8TABLE, MPG123_BAD_PARAM, MPG123_BAD_BUFFER, MPG123_OUT_OF_MEM,   MPG123_NOT_INITIALIZED, MPG123_BAD_DECODER, MPG123_BAD_HANDLE, MPG123_NO_BUFFERS,   MPG123_BAD_RVA, MPG123_NO_GAPLESS, MPG123_NO_SPACE, MPG123_BAD_TYPES,   MPG123_BAD_BAND, MPG123_ERR_NULL, MPG123_ERR_READER, MPG123_NO_SEEK_FROM_END,   MPG123_BAD_WHENCE, MPG123_NO_TIMEOUT, MPG123_BAD_FILE, MPG123_NO_SEEK,   MPG123_NO_READER, MPG123_BAD_PARS, MPG123_BAD_INDEX_PAR, MPG123_OUT_OF_SYNC,   MPG123_RESYNC_FAIL, MPG123_NO_8BIT, MPG123_BAD_ALIGN, MPG123_NULL_BUFFER,   MPG123_NO_RELSEEK, MPG123_NULL_POINTER, MPG123_BAD_KEY, MPG123_NO_INDEX,   MPG123_INDEX_FAIL, MPG123_BAD_DECODER_SETUP, MPG123_MISSING_FEATURE, MPG123_BAD_VALUE,   MPG123_LSEEK_FAILED, MPG123_BAD_CUSTOM_IO, MPG123_LFS_OVERFLOW }
enum	mpg123_enc_enum {   MPG123_ENC_8 = 0x00f, MPG123_ENC_16 = 0x040, MPG123_ENC_32 = 0x100, MPG123_ENC_SIGNED = 0x080,   MPG123_ENC_FLOAT = 0xe00, MPG123_ENC_SIGNED_16 = (MPG123_ENC_16|MPG123_ENC_SIGNED|0x10), MPG123_ENC_UNSIGNED_16 = (MPG123_ENC_16|0x20), MPG123_ENC_UNSIGNED_8 = 0x01,   MPG123_ENC_SIGNED_8 = (MPG123_ENC_SIGNED|0x02), MPG123_ENC_ULAW_8 = 0x04, MPG123_ENC_ALAW_8 = 0x08, MPG123_ENC_SIGNED_32 = MPG123_ENC_32|MPG123_ENC_SIGNED|0x1000,   MPG123_ENC_UNSIGNED_32 = MPG123_ENC_32|0x2000, MPG123_ENC_FLOAT_32 = 0x200, MPG123_ENC_FLOAT_64 = 0x400, MPG123_ENC_ANY }
enum	mpg123_channelcount { MPG123_MONO = 1, MPG123_STEREO = 2 }
enum	mpg123_channels { MPG123_LEFT = 0x1, MPG123_RIGHT = 0x2, MPG123_LR = 0x3 }
enum	mpg123_vbr { MPG123_CBR = 0, MPG123_VBR, MPG123_ABR }
enum	mpg123_version { MPG123_1_0 = 0, MPG123_2_0, MPG123_2_5 }
enum	mpg123_mode { MPG123_M_STEREO = 0, MPG123_M_JOINT, MPG123_M_DUAL, MPG123_M_MONO }
enum	mpg123_flags { MPG123_CRC = 0x1, MPG123_COPYRIGHT = 0x2, MPG123_PRIVATE = 0x4, MPG123_ORIGINAL = 0x8 }
enum	mpg123_state { MPG123_ACCURATE = 1 }
enum	mpg123_text_encoding {   mpg123_text_unknown = 0, mpg123_text_utf8 = 1, mpg123_text_latin1 = 2, mpg123_text_icy = 3,   mpg123_text_cp1252 = 4, mpg123_text_utf16 = 5, mpg123_text_utf16bom = 6, mpg123_text_utf16be = 7,   mpg123_text_max = 7 }
enum	mpg123_id3_enc {   mpg123_id3_latin1 = 0, mpg123_id3_utf16bom = 1, mpg123_id3_utf16be = 2, mpg123_id3_utf8 = 3,   mpg123_id3_enc_max = 3 }
Functions
EXPORT int	mpg123_init (void)
EXPORT void	mpg123_exit (void)
EXPORT mpg123_handle *	mpg123_new (const char *decoder, int *error)
EXPORT void	mpg123_delete (mpg123_handle *mh)
EXPORT int	mpg123_param (mpg123_handle *mh, enum mpg123_parms type, long value, double fvalue)
EXPORT int	mpg123_getparam (mpg123_handle *mh, enum mpg123_parms type, long *val, double *fval)
EXPORT int	mpg123_feature (const enum mpg123_feature_set key)
EXPORT const char *	mpg123_plain_strerror (int errcode)
EXPORT const char *	mpg123_strerror (mpg123_handle *mh)
EXPORT int	mpg123_errcode (mpg123_handle *mh)
EXPORT const char **	mpg123_decoders (void)
EXPORT const char **	mpg123_supported_decoders (void)
EXPORT int	mpg123_decoder (mpg123_handle *mh, const char *decoder_name)
EXPORT const char *	mpg123_current_decoder (mpg123_handle *mh)
EXPORT void	mpg123_rates (const long **list, size_t *number)
EXPORT void	mpg123_encodings (const int **list, size_t *number)
EXPORT int	mpg123_format_none (mpg123_handle *mh)
EXPORT int	mpg123_format_all (mpg123_handle *mh)
EXPORT int	mpg123_format (mpg123_handle *mh, long rate, int channels, int encodings)
EXPORT int	mpg123_format_support (mpg123_handle *mh, long rate, int encoding)
EXPORT int	mpg123_getformat (mpg123_handle *mh, long *rate, int *channels, int *encoding)
EXPORT int	mpg123_open (mpg123_handle *mh, const char *path)
EXPORT int	mpg123_open_fd (mpg123_handle *mh, int fd)
EXPORT int	mpg123_open_handle (mpg123_handle *mh, void *iohandle)
EXPORT int	mpg123_open_feed (mpg123_handle *mh)
EXPORT int	mpg123_close (mpg123_handle *mh)
EXPORT int	mpg123_read (mpg123_handle *mh, unsigned char *outmemory, size_t outmemsize, size_t *done)
EXPORT int	mpg123_feed (mpg123_handle *mh, const unsigned char *in, size_t size)
EXPORT int	mpg123_decode (mpg123_handle *mh, const unsigned char *inmemory, size_t inmemsize, unsigned char *outmemory, size_t outmemsize, size_t *done)
EXPORT int	mpg123_decode_frame (mpg123_handle *mh, off_t *num, unsigned char **audio, size_t *bytes)
EXPORT int	mpg123_framebyframe_decode (mpg123_handle *mh, off_t *num, unsigned char **audio, size_t *bytes)
EXPORT int	mpg123_framebyframe_next (mpg123_handle *mh)
EXPORT off_t	mpg123_tell (mpg123_handle *mh)
EXPORT off_t	mpg123_tellframe (mpg123_handle *mh)
EXPORT off_t	mpg123_tell_stream (mpg123_handle *mh)
EXPORT off_t	mpg123_seek (mpg123_handle *mh, off_t sampleoff, int whence)
EXPORT off_t	mpg123_feedseek (mpg123_handle *mh, off_t sampleoff, int whence, off_t *input_offset)
EXPORT off_t	mpg123_seek_frame (mpg123_handle *mh, off_t frameoff, int whence)
EXPORT off_t	mpg123_timeframe (mpg123_handle *mh, double sec)
EXPORT int	mpg123_index (mpg123_handle *mh, off_t **offsets, off_t *step, size_t *fill)
EXPORT int	mpg123_set_index (mpg123_handle *mh, off_t *offsets, off_t step, size_t fill)
EXPORT int	mpg123_position (mpg123_handle *mh, off_t frame_offset, off_t buffered_bytes, off_t *current_frame, off_t *frames_left, double *current_seconds, double *seconds_left)
EXPORT int	mpg123_eq (mpg123_handle *mh, enum mpg123_channels channel, int band, double val)
EXPORT double	mpg123_geteq (mpg123_handle *mh, enum mpg123_channels channel, int band)
EXPORT int	mpg123_reset_eq (mpg123_handle *mh)
EXPORT int	mpg123_volume (mpg123_handle *mh, double vol)
EXPORT int	mpg123_volume_change (mpg123_handle *mh, double change)
EXPORT int	mpg123_getvolume (mpg123_handle *mh, double *base, double *really, double *rva_db)
EXPORT int	mpg123_info (mpg123_handle *mh, struct mpg123_frameinfo *mi)
EXPORT size_t	mpg123_safe_buffer (void)
EXPORT int	mpg123_scan (mpg123_handle *mh)
EXPORT off_t	mpg123_length (mpg123_handle *mh)
EXPORT int	mpg123_set_filesize (mpg123_handle *mh, off_t size)
EXPORT double	mpg123_tpf (mpg123_handle *mh)
EXPORT long	mpg123_clip (mpg123_handle *mh)
EXPORT int	mpg123_getstate (mpg123_handle *mh, enum mpg123_state key, long *val, double *fval)
EXPORT void	mpg123_init_string (mpg123_string *sb)
EXPORT void	mpg123_free_string (mpg123_string *sb)
EXPORT int	mpg123_resize_string (mpg123_string *sb, size_t news)
EXPORT int	mpg123_grow_string (mpg123_string *sb, size_t news)
EXPORT int	mpg123_copy_string (mpg123_string *from, mpg123_string *to)
EXPORT int	mpg123_add_string (mpg123_string *sb, const char *stuff)
EXPORT int	mpg123_add_substring (mpg123_string *sb, const char *stuff, size_t from, size_t count)
EXPORT int	mpg123_set_string (mpg123_string *sb, const char *stuff)
EXPORT int	mpg123_set_substring (mpg123_string *sb, const char *stuff, size_t from, size_t count)
EXPORT enum mpg123_text_encoding	mpg123_enc_from_id3 (unsigned char id3_enc_byte)
EXPORT int	mpg123_store_utf8 (mpg123_string *sb, enum mpg123_text_encoding enc, const unsigned char *source, size_t source_size)
EXPORT int	mpg123_meta_check (mpg123_handle *mh)
EXPORT int	mpg123_id3 (mpg123_handle *mh, mpg123_id3v1 **v1, mpg123_id3v2 **v2)
EXPORT int	mpg123_icy (mpg123_handle *mh, char **icy_meta)
EXPORT char *	mpg123_icy2utf8 (const char *icy_text)
EXPORT mpg123_handle *	mpg123_parnew (mpg123_pars *mp, const char *decoder, int *error)
EXPORT mpg123_pars *	mpg123_new_pars (int *error)
EXPORT void	mpg123_delete_pars (mpg123_pars *mp)
EXPORT int	mpg123_fmt_none (mpg123_pars *mp)
EXPORT int	mpg123_fmt_all (mpg123_pars *mp)
EXPORT int	mpg123_fmt (mpg123_pars *mh, long rate, int channels, int encodings)
EXPORT int	mpg123_fmt_support (mpg123_pars *mh, long rate, int encoding)
EXPORT int	mpg123_par (mpg123_pars *mp, enum mpg123_parms type, long value, double fvalue)
EXPORT int	mpg123_getpar (mpg123_pars *mp, enum mpg123_parms type, long *val, double *fval)
EXPORT int	mpg123_replace_buffer (mpg123_handle *mh, unsigned char *data, size_t size)
EXPORT size_t	mpg123_outblock (mpg123_handle *mh)
EXPORT int	mpg123_replace_reader (mpg123_handle *mh, long(*r_read)(int, void *, size_t), off_t(*r_lseek)(int, off_t, int))
EXPORT int	mpg123_replace_reader_handle (mpg123_handle *mh, long(*r_read)(void *, void *, size_t), off_t(*r_lseek)(void *, off_t, int), void(*cleanup)(void *))

---

Detailed Description

The header file for the libmpg123 MPEG Audio decoder

Definition in file mpg123.h.