mp3_player.c File Reference

MP3 Player component implementation. More...

Data Structures
struct	mp3player_t
	MP3 File Information Structure. More...

Macros
#define	MINIMP3_IMPLEMENTATION
#define	MINIMP3_ONLY_MP3
#define	SEEK_PREDECODE_FRAMES   (5)

Functions
void	mp3player_mixer_init (void)
	Initialize the MP3 player mixer.
mp3player_err_t	mp3player_init (void)
	Initialize the MP3 player.
void	mp3player_deinit (void)
	Deinitialize the MP3 player.
mp3player_err_t	mp3player_load (char *path)
	Load an MP3 file.
void	mp3player_unload (void)
	Unload the MP3 file.
mp3player_err_t	mp3player_process (void)
	Process the MP3 player.
bool	mp3player_is_playing (void)
	Check if the MP3 player is playing.
bool	mp3player_is_finished (void)
	Check if the MP3 player has finished playing.
mp3player_err_t	mp3player_play (void)
	Play the MP3 file.
void	mp3player_stop (void)
	Stop the MP3 player.
mp3player_err_t	mp3player_toggle (void)
	Toggle the MP3 player between play and stop.
void	mp3player_mute (bool mute)
	Mute or unmute the MP3 player.
mp3player_err_t	mp3player_seek (int seconds)
	Seek to a specific position in the MP3 file.
float	mp3player_get_duration (void)
	Get the duration of the MP3 file.
float	mp3player_get_bitrate (void)
	Get the bitrate of the MP3 file.
int	mp3player_get_samplerate (void)
	Get the sample rate of the MP3 file.
float	mp3player_get_progress (void)
	Get the progress of the MP3 file playback.

Detailed Description

MP3 Player component implementation.

---

Data Structure Documentation

mp3player_t

struct mp3player_t

MP3 File Information Structure.

Data Fields
bool	loaded	Indicates if the MP3 file is loaded
FILE *	f	File pointer
size_t	file_size	Size of the file
size_t	data_start	Start position of the data
uint8_t	buffer[16 *1024]	Buffer for reading data
uint8_t *	buffer_ptr	Pointer to the current position in the buffer
size_t	buffer_left	Amount of data left in the buffer
mp3dec_t	dec	MP3 decoder
mp3dec_frame_info_t	info	MP3 frame information
int	seek_predecode_frames	Number of frames to pre-decode when seeking
float	duration	Duration of the MP3 file
float	bitrate	Bitrate of the MP3 file
waveform_t	wave	Waveform structure for playback

Function Documentation

mp3player_mixer_init()

void mp3player_mixer_init

(

void

)

Initialize the MP3 player mixer.

This function initializes the mixer for the MP3 player.

mp3player_init()

mp3player_err_t mp3player_init

(

void

)

Initialize the MP3 player.

Returns

mp3player_err_t Error code.

mp3player_deinit()

void mp3player_deinit

(

void

)

Deinitialize the MP3 player.

This function deinitializes the MP3 player and releases any resources.

mp3player_load()

mp3player_err_t mp3player_load

(

char *

path

)

Load an MP3 file.

Parameters

path	Path to the MP3 file.

Returns

mp3player_err_t Error code.

mp3player_unload()

void mp3player_unload

(

void

)

Unload the MP3 file.

Unload the current MP3 file.

mp3player_process()

mp3player_err_t mp3player_process

(

void

)

Process the MP3 player.

Returns

mp3player_err_t Error code.

mp3player_is_playing()

bool mp3player_is_playing

(

void

)

Check if the MP3 player is playing.

Returns

true if playing, false otherwise.

mp3player_is_finished()

bool mp3player_is_finished

(

void

)

Check if the MP3 player has finished playing.

Returns

true if finished, false otherwise.

mp3player_play()

mp3player_err_t mp3player_play

(

void

)

Play the MP3 file.

Start playback of the MP3 file.

Returns

mp3player_err_t Error code.

mp3player_stop()

void mp3player_stop

(

void

)

Stop the MP3 player.

Stop playback of the MP3 file.

mp3player_toggle()

mp3player_err_t mp3player_toggle

(

void

)

Toggle the MP3 player between play and stop.

Toggle playback of the MP3 file.

Returns

mp3player_err_t Error code.

mp3player_mute()

void mp3player_mute

(

bool

mute

)

Mute or unmute the MP3 player.

Parameters

mute	True to mute, false to unmute.

mp3player_seek()

mp3player_err_t mp3player_seek

(

int

seconds

)

Seek to a specific position in the MP3 file.

Parameters

seconds

Number of seconds to seek.

Returns

mp3player_err_t Error code.

mp3player_get_duration()

float mp3player_get_duration

(

void

)

Get the duration of the MP3 file.

Returns

float Duration in seconds.

mp3player_get_bitrate()

float mp3player_get_bitrate

(

void

)

Get the bitrate of the MP3 file.

Returns

float Bitrate in kbps.

mp3player_get_samplerate()

int mp3player_get_samplerate

(

void

)

Get the sample rate of the MP3 file.

Returns

int Sample rate in Hz.

mp3player_get_progress()

float mp3player_get_progress

(

void

)

Get the progress of the MP3 file playback.

Get the current playback progress.

Returns

float Progress as a percentage.