Functions

Artist subsystem

Functions

const char * sp_artist_name (sp_artist *artist)
bool sp_artist_is_loaded (sp_artist *artist)
const byte * sp_artist_portrait (sp_artist *artist, sp_image_size size)
sp_error sp_artist_add_ref (sp_artist *artist)
sp_error sp_artist_release (sp_artist *artist)

Function Documentation

sp_error sp_artist_add_ref ( sp_artist artist  ) 

Increase the reference count of a artist

Parameters:
[in] artist The artist object
Returns:
One of the following errors, from sp_error SP_ERROR_OK
bool sp_artist_is_loaded ( sp_artist artist  ) 

Check if the artist object is populated with data

Parameters:
[in] artist An artist object
Returns:
True if metadata is present, false if not
const char* sp_artist_name ( sp_artist artist  ) 

Return name of artist

Parameters:
[in] artist Artist object
Returns:
Name of artist. Returned string is valid as long as the artist object stays allocated and no longer than the next call to sp_session_process_events()
Examples:
browse.c, search.c, and toplist.c.
const byte* sp_artist_portrait ( sp_artist artist,
sp_image_size  size 
)

Return portrait for artist

Parameters:
[in] artist The artist object
[in] size The desired size of the image
Returns:
ID byte sequence that can be passed to sp_image_create() If the artist has no image or the metadata for the album is not loaded yet, this function returns NULL.
sp_error sp_artist_release ( sp_artist artist  ) 

Decrease the reference count of a artist

Parameters:
[in] artist The artist object
Returns:
One of the following errors, from sp_error SP_ERROR_OK

Generated on Wed Jun 13 2012 14:22:40.
Copyright © 2006–2012 Spotify Ltd