达内招聘前台是真的吗:记录点滴 ? Blog Archive ? libmad音频解码库简介及其数据结构

struct mad_stream

struct mad_stream {  unsigned char const *buffer;/* input bitstream buffer */  unsigned char const *bufend;/* end of buffer */  unsigned long skiplen;/* bytes to skip before next frame */  int sync;/* stream sync found */  unsigned long freerate;/* free bitrate (fixed) */  unsigned char const *this_frame;/* start of current frame */  unsigned char const *next_frame;/* start of next frame */  struct mad_bitptr ptr;/* current processing bit pointer */  struct mad_bitptr anc_ptr;/* ancillary bits pointer */  unsigned int anc_bitlen;/* number of ancillary bits */  unsigned char (*main_data)[MAD_BUFFER_MDLEN];/* Layer III main_data() */  unsigned int md_len;/* bytes in main_data */  int options;/* decoding options (see below) */  enum mad_error error;/* error code (see above) */};

mad_synth

struct mad_synth {  mad_fixed_t filter[2][2][2][16][8];/* polyphase filterbank outputs */  /* [ch][eo][peo][s][v] */  unsigned int phase;/* current processing phase */  struct mad_pcm pcm;/* PCM output */};

mad_pcm

struct mad_pcm {  unsigned int samplerate;/* sampling frequency (Hz) */  unsigned short channels;/* number of channels */  unsigned short length;/* number of samples per channel */  mad_fixed_t samples[2][1152];/* PCM output samples [ch][sample] */};

mad_frame

struct mad_frame {  struct mad_header header;/* MPEG audio header */  int options;/* decoding options (from stream) */  mad_fixed_t sbsample[2][36][32];/* synthesis subband filter samples */  mad_fixed_t (*overlap)[2][32][18];/* Layer III block overlap data */};

mad API的调用顺序

• mad_decoder_init()【decoder.h】
  Minimad.c中给出了一个函数调用过程的实例。首先定义一个mad_decoder变量（解码器对象），这时不需要对解码器对象进行任何初始化。调用mad_decoder_init()函数对刚才创建的decoder对象进行初始化，mad_decoder_init()函数定义于decoder.h头文件中。原型如下：

  void mad_decoder_init(struct mad_decoder *, //解码器对象指针void *,//自定义消息指针，这个值被复制进mad_decoder的cb_data成员                    enum mad_flow (*)(void *, struct mad_stream *),//input回调函数                    enum mad_flow (*)(void *, struct mad_header const *),//header回调函数                    enum mad_flow (*)(void *,struct mad_stream const *,struct mad_frame *),//filter回调函数                    enum mad_flow (*)(void *,struct mad_header const *,struct mad_pcm *),//output回调函数                    enum mad_flow (*)(void *,struct mad_stream *,struct mad_frame *),//error回调函数                    enum mad_flow (*)(void *, void *, unsigned int *)//message回调函数);

  其中的input回到函数和output回调函数是必须定义并传递给mad_decoder_init()的，message回调函数在异步工作模式下必选，其他回调函数都可选。

• mad_stream_buffer()【stream.h】
  Input回调函数具有两个参数，第一个参数是个void指针，指向自定义消息结构，在input回调函数内部对消息进行解释并调用mad_stream_buffer()函数对输入流进行初始化，具体参考minimad.c中input函数的写法。mad_stream_buffer()函数原型如下：

  void mad_stream_buffer(struct mad_stream *,//输入流指针unsigned char const *, //文件起始地址unsigned long//文件长度);

  第一个参数指向一个mad_stream变量，mad_stream结构定义在stream.h头文件里，用于记录文件的地址和当前处理的位置。第二、三个参数分别是mp3文件在内存中映像的起始地址和文件长度。mad_stream_buffer()函数将mp3文件与mad_stream结构进行关联。Input回调函数在解码器启动后会被调用一次，在整个解码过程中都不再被调用。

  Output回调函数的原型是：

  enum mad_flow (*output_func)(void *,struct mad_header const *,struct mad_pcm *)

  Output回调函数将解码得到的原始PCM块作为参数传入，在这里可以进行一些解码后的操作如加入均衡器等。MadLib使用的PCM结构mad_pcm在头文件synth.h中定义：

  struct mad_pcm {  unsigned int samplerate;         /* sampling frequency (Hz) */  unsigned short channels;         /* number of channels */  unsigned short length;             /* number of samples per channel */  mad_fixed_t samples[2][1152];           /* PCM output samples [ch][sample] */};

  Madlib解码器是以帧为单位进行解码的，mad_pcm每次携带最多1152个PCM采样数据（左右声道共2*1152个），每个采样使用32bit存放，只使用了其中的24bit，但目前大多数的音频设备支持的是16bit量化分辨率，所以在交给声卡输出前还要自己进行转换，将24bit分辨率降低为16bit。length成员指定了当前PCM数据块的实际大小。

  另外两个参数分别将自定义消息结构和已解码帧的帧头传入，以处理用户消息和获取帧信息。Output回调函数在madlib每解码完成一个帧后被调用，直到全部解码完成或出错。

  Input和output回调函数的返回值是一个mad_folw枚举类型，在decoder.h头文件中定义如下：

  enum mad_flow {  MAD_FLOW_CONTINUE = 0x0000,     /* continue normally */  MAD_FLOW_STOP     = 0x0010,      /* stop decoding normally */  MAD_FLOW_BREAK    = 0x0011,     /* stop decoding and signal an error */  MAD_FLOW_IGNORE   = 0x0020      /* ignore the current frame */};

• mad_decoder_run()【decoder.h】
  获取了待解吗的mp3文件后解码器开始运行。mad_decoder_run()函数可以看作是mad解码器的运行入口。其原型如下：

  int mad_decoder_run(struct mad_decoder * decoder, enum mad_decoder_mode mode)

  第一、二个参数将初始化好的decoder变量和解码器工作模式（同步或异步）进行关联。后面我们会看到真正完成解码工作的并不是mad_decoder_run，而是根据工作模式的不同在它的内部调用了另外不同的函数进行解码。函数返回后解码就完成了。

• mad_decoder_finish()【decoder.h】
  最后调用mad_decoder_finish()进行最后的清理工作。