vorbisfile.h
上传用户:tuheem
上传日期:2007-05-01
资源大小:21889k
文件大小:4k
源码类别:

多媒体编程

开发平台:

Visual C++

  1. /********************************************************************
  2.  *                                                                  *
  3.  * THIS FILE IS PART OF THE OggVorbis SOFTWARE CODEC SOURCE CODE.   *
  4.  * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS     *
  5.  * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE *
  6.  * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING.       *
  7.  *                                                                  *
  8.  * THE OggVorbis SOURCE CODE IS (C) COPYRIGHT 1994-2001             *
  9.  * by the XIPHOPHORUS Company http://www.xiph.org/                  *
  10.  ********************************************************************
  11.  function: stdio-based convenience library for opening/seeking/decoding
  12.  last mod: $Id: vorbisfile.h,v 1.1.1.1 2003/02/06 04:06:52 hurly Exp $
  13.  ********************************************************************/
  14. #ifndef _OV_FILE_H_
  15. #define _OV_FILE_H_
  16. #ifdef __cplusplus
  17. extern "C"
  18. {
  19. #endif /* __cplusplus */
  20. #include <stdio.h>
  21. #include "codec.h"
  22. /* The function prototypes for the callbacks are basically the same as for
  23.  * the stdio functions fread, fseek, fclose, ftell. 
  24.  * The one difference is that the FILE * arguments have been replaced with
  25.  * a void * - this is to be used as a pointer to whatever internal data these
  26.  * functions might need. In the stdio case, it's just a FILE * cast to a void *
  27.  * 
  28.  * If you use other functions, check the docs for these functions and return
  29.  * the right values. For seek_func(), you *MUST* return -1 if the stream is
  30.  * unseekable
  31.  */
  32. typedef struct {
  33.   size_t (*read_func)  (void *ptr, size_t size, size_t nmemb, void *datasource);
  34.   int    (*seek_func)  (void *datasource, ogg_int64_t offset, int whence);
  35.   int    (*close_func) (void *datasource);
  36.   long   (*tell_func)  (void *datasource);
  37. } ov_callbacks;
  38. typedef struct OggVorbis_File {
  39.   void             *datasource; /* Pointer to a FILE *, etc. */
  40.   int              seekable;
  41.   ogg_int64_t          offset;
  42.   ogg_int64_t          end;
  43.   ogg_sync_state   oy; 
  44.   /* If the FILE handle isn't seekable (eg, a pipe), only the current
  45.      stream appears */
  46.   int              links;
  47.   ogg_int64_t          *offsets;
  48.   ogg_int64_t          *dataoffsets;
  49.   long             *serialnos;
  50.   ogg_int64_t          *pcmlengths;
  51.   vorbis_info      *vi;
  52.   vorbis_comment   *vc;
  53.   /* Decoding working state local storage */
  54.   ogg_int64_t          pcm_offset;
  55.   int              decode_ready;
  56.   long             current_serialno;
  57.   int              current_link;
  58.   double           bittrack;
  59.   double           samptrack;
  60.   ogg_stream_state os; /* take physical pages, weld into a logical
  61.                           stream of packets */
  62.   vorbis_dsp_state vd; /* central working state for the packet->PCM decoder */
  63.   vorbis_block     vb; /* local working space for packet->PCM decode */
  64.   ov_callbacks callbacks;
  65. } OggVorbis_File;
  66. extern int ov_clear(OggVorbis_File *vf);
  67. extern int ov_open(FILE *f,OggVorbis_File *vf,char *initial,long ibytes);
  68. extern int ov_open_callbacks(void *datasource, OggVorbis_File *vf,
  69. char *initial, long ibytes, ov_callbacks callbacks);
  70. extern long ov_bitrate(OggVorbis_File *vf,int i);
  71. extern long ov_bitrate_instant(OggVorbis_File *vf);
  72. extern long ov_streams(OggVorbis_File *vf);
  73. extern long ov_seekable(OggVorbis_File *vf);
  74. extern long ov_serialnumber(OggVorbis_File *vf,int i);
  75. extern ogg_int64_t ov_raw_total(OggVorbis_File *vf,int i);
  76. extern ogg_int64_t ov_pcm_total(OggVorbis_File *vf,int i);
  77. extern double ov_time_total(OggVorbis_File *vf,int i);
  78. extern int ov_raw_seek(OggVorbis_File *vf,long pos);
  79. extern int ov_pcm_seek(OggVorbis_File *vf,ogg_int64_t pos);
  80. extern int ov_pcm_seek_page(OggVorbis_File *vf,ogg_int64_t pos);
  81. extern int ov_time_seek(OggVorbis_File *vf,double pos);
  82. extern int ov_time_seek_page(OggVorbis_File *vf,double pos);
  83. extern ogg_int64_t ov_raw_tell(OggVorbis_File *vf);
  84. extern ogg_int64_t ov_pcm_tell(OggVorbis_File *vf);
  85. extern double ov_time_tell(OggVorbis_File *vf);
  86. extern vorbis_info *ov_info(OggVorbis_File *vf,int link);
  87. extern vorbis_comment *ov_comment(OggVorbis_File *vf,int link);
  88. extern long ov_read(OggVorbis_File *vf,char *buffer,int length,
  89.     int bigendianp,int word,int sgned,int *bitstream);
  90. #ifdef __cplusplus
  91. }
  92. #endif /* __cplusplus */
  93. #endif