![]() |
![]() |
![]() |
Grilo Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy |
#include <grilo.h> struct GrlMediaAudio; struct GrlMediaAudioClass; GrlMedia * grl_media_audio_new (void
); void grl_media_audio_add_artist (GrlMediaAudio *audio
,const gchar *artist
); void grl_media_audio_add_genre (GrlMediaAudio *audio
,const gchar *genre
); void grl_media_audio_add_lyrics (GrlMediaAudio *audio
,const gchar *lyrics
); void grl_media_audio_add_url_data (GrlMediaAudio *audio
,const gchar *url
,const gchar *mime
,gint bitrate
); const gchar * grl_media_audio_get_album (GrlMediaAudio *audio
); const gchar * grl_media_audio_get_artist (GrlMediaAudio *audio
); const gchar * grl_media_audio_get_artist_nth (GrlMediaAudio *audio
,guint index
); gint grl_media_audio_get_bitrate (GrlMediaAudio *audio
); const gchar * grl_media_audio_get_genre (GrlMediaAudio *audio
); const gchar * grl_media_audio_get_genre_nth (GrlMediaAudio *audio
,guint index
); const gchar * grl_media_audio_get_lyrics (GrlMediaAudio *audio
); const gchar * grl_media_audio_get_lyrics_nth (GrlMediaAudio *audio
,guint index
); gint grl_media_audio_get_track_number (GrlMediaAudio *audio
); const gchar * grl_media_audio_get_url_data (GrlMediaAudio *audio
,gchar **mime
,gint *bitrate
); const gchar * grl_media_audio_get_url_data_nth (GrlMediaAudio *audio
,guint index
,gchar **mime
,gint *bitrate
); void grl_media_audio_set_album (GrlMediaAudio *audio
,const gchar *album
); void grl_media_audio_set_artist (GrlMediaAudio *audio
,const gchar *artist
); void grl_media_audio_set_bitrate (GrlMediaAudio *audio
,gint bitrate
); void grl_media_audio_set_genre (GrlMediaAudio *audio
,const gchar *genre
); void grl_media_audio_set_lyrics (GrlMediaAudio *audio
,const gchar *lyrics
); void grl_media_audio_set_track_number (GrlMediaAudio *audio
,gint track_number
); void grl_media_audio_set_url_data (GrlMediaAudio *audio
,const gchar *url
,const gchar *mime
,gint bitrate
);
This high level class represents an audio multimedia item. It has methods to set and get properties like artist, album, and so on.
struct GrlMediaAudioClass { GrlMediaClass parent_class; };
Grilo Media audio Class
GrlMediaClass |
the parent class structure |
GrlMedia * grl_media_audio_new (void
);
Creates a new data audio object.
Returns : |
a newly-allocated data audio. |
Since 0.1.4
void grl_media_audio_add_artist (GrlMediaAudio *audio
,const gchar *artist
);
Adds a new artist to audio
.
|
the media instance |
|
an audio's artist |
Since 0.1.10
void grl_media_audio_add_genre (GrlMediaAudio *audio
,const gchar *genre
);
Adds a new genre to audio
.
|
the media instance |
|
an audio's genre |
Since 0.1.10
void grl_media_audio_add_lyrics (GrlMediaAudio *audio
,const gchar *lyrics
);
Adds a new lyrics to audio
.
|
the media instance |
|
an audio's lyrics |
Since 0.1.10
void grl_media_audio_add_url_data (GrlMediaAudio *audio
,const gchar *url
,const gchar *mime
,gint bitrate
);
Sets all the keys related with the URL of a media resource and adds it to
audio
(useful for resources with more than one URL).
|
the media instance |
|
an audio's url |
|
the url mime-type |
|
the url bitrate, or -1 to ignore |
Since 0.1.10
const gchar * grl_media_audio_get_album (GrlMediaAudio *audio
);
|
the media instance |
Returns : |
the album of the audio |
Since 0.1.4
const gchar * grl_media_audio_get_artist (GrlMediaAudio *audio
);
|
the media instance |
Returns : |
the artist of the audio |
Since 0.1.4
const gchar * grl_media_audio_get_artist_nth (GrlMediaAudio *audio
,guint index
);
|
the media instance |
|
element to retrieve, starting at 0 |
Returns : |
the n-th artist of the audio |
Since 0.1.10
gint grl_media_audio_get_bitrate (GrlMediaAudio *audio
);
|
the media instance |
Returns : |
the bitrate of the audio |
Since 0.1.4
const gchar * grl_media_audio_get_genre (GrlMediaAudio *audio
);
|
the media instance |
Returns : |
the genre of the audio |
Since 0.1.4
const gchar * grl_media_audio_get_genre_nth (GrlMediaAudio *audio
,guint index
);
|
the media instance |
|
element to retrieve, starting at 0 |
Returns : |
the n-th genre of the audio |
Since 0.1.10
const gchar * grl_media_audio_get_lyrics (GrlMediaAudio *audio
);
|
the media instance |
Returns : |
the lyrics of the audio |
Since 0.1.4
const gchar * grl_media_audio_get_lyrics_nth (GrlMediaAudio *audio
,guint index
);
|
the media instance |
|
element to retrieve, starting at 0 |
Returns : |
the n-th lyrics of the audio |
Since 0.1.10
gint grl_media_audio_get_track_number (GrlMediaAudio *audio
);
|
the media instance |
Returns : |
the track number of the audio |
const gchar * grl_media_audio_get_url_data (GrlMediaAudio *audio
,gchar **mime
,gint *bitrate
);
|
the media instance |
|
the url mime-type, or NULL to ignore. [out][transfer none]
|
|
the url bitrate, or NULL to ignore. [out]
|
Returns : |
all the keys related with the URL of an audio resource in one go. |
Since 0.1.10
const gchar * grl_media_audio_get_url_data_nth (GrlMediaAudio *audio
,guint index
,gchar **mime
,gint *bitrate
);
|
the media instance |
|
element to retrieve, starting at 0 |
|
the url mime-type, or NULL to ignore. [out][transfer none]
|
|
the url bitrate, or NULL to ignore. [out]
|
Returns : |
all the keys related with the URL number index of an audio resource
in one go. |
Since 0.1.10
void grl_media_audio_set_album (GrlMediaAudio *audio
,const gchar *album
);
Set the album of the audio
|
the media instance |
|
the audio's album |
Since 0.1.4
void grl_media_audio_set_artist (GrlMediaAudio *audio
,const gchar *artist
);
Set the artist of the audio
|
the media instance |
|
the audio's artist |
Since 0.1.4
void grl_media_audio_set_bitrate (GrlMediaAudio *audio
,gint bitrate
);
Set the bitrate of the audio
|
the media instance |
|
the audio's bitrate |
Since 0.1.4
void grl_media_audio_set_genre (GrlMediaAudio *audio
,const gchar *genre
);
Set the genre of the audio
|
the media instance |
|
the audio's genre |
Since 0.1.4
void grl_media_audio_set_lyrics (GrlMediaAudio *audio
,const gchar *lyrics
);
Set the lyrics of the audio
|
the media instance |
|
the audio's lyrics |
Since 0.1.4
void grl_media_audio_set_track_number (GrlMediaAudio *audio
,gint track_number
);
Set the track number of the audio
|
the media instance |
|
the audio's track number |
void grl_media_audio_set_url_data (GrlMediaAudio *audio
,const gchar *url
,const gchar *mime
,gint bitrate
);
Sets all the keys related with the URL of an audio resource in one go.
|
the media instance |
|
the audio's url |
|
the url mime-type |
|
the url bitrate, or -1 to ignore |
Since 0.1.10