| Libbrasero-burn Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
BraseroTrack;
void brasero_track_changed (BraseroTrack *track);
BraseroBurnResult brasero_track_get_size (BraseroTrack *track,
goffset *blocks,
goffset *bytes);
BraseroTrackDataType brasero_track_get_track_type (BraseroTrack *track,
BraseroTrackType *type);
BraseroBurnResult brasero_track_get_status (BraseroTrack *track,
BraseroStatus *status);
enum BraseroChecksumType;
BraseroBurnResult brasero_track_set_checksum (BraseroTrack *track,
BraseroChecksumType type,
const gchar *checksum);
const gchar * brasero_track_get_checksum (BraseroTrack *track);
BraseroChecksumType brasero_track_get_checksum_type (BraseroTrack *track);
BraseroBurnResult brasero_track_tag_add (BraseroTrack *track,
const gchar *tag,
GValue *value);
BraseroBurnResult brasero_track_tag_lookup (BraseroTrack *track,
const gchar *tag,
GValue **value);
void brasero_track_tag_copy_missing (BraseroTrack *dest,
BraseroTrack *src);
BraseroBurnResult brasero_track_tag_add_string (BraseroTrack *track,
const gchar *tag,
const gchar *string);
const gchar * brasero_track_tag_lookup_string (BraseroTrack *track,
const gchar *tag);
BraseroBurnResult brasero_track_tag_add_int (BraseroTrack *track,
const gchar *tag,
int value);
int brasero_track_tag_lookup_int (BraseroTrack *track,
const gchar *tag);
void brasero_track_changed (BraseroTrack *track);
Used internally in BraseroTrack implementations to signal a BraseroTrack object has changed.
|
a BraseroTrack |
BraseroBurnResult brasero_track_get_size (BraseroTrack *track, goffset *blocks, goffset *bytes);
Returns the size of the data contained by track in bytes or in sectors
|
a BraseroTrack |
|
a goffset or NULL |
|
a goffset or NULL |
Returns : |
a BraseroBurnResult.
BRASERO_BURN_OK if it was successful
BRASERO_BURN_NOT_READY if track needs more time for processing the size
BRASERO_BURN_ERR if something is wrong or if it is empty
|
BraseroTrackDataType brasero_track_get_track_type (BraseroTrack *track, BraseroTrackType *type);
Sets type to reflect the type of data contained in track
|
a BraseroTrack |
|
a BraseroTrackType or NULL |
Returns : |
theBraseroTrackDataType of the track |
BraseroBurnResult brasero_track_get_status (BraseroTrack *track, BraseroStatus *status);
Sets status to reflect whether track is ready to be used
|
a BraseroTrack |
|
a BraseroTrackStatus |
Returns : |
a BraseroBurnResult.
BRASERO_BURN_OK if it was successful
BRASERO_BURN_NOT_READY if track needs more time for processing
BRASERO_BURN_ERR if something is wrong or if it is empty
|
typedef enum {
BRASERO_CHECKSUM_NONE = 0,
BRASERO_CHECKSUM_DETECT = 1, /* means the plugin handles detection of checksum type */
BRASERO_CHECKSUM_MD5 = 1 << 1,
BRASERO_CHECKSUM_MD5_FILE = 1 << 2,
BRASERO_CHECKSUM_SHA1 = 1 << 3,
BRASERO_CHECKSUM_SHA1_FILE = 1 << 4,
BRASERO_CHECKSUM_SHA256 = 1 << 5,
BRASERO_CHECKSUM_SHA256_FILE = 1 << 6,
} BraseroChecksumType;
BraseroBurnResult brasero_track_set_checksum (BraseroTrack *track, BraseroChecksumType type, const gchar *checksum);
Sets a checksum for the track
|
a BraseroTrack |
|
a BraseroChecksumType |
|
a gchar * holding the checksum |
Returns : |
a BraseroBurnResult. BRASERO_BURN_OK if the checksum was previously empty or matches the new one BRASERO_BURN_ERR otherwise |
const gchar * brasero_track_get_checksum (BraseroTrack *track);
Get the current checksum (as a string) for the track
|
a BraseroTrack |
Returns : |
a gchar * (not to be freed) or NULL |
BraseroChecksumType brasero_track_get_checksum_type (BraseroTrack *track);
Get the current checksum type for the track if any.
|
a BraseroTrack |
Returns : |
a BraseroChecksumType |
BraseroBurnResult brasero_track_tag_add (BraseroTrack *track, const gchar *tag, GValue *value);
Associates a new tag with a track. This can be used
to pass arbitrary information for plugins, like parameters
for video discs, ...
See brasero-tags.h for a list of knowns tags.
|
a BraseroTrack |
|
a gchar * |
|
a GValue |
Returns : |
a BraseroBurnResult. BRASERO_BURN_OK if it was successful, BRASERO_BURN_ERR otherwise. |
BraseroBurnResult brasero_track_tag_lookup (BraseroTrack *track, const gchar *tag, GValue **value);
Retrieves a value associated with track through
brasero_track_tag_add() and stores it in value. Do
not destroy value afterwards as it is not a copy
|
a BraseroTrack |
|
a gchar * |
|
a GValue ** |
Returns : |
a BraseroBurnResult. BRASERO_BURN_OK if the retrieval was successful BRASERO_BURN_ERR otherwise |
void brasero_track_tag_copy_missing (BraseroTrack *dest, BraseroTrack *src);
Adds all tags of dest to src provided they do not
already exists.
|
a BraseroTrack |
|
a BraseroTrack |
BraseroBurnResult brasero_track_tag_add_string (BraseroTrack *track, const gchar *tag, const gchar *string);
A wrapper around brasero_track_tag_add() to associate
a string with track
See also brasero_track_tag_add()
|
a BraseroTrack |
|
a gchar * |
|
a gchar * |
Returns : |
a BraseroBurnResult. BRASERO_BURN_OK if it was successful, BRASERO_BURN_ERR otherwise. |
const gchar * brasero_track_tag_lookup_string (BraseroTrack *track, const gchar *tag);
Retrieves a string value associated with track. This
is a wrapper around brasero_track_tag_lookup().
|
a BraseroTrack |
|
a gchar * |
Returns : |
a gchar *. The value or NULL otherwise. Do not free the string as it is not a copy. |
BraseroBurnResult brasero_track_tag_add_int (BraseroTrack *track, const gchar *tag, int value);
A wrapper around brasero_track_tag_add() to associate
a int value with track
See also brasero_track_tag_add()
|
a BraseroTrack |
|
a gchar * |
|
a int |
Returns : |
a BraseroBurnResult. BRASERO_BURN_OK if it was successful, BRASERO_BURN_ERR otherwise. |
int brasero_track_tag_lookup_int (BraseroTrack *track, const gchar *tag);
Retrieves a int value associated with track. This
is a wrapper around brasero_track_tag_lookup().
|
a BraseroTrack |
|
a gchar * |
Returns : |
a int; the value or 0 otherwise |