Album subsystem


Functions

bool sp_album_is_loaded (sp_album *album)
sp_artistsp_album_artist (sp_album *album)
const byte * sp_album_cover (sp_album *album)
const char * sp_album_name (sp_album *album)
int sp_album_year (sp_album *album)
void sp_album_add_ref (sp_album *album)
void sp_album_release (sp_album *album)

Function Documentation

void sp_album_add_ref ( sp_album album  ) 

Increase the reference count of an album

Parameters:
[in] album The album object

sp_artist* sp_album_artist ( sp_album album  ) 

Get the artist associated with the given album

Parameters:
[in] album Album object
Returns:
A reference to the artist. NULL if the metadata has not been loaded yet

const byte* sp_album_cover ( sp_album album  ) 

Return image ID representing the album's coverart.

Parameters:
[in] album Album object
Returns:
ID byte sequence that can be passed to sp_image_create() If the album has no image or the metadata for the album is not loaded yet, this function returns NULL.
See also:
sp_image_create
Examples:
track.c.

bool sp_album_is_loaded ( sp_album album  ) 

Check if the album object is populated with data

Parameters:
[in] album Album object
Returns:
True if metadata is present, false if not
Examples:
track.c.

const char* sp_album_name ( sp_album album  ) 

Return name of album

Parameters:
[in] album Album object
Returns:
Name of album. Returned string is valid as long as the album object stays allocated and no longer than the next call to sp_session_process_events()
Examples:
browse.c, and search.c.

void sp_album_release ( sp_album album  ) 

Decrease the reference count of an album

Parameters:
[in] album The album object

int sp_album_year ( sp_album album  ) 

Return release year of specified album

Parameters:
[in] album Album object
Returns:
Release year
Examples:
browse.c, and search.c.


Generated on Tue Apr 7 15:21:55 2009.
Copyright © 2006–2009 Spotify Ltd