BraseroMedium

BraseroMedium

Synopsis

                    BraseroMedium;
BraseroMedia        brasero_medium_get_status           (BraseroMedium *medium);
guint64             brasero_medium_get_max_write_speed  (BraseroMedium *medium);
guint64 *           brasero_medium_get_write_speeds     (BraseroMedium *medium);
void                brasero_medium_get_free_space       (BraseroMedium *medium,
                                                         goffset *bytes,
                                                         goffset *blocks);
void                brasero_medium_get_capacity         (BraseroMedium *medium,
                                                         goffset *bytes,
                                                         goffset *blocks);
void                brasero_medium_get_data_size        (BraseroMedium *medium,
                                                         goffset *bytes,
                                                         goffset *blocks);
gint64              brasero_medium_get_next_writable_address
                                                        (BraseroMedium *medium);
gboolean            brasero_medium_can_be_rewritten     (BraseroMedium *medium);
gboolean            brasero_medium_can_be_written       (BraseroMedium *medium);
const gchar *       brasero_medium_get_CD_TEXT_title    (BraseroMedium *medium);
const gchar *       brasero_medium_get_type_string      (BraseroMedium *medium);
gchar *             brasero_medium_get_tooltip          (BraseroMedium *medium);
BraseroDrive *      brasero_medium_get_drive            (BraseroMedium *medium);
guint               brasero_medium_get_track_num        (BraseroMedium *medium);
gboolean            brasero_medium_get_last_data_track_space
                                                        (BraseroMedium *medium,
                                                         goffset *bytes,
                                                         goffset *sectors);
gboolean            brasero_medium_get_last_data_track_address
                                                        (BraseroMedium *medium,
                                                         goffset *bytes,
                                                         goffset *sectors);
gboolean            brasero_medium_get_track_space      (BraseroMedium *medium,
                                                         guint num,
                                                         goffset *bytes,
                                                         goffset *sectors);
gboolean            brasero_medium_get_track_address    (BraseroMedium *medium,
                                                         guint num,
                                                         goffset *bytes,
                                                         goffset *sectors);
gboolean            brasero_medium_can_use_dummy_for_sao
                                                        (BraseroMedium *medium);
gboolean            brasero_medium_can_use_dummy_for_tao
                                                        (BraseroMedium *medium);
gboolean            brasero_medium_can_use_burnfree     (BraseroMedium *medium);

Description

Details

BraseroMedium

typedef struct {
	GObject parent_instance;
} BraseroMedium;


brasero_medium_get_status ()

BraseroMedia        brasero_medium_get_status           (BraseroMedium *medium);

Gets the medium type and state.

medium :

BraseroMedium

Returns :

a BraseroMedia.

brasero_medium_get_max_write_speed ()

guint64             brasero_medium_get_max_write_speed  (BraseroMedium *medium);

Gets the maximum speed that can be used to write to medium. Note: the speed are in B/sec.

medium :

BraseroMedium

Returns :

a guint64.

brasero_medium_get_write_speeds ()

guint64 *           brasero_medium_get_write_speeds     (BraseroMedium *medium);

Gets an array holding all possible speeds to write to medium. Note: the speed are in B/sec.

medium :

BraseroMedium

Returns :

a guint64 *.

brasero_medium_get_free_space ()

void                brasero_medium_get_free_space       (BraseroMedium *medium,
                                                         goffset *bytes,
                                                         goffset *blocks);

Stores in either size (in bytes) or blocks (the number of blocks) the space on the disc that can be used for writing.

medium :

BraseroMedium

bytes :

a gint64 * or NULL

blocks :

a gint64 * or NULL

brasero_medium_get_capacity ()

void                brasero_medium_get_capacity         (BraseroMedium *medium,
                                                         goffset *bytes,
                                                         goffset *blocks);

Stores in either size (in bytes) or blocks (the number of blocks) the total disc space. Note that when the disc is closed this space is the one occupied by data. Otherwise it is the sum of free and used space.

medium :

BraseroMedium

bytes :

a gint64 * or NULL

blocks :

a gint64 * or NULL

brasero_medium_get_data_size ()

void                brasero_medium_get_data_size        (BraseroMedium *medium,
                                                         goffset *bytes,
                                                         goffset *blocks);

Stores in either size (in bytes) or blocks (the number of blocks) the size used to store data (including audio on CDs) on the disc.

medium :

BraseroMedium

bytes :

a gint64 * or NULL

blocks :

a gint64 * or NULL

brasero_medium_get_next_writable_address ()

gint64              brasero_medium_get_next_writable_address
                                                        (BraseroMedium *medium);

Gets the address (block number) that can be used to write a new session on medium

medium :

BraseroMedium

Returns :

a gint64.

brasero_medium_can_be_rewritten ()

gboolean            brasero_medium_can_be_rewritten     (BraseroMedium *medium);

Gets whether the medium can be rewritten. Note: it also checks that the drive can rewrite the medium type.

medium :

BraseroMedium

Returns :

a gboolean. TRUE if the medium can be rewritten, FALSE otherwise.

brasero_medium_can_be_written ()

gboolean            brasero_medium_can_be_written       (BraseroMedium *medium);

Gets whether the medium can be written. It also checks that the medium can write the medium.

medium :

BraseroMedium

Returns :

a gboolean. TRUE if the medium can be rewritten, FALSE otherwise.

brasero_medium_get_CD_TEXT_title ()

const gchar *       brasero_medium_get_CD_TEXT_title    (BraseroMedium *medium);

Gets the CD-TEXT title for Medium.

medium :

BraseroMedium

Returns :

a gchar *.

brasero_medium_get_type_string ()

const gchar *       brasero_medium_get_type_string      (BraseroMedium *medium);

Returns the medium type as a string to be displayed in a UI.

medium :

BraseroMedium

Returns :

a gchar *.

brasero_medium_get_tooltip ()

gchar *             brasero_medium_get_tooltip          (BraseroMedium *medium);

Returns a tooltip to be displayed in the UI. It is of the form {content type} {disc type} in {drive name}.

medium :

BraseroMedium

Returns :

a gchar *.

brasero_medium_get_drive ()

BraseroDrive *      brasero_medium_get_drive            (BraseroMedium *medium);

Gets the BraseroDrive in which the medium is inserted.

medium :

BraseroMedium

Returns :

a BraseroDrive. No need to unref after use.

brasero_medium_get_track_num ()

guint               brasero_medium_get_track_num        (BraseroMedium *medium);

Gets the number of tracks on the medium.

medium :

BraseroMedium

Returns :

a guint.

brasero_medium_get_last_data_track_space ()

gboolean            brasero_medium_get_last_data_track_space
                                                        (BraseroMedium *medium,
                                                         goffset *bytes,
                                                         goffset *sectors);

Stores in either bytes (in bytes) or in sectors (in blocks) the space used by the last track on the medium.

medium :

BraseroMedium

bytes :

a goffset * or NULL

sectors :

a goffset * or NULL

Returns :

a gboolean. Returns TRUE if information could be retrieved.

brasero_medium_get_last_data_track_address ()

gboolean            brasero_medium_get_last_data_track_address
                                                        (BraseroMedium *medium,
                                                         goffset *bytes,
                                                         goffset *sectors);

Stores in either bytes (in bytes) or in sectors (in blocks) the address where the last session starts. This is useful when creating a multisession image or when reading the contents of this last track.

medium :

BraseroMedium

bytes :

a goffset * or NULL

sectors :

a goffset * or NULL

Returns :

a gboolean. Returns TRUE if information could be retrieved.

brasero_medium_get_track_space ()

gboolean            brasero_medium_get_track_space      (BraseroMedium *medium,
                                                         guint num,
                                                         goffset *bytes,
                                                         goffset *sectors);

Stores in either bytes (in bytes) or in sectors (in blocks) the space used by session num on the disc.

medium :

a BraseroMedium

num :

a guint

bytes :

a goffset * or NULL

sectors :

a goffset * or NULL

Returns :

a gboolean. Returns TRUE if information could be retrieved; FALSE otherwise (usually when track num doesn't exist).

brasero_medium_get_track_address ()

gboolean            brasero_medium_get_track_address    (BraseroMedium *medium,
                                                         guint num,
                                                         goffset *bytes,
                                                         goffset *sectors);

Stores in either bytes (in bytes) or in sectors (in blocks) the address at which the session identified by num starts.

medium :

a BraseroMedium

num :

a guint

bytes :

a goffset * or NULL

sectors :

a goffset * or NULL

Returns :

a gboolean. Returns TRUE if information could be retrieved; FALSE otherwise (usually when track num doesn't exist).

brasero_medium_can_use_dummy_for_sao ()

gboolean            brasero_medium_can_use_dummy_for_sao
                                                        (BraseroMedium *medium);

Gets whether the medium supports doing a test write with SAO on.

medium :

BraseroMedium

Returns :

a gboolean. TRUE if the medium can use SAO write mode during a test write, FALSE otherwise.

brasero_medium_can_use_dummy_for_tao ()

gboolean            brasero_medium_can_use_dummy_for_tao
                                                        (BraseroMedium *medium);

Gets whether the medium supports doing a test write with TAO on.

medium :

BraseroMedium

Returns :

a gboolean. TRUE if the medium can use TAO write mode during a test write, FALSE otherwise.

brasero_medium_can_use_burnfree ()

gboolean            brasero_medium_can_use_burnfree     (BraseroMedium *medium);

Gets whether the medium supports any burnfree technology.

medium :

BraseroMedium

Returns :

a gboolean. TRUE if the medium can use any burnfree technology, FALSE otherwise.