BraseroTrackData

BraseroTrackData

Synopsis

                    BraseroGraftPt;
void                brasero_graft_point_free            (BraseroGraftPt *graft);
BraseroGraftPt *    brasero_graft_point_copy            (BraseroGraftPt *graft);
                    BraseroTrackData;
BraseroTrackData *  brasero_track_data_new              (void);
BraseroBurnResult   brasero_track_data_set_source       (BraseroTrackData *track,
                                                         GSList *grafts,
                                                         GSList *unreadable);
BraseroBurnResult   brasero_track_data_add_fs           (BraseroTrackData *track,
                                                         BraseroImageFS fstype);
BraseroBurnResult   brasero_track_data_rm_fs            (BraseroTrackData *track,
                                                         BraseroImageFS fstype);
BraseroBurnResult   brasero_track_data_set_data_blocks  (BraseroTrackData *track,
                                                         goffset blocks);
BraseroBurnResult   brasero_track_data_set_file_num     (BraseroTrackData *track,
                                                         guint64 number);
GSList *            brasero_track_data_get_grafts       (BraseroTrackData *track);
GSList *            brasero_track_data_get_excluded     (BraseroTrackData *track,
                                                         gboolean copy);
BraseroBurnResult   brasero_track_data_get_paths        (BraseroTrackData *track,
                                                         gboolean use_joliet,
                                                         const gchar *grafts_path,
                                                         const gchar *excluded_path,
                                                         const gchar *emptydir,
                                                         const gchar *videodir,
                                                         GError **error);
BraseroBurnResult   brasero_track_data_get_file_num     (BraseroTrackData *track,
                                                         guint64 *file_num);
BraseroImageFS      brasero_track_data_get_fs           (BraseroTrackData *track);

Description

Details

BraseroGraftPt

typedef struct {
	gchar *uri;
	gchar *path;
} BraseroGraftPt;


brasero_graft_point_free ()

void                brasero_graft_point_free            (BraseroGraftPt *graft);

Frees graft. Do not use grafts afterwards.

graft :

a BraseroGraftPt

brasero_graft_point_copy ()

BraseroGraftPt *    brasero_graft_point_copy            (BraseroGraftPt *graft);

Copies graft.

graft :

a BraseroGraftPt

Returns :

a BraseroGraftPt.

BraseroTrackData

typedef struct {
	BraseroTrack parent_instance;
} BraseroTrackData;


brasero_track_data_new ()

BraseroTrackData *  brasero_track_data_new              (void);

Creates a new BraseroTrackData.

This type of tracks is used to create a disc image from or burn a selection of files.

Returns :

a BraseroTrackData

brasero_track_data_set_source ()

BraseroBurnResult   brasero_track_data_set_source       (BraseroTrackData *track,
                                                         GSList *grafts,
                                                         GSList *unreadable);

Sets the lists of grafts points (grafts) and excluded URIs (unreadable) to be used to create an image.

Be careful track takes ownership of grafts and unreadable which must not be freed afterwards.

track :

a BraseroTrackData

grafts :

a GSList of BraseroGraftPt

unreadable :

a GSList of URIS as strings

Returns :

a BraseroBurnResult. BRASERO_BURN_OK if it was successful, BRASERO_BURN_ERR otherwise.

brasero_track_data_add_fs ()

BraseroBurnResult   brasero_track_data_add_fs           (BraseroTrackData *track,
                                                         BraseroImageFS fstype);

Adds one or more parameters determining the file system type and various other options to create an image.

track :

a BraseroTrackData

fstype :

a BraseroImageFS

Returns :

a BraseroBurnResult. BRASERO_BURN_OK if it was successful, BRASERO_BURN_ERR otherwise.

brasero_track_data_rm_fs ()

BraseroBurnResult   brasero_track_data_rm_fs            (BraseroTrackData *track,
                                                         BraseroImageFS fstype);

Removes one or more parameters determining the file system type and various other options to create an image.

track :

a BraseroTrackData

fstype :

a BraseroImageFS

Returns :

a BraseroBurnResult. BRASERO_BURN_OK if it was successful, BRASERO_BURN_ERR otherwise.

brasero_track_data_set_data_blocks ()

BraseroBurnResult   brasero_track_data_set_data_blocks  (BraseroTrackData *track,
                                                         goffset blocks);

Sets the size of the image to be created (in sectors of 2048 bytes).

track :

a BraseroTrackData

blocks :

a goffset

Returns :

a BraseroBurnResult. BRASERO_BURN_OK if it was successful, BRASERO_BURN_ERR otherwise.

brasero_track_data_set_file_num ()

BraseroBurnResult   brasero_track_data_set_file_num     (BraseroTrackData *track,
                                                         guint64 number);

Sets the number of files (not directories) in track.

track :

a BraseroTrackData

number :

a guint64

Returns :

a BraseroBurnResult. BRASERO_BURN_OK if it was successful, BRASERO_BURN_ERR otherwise.

brasero_track_data_get_grafts ()

GSList *            brasero_track_data_get_grafts       (BraseroTrackData *track);

track :

Returns :


brasero_track_data_get_excluded ()

GSList *            brasero_track_data_get_excluded     (BraseroTrackData *track,
                                                         gboolean copy);

Returns a list of URIs which must not be included in the image to be created. If copy is TRUE then the list is a copy and must be freed once it is not needed anymore. If FALSE, do not free after usage as track retains ownership.

track :

a BraseroTrackData

copy :

a gboolean

Returns :

a GSList of gchar * or NULL if no URI should be excluded.

brasero_track_data_get_paths ()

BraseroBurnResult   brasero_track_data_get_paths        (BraseroTrackData *track,
                                                         gboolean use_joliet,
                                                         const gchar *grafts_path,
                                                         const gchar *excluded_path,
                                                         const gchar *emptydir,
                                                         const gchar *videodir,
                                                         GError **error);

Write in grafts_path (a path to a file) the graft points, in excluded_path (a path to a file) the list of paths to be excluded, emptydir (a path to a file) an empty directory to be used for created directories, videodir (a path to a file) for a directory to be used to build the the video image.

This is mostly for internal use by mkisofs and similar.

This function takes care of mangling.

track :

a BraseroTrackData

use_joliet :

a gboolean

grafts_path :

a gchar

excluded_path :

a gchar

emptydir :

a gchar

videodir :

a gchar or NULL

error :

a GError

Returns :

a BraseroBurnResult.

brasero_track_data_get_file_num ()

BraseroBurnResult   brasero_track_data_get_file_num     (BraseroTrackData *track,
                                                         guint64 *file_num);

Sets the number of files (not directories) in file_num.

track :

a BraseroTrackData

file_num :

a guint64

Returns :

a BraseroBurnResult. TRUE if file_num was set, FALSE otherwise.

brasero_track_data_get_fs ()

BraseroImageFS      brasero_track_data_get_fs           (BraseroTrackData *track);

Returns a list of BraseroGraftPt.

Do not free after usage as track retains ownership.

track :

a BraseroTrackData

Returns :

a GSList of BraseroGraftPt or NULL if empty.