|  |  |  | Libbrasero-burn Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
#define BRASERO_DND_TARGET_DATA_TRACK_REFERENCE_LIST enum BraseroTrackDataCfgColumn; BraseroTrackDataCfg; BraseroTrackDataCfg * brasero_track_data_cfg_new (void); gboolean brasero_track_data_cfg_add (BraseroTrackDataCfg *track, const gchar *uri, GtkTreePath *parent); GtkTreePath * brasero_track_data_cfg_add_empty_directory (BraseroTrackDataCfg *track, const gchar *name, GtkTreePath *parent); gboolean brasero_track_data_cfg_remove (BraseroTrackDataCfg *track, GtkTreePath *treepath); gboolean brasero_track_data_cfg_rename (BraseroTrackDataCfg *track, const gchar *newname, GtkTreePath *treepath); gboolean brasero_track_data_cfg_reset (BraseroTrackDataCfg *track); gboolean brasero_track_data_cfg_load_medium (BraseroTrackDataCfg *track, BraseroMedium *medium, GError **error); void brasero_track_data_cfg_unload_current_medium (BraseroTrackDataCfg *track); BraseroMedium * brasero_track_data_cfg_get_current_medium (BraseroTrackDataCfg *track); GSList * brasero_track_data_cfg_get_available_media (BraseroTrackDataCfg *track); void brasero_track_data_cfg_dont_filter_uri (BraseroTrackDataCfg *track, const gchar *uri); GSList * brasero_track_data_cfg_get_restored_list (BraseroTrackDataCfg *track); void brasero_track_data_cfg_restore (BraseroTrackDataCfg *track, GtkTreePath *treepath); GtkTreeModel * brasero_track_data_cfg_get_filtered_model (BraseroTrackDataCfg *track); BraseroBurnResult brasero_track_data_cfg_span (BraseroTrackDataCfg *track, goffset sectors, BraseroTrackData *new_track); BraseroBurnResult brasero_track_data_cfg_span_again (BraseroTrackDataCfg *track); BraseroBurnResult brasero_track_data_cfg_span_possible (BraseroTrackDataCfg *track, goffset sectors); void brasero_track_data_cfg_span_stop (BraseroTrackDataCfg *track); GIcon * brasero_track_data_cfg_get_icon (BraseroTrackDataCfg *track); gchar * brasero_track_data_cfg_get_icon_path (BraseroTrackDataCfg *track); gboolean brasero_track_data_cfg_set_icon (BraseroTrackDataCfg *track, const gchar *icon_path, GError **error);
#define BRASERO_DND_TARGET_DATA_TRACK_REFERENCE_LIST "GTK_TREE_MODEL_ROW"
typedef enum {
	BRASERO_DATA_TREE_MODEL_NAME		= 0,
	BRASERO_DATA_TREE_MODEL_URI,
	BRASERO_DATA_TREE_MODEL_MIME_DESC,
	BRASERO_DATA_TREE_MODEL_MIME_ICON,
	BRASERO_DATA_TREE_MODEL_SIZE,
	BRASERO_DATA_TREE_MODEL_SHOW_PERCENT,
	BRASERO_DATA_TREE_MODEL_PERCENT,
	BRASERO_DATA_TREE_MODEL_STYLE,
	BRASERO_DATA_TREE_MODEL_COLOR,
	BRASERO_DATA_TREE_MODEL_EDITABLE,
	BRASERO_DATA_TREE_MODEL_IS_FILE,
	BRASERO_DATA_TREE_MODEL_IS_LOADING,
	BRASERO_DATA_TREE_MODEL_IS_IMPORTED,
	BRASERO_DATA_TREE_MODEL_COL_NUM
} BraseroTrackDataCfgColumn;
BraseroTrackDataCfg * brasero_track_data_cfg_new (void);
Creates a new BraseroTrackDataCfg.
| Returns : | a new BraseroTrackDataCfg. | 
gboolean brasero_track_data_cfg_add (BraseroTrackDataCfg *track, const gchar *uri, GtkTreePath *parent);
Add a new file (with uri as URI) under a directory (parent).
If parent is NULL, the file is added to the root.
Also if uri is the path of a directory, this directory will be explored
and all its children added to the tree.
| 
 | a BraseroTrackDataCfg | 
| 
 | a gchar | 
| 
 | a GtkTreePath or NULL | 
| Returns : | a gboolean. TRUE if the operation was successful, FALSE otherwise | 
GtkTreePath * brasero_track_data_cfg_add_empty_directory (BraseroTrackDataCfg *track, const gchar *name, GtkTreePath *parent);
Add a new empty directory (with name as name) under another directory (parent).
If parent is NULL, the file is added to the root.
| 
 | a BraseroTrackDataCfg | 
| 
 | a gchar | 
| 
 | a GtkTreePath or NULL | 
| Returns : | a GtkTreePath which should be destroyed when not needed; NULL if the operation was not successful. | 
gboolean brasero_track_data_cfg_remove (BraseroTrackDataCfg *track, GtkTreePath *treepath);
Removes a file or a directory (as well as its children) from the tree. NOTE: some files cannot be removed like files from an imported session.
| 
 | a BraseroTrackDataCfg | 
| 
 | a GtkTreePath | 
| Returns : | a gboolean. TRUE if the operation was successful, FALSE otherwise | 
gboolean brasero_track_data_cfg_rename (BraseroTrackDataCfg *track, const gchar *newname, GtkTreePath *treepath);
Renames the file in the tree pointed by treepath.
| 
 | a BraseroTrackDataCfg | 
| 
 | a gchar | 
| 
 | a GtkTreePath | 
| Returns : | a gboolean. TRUE if the operation was successful, FALSE otherwise | 
gboolean brasero_track_data_cfg_reset (BraseroTrackDataCfg *track);
Completely empties track and unloads any currently loaded session
| 
 | a BraseroTrackDataCfg | 
| Returns : | a gboolean. TRUE if the operation was successful, FALSE otherwise | 
gboolean brasero_track_data_cfg_load_medium (BraseroTrackDataCfg *track, BraseroMedium *medium, GError **error);
Tries to load the contents of the last session of medium so all its files will be included in the tree
to perform a merge between files from the session and new added files.
Errors are stored in error.
| 
 | a BraseroTrackDataCfg | 
| 
 | a BraseroMedium | 
| 
 | a GError | 
| Returns : | a gboolean. TRUE if the operation was successful, FALSE otherwise | 
void brasero_track_data_cfg_unload_current_medium (BraseroTrackDataCfg *track);
Unload the contents of the last session of the currently loaded medium.
See brasero_track_data_cfg_load_medium().
| 
 | a BraseroTrackDataCfg | 
BraseroMedium * brasero_track_data_cfg_get_current_medium (BraseroTrackDataCfg *track);
Gets the currently loaded medium.
| 
 | a BraseroTrackDataCfg | 
| Returns : | a BraseroMedium. NULL if no medium are currently loaded. Do not unref when the BraseroMedium is not needed anymore. | 
GSList * brasero_track_data_cfg_get_available_media (BraseroTrackDataCfg *track);
Gets a list of all the media that can be appended with new data and which have a session that can be loaded.
| 
 | a BraseroTrackDataCfg | 
| Returns : | a GSList of BraseroMedium. Free the list and unref its contents when the list is not needed anymore. | 
void brasero_track_data_cfg_dont_filter_uri (BraseroTrackDataCfg *track, const gchar *uri);
Prevents uri to be filtered while automatic exploration
of added directories is performed.
| 
 | a BraseroTrackDataCfg | 
| 
 | a gchar | 
GSList * brasero_track_data_cfg_get_restored_list (BraseroTrackDataCfg *track);
Gets a list of URIs (as gchar *) that were restored with brasero_track_data_cfg_restore().
| 
 | a BraseroTrackDataCfg | 
| Returns : | a GSList; free the list and its contents when not needed anymore. | 
void brasero_track_data_cfg_restore (BraseroTrackDataCfg *track, GtkTreePath *treepath);
Removes a file from the filtered file list (see brasero_track_data_cfg_get_filtered_model())
and re-adds it wherever it should be in the tree.
treepath is a GtkTreePath associated with the GtkTreeModel which holds the
filtered files not the main tree.
| 
 | a BraseroTrackDataCfg | 
| 
 | a GtkTreePath | 
GtkTreeModel * brasero_track_data_cfg_get_filtered_model (BraseroTrackDataCfg *track);
Gets a GtkTreeModel which contains all the files that were automatically filtered while added directories were explored.
| 
 | a BraseroTrackDataCfg | 
| Returns : | a GtkTreeModel. Unref when not needed. | 
BraseroBurnResult brasero_track_data_cfg_span (BraseroTrackDataCfg *track, goffset sectors, BraseroTrackData *new_track);
Creates a new BraseroTrackData (stored in new_track) from the files contained in track. The sum of their sizes
does not exceed sectors. This allows to burn a tree on multiple discs. This function can be
called repeatedly; in this case if some files were left out after the previous calls, the newly created BraseroTrackData
is created with all or part of the remaining files.
| 
 | a BraseroTrackDataCfg | 
| 
 | a goffset | 
| 
 | a BraseroTrackData | 
| Returns : | a BraseroBurnResult. BRASERO_BURN_OK if there is not anymore data. BRASERO_BURN_RETRY if the operation was successful and a new BraseroTrackDataCfg was created. BRASERO_BURN_ERR otherwise. | 
BraseroBurnResult brasero_track_data_cfg_span_again (BraseroTrackDataCfg *track);
Checks whether some files were not included during calls to brasero_track_data_cfg_span().
| 
 | a BraseroTrackDataCfg | 
| Returns : | a BraseroBurnResult. BRASERO_BURN_OK if there is not anymore data. BRASERO_BURN_RETRY if the operation was successful and a new BraseroTrackDataCfg was created. BRASERO_BURN_ERR otherwise. | 
BraseroBurnResult brasero_track_data_cfg_span_possible (BraseroTrackDataCfg *track, goffset sectors);
Checks if a new BraseroTrackData can be created from the files remaining in the tree 
after calls to brasero_track_data_cfg_span().
| 
 | a BraseroTrackDataCfg | 
| 
 | a goffset | 
| Returns : | a BraseroBurnResult. BRASERO_BURN_OK if there is not anymore data. BRASERO_BURN_RETRY if the operation was successful and a new BraseroTrackDataCfg was created. BRASERO_BURN_ERR otherwise. | 
void brasero_track_data_cfg_span_stop (BraseroTrackDataCfg *track);
Resets the list of files that were included after calls to brasero_track_data_cfg_span().
| 
 | a BraseroTrackDataCfg | 
GIcon * brasero_track_data_cfg_get_icon (BraseroTrackDataCfg *track);
Returns the currently selected icon.
| 
 | a BraseroTrackDataCfg | 
| Returns : | a GIcon or NULL. | 
gchar * brasero_track_data_cfg_get_icon_path (BraseroTrackDataCfg *track);
Returns a path pointing to the currently selected icon file.
| 
 | a BraseroTrackDataCfg | 
| Returns : | a gchar or NULL. | 
gboolean brasero_track_data_cfg_set_icon (BraseroTrackDataCfg *track, const gchar *icon_path, GError **error);
Sets the current icon.
| 
 | a BraseroTrackDataCfg | 
| 
 | a gchar | 
| 
 | a GError | 
| Returns : | a gboolean. TRUE if the operation was successful, FALSE otherwise |