liboggz 1.1.3
oggz_read.h
Go to the documentation of this file.
1/*
2 Copyright (C) 2003 Commonwealth Scientific and Industrial Research
3 Organisation (CSIRO) Australia
4
5 Redistribution and use in source and binary forms, with or without
6 modification, are permitted provided that the following conditions
7 are met:
8
9 - Redistributions of source code must retain the above copyright
10 notice, this list of conditions and the following disclaimer.
11
12 - Redistributions in binary form must reproduce the above copyright
13 notice, this list of conditions and the following disclaimer in the
14 documentation and/or other materials provided with the distribution.
15
16 - Neither the name of CSIRO Australia nor the names of its
17 contributors may be used to endorse or promote products derived from
18 this software without specific prior written permission.
19
20 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21 ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
23 PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE ORGANISATION OR
24 CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25 EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
26 PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
27 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
28 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
29 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
30 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31*/
32
33#ifndef OGGZ_READ_HEADER
34#define OGGZ_READ_HEADER
35
40#include <oggz/oggz_packet.h>
41
81typedef int (*OggzReadPacket) (OGGZ * oggz, oggz_packet * packet, long serialno,
82 void * user_data);
83
108int oggz_set_read_callback (OGGZ * oggz, long serialno,
109 OggzReadPacket read_packet, void * user_data);
110
121typedef int (*OggzReadPage) (OGGZ * oggz, const ogg_page * og,
122 long serialno, void * user_data);
123
146int oggz_set_read_page (OGGZ * oggz, long serialno,
147 OggzReadPage read_page, void * user_data);
148
149
166long oggz_read (OGGZ * oggz, long n);
167
183long oggz_read_input (OGGZ * oggz, unsigned char * buf, long n);
184
198int oggz_purge (OGGZ * oggz);
199
212
222const char * oggz_stream_get_content_type (OGGZ *oggz, long serialno);
223
236int oggz_stream_get_numheaders (OGGZ * oggz, long serialno);
237
238#endif /* OGGZ_READ_HEADER */
int(* OggzReadPage)(OGGZ *oggz, const ogg_page *og, long serialno, void *user_data)
This is the signature of a callback which you must provide for Oggz to call whenever it finds a new p...
Definition: oggz_read.h:121
long oggz_read(OGGZ *oggz, long n)
Read n bytes into oggz, calling any read callbacks on the fly.
int oggz_set_read_callback(OGGZ *oggz, long serialno, OggzReadPacket read_packet, void *user_data)
Set a callback for Oggz to call when a new Ogg packet is found in the stream.
long oggz_read_input(OGGZ *oggz, unsigned char *buf, long n)
Input data into oggz.
int(* OggzReadPacket)(OGGZ *oggz, oggz_packet *packet, long serialno, void *user_data)
This is the signature of a callback which you must provide for Oggz to call whenever it finds a new p...
Definition: oggz_read.h:81
int oggz_set_read_page(OGGZ *oggz, long serialno, OggzReadPage read_page, void *user_data)
Set a callback for Oggz to call when a new Ogg page is found in the stream.
void OGGZ
An opaque handle to an Ogg file.
Definition: oggz.h:441
OggzStreamContent
Definition of stream content types, including error codes returned by oggz_stream_get_content().
Definition: oggz_constants.h:193
Packet positioning.
const char * oggz_stream_get_content_type(OGGZ *oggz, long serialno)
Return human-readable string representation of content type of oggz stream referred to by serialno.
OggzStreamContent oggz_stream_get_content(OGGZ *oggz, long serialno)
Determine the content type of the oggz stream referred to by serialno.
int oggz_purge(OGGZ *oggz)
Erase any input buffered in Oggz.
int oggz_stream_get_numheaders(OGGZ *oggz, long serialno)
Determine the number of headers of the oggz stream referred to by serialno.
An ogg_packet and its position in the stream.
Definition: oggz_packet.h:84