关键数据结构之 输入与输出：mad_stream和mad_synth

在2.1-数据流向中我们总结出：一个mp3文件首先被嵌入到一个“输入流结构”中，在解码之后的PCM流存入“输出结构”中，这两个结构对应于mad_stream和mad_synth两个结构，前者用于mp3文件的输入和解码流程的控制，后者用于存放输出数据。这两个结构分别定义在stream.h和synth.h头文件中。它们在整个解码过程中起到最重要的作用：

 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) */ };

buffer成员指向mp3文件在内存中映像的起始地址，这个地址可以去除头部的ID3V2标签，也可以不去除，由madlib自动跳过标签部分；bufferend成员指向文件映射区域的最后一个字节；skiplen成员指定从当前位置跳过的数据长度（可以不是帧长度的倍数，madlib会去寻找下一个有效帧的12bit同步字），这个成员可以用于在拖动进度条时指定播放位置；sync成员用于检查当前帧的同步状态，如果当前帧是有效帧并且正确找到了12bit同步字，该值被置1，否则置0；freerate，我不知道它的作用，从注释上看是“空闲比特率”，谁知道是什么意思？this_frame通常指向当前帧的帧头位置，next_frame则指向下一个帧的帧头位置。例外的情况是没有找到当前帧的同步字（sync=0）时会假设next_frame=this_frame+1是正确的帧同步字，以继续寻找mad_stream里的当前有效帧，这种情况不影响播放。ptr成员是当前输入流的处理位置，这个位置不一定指向帧头甚至不保证指向一个有效的mp3帧，它在解码过程中标识一个全局的位置。anc_ptr和anc_bitlen是mp3帧中附加数据的位置和长度（具体参考mp3帧的说明文章）；main_data与md_len指定mp3帧的主数据区的位置和长度；options目前只有两个取值：MAD_OPTION_IGNORECRC=0x0001表示忽略CRC校验，MAD_OPTION_HALFSAMPLERATE=0x0002表示使用实际采样率的一半进行解码。error保存解码过程中的错误信息，错误处理回调函数（见第一节）以该成员作为参数进行处理。

相比之下，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 */ };

 

其中包含一个过滤器，一个当前处理进度计数变量和输出的pcm结构数据(见第一节-API 调用顺序)。过滤器(filter)由filter回调函数初始化，用于过滤掉杂音信号。