![]() |
![]() |
![]() |
Libbrasero-burn Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
BraseroTrack; void brasero_track_changed (BraseroTrack *track
); BraseroBurnResult brasero_track_get_size (BraseroTrack *track
,goffset *blocks
,goffset *bytes
); BraseroBurnResult 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 |
BraseroBurnResult 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 : |
the BraseroBurnResult 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 |