OGMDvd Reference Manual: OGMDvdTitle

## OGMDvdTitle OGMDvdTitle — Structure describing a DVD title |

## Functions

gboolean | ogmdvd_title_open ()
void | ogmdvd_title_close ()
gboolean | ogmdvd_title_is_open ()
void | ogmdvd_title_ref ()
void | ogmdvd_title_unref ()
gboolean | ogmdvd_title_analyze ()
OGMDvdDisc * | ogmdvd_title_get_disc ()
gint64 | ogmdvd_title_get_vts_size ()
gint | ogmdvd_title_get_nr ()
gint | ogmdvd_title_get_ts_nr ()
gdouble | ogmdvd_title_get_length ()
gdouble | ogmdvd_title_get_chapters_length ()
void | ogmdvd_title_get_framerate ()
void | ogmdvd_title_get_size ()
gint | ogmdvd_title_get_video_format ()
gint | ogmdvd_title_get_display_aspect ()
gint | ogmdvd_title_get_display_format ()
const guint * | ogmdvd_title_get_palette ()
gint | ogmdvd_title_get_n_angles ()
gint | ogmdvd_title_get_n_chapters ()
gint | ogmdvd_title_get_n_audio_streams ()
OGMDvdAudioStream * | ogmdvd_title_get_nth_audio_stream ()
GSList * | ogmdvd_title_get_audio_streams ()
gint | ogmdvd_title_get_n_subp_streams ()
OGMDvdSubpStream * | ogmdvd_title_get_nth_subp_stream ()
GSList * | ogmdvd_title_get_subp_streams ()
void | ogmdvd_title_get_aspect_ratio ()
OGMDvdAudioStream * | ogmdvd_title_find_audio_stream ()
OGMDvdSubpStream * | ogmdvd_title_find_subp_stream ()

## Includes

    #include <ogmdvd-title.h>

## Description

## Functions

### ogmdvd_title_open ()

    gboolean
    ogmdvd_title_open (OGMDvdTitle *title,
                       GError **error);

Opens `title` , opening the disc if needed.

#### Parameters

title | An OGMDvdTitle |
error | Location to store the error occuring, or NULL to ignore errors. |

#### Returns

TRUE on success

### ogmdvd_title_close ()

    void
    ogmdvd_title_close (OGMDvdTitle *title);

Closes `title` .

#### Parameters

title | A OGMDvdTitle |

### ogmdvd_title_is_open ()

    gboolean
    ogmdvd_title_is_open (OGMDvdTitle *title);

Returns whether the title is open or not.

#### Parameters

title | An OGMDvdTitle |

#### Returns

TRUE if the title is open

### ogmdvd_title_ref ()

    void
    ogmdvd_title_ref (OGMDvdTitle *title);

Increments the reference count of an OGMDvdTitle.

#### Parameters

title | An OGMDvdTitle |

### ogmdvd_title_unref ()

    void
    ogmdvd_title_unref (OGMDvdTitle *title);

Decrements the reference count of an OGMDvdTitle.

#### Parameters

title | An OGMDvdTitle |

### ogmdvd_title_analyze ()

    gboolean
    ogmdvd_title_analyze (OGMDvdTitle *title);

Performs a depper analysis of the title to get more information about it and its audio and subtitle streams. This function should be called multiple times until the analysis is complete.

#### Parameters

title | An OGMDvdTitle |

#### Returns

FALSE if the analysis is complete, TRUE otherwise

### ogmdvd_title_get_disc ()

    OGMDvdDisc *
    ogmdvd_title_get_disc (OGMDvdTitle *title);

Returns the disc the OGMDvdTitle was open from.

#### Parameters

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.

#### Parameters

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.

#### Parameters

title | An OGMDvdTitle |

#### Returns

The title number, or -1

### ogmdvd_title_get_ts_nr ()

    gint
    ogmdvd_title_get_ts_nr (OGMDvdTitle *title);

Returns the titleset number.

#### Parameters

title | An OGMDvdTitle |

#### Returns

The titleset 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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

title | An OGMDvdTitle |

#### Returns

OGMDvdDisplayFormat, or -1

### ogmdvd_title_get_palette ()

    const guint *
    ogmdvd_title_get_palette (OGMDvdTitle *title);

Returns the palette of the movie.

#### Parameters

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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

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.

#### Parameters

title | An OGMDvdTitle |
nr | The audio stream number |

#### Returns

The OGMDvdAudioStream, or NULL

### ogmdvd_title_get_audio_streams ()

    GSList *
    ogmdvd_title_get_audio_streams (OGMDvdTitle *title);

Returns a list of audio stream.

#### Parameters

title | An OGMDvdTitle |

#### Returns

The GSList, 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.

#### Parameters

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.

#### Parameters

title | An OGMDvdTitle |
nr | The subtitles stream number |

#### Returns

The OGMDvdSubpStream, or NULL

### ogmdvd_title_get_subp_streams ()

    GSList *
    ogmdvd_title_get_subp_streams (OGMDvdTitle *title);

Returns a list of subp stream.

#### Parameters

title | An OGMDvdTitle |

#### Returns

The GSList, 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.

#### Parameters

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 |

### ogmdvd_title_find_audio_stream ()

    OGMDvdAudioStream *
    ogmdvd_title_find_audio_stream (OGMDvdTitle *title,
                                    GCompareFunc func,
                                    gpointer data);

Searches for an audio stream with custom criteria.

#### Parameters

title | An OGMDvdTitle |
func | A GCompareFunc |
data | The data to pass to `func` |

#### Returns

An OGMDvdAudioStream, or NULL

### ogmdvd_title_find_subp_stream ()

    OGMDvdSubpStream *
    ogmdvd_title_find_subp_stream (OGMDvdTitle *title,
                                   GCompareFunc func,
                                   gpointer data);

Searches for a subp stream with custom criteria.

#### Parameters

title | An OGMDvdTitle |
func | A GCompareFunc |
data | The data to pass to `func` |

#### Returns

An OGMDvdSubpStream, or NULL

## Types and Values