1 /********************************************************************
3 * THIS FILE IS PART OF THE OggVorbis 'TREMOR' CODEC SOURCE CODE. *
5 * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS *
6 * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE *
7 * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. *
9 * THE OggVorbis 'TREMOR' SOURCE CODE IS (C) COPYRIGHT 1994-2003 *
10 * BY THE Xiph.Org FOUNDATION http://www.xiph.org/ *
12 ********************************************************************
14 function: stdio-based convenience library for opening/seeking/decoding
16 ********************************************************************/
24 #endif /* __cplusplus */
27 #include "ivorbiscodec.h"
29 /* The function prototypes for the callbacks are basically the same as for
30 * the stdio functions fread, fseek, fclose, ftell.
31 * The one difference is that the FILE * arguments have been replaced with
32 * a void * - this is to be used as a pointer to whatever internal data these
33 * functions might need. In the stdio case, it's just a FILE * cast to a void *
35 * If you use other functions, check the docs for these functions and return
36 * the right values. For seek_func(), you *MUST* return -1 if the stream is
40 size_t (*read_func
) (void *ptr
, size_t size
, size_t nmemb
, void *datasource
);
41 int (*seek_func
) (void *datasource
, ogg_int64_t offset
, int whence
);
42 int (*close_func
) (void *datasource
);
43 long (*tell_func
) (void *datasource
);
46 typedef struct OggVorbis_File
{
47 void *datasource
; /* Pointer to a FILE *, etc. */
53 /* If the FILE handle isn't seekable (eg, a pipe), only the current
57 ogg_int64_t
*dataoffsets
;
58 ogg_uint32_t
*serialnos
;
59 ogg_int64_t
*pcmlengths
;
63 /* Decoding working state local storage */
64 ogg_int64_t pcm_offset
;
66 ogg_uint32_t current_serialno
;
70 ogg_int64_t samptrack
;
72 ogg_stream_state
*os
; /* take physical pages, weld into a logical
74 vorbis_dsp_state
*vd
; /* central working state for the packet->PCM decoder */
76 ov_callbacks callbacks
;
80 extern int ov_clear(OggVorbis_File
*vf
);
81 extern int ov_open(FILE *f
,OggVorbis_File
*vf
,char *initial
,long ibytes
);
82 extern int ov_open_callbacks(void *datasource
, OggVorbis_File
*vf
,
83 char *initial
, long ibytes
, ov_callbacks callbacks
);
85 extern int ov_test(FILE *f
,OggVorbis_File
*vf
,char *initial
,long ibytes
);
86 extern int ov_test_callbacks(void *datasource
, OggVorbis_File
*vf
,
87 char *initial
, long ibytes
, ov_callbacks callbacks
);
88 extern int ov_test_open(OggVorbis_File
*vf
);
90 extern long ov_bitrate(OggVorbis_File
*vf
,int i
);
91 extern long ov_bitrate_instant(OggVorbis_File
*vf
);
92 extern long ov_streams(OggVorbis_File
*vf
);
93 extern long ov_seekable(OggVorbis_File
*vf
);
94 extern long ov_serialnumber(OggVorbis_File
*vf
,int i
);
96 extern ogg_int64_t
ov_raw_total(OggVorbis_File
*vf
,int i
);
97 extern ogg_int64_t
ov_pcm_total(OggVorbis_File
*vf
,int i
);
98 extern ogg_int64_t
ov_time_total(OggVorbis_File
*vf
,int i
);
100 extern int ov_raw_seek(OggVorbis_File
*vf
,ogg_int64_t pos
);
101 extern int ov_pcm_seek(OggVorbis_File
*vf
,ogg_int64_t pos
);
102 extern int ov_pcm_seek_page(OggVorbis_File
*vf
,ogg_int64_t pos
);
103 extern int ov_time_seek(OggVorbis_File
*vf
,ogg_int64_t pos
);
104 extern int ov_time_seek_page(OggVorbis_File
*vf
,ogg_int64_t pos
);
106 extern ogg_int64_t
ov_raw_tell(OggVorbis_File
*vf
);
107 extern ogg_int64_t
ov_pcm_tell(OggVorbis_File
*vf
);
108 extern ogg_int64_t
ov_time_tell(OggVorbis_File
*vf
);
110 extern vorbis_info
*ov_info(OggVorbis_File
*vf
,int link
);
111 extern vorbis_comment
*ov_comment(OggVorbis_File
*vf
,int link
);
113 extern long ov_read(OggVorbis_File
*vf
,void *buffer
,int length
,
118 #endif /* __cplusplus */