OGMDvdTitle

OGMDvdTitle — Structure describing a DVD title

Synopsis


#include <ogmdvd-title.h>


void                ogmdvd_title_ref                    (OGMDvdTitle *title);
void                ogmdvd_title_unref                  (OGMDvdTitle *title);
OGMDvdDisc*         ogmdvd_title_get_disc               (OGMDvdTitle *title);
gint64              ogmdvd_title_get_vts_size           (OGMDvdTitle *title);
gint                ogmdvd_title_get_nr                 (OGMDvdTitle *title);
gdouble             ogmdvd_title_get_length             (OGMDvdTitle *title,
                                                         OGMDvdTime *length);
gdouble             ogmdvd_title_get_chapters_length    (OGMDvdTitle *title,
                                                         guint start,
                                                         gint end,
                                                         OGMDvdTime *length);
void                ogmdvd_title_get_framerate          (OGMDvdTitle *title,
                                                         guint *numerator,
                                                         guint *denominator);
void                ogmdvd_title_get_size               (OGMDvdTitle *title,
                                                         guint *width,
                                                         guint *height);
gint                ogmdvd_title_get_video_format       (OGMDvdTitle *title);
gint                ogmdvd_title_get_display_aspect     (OGMDvdTitle *title);
gint                ogmdvd_title_get_display_format     (OGMDvdTitle *title);
guint*              ogmdvd_title_get_palette            (OGMDvdTitle *title);
gint                ogmdvd_title_get_n_angles           (OGMDvdTitle *title);
gint                ogmdvd_title_get_n_chapters         (OGMDvdTitle *title);
gint                ogmdvd_title_get_n_audio_streams    (OGMDvdTitle *title);
OGMDvdAudioStream*  ogmdvd_title_get_nth_audio_stream   (OGMDvdTitle *title,
                                                         guint nr);
gint                ogmdvd_title_get_n_subp_streams     (OGMDvdTitle *title);
OGMDvdSubpStream*   ogmdvd_title_get_nth_subp_stream    (OGMDvdTitle *title,
                                                         guint nr);
void                ogmdvd_title_get_aspect_ratio       (OGMDvdTitle *title,
                                                         guint *numerator,
                                                         guint *denominator);

Description

Details

ogmdvd_title_ref ()

void                ogmdvd_title_ref                    (OGMDvdTitle *title);

Increments the reference count of an OGMDvdTitle.

title : An OGMDvdTitle

ogmdvd_title_unref ()

void                ogmdvd_title_unref                  (OGMDvdTitle *title);

Decrements the reference count of an OGMDvdTitle.

title : An OGMDvdTitle

ogmdvd_title_get_disc ()

OGMDvdDisc*         ogmdvd_title_get_disc               (OGMDvdTitle *title);

Returns the disc the OGMDvdTitle was opened from.

title : An OGMDvdTitle
Returns : The OGMDvdDisc, or NULL

ogmdvd_title_get_vts_size ()

gint64              ogmdvd_title_get_vts_size           (OGMDvdTitle *title);

Returns the size of the video title set in bytes.

title : An OGMDvdTitle
Returns : The size in bytes, or -1

ogmdvd_title_get_nr ()

gint                ogmdvd_title_get_nr                 (OGMDvdTitle *title);

Returns the title number.

title : An OGMDvdTitle
Returns : The title number, or -1

ogmdvd_title_get_length ()

gdouble             ogmdvd_title_get_length             (OGMDvdTitle *title,
                                                         OGMDvdTime *length);

Returns the title length in seconds. If length is not NULL, the data structure will be filled with the length in hours, minutes seconds and frames.

title : An OGMDvdTitle
length : A pointer to set the OGMDvdTime, or NULL
Returns : The length in seconds, or -1.0

ogmdvd_title_get_chapters_length ()

gdouble             ogmdvd_title_get_chapters_length    (OGMDvdTitle *title,
                                                         guint start,
                                                         gint end,
                                                         OGMDvdTime *length);

Returns the length in seconds between start and end chapters. If length is not NULL, the data structure will be filled with the length in hours, minutes seconds and frames.

title : An OGMDvdTitle
start : The start chapter
end : The end chapter
length : A pointer to set the OGMDvdTime, or NULL
Returns : The length in seconds, or -1.0

ogmdvd_title_get_framerate ()

void                ogmdvd_title_get_framerate          (OGMDvdTitle *title,
                                                         guint *numerator,
                                                         guint *denominator);

Gets the framerate of the DVD title in the form of a fraction.

title : An OGMDvdTitle
numerator : A pointer to set the framerate numerator, or NULL
denominator : A pointer to set the framerate denominator, or NULL

ogmdvd_title_get_size ()

void                ogmdvd_title_get_size               (OGMDvdTitle *title,
                                                         guint *width,
                                                         guint *height);

Gets the size of the picture.

title : An OGMDvdTitle
width : A pointer to set the width of the picture, or NULL
height : A pointer to set the height of the picture, or NULL

ogmdvd_title_get_video_format ()

gint                ogmdvd_title_get_video_format       (OGMDvdTitle *title);

Returns the video format of the movie.

title : An OGMDvdTitle
Returns : OGMDvdVideoFormat, or -1

ogmdvd_title_get_display_aspect ()

gint                ogmdvd_title_get_display_aspect     (OGMDvdTitle *title);

Returns the display aspect of the movie.

title : An OGMDvdTitle
Returns : OGMDvdDisplayAspect, or -1

ogmdvd_title_get_display_format ()

gint                ogmdvd_title_get_display_format     (OGMDvdTitle *title);

Returns the display format of the movie.

title : An OGMDvdTitle
Returns : OGMDvdDisplayFormat, or -1

ogmdvd_title_get_palette ()

guint*              ogmdvd_title_get_palette            (OGMDvdTitle *title);

Returns the palette of the movie.

title : An OGMDvdTitle
Returns : a constant array of 16 integers, or NULL

ogmdvd_title_get_n_angles ()

gint                ogmdvd_title_get_n_angles           (OGMDvdTitle *title);

Returns the number of angles of the video title.

title : An OGMDvdTitle
Returns : The number of angles, or -1

ogmdvd_title_get_n_chapters ()

gint                ogmdvd_title_get_n_chapters         (OGMDvdTitle *title);

Returns the number of chapters of the video title.

title : An OGMDvdTitle
Returns : The number of chapters, or -1

ogmdvd_title_get_n_audio_streams ()

gint                ogmdvd_title_get_n_audio_streams    (OGMDvdTitle *title);

Returns the number of audio streams of the video title.

title : An OGMDvdTitle
Returns : The number of audio streams, or -1

ogmdvd_title_get_nth_audio_stream ()

OGMDvdAudioStream*  ogmdvd_title_get_nth_audio_stream   (OGMDvdTitle *title,
                                                         guint nr);

Returns the audio stream at position nr. The first nr is 0.

title : An OGMDvdTitle
nr : The audio stream number
Returns : The OGMDvdAudioStream, or NULL

ogmdvd_title_get_n_subp_streams ()

gint                ogmdvd_title_get_n_subp_streams     (OGMDvdTitle *title);

Returns the number of subtitles streams of the video title.

title : An OGMDvdTitle
Returns : The number of subtitles streams, or -1

ogmdvd_title_get_nth_subp_stream ()

OGMDvdSubpStream*   ogmdvd_title_get_nth_subp_stream    (OGMDvdTitle *title,
                                                         guint nr);

Returns the subtitles stream at position nr. The first nr is 0.

title : An OGMDvdTitle
nr : The subtitles stream number
Returns : The OGMDvdSubpStream, or NULL

ogmdvd_title_get_aspect_ratio ()

void                ogmdvd_title_get_aspect_ratio       (OGMDvdTitle *title,
                                                         guint *numerator,
                                                         guint *denominator);

Gets the aspect ratio of the DVD title in the form of a fraction.

title : An OGMDvdTitle
numerator : A pointer to set the aspect ratio numerator, or NULL
denominator : A pointer to set the aspect ratio denominator, or NULL