OGMDvd Reference Manual: Parser

## Parser Parser — Parses the content of a DVD |

## Functions

OGMDvdParser * | ogmdvd_parser_new ()
void | ogmdvd_parser_ref ()
void | ogmdvd_parser_unref ()
gint | ogmdvd_parser_analyze ()
gint | ogmdvd_parser_get_max_frames ()
void | ogmdvd_parser_set_max_frames ()
gint | ogmdvd_parser_get_audio_bitrate ()

## Types and Values

enum | OGMDvdParserStatus

## Includes

    #include <ogmdvd-parser.h>

## Description

## Functions

### ogmdvd_parser_new ()

    OGMDvdParser *
    ogmdvd_parser_new (OGMDvdTitle *title);

Creates a new OGMDvdParser.

#### Parameters

title | An OGMDvdTitle |

#### Returns

The new OGMDvdParser, or NULL

### ogmdvd_parser_ref ()

    void
    ogmdvd_parser_ref (OGMDvdParser *parser);

Increments the reference count of an OGMDvdParser.

#### Parameters

parser | An OGMDvdParser |

### ogmdvd_parser_unref ()

    void
    ogmdvd_parser_unref (OGMDvdParser *parser);

Decrements the reference count of an OGMDvdParser.

#### Parameters

parser | An OGMDvdParser |

### ogmdvd_parser_analyze ()

    gint
    ogmdvd_parser_analyze (OGMDvdParser *parser,
                           guchar *buffer);

Analyzes the block contained in `buffer` .

#### Parameters

parser | An OGMDvdParser |
buffer | A buffer containing a block to analyze |

#### Returns

the status of the analysis

### ogmdvd_parser_get_max_frames ()

    gint
    ogmdvd_parser_get_max_frames (OGMDvdParser *parser);

Returns the maximum number of frames to analyze.

#### Parameters

parser | An OGMDvdParser |

#### Returns

The number of frames, -1 if the whole title is to be analyzed, 0 on error

### ogmdvd_parser_set_max_frames ()

    void
    ogmdvd_parser_set_max_frames (OGMDvdParser *parser,
                                  gint max_frames);

Sets the maximum number of frames to analyse. If `max_frames` is negative, all the frames of the title will be analyzed.

#### Parameters

parser | An OGMDvdParser |
max_frames | A number of frames |

### ogmdvd_parser_get_audio_bitrate ()

    gint
    ogmdvd_parser_get_audio_bitrate (OGMDvdParser *parser,
                                     guint nr);

Returns the bitrate of the audio stream at position nr, starting at 0.

#### Parameters

parser | An OGMDvdParser |
nr | The audio stream number |

#### Returns

The bitrate, or -1

## Types and Values

### enum OGMDvdParserStatus

Status code returned by `ogmdvd_parser_analyze()`

#### Members

OGMDVD_PARSER_STATUS_NONE | There is no information available yet |
OGMDVD_PARSER_STATUS_BITRATES | The bitrates of all the audio tracks are available |
OGMDVD_PARSER_STATUS_MAX_FRAMES | The maximum number of frames has been reached |