3.2 “頭部”回調函數header()

之所以要加上引號的原因是這個函數從名字上看是用於處理MP3幀頭的，實際情況是真正的幀頭解碼是在mad_header_decode函數中進行的，mad_header_decode函數負責填充struct mad_header結構：

//file:libmad-1.05b/frame.c;line:364~375 /* begin processing */ stream->this_frame = ptr; stream->next_frame = ptr + 1; /* possibly bogus sync word */ mad_bit_init(&stream->ptr, stream->this_frame); if (decode_header(header, stream) == -1) goto fail; /* calculate frame duration */ mad_timer_set(&header->duration,0,32 * MAD_NSBSAMPLES(header), header->samplerate);

decode_header函數內部是大堆的if…else，將MP3頭部的數據位表示的含義填充進header結構，而mad_timer_set函數精確地計算幀的播放持續時間（duration），這點對統計MP3文件的總播放時間很有幫助，因爲不論MP3文件是恆定編碼率（CBR）還是可變編碼率（VBR），如果逐幀計算duration的話會精確得多。

在前面的關鍵數據結構的章節裏我們介紹過libmad幀頭結構struct mad_header，下面再回過頭來看看以該結構作爲參數的回調函數header(void* , struct mad_header const *)可以做什麼：

//file: libmad-1.05b/frame.h;line:49~65 struct mad_header { enum mad_layer layer; /* audio layer (1, 2, or 3) */ enum mad_mode mode; /* channel mode (see above) */ int mode_extension; /* additional mode info */ enum mad_emphasis emphasis; /* de-emphasis to use (see above) */ unsigned long bitrate; /* stream bitrate (bps) */ unsigned int samplerate; /* sampling frequency (Hz) */ unsigned short crc_check; /* frame CRC accumulator */ unsigned short crc_target; /* final target CRC checksum */ int flags; /* flags (see below) */ int private_bits; /* private bits (see below) */ mad_timer_t duration; /* audio playing time of frame */ };

 

重寫該函數並初始化到decoder結構後，我們可能做的事情有：

1、  獲得音頻壓縮標準的層信息（layerI、II、III）

2、  獲得音頻文件的聲道信息（單聲道、立體聲等）

3、  獲得頻文件的播放碼率（bps）

4、  獲得音頻文件的波特率（Hz，典型的是44.1KHz）

5、  獲得該幀的CRC校驗計算值（如果啓用了CRC的話）

6、  獲得該幀的CRC校驗目標值（如果有的話）

7、  最重要的是，獲得該幀的播放時常！

以上的數據可以獲得但不能修改，原因很簡單，指針以const形式進行傳遞，還記得const * 與*const、const * const的區別嗎？

header()回調函數如果存在（這個函數不是必須的，可以被初始化成0或NULL）那麼它是緊隨着input()回調函數之後被調用的，如果header()回調函數不存在，說明用戶對header信息不感興趣，那麼連mad_header_decode()函數都不會被調用：

//file:libmad-1.05b/decoder.c;line:346~402 mad_stream_options(stream, decoder->options); do { switch (decoder->input_func(decoder->cb_data, stream)) { case MAD_FLOW_STOP: goto done; case MAD_FLOW_BREAK: goto fail; case MAD_FLOW_IGNORE: continue; case MAD_FLOW_CONTINUE: break; } 。。。 。。。 if (decoder->header_func) { if (mad_header_decode(&frame->header, stream) == -1) { if (!MAD_RECOVERABLE(stream->error)) break; switch (error_func(error_data, stream, frame)) { case MAD_FLOW_STOP: goto done; case MAD_FLOW_BREAK: goto fail; case MAD_FLOW_IGNORE: case MAD_FLOW_CONTINUE: default: continue; } } switch (decoder->header_func(decoder->cb_data, &frame->header)) { case MAD_FLOW_STOP: goto done; case MAD_FLOW_BREAK: goto fail; case MAD_FLOW_IGNORE: continue; case MAD_FLOW_CONTINUE: break; } }