## brasero-media

brasero-media

## Synopsis

    #define             LIBBRASERO_MEDIA_VERSION_MAJOR
    #define             LIBBRASERO_MEDIA_VERSION_MINOR
    #define             LIBBRASERO_MEDIA_VERSION_MICRO
    #define             LIBBRASERO_MEDIA_AGE
    #define             LIBBRASERO_MEDIA_INSTALL
    void                brasero_media_library_start         (void);
    void                brasero_media_library_stop          (void);
    GOptionGroup *      brasero_media_get_option_group      (void);
    GQuark              brasero_media_quark                 (void);
    #define             BRASERO_MEDIA_ERROR
    enum                BraseroMediaError;
    enum                BraseroMedia;
    #define             BRASERO_MEDIUM_CDROM
    #define             BRASERO_MEDIUM_CDR
    #define             BRASERO_MEDIUM_CDRW
    #define             BRASERO_MEDIUM_DVD_ROM
    #define             BRASERO_MEDIUM_DVDR
    #define             BRASERO_MEDIUM_DVDRW
    #define             BRASERO_MEDIUM_DVDRW_RESTRICTED
    #define             BRASERO_MEDIUM_DVDR_DL
    #define             BRASERO_MEDIUM_DVDR_JUMP_DL
    #define             BRASERO_MEDIUM_DVDR_PLUS
    #define             BRASERO_MEDIUM_DVDRW_PLUS
    #define             BRASERO_MEDIUM_DVDR_PLUS_DL
    #define             BRASERO_MEDIUM_DVDRW_PLUS_DL
    #define             BRASERO_MEDIUM_DVD_RAM
    #define             BRASERO_MEDIUM_BD_ROM
    #define             BRASERO_MEDIUM_BDR_SRM
    #define             BRASERO_MEDIUM_BDR_SRM_POW
    #define             BRASERO_MEDIUM_BDR_RANDOM
    #define             BRASERO_MEDIUM_BDRE
    #define             BRASERO_MEDIUM_VALID                (media)
    #define             BRASERO_MEDIUM_TYPE                 (media)
    #define             BRASERO_MEDIUM_ATTR                 (media)
    #define             BRASERO_MEDIUM_STATUS               (media)
    #define             BRASERO_MEDIUM_SUBTYPE              (media)
    #define             BRASERO_MEDIUM_INFO                 (media)
    #define             BRASERO_MEDIUM_IS                   (media,
                                                             type)
    #define             BRASERO_MEDIUM_RANDOM_WRITABLE      (media)

## Description

## Details

### LIBBRASERO_MEDIA_VERSION_MAJOR

    #define             LIBBRASERO_MEDIA_VERSION_MAJOR

### LIBBRASERO_MEDIA_VERSION_MINOR

    #define             LIBBRASERO_MEDIA_VERSION_MINOR

### LIBBRASERO_MEDIA_VERSION_MICRO

    #define             LIBBRASERO_MEDIA_VERSION_MICRO

### LIBBRASERO_MEDIA_AGE

    #define             LIBBRASERO_MEDIA_AGE

### LIBBRASERO_MEDIA_INSTALL

    #define             LIBBRASERO_MEDIA_INSTALL

### brasero_media_library_start ()

    void                brasero_media_library_start         (void);

Initialize the library.

You should call this function before using any other from the library.

Rename to: init

### brasero_media_library_stop ()

    void                brasero_media_library_stop          (void);

De-initialize the library once you do not need the library anymore.

Rename to: deinit

### brasero_media_get_option_group ()

    GOptionGroup *      brasero_media_get_option_group      (void);

Returns a GOptionGroup for the commandline arguments recognized by libbrasero-media. You should add this to your GOptionContext if your are using `g_option_context_parse()` to parse your commandline arguments.

Returns : | a GOptionGroup *

### brasero_media_quark ()

    GQuark              brasero_media_quark                 (void);

### BRASERO_MEDIA_ERROR

    #define BRASERO_MEDIA_ERROR brasero_media_quark()

The GQuark used for BraseroMediaError

### enum BraseroMediaError

    typedef enum {
    	BRASERO_MEDIA_ERROR_NONE,
    	BRASERO_MEDIA_ERROR_GENERAL,
    	BRASERO_MEDIA_ERROR_IMAGE_INVALID,
    } BraseroMediaError;

Error codes returned by libbrasero-media

`BRASERO_MEDIA_ERROR_NONE` |
`BRASERO_MEDIA_ERROR_GENERAL` |
`BRASERO_MEDIA_ERROR_IMAGE_INVALID` |

### enum BraseroMedia

    typedef enum {
    	BRASERO_MEDIUM_UNSUPPORTED		= -2,
    	BRASERO_MEDIUM_BUSY			= -1,
    	BRASERO_MEDIUM_NONE			= 0,

    	/* types */
    	BRASERO_MEDIUM_FILE			= 1,

    	BRASERO_MEDIUM_CD			= 1 << 1,

    	BRASERO_MEDIUM_DVD			= 1 << 2,

    	BRASERO_MEDIUM_BD			= 1 << 3,

    	/* subtype for DVD and BD types */
    	BRASERO_MEDIUM_DUAL_L			= 1 << 4,

    	/* DVD and DVD DL subtypes */
    	BRASERO_MEDIUM_RAM			= 1 << 5,
    	BRASERO_MEDIUM_PLUS			= 1 << 6,
    	BRASERO_MEDIUM_SEQUENTIAL		= 1 << 7,
    	BRASERO_MEDIUM_RESTRICTED		= 1 << 8, /* DVD-RW only */

    	/* DVD-R dual layer only subtype */
    	BRASERO_MEDIUM_JUMP			= 1 << 9,

    	/* BD subtypes */
    	BRASERO_MEDIUM_RANDOM			= 1 << 10,
    	BRASERO_MEDIUM_SRM			= 1 << 11,
    	BRASERO_MEDIUM_POW			= 1 << 12, /* This is Pseudo OverWrite */

    	/* discs attributes */
    	BRASERO_MEDIUM_REWRITABLE		= 1 << 14,
    	BRASERO_MEDIUM_WRITABLE			= 1 << 15,
    	BRASERO_MEDIUM_ROM			= 1 << 16,

    	/* status of the disc */
    	BRASERO_MEDIUM_BLANK			= 1 << 17,
    	BRASERO_MEDIUM_CLOSED			= 1 << 18,
    	BRASERO_MEDIUM_APPENDABLE		= 1 << 19,

    	/* Only used for DVD+RW, DVD-RW restricted */
    	BRASERO_MEDIUM_UNFORMATTED		= 1 << 20,

    	BRASERO_MEDIUM_PROTECTED		= 1 << 21,
    	BRASERO_MEDIUM_HAS_DATA			= 1 << 22,
    	BRASERO_MEDIUM_HAS_AUDIO		= 1 << 23,
    } BraseroMedia;

This enum allows to define all characteristics for a media (closed, writable, ...) and identify all types of optical media.

`BRASERO_MEDIUM_UNSUPPORTED` |
`BRASERO_MEDIUM_BUSY` |
`BRASERO_MEDIUM_NONE` |
`BRASERO_MEDIUM_FILE` |
`BRASERO_MEDIUM_CD` |
`BRASERO_MEDIUM_DVD` |
`BRASERO_MEDIUM_BD` |
`BRASERO_MEDIUM_DUAL_L` |
`BRASERO_MEDIUM_RAM` |
`BRASERO_MEDIUM_PLUS` |
`BRASERO_MEDIUM_SEQUENTIAL` |
`BRASERO_MEDIUM_RESTRICTED` |
`BRASERO_MEDIUM_JUMP` |
`BRASERO_MEDIUM_RANDOM` |
`BRASERO_MEDIUM_SRM` |
`BRASERO_MEDIUM_POW` |
`BRASERO_MEDIUM_REWRITABLE` |
`BRASERO_MEDIUM_WRITABLE` |
`BRASERO_MEDIUM_ROM` |
`BRASERO_MEDIUM_BLANK` |
`BRASERO_MEDIUM_CLOSED` |
`BRASERO_MEDIUM_APPENDABLE` |
`BRASERO_MEDIUM_UNFORMATTED` |
`BRASERO_MEDIUM_PROTECTED` |
`BRASERO_MEDIUM_HAS_DATA` |
`BRASERO_MEDIUM_HAS_AUDIO` |

### BRASERO_MEDIUM_CDROM

    #define             BRASERO_MEDIUM_CDROM

### BRASERO_MEDIUM_CDR

    #define             BRASERO_MEDIUM_CDR

### BRASERO_MEDIUM_CDRW

    #define             BRASERO_MEDIUM_CDRW

### BRASERO_MEDIUM_DVD_ROM

    #define             BRASERO_MEDIUM_DVD_ROM

### BRASERO_MEDIUM_DVDR

    #define             BRASERO_MEDIUM_DVDR

### BRASERO_MEDIUM_DVDRW

    #define             BRASERO_MEDIUM_DVDRW

### BRASERO_MEDIUM_DVDRW_RESTRICTED

    #define             BRASERO_MEDIUM_DVDRW_RESTRICTED

### BRASERO_MEDIUM_DVDR_DL

    #define             BRASERO_MEDIUM_DVDR_DL

### BRASERO_MEDIUM_DVDR_JUMP_DL

    #define             BRASERO_MEDIUM_DVDR_JUMP_DL

### BRASERO_MEDIUM_DVDR_PLUS

    #define             BRASERO_MEDIUM_DVDR_PLUS

### BRASERO_MEDIUM_DVDRW_PLUS

    #define             BRASERO_MEDIUM_DVDRW_PLUS

### BRASERO_MEDIUM_DVDR_PLUS_DL

    #define             BRASERO_MEDIUM_DVDR_PLUS_DL

### BRASERO_MEDIUM_DVDRW_PLUS_DL

    #define             BRASERO_MEDIUM_DVDRW_PLUS_DL

### BRASERO_MEDIUM_DVD_RAM

    #define             BRASERO_MEDIUM_DVD_RAM

### BRASERO_MEDIUM_BD_ROM

    #define             BRASERO_MEDIUM_BD_ROM

### BRASERO_MEDIUM_BDR_SRM

    #define             BRASERO_MEDIUM_BDR_SRM

### BRASERO_MEDIUM_BDR_SRM_POW

    #define             BRASERO_MEDIUM_BDR_SRM_POW

### BRASERO_MEDIUM_BDR_RANDOM

    #define             BRASERO_MEDIUM_BDR_RANDOM

### BRASERO_MEDIUM_BDRE

    #define             BRASERO_MEDIUM_BDRE

### BRASERO_MEDIUM_VALID()

    #define             BRASERO_MEDIUM_VALID(media)

### BRASERO_MEDIUM_TYPE()

    #define BRASERO_MEDIUM_TYPE(media) ((media) & 0x003F)

### BRASERO_MEDIUM_ATTR()

    #define BRASERO_MEDIUM_ATTR(media) ((media) & 0x1C000)

### BRASERO_MEDIUM_STATUS()

    #define BRASERO_MEDIUM_STATUS(media) ((media) & 0xE0000)

### BRASERO_MEDIUM_SUBTYPE()

    #define BRASERO_MEDIUM_SUBTYPE(media) ((media) & 0x1FC0)

### BRASERO_MEDIUM_INFO()

    #define BRASERO_MEDIUM_INFO(media) ((media) & 0xFE0000)

### BRASERO_MEDIUM_IS()

    #define BRASERO_MEDIUM_IS(media, type) (((media)&(type))==(type))

### BRASERO_MEDIUM_RANDOM_WRITABLE()

    #define             BRASERO_MEDIUM_RANDOM_WRITABLE(media)