view tremor/ivorbiscodec.h @ 15011:83077e6742e7

various (de)muxer_lavf fixes

+
鐃緒申��申鐃緒申/********************************************************************
+
鐃緒申��申鐃緒申 *                                                                  *
+
鐃緒申��申鐃緒申 * THIS FILE IS PART OF THE OggVorbis 'TREMOR' CODEC SOURCE CODE.   *
+
鐃緒申��申鐃緒申 *                                                                  *
+
鐃緒申��申鐃緒申 * THE OggVorbis 'TREMOR' SOURCE CODE IS (C) COPYRIGHT 1994-2002    *
+
鐃緒申��申鐃緒申 * BY THE Xiph.Org FOUNDATION http://www.xiph.org/                  *
+
鐃緒申��申鐃緒申 * ALL REDISTRIBUTION RIGHTS RESERVED.                              *
+
鐃緒申��申鐃緒申 *                                                                  *
+
鐃緒申��申鐃緒申 ********************************************************************
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申 function: libvorbis codec headers
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申 ********************************************************************/
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申#ifndef _vorbis_codec_h_
+
鐃緒申��申鐃緒申#define _vorbis_codec_h_
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申#ifdef __cplusplus
+
鐃緒申��申鐃緒申extern "C"
+
鐃緒申��申鐃緒申{
+
鐃緒申��申鐃緒申#endif /* __cplusplus */
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申#include "ogg.h"
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申typedef struct vorbis_info{
+
鐃緒申��申鐃緒申  int version;
+
鐃緒申��申鐃緒申  int channels;
+
鐃緒申��申鐃緒申  long rate;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  /* The below bitrate declarations are *hints*.
+
鐃緒申��申鐃緒申     Combinations of the three values carry the following implications:
+
鐃緒申��申鐃緒申     
+
鐃緒申��申鐃緒申     all three set to the same value: 
+
鐃緒申��申鐃緒申       implies a fixed rate bitstream
+
鐃緒申��申鐃緒申     only nominal set: 
+
鐃緒申��申鐃緒申       implies a VBR stream that averages the nominal bitrate.  No hard 
+
鐃緒申��申鐃緒申       upper/lower limit
+
鐃緒申��申鐃緒申     upper and or lower set: 
+
鐃緒申��申鐃緒申       implies a VBR bitstream that obeys the bitrate limits. nominal 
+
鐃緒申��申鐃緒申       may also be set to give a nominal rate.
+
鐃緒申��申鐃緒申     none set:
+
鐃緒申��申鐃緒申       the coder does not care to speculate.
+
鐃緒申��申鐃緒申  */
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  long bitrate_upper;
+
鐃緒申��申鐃緒申  long bitrate_nominal;
+
鐃緒申��申鐃緒申  long bitrate_lower;
+
鐃緒申��申鐃緒申  long bitrate_window;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  void *codec_setup;
+
鐃緒申��申鐃緒申} vorbis_info;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申/* vorbis_dsp_state buffers the current vorbis audio
+
鐃緒申��申鐃緒申   analysis/synthesis state.  The DSP state belongs to a specific
+
鐃緒申��申鐃緒申   logical bitstream ****************************************************/
+
鐃緒申��申鐃緒申typedef struct vorbis_dsp_state{
+
鐃緒申��申鐃緒申  int analysisp;
+
鐃緒申��申鐃緒申  vorbis_info *vi;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  ogg_int32_t **pcm;
+
鐃緒申��申鐃緒申  ogg_int32_t **pcmret;
+
鐃緒申��申鐃緒申  int      pcm_storage;
+
鐃緒申��申鐃緒申  int      pcm_current;
+
鐃緒申��申鐃緒申  int      pcm_returned;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  int  preextrapolate;
+
鐃緒申��申鐃緒申  int  eofflag;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  long lW;
+
鐃緒申��申鐃緒申  long W;
+
鐃緒申��申鐃緒申  long nW;
+
鐃緒申��申鐃緒申  long centerW;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  ogg_int64_t granulepos;
+
鐃緒申��申鐃緒申  ogg_int64_t sequence;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  void       *backend_state;
+
鐃緒申��申鐃緒申} vorbis_dsp_state;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申typedef struct vorbis_block{
+
鐃緒申��申鐃緒申  /* necessary stream state for linking to the framing abstraction */
+
鐃緒申��申鐃緒申  ogg_int32_t  **pcm;       /* this is a pointer into local storage */ 
+
鐃緒申��申鐃緒申  oggpack_buffer opb;
+
鐃緒申��申鐃緒申  
+
鐃緒申��申鐃緒申  long  lW;
+
鐃緒申��申鐃緒申  long  W;
+
鐃緒申��申鐃緒申  long  nW;
+
鐃緒申��申鐃緒申  int   pcmend;
+
鐃緒申��申鐃緒申  int   mode;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  int         eofflag;
+
鐃緒申��申鐃緒申  ogg_int64_t granulepos;
+
鐃緒申��申鐃緒申  ogg_int64_t sequence;
+
鐃緒申��申鐃緒申  vorbis_dsp_state *vd; /* For read-only access of configuration */
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申  /* local storage to avoid remallocing; it's up to the mapping to
+
鐃緒申��申鐃緒申     structure it */
+
鐃緒申��申鐃緒申  void               *localstore;
+
鐃緒申��申鐃緒申  long                localtop;
+
鐃緒申��申鐃緒申  long                localalloc;
+
鐃緒申��申鐃緒申  long                totaluse;
+
鐃緒申��申鐃緒申  struct alloc_chain *reap;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申} vorbis_block;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申/* vorbis_block is a single block of data to be processed as part of
+
鐃緒申��申鐃緒申the analysis/synthesis stream; it belongs to a specific logical
+
鐃緒申��申鐃緒申bitstream, but is independant from other vorbis_blocks belonging to
+
鐃緒申��申鐃緒申that logical bitstream. *************************************************/
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申struct alloc_chain{
+
鐃緒申��申鐃緒申  void *ptr;
+
鐃緒申��申鐃緒申  struct alloc_chain *next;
+
鐃緒申��申鐃緒申};
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申/* vorbis_info contains all the setup information specific to the
+
鐃緒申��申鐃緒申   specific compression/decompression mode in progress (eg,
+
鐃緒申��申鐃緒申   psychoacoustic settings, channel setup, options, codebook
+
鐃緒申��申鐃緒申   etc). vorbis_info and substructures are in backends.h.
+
鐃緒申��申鐃緒申*********************************************************************/
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申/* the comments are not part of vorbis_info so that vorbis_info can be
+
鐃緒申��申鐃緒申   static storage */
+
鐃緒申��申鐃緒申typedef struct vorbis_comment{
+
鐃緒申��申鐃緒申  /* unlimited user comment fields.  libvorbis writes 'libvorbis'
+
鐃緒申��申鐃緒申     whatever vendor is set to in encode */
+
鐃緒申��申鐃緒申  char **user_comments;
+
鐃緒申��申鐃緒申  int   *comment_lengths;
+
鐃緒申��申鐃緒申  int    comments;
+
鐃緒申��申鐃緒申  char  *vendor;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申} vorbis_comment;
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申/* libvorbis encodes in two abstraction layers; first we perform DSP
+
鐃緒申��申鐃緒申   and produce a packet (see docs/analysis.txt).  The packet is then
+
鐃緒申��申鐃緒申   coded into a framed OggSquish bitstream by the second layer (see
+
鐃緒申��申鐃緒申   docs/framing.txt).  Decode is the reverse process; we sync/frame
+
鐃緒申��申鐃緒申   the bitstream and extract individual packets, then decode the
+
鐃緒申��申鐃緒申   packet back into PCM audio.
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申   The extra framing/packetizing is used in streaming formats, such as
+
鐃緒申��申鐃緒申   files.  Over the net (such as with UDP), the framing and
+
鐃緒申��申鐃緒申   packetization aren't necessary as they're provided by the transport
+
鐃緒申��申鐃緒申   and the streaming layer is not used */
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申/* Vorbis PRIMITIVES: general ***************************************/
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申extern void     vorbis_info_init(vorbis_info *vi);
+
鐃緒申��申鐃緒申extern void     vorbis_info_clear(vorbis_info *vi);
+
鐃緒申��申鐃緒申extern int      vorbis_info_blocksize(vorbis_info *vi,int zo);
+
鐃緒申��申鐃緒申extern void     vorbis_comment_init(vorbis_comment *vc);
+
鐃緒申��申鐃緒申extern void     vorbis_comment_add(vorbis_comment *vc, char *comment); 
+
鐃緒申��申鐃緒申extern void     vorbis_comment_add_tag(vorbis_comment *vc, 
+
鐃緒申��申鐃緒申				       char *tag, char *contents);
+
鐃緒申��申鐃緒申extern char    *vorbis_comment_query(vorbis_comment *vc, char *tag, int count);
+
鐃緒申��申鐃緒申extern int      vorbis_comment_query_count(vorbis_comment *vc, char *tag);
+
鐃緒申��申鐃緒申extern void     vorbis_comment_clear(vorbis_comment *vc);
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申extern int      vorbis_block_init(vorbis_dsp_state *v, vorbis_block *vb);
+
鐃緒申��申鐃緒申extern int      vorbis_block_clear(vorbis_block *vb);
+
鐃緒申��申鐃緒申extern void     vorbis_dsp_clear(vorbis_dsp_state *v);
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申/* Vorbis PRIMITIVES: synthesis layer *******************************/
+
鐃緒申��申鐃緒申extern int      vorbis_synthesis_headerin(vorbis_info *vi,vorbis_comment *vc,
+
鐃緒申��申鐃緒申					  ogg_packet *op);
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申extern int      vorbis_synthesis_init(vorbis_dsp_state *v,vorbis_info *vi);
+
鐃緒申��申鐃緒申extern int      vorbis_synthesis(vorbis_block *vb,ogg_packet *op);
+
鐃緒申��申鐃緒申extern int      vorbis_synthesis_blockin(vorbis_dsp_state *v,vorbis_block *vb);
+
鐃緒申��申鐃緒申extern int      vorbis_synthesis_pcmout(vorbis_dsp_state *v,ogg_int32_t ***pcm);
+
鐃緒申��申鐃緒申extern int      vorbis_synthesis_read(vorbis_dsp_state *v,int samples);
+
鐃緒申��申鐃緒申extern long     vorbis_packet_blocksize(vorbis_info *vi,ogg_packet *op);
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申/* Vorbis ERRORS and return codes ***********************************/
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申#define OV_FALSE      -1  
+
鐃緒申��申鐃緒申#define OV_EOF        -2
+
鐃緒申��申鐃緒申#define OV_HOLE       -3
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申#define OV_EREAD      -128
+
鐃緒申��申鐃緒申#define OV_EFAULT     -129
+
鐃緒申��申鐃緒申#define OV_EIMPL      -130
+
鐃緒申��申鐃緒申#define OV_EINVAL     -131
+
鐃緒申��申鐃緒申#define OV_ENOTVORBIS -132
+
鐃緒申��申鐃緒申#define OV_EBADHEADER -133
+
鐃緒申��申鐃緒申#define OV_EVERSION   -134
+
鐃緒申��申鐃緒申#define OV_ENOTAUDIO  -135
+
鐃緒申��申鐃緒申#define OV_EBADPACKET -136
+
鐃緒申��申鐃緒申#define OV_EBADLINK   -137
+
鐃緒申��申鐃緒申#define OV_ENOSEEK    -138
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申#ifdef __cplusplus
+
鐃緒申��申鐃緒申}
+
鐃緒申��申鐃緒申#endif /* __cplusplus */
+
鐃緒申��申鐃緒申
+
鐃緒申��申鐃緒申#endif
+
鐃緒申��申鐃緒申