Top |
Functions
GQuark | rb_metadata_error_quark () |
GType | rb_metadata_get_field_type () |
const char * | rb_metadata_get_field_name () |
RBMetaData * | rb_metadata_new () |
gboolean | rb_metadata_can_save () |
char ** | rb_metadata_get_saveable_types () |
void | rb_metadata_reset () |
void | rb_metadata_load () |
void | rb_metadata_save () |
const char * | rb_metadata_get_media_type () |
gboolean | rb_metadata_has_missing_plugins () |
gboolean | rb_metadata_get_missing_plugins () |
gboolean | rb_metadata_has_audio () |
gboolean | rb_metadata_has_video () |
gboolean | rb_metadata_has_other_data () |
gboolean | rb_metadata_get () |
gboolean | rb_metadata_set () |
Functions
rb_metadata_get_field_type ()
GType
rb_metadata_get_field_type (RBMetaDataField field
);
Returns the GType of the value for a metadata field.
rb_metadata_get_field_name ()
const char *
rb_metadata_get_field_name (RBMetaDataField field
);
Returns the name of a metadata field.
rb_metadata_can_save ()
gboolean rb_metadata_can_save (RBMetaData *md
,const char *media_type
);
Checks if the metadata writer is capable of updating file metadata for a given media type.
rb_metadata_get_saveable_types ()
char **
rb_metadata_get_saveable_types (RBMetaData *md
);
Constructs a list of the media types for which the metadata backend implements tag saving.
Returns
a NULL-terminated array of media type strings. Use g_strfreev to free it.
[transfer full][array zero-terminated=1]
rb_metadata_reset ()
void
rb_metadata_reset (RBMetaData *md
);
Resets the state of the metadata interface. Call this before setting tags to be written to a file.
rb_metadata_load ()
void rb_metadata_load (RBMetaData *md
,const char *uri
,GError **error
);
Reads metadata information from the specified URI. Once this has returned successfully (with *error == NULL), rb_metadata_get, rb_metadata_get_media_type, rb_metadata_has_missing_plugins, and rb_metadata_get_missing_plugins can usefully be called.
rb_metadata_save ()
void rb_metadata_save (RBMetaData *md
,const char *uri
,GError **error
);
Saves all metadata changes made with rb_metadata_set to the target URI.
rb_metadata_get_media_type ()
const char *
rb_metadata_get_media_type (RBMetaData *md
);
Returns the type of the file from which metadata was read. This may look like a MIME type, but it isn't.
rb_metadata_has_missing_plugins ()
gboolean
rb_metadata_has_missing_plugins (RBMetaData *md
);
If the metadata reader could not decode the file it was asked to because one or more media framework plugins (specifically, for the existing implementations, GStreamer plugins) required are missing, this will return TRUE.
rb_metadata_get_missing_plugins ()
gboolean rb_metadata_get_missing_plugins (RBMetaData *md
,char ***missing_plugins
,char ***plugin_descriptions
);
This function returns the information used to request automatic
installation of media framework plugins required to decode the target URI.
Use g_strfreev()
to free the returned information arrays.
rb_metadata_get ()
gboolean rb_metadata_get (RBMetaData *md
,RBMetaDataField field
,GValue *val
);
Retrieves the value of a metadata field extracted from the target URI. If the target URI contained no value for the field, returns FALSE.
Parameters
md |
||
field |
the RBMetaDataField to retrieve |
|
val |
returns the field value. |
[out caller-allocates][transfer full] |
rb_metadata_set ()
gboolean rb_metadata_set (RBMetaData *md
,RBMetaDataField field
,const GValue *val
);
Sets a metadata field value. The value is only stored inside the RBMetaData object until rb_metadata_save is called.
Types and Values
enum RBMetaDataField
Metadata fields that can be read from and written to files.
Members
Title of the recording |
||
Person(s) responsible for the recording |
||
Album containing the recording |
||
Release date of the album |
||
Genre of the recording |
||
Free form comment on the recording |
||
Track number inside a collection |
||
Count of tracks inside the collection |
||
Disc number inside a collection |
||
Count of discs inside the collection |
||
Short text describing the recording |
||
Version of the recording |
||
International Standard Recording Code |
||
Organization responsible for the recording |
||
Copyright notice on the recording |
||
Contact information |
||
License of the recording |
||
Person(s) performing in the recording |
||
Duration of the recording |
||
Codec used to store the recording |
||
Exact or average encoding bitrate in bits/s |
||
Track gain in dB for replaygain |
||
Track peak volume level |
||
Album gain in dB for replaygain |
||
Album peak volume level |
||
Language code (ISO-639-1) |
||
Beats Per Minute |
||
MusicBrainz track ID |
||
MusicBrainz artist ID |
||
MusicBrainz album ID |
||
MusicBrainz album artist ID |
||
Person(s) responsible for the recording, as used for sorting |
||
Album containing the recording, as used for sorting |
||
The artist of the entire album |
||
The artist of the entire album, as it should be sorted |
||
The composer of the recording |
||
The composer of the recording, as it should be sorted |
||
invalid field |