OGMDvdDisc

OGMDvdDisc — Structure describing a video DVD

Synopsis


#include <ogmdvd-disc.h>


enum                OGMDvdDiscError;
OGMDvdDisc*         ogmdvd_disc_open                    (const gchar *device,
                                                         GError **error);
void                ogmdvd_disc_ref                     (OGMDvdDisc *disc);
void                ogmdvd_disc_unref                   (OGMDvdDisc *disc);
gchar*              ogmdvd_disc_get_label               (OGMDvdDisc *disc);
gchar*              ogmdvd_disc_get_device              (OGMDvdDisc *disc);
gint64              ogmdvd_disc_get_vmg_size            (OGMDvdDisc *disc);
gint                ogmdvd_disc_get_n_titles            (OGMDvdDisc *disc);
OGMDvdTitle*        ogmdvd_disc_get_nth_title           (OGMDvdDisc *disc,
                                                         guint nr);

Description

Details

enum OGMDvdDiscError

typedef enum
{
  OGMDVD_DISC_ERROR_EXIST,  /* No such file or directory */
  OGMDVD_DISC_ERROR_PERM,   /* Permission denied to access device */
  OGMDVD_DISC_ERROR_TRAY,   /* Tray seems to be opened */
  OGMDVD_DISC_ERROR_DEV,    /* Device does not contain a valid DVD video */
  OGMDVD_DISC_ERROR_PATH,   /* Path does not contain a valid DVD structure */
  OGMDVD_DISC_ERROR_ACCESS, /* No such directory, block device or iso file */
  OGMDVD_DISC_ERROR_VMG,    /* Cannot open video manager */
  OGMDVD_DISC_ERROR_UNKNOWN /* Unknown error */
} OGMDvdDiscError;

Error codes returned by ogmdvd_disc_open()

OGMDVD_DISC_ERROR_EXIST No such file or directory
OGMDVD_DISC_ERROR_PERM Permission denied to access device
OGMDVD_DISC_ERROR_TRAY Tray seems to be opened
OGMDVD_DISC_ERROR_DEV Device does not contain a valid DVD video
OGMDVD_DISC_ERROR_PATH Path does not contain a valid DVD structure
OGMDVD_DISC_ERROR_ACCESS No such directory, block device or iso file
OGMDVD_DISC_ERROR_VMG Cannot open video manager
OGMDVD_DISC_ERROR_UNKNOWN Unknown error

ogmdvd_disc_open ()

OGMDvdDisc*         ogmdvd_disc_open                    (const gchar *device,
                                                         GError **error);

Creates a new OGMDvdDisc given a DVD device.

device : A DVD device.
error : Location to store the error occuring, or NULL to ignore errors.
Returns : The new OGMDvdDisc, or NULL

ogmdvd_disc_ref ()

void                ogmdvd_disc_ref                     (OGMDvdDisc *disc);

Increments the reference count of an OGMDvdDisc.

disc : An OGMDvdDisc

ogmdvd_disc_unref ()

void                ogmdvd_disc_unref                   (OGMDvdDisc *disc);

Decrements the reference count of an OGMDvdDisc.

disc : An OGMDvdDisc

ogmdvd_disc_get_label ()

gchar*              ogmdvd_disc_get_label               (OGMDvdDisc *disc);

Returns the label of the DVD.

disc : An OGMDvdDisc
Returns : The label of the DVD, or NULL

ogmdvd_disc_get_device ()

gchar*              ogmdvd_disc_get_device              (OGMDvdDisc *disc);

Returns the DVD device.

disc : An OGMDvdDisc
Returns : The device of the DVD.

ogmdvd_disc_get_vmg_size ()

gint64              ogmdvd_disc_get_vmg_size            (OGMDvdDisc *disc);

Returns the size of the video manager in bytes.

disc : An OGMDvdDisc
Returns : The size in bytes, or -1

ogmdvd_disc_get_n_titles ()

gint                ogmdvd_disc_get_n_titles            (OGMDvdDisc *disc);

Returns the number of video titles of this DVD.

disc : An OGMDvdDisc
Returns : The number of video titles, or -1

ogmdvd_disc_get_nth_title ()

OGMDvdTitle*        ogmdvd_disc_get_nth_title           (OGMDvdDisc *disc,
                                                         guint nr);

Returns the video title at position nr. The first nr is 0.

disc : An OGMDvdDisc
nr : The title number
Returns : The OGMDvdTitle, or NULL