1 /*****************************************************************************
2 * mpeg_audio.c: parse MPEG audio sync info and packetize the stream
3 *****************************************************************************
4 * Copyright (C) 2001-2003 VideoLAN
5 * $Id: mpeg_audio.c,v 1.20 2003/10/23 20:51:20 gbazin Exp $
7 * Authors: Laurent Aimar <fenrir@via.ecp.fr>
8 * Eric Petit <titer@videolan.org>
9 * Christophe Massiot <massiot@via.ecp.fr>
10 * Gildas Bazin <gbazin@netcourrier.com>
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
25 *****************************************************************************/
27 /*****************************************************************************
29 *****************************************************************************/
30 #include <stdlib.h> /* malloc(), free() */
31 #include <string.h> /* strdup() */
34 #include <vlc/decoder.h>
35 #include <vlc/input.h>
39 #include "vlc_block_helper.h"
41 /*****************************************************************************
42 * decoder_sys_t : decoder descriptor
43 *****************************************************************************/
47 vlc_bool_t b_packetizer;
55 block_bytestream_t bytestream;
58 * Decoder output properties
60 aout_instance_t * p_aout; /* opaque */
61 aout_input_t * p_aout_input; /* opaque */
62 audio_sample_format_t aout_format;
63 aout_buffer_t * p_aout_buffer; /* current aout buffer being filled */
66 * Packetizer output properties
68 sout_packetizer_input_t *p_sout_input;
69 sout_format_t sout_format;
70 sout_buffer_t * p_sout_buffer; /* current sout buffer */
75 uint8_t *p_out_buffer; /* output buffer */
76 audio_date_t end_date;
77 unsigned int i_current_layer;
81 int i_frame_size, i_free_frame_size;
82 unsigned int i_channels_conf, i_channels;
83 unsigned int i_rate, i_max_frame_size, i_frame_length;
84 unsigned int i_layer, i_bit_rate;
96 /* This isn't the place to put mad-specific stuff. However, it makes the
97 * mad plug-in's life much easier if we put 8 extra bytes at the end of the
98 * buffer, because that way it doesn't have to copy the aout_buffer_t to a
99 * bigger buffer. This has no implication on other plug-ins, and we only
100 * lose 8 bytes per frame. --Meuuh */
101 #define MAD_BUFFER_GUARD 8
102 #define MPGA_HEADER_SIZE 4
104 /****************************************************************************
106 ****************************************************************************/
107 static int OpenDecoder ( vlc_object_t * );
108 static int OpenPacketizer( vlc_object_t * );
110 static int InitDecoder ( decoder_t * );
111 static int RunDecoder ( decoder_t *, block_t * );
112 static int EndDecoder ( decoder_t * );
114 static int GetOutBuffer ( decoder_t *, uint8_t ** );
115 static int GetAoutBuffer( decoder_t *, aout_buffer_t ** );
116 static int GetSoutBuffer( decoder_t *, sout_buffer_t ** );
117 static int SendOutBuffer( decoder_t * );
119 static int SyncInfo( uint32_t i_header, unsigned int * pi_channels,
120 unsigned int * pi_channels_conf,
121 unsigned int * pi_sample_rate, unsigned int * pi_bit_rate,
122 unsigned int * pi_frame_length,
123 unsigned int * pi_max_frame_size,
124 unsigned int * pi_layer );
126 /*****************************************************************************
128 *****************************************************************************/
130 set_description( _("MPEG audio layer I/II/III parser") );
131 set_capability( "decoder", 100 );
132 set_callbacks( OpenDecoder, NULL );
135 set_description( _("MPEG audio layer I/II/III packetizer") );
136 set_capability( "packetizer", 10 );
137 set_callbacks( OpenPacketizer, NULL );
140 /*****************************************************************************
141 * OpenDecoder: probe the decoder and return score
142 *****************************************************************************/
143 static int OpenDecoder( vlc_object_t *p_this )
145 decoder_t *p_dec = (decoder_t*)p_this;
147 if( p_dec->p_fifo->i_fourcc != VLC_FOURCC( 'm', 'p', 'g', 'a') )
152 p_dec->pf_init = InitDecoder;
153 p_dec->pf_decode = RunDecoder;
154 p_dec->pf_end = EndDecoder;
156 /* Allocate the memory needed to store the decoder's structure */
158 (decoder_sys_t *)malloc(sizeof(decoder_sys_t)) ) == NULL )
160 msg_Err( p_dec, "out of memory" );
163 p_dec->p_sys->b_packetizer = VLC_FALSE;
168 static int OpenPacketizer( vlc_object_t *p_this )
170 decoder_t *p_dec = (decoder_t*)p_this;
172 int i_ret = OpenDecoder( p_this );
174 if( i_ret == VLC_SUCCESS ) p_dec->p_sys->b_packetizer = VLC_TRUE;
179 /*****************************************************************************
180 * InitDecoder: Initalize the decoder
181 *****************************************************************************/
182 static int InitDecoder( decoder_t *p_dec )
184 p_dec->p_sys->i_state = STATE_NOSYNC;
186 p_dec->p_sys->p_out_buffer = NULL;
187 aout_DateSet( &p_dec->p_sys->end_date, 0 );
189 p_dec->p_sys->p_aout = NULL;
190 p_dec->p_sys->p_aout_input = NULL;
191 p_dec->p_sys->p_aout_buffer = NULL;
192 p_dec->p_sys->aout_format.i_format = VLC_FOURCC('m','p','g','a');
194 p_dec->p_sys->p_sout_input = NULL;
195 p_dec->p_sys->p_sout_buffer = NULL;
196 p_dec->p_sys->sout_format.i_cat = AUDIO_ES;
197 p_dec->p_sys->sout_format.i_fourcc = VLC_FOURCC('m','p','g','a');
199 /* Start with the minimum size for a free bitrate frame */
200 p_dec->p_sys->i_free_frame_size = MPGA_HEADER_SIZE;
202 p_dec->p_sys->p_chain = NULL;
207 /****************************************************************************
208 * RunDecoder: the whole thing
209 ****************************************************************************
210 * This function is called just after the thread is launched.
211 ****************************************************************************/
212 static int RunDecoder( decoder_t *p_dec, block_t *p_block )
214 decoder_sys_t *p_sys = p_dec->p_sys;
215 uint8_t p_header[MAD_BUFFER_GUARD];
218 if( !aout_DateGet( &p_sys->end_date ) && !p_block->i_pts )
220 /* We've just started the stream, wait for the first PTS. */
221 block_Release( p_block );
225 if( p_block->b_discontinuity )
227 p_sys->i_state = STATE_SYNC;
232 block_ChainAppend( &p_sys->p_chain, p_block );
236 block_ChainAppend( &p_sys->p_chain, p_block );
237 p_sys->bytestream = block_BytestreamInit( p_dec, p_sys->p_chain, 0 );
242 switch( p_sys->i_state )
246 while( block_PeekBytes( &p_sys->bytestream, p_header, 2 )
249 /* Look for sync word - should be 0xffe */
250 if( p_header[0] == 0xff && (p_header[1] & 0xe0) == 0xe0 )
252 p_sys->i_state = STATE_SYNC;
255 block_SkipByte( &p_sys->bytestream );
257 if( p_sys->i_state != STATE_SYNC )
259 if( block_PeekByte( &p_sys->bytestream, p_header )
260 == VLC_SUCCESS && p_header[0] == 0xff )
262 /* Start of a sync word, need more data */
266 block_ChainRelease( p_sys->p_chain );
267 p_sys->p_chain = NULL;
274 /* New frame, set the Presentation Time Stamp */
275 p_sys->pts = p_sys->bytestream.p_block->i_pts;
276 if( p_sys->pts != 0 &&
277 p_sys->pts != aout_DateGet( &p_sys->end_date ) )
279 msg_Err( p_dec, "set PTS: %lli old: %lli", p_sys->pts,
280 aout_DateGet( &p_sys->end_date ) );
281 aout_DateSet( &p_sys->end_date, p_sys->pts );
283 p_sys->i_state = STATE_HEADER;
287 /* Get MPGA frame header (MPGA_HEADER_SIZE bytes) */
288 if( block_PeekBytes( &p_sys->bytestream, p_header,
289 MPGA_HEADER_SIZE ) != VLC_SUCCESS )
295 /* Build frame header */
296 i_header = (p_header[0]<<24)|(p_header[1]<<16)|(p_header[2]<<8)
299 /* Check if frame is valid and get frame info */
300 p_sys->i_frame_size = SyncInfo( i_header,
302 &p_sys->i_channels_conf,
305 &p_sys->i_frame_length,
306 &p_sys->i_max_frame_size,
309 if( p_sys->i_frame_size == -1 )
311 msg_Dbg( p_dec, "emulated start code" );
312 block_SkipByte( &p_sys->bytestream );
313 p_sys->i_state = STATE_NOSYNC;
317 if( p_sys->i_bit_rate == 0 )
319 /* Free birate, but 99% emulated startcode :( */
320 if( p_dec->p_sys->i_free_frame_size == MPGA_HEADER_SIZE )
322 msg_Dbg( p_dec, "free bitrate mode");
324 p_sys->i_frame_size = p_sys->i_free_frame_size;
327 p_sys->i_state = STATE_NEXT_SYNC;
329 case STATE_NEXT_SYNC:
330 /* TODO: If p_block == NULL, flush the buffer without checking the
333 /* Check if next expected frame contains the sync word */
334 if( block_PeekOffsetBytes( &p_sys->bytestream,
335 p_sys->i_frame_size, p_header,
336 MAD_BUFFER_GUARD ) != VLC_SUCCESS )
342 if( p_header[0] == 0xff && (p_header[1] & 0xe0) == 0xe0 )
344 /* Startcode is fine, let's try the header as an extra check */
345 int i_next_frame_size;
346 unsigned int i_next_channels, i_next_channels_conf;
347 unsigned int i_next_rate, i_next_bit_rate;
348 unsigned int i_next_frame_length, i_next_max_frame_size;
349 unsigned int i_next_layer;
351 /* Build frame header */
352 i_header = (p_header[0]<<24)|(p_header[1]<<16)|(p_header[2]<<8)
355 i_next_frame_size = SyncInfo( i_header,
357 &i_next_channels_conf,
360 &i_next_frame_length,
361 &i_next_max_frame_size,
364 if( i_next_frame_size == -1 )
366 msg_Dbg( p_dec, "emulated start code on next frame" );
367 block_SkipByte( &p_sys->bytestream );
368 p_sys->i_state = STATE_NOSYNC;
372 /* Free bitrate only */
373 if( p_sys->i_bit_rate == 0 )
375 if( i_next_bit_rate != 0 )
377 p_sys->i_frame_size++;
381 if( (unsigned int)p_sys->i_frame_size >
382 p_sys->i_max_frame_size )
384 msg_Dbg( p_dec, "frame too big %d > %d "
385 "(emulated startcode ?)", p_sys->i_frame_size,
386 p_sys->i_max_frame_size );
387 block_SkipByte( &p_sys->bytestream );
388 p_sys->i_state = STATE_NOSYNC;
389 p_sys->i_free_frame_size = MPGA_HEADER_SIZE;
394 /* Check info is in sync with previous one */
395 if( i_next_channels_conf != p_sys->i_channels_conf ||
396 i_next_rate != p_sys->i_rate ||
397 i_next_layer != p_sys->i_layer ||
398 i_next_frame_length != p_sys->i_frame_length )
400 /* Free bitrate only */
401 if( p_sys->i_bit_rate == 0 )
403 p_sys->i_frame_size++;
407 msg_Dbg( p_dec, "parameters changed unexpectedly "
408 "(emulated startcode ?)" );
409 block_SkipByte( &p_sys->bytestream );
410 p_sys->i_state = STATE_NOSYNC;
416 /* Free bitrate only */
417 if( p_sys->i_bit_rate == 0 )
419 p_sys->i_frame_size++;
423 msg_Dbg( p_dec, "emulated startcode "
424 "(no startcode on following frame)" );
425 p_sys->i_state = STATE_NOSYNC;
426 block_SkipByte( &p_sys->bytestream );
430 if( GetOutBuffer( p_dec, &p_sys->p_out_buffer ) != VLC_SUCCESS )
435 /* Free bitrate only */
436 if( p_sys->i_bit_rate == 0 )
438 p_sys->i_free_frame_size = p_sys->i_frame_size;
441 p_sys->i_state = STATE_DATA;
444 /* Copy the whole frame into the buffer */
445 if( block_GetBytes( &p_sys->bytestream, p_sys->p_out_buffer,
446 p_sys->i_frame_size ) != VLC_SUCCESS )
452 p_sys->p_chain = block_BytestreamFlush( &p_sys->bytestream );
454 /* Get beginning of next frame for libmad */
455 if( !p_sys->b_packetizer )
457 memcpy( p_sys->p_out_buffer + p_sys->i_frame_size,
458 p_header, MAD_BUFFER_GUARD );
461 SendOutBuffer( p_dec );
462 p_sys->i_state = STATE_NOSYNC;
464 /* Make sure we don't reuse the same pts twice */
465 if( p_sys->pts == p_sys->bytestream.p_block->i_pts )
466 p_sys->pts = p_sys->bytestream.p_block->i_pts = 0;
473 /*****************************************************************************
475 *****************************************************************************/
476 static int GetOutBuffer( decoder_t *p_dec, uint8_t **pp_out_buffer )
478 decoder_sys_t *p_sys = p_dec->p_sys;
481 if( p_sys->b_packetizer )
483 i_ret = GetSoutBuffer( p_dec, &p_sys->p_sout_buffer );
485 p_sys->p_sout_buffer ? p_sys->p_sout_buffer->p_buffer : NULL;
489 i_ret = GetAoutBuffer( p_dec, &p_sys->p_aout_buffer );
491 p_sys->p_aout_buffer ? p_sys->p_aout_buffer->p_buffer : NULL;
497 /*****************************************************************************
499 *****************************************************************************/
500 static int GetAoutBuffer( decoder_t *p_dec, aout_buffer_t **pp_buffer )
502 decoder_sys_t *p_sys = p_dec->p_sys;
504 if( p_sys->p_aout_input != NULL &&
505 ( p_sys->aout_format.i_rate != p_sys->i_rate
506 || p_sys->aout_format.i_original_channels != p_sys->i_channels_conf
507 || p_sys->aout_format.i_bytes_per_frame !=
508 p_sys->i_max_frame_size + MAD_BUFFER_GUARD
509 || p_sys->aout_format.i_frame_length != p_sys->i_frame_length
510 || p_sys->i_current_layer != p_sys->i_layer ) )
512 /* Parameters changed - this should not happen. */
513 aout_DecDelete( p_sys->p_aout, p_sys->p_aout_input );
514 p_sys->p_aout_input = NULL;
517 /* Creating the audio input if not created yet. */
518 if( p_sys->p_aout_input == NULL )
520 p_sys->i_current_layer = p_sys->i_layer;
521 if( p_sys->i_layer == 3 )
523 p_sys->aout_format.i_format = VLC_FOURCC('m','p','g','3');
527 p_sys->aout_format.i_format = VLC_FOURCC('m','p','g','a');
530 p_sys->aout_format.i_rate = p_sys->i_rate;
531 p_sys->aout_format.i_original_channels = p_sys->i_channels_conf;
532 p_sys->aout_format.i_physical_channels
533 = p_sys->i_channels_conf & AOUT_CHAN_PHYSMASK;
534 p_sys->aout_format.i_bytes_per_frame = p_sys->i_max_frame_size
536 p_sys->aout_format.i_frame_length = p_sys->i_frame_length;
537 aout_DateInit( &p_sys->end_date, p_sys->i_rate );
538 aout_DateSet( &p_sys->end_date, p_sys->pts );
539 p_sys->p_aout_input = aout_DecNew( p_dec,
541 &p_sys->aout_format );
542 if( p_sys->p_aout_input == NULL )
549 *pp_buffer = aout_DecNewBuffer( p_sys->p_aout, p_sys->p_aout_input,
550 p_sys->i_frame_length );
551 if( *pp_buffer == NULL )
556 (*pp_buffer)->start_date = aout_DateGet( &p_sys->end_date );
557 (*pp_buffer)->end_date =
558 aout_DateIncrement( &p_sys->end_date, p_sys->i_frame_length );
563 /*****************************************************************************
565 *****************************************************************************/
566 static int GetSoutBuffer( decoder_t *p_dec, sout_buffer_t **pp_buffer )
568 decoder_sys_t *p_sys = p_dec->p_sys;
570 if( p_sys->p_sout_input != NULL &&
571 ( p_sys->sout_format.i_sample_rate != (int)p_sys->i_rate
572 || p_sys->sout_format.i_channels != (int)p_sys->i_channels ) )
574 /* Parameters changed - this should not happen. */
577 /* Creating the sout input if not created yet. */
578 if( p_sys->p_sout_input == NULL )
580 p_sys->sout_format.i_sample_rate = p_sys->i_rate;
581 p_sys->sout_format.i_channels = p_sys->i_channels;
582 p_sys->sout_format.i_block_align = 0;
583 p_sys->sout_format.i_bitrate = p_sys->i_bit_rate;
584 p_sys->sout_format.i_extra_data = 0;
585 p_sys->sout_format.p_extra_data = NULL;
587 aout_DateInit( &p_sys->end_date, p_sys->i_rate );
588 aout_DateSet( &p_sys->end_date, p_sys->pts );
590 p_sys->p_sout_input = sout_InputNew( p_dec, &p_sys->sout_format );
591 if( p_sys->p_sout_input == NULL )
593 msg_Err( p_dec, "cannot add a new stream" );
597 msg_Info( p_dec, "MPGA channels:%d samplerate:%d bitrate:%d",
598 p_sys->i_channels, p_sys->i_rate, p_sys->i_bit_rate );
601 *pp_buffer = sout_BufferNew( p_sys->p_sout_input->p_sout,
602 p_sys->i_frame_size );
603 if( *pp_buffer == NULL )
608 (*pp_buffer)->i_pts =
609 (*pp_buffer)->i_dts = aout_DateGet( &p_sys->end_date );
611 (*pp_buffer)->i_length =
612 aout_DateIncrement( &p_sys->end_date, p_sys->i_frame_length )
613 - (*pp_buffer)->i_pts;
618 /*****************************************************************************
620 *****************************************************************************/
621 static int SendOutBuffer( decoder_t *p_dec )
623 decoder_sys_t *p_sys = p_dec->p_sys;
625 if( p_sys->b_packetizer )
627 sout_InputSendBuffer( p_sys->p_sout_input, p_sys->p_sout_buffer );
628 p_sys->p_sout_buffer = NULL;
632 /* We have all we need, send the buffer to the aout core. */
633 p_sys->p_aout_buffer->i_nb_bytes =
634 p_sys->i_frame_size + MAD_BUFFER_GUARD;
635 aout_DecPlay( p_sys->p_aout, p_sys->p_aout_input,
636 p_sys->p_aout_buffer );
637 p_sys->p_aout_buffer = NULL;
640 p_sys->p_out_buffer = NULL;
645 /*****************************************************************************
646 * EndDecoder: clean up the decoder
647 *****************************************************************************/
648 static int EndDecoder( decoder_t *p_dec )
650 if( p_dec->p_sys->p_aout_input != NULL )
652 if( p_dec->p_sys->p_aout_buffer )
654 aout_DecDeleteBuffer( p_dec->p_sys->p_aout,
655 p_dec->p_sys->p_aout_input,
656 p_dec->p_sys->p_aout_buffer );
659 aout_DecDelete( p_dec->p_sys->p_aout, p_dec->p_sys->p_aout_input );
662 if( p_dec->p_sys->p_sout_input != NULL )
664 if( p_dec->p_sys->p_sout_buffer )
666 sout_BufferDelete( p_dec->p_sys->p_sout_input->p_sout,
667 p_dec->p_sys->p_sout_buffer );
670 sout_InputDelete( p_dec->p_sys->p_sout_input );
673 if( p_dec->p_sys->p_chain ) block_ChainRelease( p_dec->p_sys->p_chain );
675 free( p_dec->p_sys );
680 /*****************************************************************************
681 * SyncInfo: parse MPEG audio sync info
682 *****************************************************************************/
683 static int SyncInfo( uint32_t i_header, unsigned int * pi_channels,
684 unsigned int * pi_channels_conf,
685 unsigned int * pi_sample_rate, unsigned int * pi_bit_rate,
686 unsigned int * pi_frame_length,
687 unsigned int * pi_max_frame_size, unsigned int * pi_layer)
689 static const int ppi_bitrate[2][3][16] =
693 { 0, 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384,
696 { 0, 32, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256,
699 { 0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224,
705 { 0, 32, 48, 56, 64, 80, 96, 112, 128, 144, 160, 176, 192,
708 { 0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128,
711 { 0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128,
716 static const int ppi_samplerate[2][4] = /* version 1 then 2 */
718 { 44100, 48000, 32000, 0 },
719 { 22050, 24000, 16000, 0 }
722 int i_version, i_mode, i_emphasis;
723 vlc_bool_t b_padding, b_mpeg_2_5, b_crc;
724 int i_frame_size = 0;
725 int i_bitrate_index, i_samplerate_index;
728 b_mpeg_2_5 = 1 - ((i_header & 0x100000) >> 20);
729 i_version = 1 - ((i_header & 0x80000) >> 19);
730 *pi_layer = 4 - ((i_header & 0x60000) >> 17);
731 b_crc = !((i_header >> 16) & 0x01);
732 i_bitrate_index = (i_header & 0xf000) >> 12;
733 i_samplerate_index = (i_header & 0xc00) >> 10;
734 b_padding = (i_header & 0x200) >> 9;
736 i_mode = (i_header & 0xc0) >> 6;
737 /* Modeext, copyright & original */
738 i_emphasis = i_header & 0x3;
740 if( *pi_layer != 4 &&
741 i_bitrate_index < 0x0f &&
742 i_samplerate_index != 0x03 &&
748 case 1: /* joint stereo */
750 *pi_channels_conf = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT;
752 case 2: /* dual-mono */
754 *pi_channels_conf = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT
755 | AOUT_CHAN_DUALMONO;
759 *pi_channels_conf = AOUT_CHAN_CENTER;
762 *pi_bit_rate = ppi_bitrate[i_version][*pi_layer-1][i_bitrate_index];
763 i_max_bit_rate = ppi_bitrate[i_version][*pi_layer-1][14];
764 *pi_sample_rate = ppi_samplerate[i_version][i_samplerate_index];
768 *pi_sample_rate >>= 1;
774 i_frame_size = ( 12000 * *pi_bit_rate / *pi_sample_rate +
776 *pi_max_frame_size = ( 12000 * i_max_bit_rate /
777 *pi_sample_rate + 1 ) * 4;
778 *pi_frame_length = 384;
782 i_frame_size = 144000 * *pi_bit_rate / *pi_sample_rate + b_padding;
783 *pi_max_frame_size = 144000 * i_max_bit_rate / *pi_sample_rate + 1;
784 *pi_frame_length = 1152;
788 i_frame_size = ( i_version ? 72000 : 144000 ) *
789 *pi_bit_rate / *pi_sample_rate + b_padding;
790 *pi_max_frame_size = ( i_version ? 72000 : 144000 ) *
791 i_max_bit_rate / *pi_sample_rate + 1;
792 *pi_frame_length = i_version ? 576 : 1152;