Functions to get and modify the status/state of mpd.
◆ mpd_status_check()
int mpd_status_check |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
Checks if there is status information available. if not available, it tries to fetch it. This function is called from within libmpd, and shouldn't be called from the program.
- Returns
- 0 when successful
◆ mpd_status_db_is_updating()
int mpd_status_db_is_updating |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
Checks if mpd is updating it's music db.
- Returns
- TRUE if mpd is still updating, FALSE if not.
- Examples:
- testcase.c.
◆ mpd_status_get_bitrate()
int mpd_status_get_bitrate |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
get the bitrate of the currently playing song in kbs. This is a constantly updating value. (for vbr songs)
- Returns
- bitrate in kbs
◆ mpd_status_get_bits()
int mpd_status_get_bits |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
get the number of bits per sample of the currently playing song.
- Returns
- bits per sample
◆ mpd_status_get_channels()
int mpd_status_get_channels |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
get the number of channels in the currently playing song. This is usually only 1(mono) or 2(stereo), but this might change in the future.
- Returns
- number of channels
◆ mpd_status_get_crossfade()
int mpd_status_get_crossfade |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
Get the crossfade time. 0 is disabled.
- Returns
- The crossfade time in seconds
- Examples:
- testcase.c.
◆ mpd_status_get_elapsed_song_time()
int mpd_status_get_elapsed_song_time |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
Gets the elapsed time of the currently playing song.
- Returns
- Time in seconds
◆ mpd_status_get_mpd_error()
char* mpd_status_get_mpd_error |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
- Returns
- the error message that mpd last reported, or NULL. Needs to be freed.
◆ mpd_status_get_samplerate()
unsigned int mpd_status_get_samplerate |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
get the samplerate of the currently playing song in bps.
- Returns
- samplerate in bps
◆ mpd_status_get_total_song_time()
int mpd_status_get_total_song_time |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
get the total length of the currently playing song.
- Returns
- time in seconds or <0 when failed.
- Examples:
- testcase.c.
◆ mpd_status_get_volume()
int mpd_status_get_volume |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
Get the audio output volume.
- Returns
- the audio output volume between 0 and 100 or < 0 when failed
- Examples:
- testcase.c.
◆ mpd_status_queue_update()
int mpd_status_queue_update |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
Marks the current status invalid, the next time status is needed it will be fetched from mpd.
- Returns
- 0 when successful
◆ mpd_status_set_crossfade()
int mpd_status_set_crossfade |
( |
MpdObj * |
mi, |
|
|
int |
crossfade_time |
|
) |
| |
- Parameters
-
mi | a MpdObj |
crossfade_time | the time to crossfade in seconds |
Sets the crossfade time. 0 to disable crossfade.
- Returns
- 0 when successful
◆ mpd_status_set_volume()
int mpd_status_set_volume |
( |
MpdObj * |
mi, |
|
|
int |
volume |
|
) |
| |
- Parameters
-
mi | a MpdObj |
volume | a value between 0 and 100. |
Set the output volume
- Returns
- the new volume or < 0 when failed.
- Examples:
- testcase.c.
◆ mpd_status_set_volume_as_float()
float mpd_status_set_volume_as_float |
( |
MpdObj * |
mi, |
|
|
float |
fvol |
|
) |
| |
- Parameters
-
mi | a MpdObj |
fvol | a float between 0.0 and 1.0 |
Set the output volume
- Returns
- the new volume or a value below 0 when failed.
◆ mpd_status_update()
int mpd_status_update |
( |
MpdObj * |
mi | ) |
|
- Parameters
-
Updates the status field from mpd. Call this function every 0.x seconds from the program's main-loop to receive signals when mpd's status has changed.
- Returns
- 0 when succesfull
- Examples:
- testcase.c.