1 /*****************************************************************************
2 * decoder.c: AAC decoder using libfaad2
3 *****************************************************************************
4 * Copyright (C) 2001, 2003 the VideoLAN team
7 * Authors: Laurent Aimar <fenrir@via.ecp.fr>
8 * Gildas Bazin <gbazin@videolan.org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
29 #include <vlc_common.h>
30 #include <vlc_plugin.h>
31 #include <vlc_input.h>
33 #include <vlc_codec.h>
38 /*****************************************************************************
40 *****************************************************************************/
41 static int Open( vlc_object_t * );
42 static void Close( vlc_object_t * );
45 set_description( N_("AAC audio decoder (using libfaad2)") )
46 set_capability( "decoder", 100 )
47 set_category( CAT_INPUT )
48 set_subcategory( SUBCAT_INPUT_ACODEC )
49 set_callbacks( Open, Close )
52 /****************************************************************************
54 ****************************************************************************/
55 static aout_buffer_t *DecodeBlock( decoder_t *, block_t ** );
56 static void DoReordering( uint32_t *, uint32_t *, int, int, uint32_t * );
58 #define MAX_CHANNEL_POSITIONS 9
68 /* temporary buffer */
73 /* Channel positions of the current stream (for re-ordering) */
74 uint32_t pi_channel_positions[MAX_CHANNEL_POSITIONS];
79 static const uint32_t pi_channels_in[MAX_CHANNEL_POSITIONS] =
80 { FRONT_CHANNEL_CENTER, FRONT_CHANNEL_LEFT, FRONT_CHANNEL_RIGHT,
81 SIDE_CHANNEL_LEFT, SIDE_CHANNEL_RIGHT,
82 BACK_CHANNEL_LEFT, BACK_CHANNEL_RIGHT,
83 BACK_CHANNEL_CENTER, LFE_CHANNEL };
84 static const uint32_t pi_channels_out[MAX_CHANNEL_POSITIONS] =
85 { AOUT_CHAN_CENTER, AOUT_CHAN_LEFT, AOUT_CHAN_RIGHT,
86 AOUT_CHAN_MIDDLELEFT, AOUT_CHAN_MIDDLERIGHT,
87 AOUT_CHAN_REARLEFT, AOUT_CHAN_REARRIGHT,
88 AOUT_CHAN_REARCENTER, AOUT_CHAN_LFE };
89 static const uint32_t pi_channels_ordered[MAX_CHANNEL_POSITIONS] =
90 { AOUT_CHAN_LEFT, AOUT_CHAN_RIGHT,
91 AOUT_CHAN_MIDDLELEFT, AOUT_CHAN_MIDDLERIGHT,
92 AOUT_CHAN_REARLEFT, AOUT_CHAN_REARRIGHT,
93 AOUT_CHAN_CENTER, AOUT_CHAN_REARCENTER, AOUT_CHAN_LFE
95 static const uint32_t pi_channels_guessed[MAX_CHANNEL_POSITIONS] =
96 { 0, AOUT_CHAN_CENTER, AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT,
97 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_LFE,
98 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_REARLEFT
99 | AOUT_CHAN_REARRIGHT,
100 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_REARLEFT
101 | AOUT_CHAN_REARRIGHT | AOUT_CHAN_CENTER,
102 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_REARLEFT
103 | AOUT_CHAN_REARRIGHT | AOUT_CHAN_CENTER | AOUT_CHAN_LFE,
104 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_MIDDLELEFT
105 | AOUT_CHAN_MIDDLERIGHT | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT
107 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_MIDDLELEFT
108 | AOUT_CHAN_MIDDLERIGHT | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT
109 | AOUT_CHAN_CENTER | AOUT_CHAN_LFE
112 /*****************************************************************************
113 * OpenDecoder: probe the decoder and return score
114 *****************************************************************************/
115 static int Open( vlc_object_t *p_this )
117 decoder_t *p_dec = (decoder_t*)p_this;
118 decoder_sys_t *p_sys = p_dec->p_sys;
119 faacDecConfiguration *cfg;
121 if( p_dec->fmt_in.i_codec != VLC_CODEC_MP4A )
126 /* Allocate the memory needed to store the decoder's structure */
127 if( ( p_dec->p_sys = p_sys = malloc( sizeof(*p_sys) ) ) == NULL )
130 /* Open a faad context */
131 if( ( p_sys->hfaad = faacDecOpen() ) == NULL )
133 msg_Err( p_dec, "cannot initialize faad" );
139 date_Set( &p_sys->date, 0 );
140 p_dec->fmt_out.i_cat = AUDIO_ES;
143 p_dec->fmt_out.i_codec = VLC_CODEC_FL32;
145 p_dec->fmt_out.i_codec = VLC_CODEC_S16N;
146 p_dec->pf_decode_audio = DecodeBlock;
148 p_dec->fmt_out.audio.i_physical_channels =
149 p_dec->fmt_out.audio.i_original_channels = 0;
151 if( p_dec->fmt_in.i_extra > 0 )
153 /* We have a decoder config so init the handle */
154 unsigned long i_rate;
155 unsigned char i_channels;
157 if( faacDecInit2( p_sys->hfaad, p_dec->fmt_in.p_extra,
158 p_dec->fmt_in.i_extra,
159 &i_rate, &i_channels ) < 0 )
161 msg_Err( p_dec, "Failed to initialize faad using extra data" );
162 faacDecClose( p_sys->hfaad );
167 p_dec->fmt_out.audio.i_rate = i_rate;
168 p_dec->fmt_out.audio.i_channels = i_channels;
169 p_dec->fmt_out.audio.i_physical_channels
170 = p_dec->fmt_out.audio.i_original_channels
171 = pi_channels_guessed[i_channels];
172 date_Init( &p_sys->date, i_rate, 1 );
176 /* Will be initalised from first frame */
177 p_dec->fmt_out.audio.i_rate = 0;
178 p_dec->fmt_out.audio.i_channels = 0;
181 /* Set the faad config */
182 cfg = faacDecGetCurrentConfiguration( p_sys->hfaad );
184 cfg->outputFormat = FAAD_FMT_FLOAT;
186 cfg->outputFormat = FAAD_FMT_16BIT;
187 faacDecSetConfiguration( p_sys->hfaad, cfg );
190 p_sys->i_buffer = p_sys->i_buffer_size = 0;
191 p_sys->p_buffer = NULL;
193 /* Faad2 can't deal with truncated data (eg. from MPEG TS) */
194 p_dec->b_need_packetized = true;
196 p_sys->b_sbr = p_sys->b_ps = false;
200 /*****************************************************************************
202 *****************************************************************************/
203 static aout_buffer_t *DecodeBlock( decoder_t *p_dec, block_t **pp_block )
205 decoder_sys_t *p_sys = p_dec->p_sys;
206 block_t *p_block = *pp_block;
208 if( !p_block ) return NULL;
210 if( p_block->i_flags&(BLOCK_FLAG_DISCONTINUITY|BLOCK_FLAG_CORRUPTED) )
212 block_Release( p_block );
216 /* Remove ADTS header if we have decoder specific config */
217 if( p_dec->fmt_in.i_extra && p_block->i_buffer > 7 )
219 if( p_block->p_buffer[0] == 0xff &&
220 ( p_block->p_buffer[1] & 0xf0 ) == 0xf0 ) /* syncword */
221 { /* ADTS header present */
222 size_t i_header_size; /* 7 bytes (+ 2 bytes for crc) */
223 i_header_size = 7 + ( ( p_block->p_buffer[1] & 0x01 ) ? 0 : 2 );
224 /* FIXME: multiple blocks per frame */
225 if( p_block->i_buffer > i_header_size )
227 p_block->p_buffer += i_header_size;
228 p_block->i_buffer -= i_header_size;
233 /* Append the block to the temporary buffer */
234 if( p_sys->i_buffer_size < p_sys->i_buffer + p_block->i_buffer )
236 size_t i_buffer_size = p_sys->i_buffer + p_block->i_buffer;
237 uint8_t *p_buffer = realloc( p_sys->p_buffer, i_buffer_size );
240 p_sys->i_buffer_size = i_buffer_size;
241 p_sys->p_buffer = p_buffer;
245 p_block->i_buffer = 0;
249 if( p_block->i_buffer > 0 )
251 vlc_memcpy( &p_sys->p_buffer[p_sys->i_buffer],
252 p_block->p_buffer, p_block->i_buffer );
253 p_sys->i_buffer += p_block->i_buffer;
254 p_block->i_buffer = 0;
257 if( p_dec->fmt_out.audio.i_rate == 0 && p_dec->fmt_in.i_extra > 0 )
259 /* We have a decoder config so init the handle */
260 unsigned long i_rate;
261 unsigned char i_channels;
263 if( faacDecInit2( p_sys->hfaad, p_dec->fmt_in.p_extra,
264 p_dec->fmt_in.i_extra,
265 &i_rate, &i_channels ) >= 0 )
267 p_dec->fmt_out.audio.i_rate = i_rate;
268 p_dec->fmt_out.audio.i_channels = i_channels;
269 p_dec->fmt_out.audio.i_physical_channels
270 = p_dec->fmt_out.audio.i_original_channels
271 = pi_channels_guessed[i_channels];
273 date_Init( &p_sys->date, i_rate, 1 );
277 if( p_dec->fmt_out.audio.i_rate == 0 && p_sys->i_buffer )
279 unsigned long i_rate;
280 unsigned char i_channels;
282 /* Init faad with the first frame */
283 if( faacDecInit( p_sys->hfaad,
284 p_sys->p_buffer, p_sys->i_buffer,
285 &i_rate, &i_channels ) < 0 )
287 block_Release( p_block );
291 p_dec->fmt_out.audio.i_rate = i_rate;
292 p_dec->fmt_out.audio.i_channels = i_channels;
293 p_dec->fmt_out.audio.i_physical_channels
294 = p_dec->fmt_out.audio.i_original_channels
295 = pi_channels_guessed[i_channels];
296 date_Init( &p_sys->date, i_rate, 1 );
299 if( p_block->i_pts > VLC_TS_INVALID && p_block->i_pts != date_Get( &p_sys->date ) )
301 date_Set( &p_sys->date, p_block->i_pts );
303 else if( !date_Get( &p_sys->date ) )
305 /* We've just started the stream, wait for the first PTS. */
306 block_Release( p_block );
311 /* Decode all data */
312 if( p_sys->i_buffer )
315 faacDecFrameInfo frame;
316 aout_buffer_t *p_out;
319 samples = faacDecDecode( p_sys->hfaad, &frame,
320 p_sys->p_buffer, p_sys->i_buffer );
322 if( frame.error > 0 )
324 msg_Warn( p_dec, "%s", faacDecGetErrorMessage( frame.error ) );
326 /* Flush the buffer */
328 block_Release( p_block );
332 if( frame.channels <= 0 || frame.channels > 8 || frame.channels == 7 )
334 msg_Warn( p_dec, "invalid channels count: %i", frame.channels );
336 /* Flush the buffer */
337 p_sys->i_buffer -= frame.bytesconsumed;
338 if( p_sys->i_buffer > 0 )
340 memmove( p_sys->p_buffer,&p_sys->p_buffer[frame.bytesconsumed],
343 block_Release( p_block );
347 if( frame.samples <= 0 )
349 msg_Warn( p_dec, "decoded zero sample" );
351 /* Flush the buffer */
352 p_sys->i_buffer -= frame.bytesconsumed;
353 if( p_sys->i_buffer > 0 )
355 memmove( p_sys->p_buffer,&p_sys->p_buffer[frame.bytesconsumed],
358 block_Release( p_block );
362 /* We decoded a valid frame */
363 if( p_dec->fmt_out.audio.i_rate != frame.samplerate )
365 date_Init( &p_sys->date, frame.samplerate, 1 );
366 date_Set( &p_sys->date, p_block->i_pts );
368 p_block->i_pts = VLC_TS_INVALID; /* PTS is valid only once */
370 p_dec->fmt_out.audio.i_rate = frame.samplerate;
371 p_dec->fmt_out.audio.i_channels = frame.channels;
372 p_dec->fmt_out.audio.i_physical_channels
373 = p_dec->fmt_out.audio.i_original_channels
374 = pi_channels_guessed[frame.channels];
376 /* Adjust stream info when dealing with SBR/PS */
377 bool b_sbr = (frame.sbr == 1) || (frame.sbr == 2);
378 if( p_sys->b_sbr != b_sbr || p_sys->b_ps != frame.ps )
380 const char *psz_ext = (b_sbr && frame.ps) ? "SBR+PS" :
381 b_sbr ? "SBR" : "PS";
383 msg_Dbg( p_dec, "AAC %s (channels: %u, samplerate: %lu)",
384 psz_ext, frame.channels, frame.samplerate );
386 if( !p_dec->p_description )
387 p_dec->p_description = vlc_meta_New();
388 if( p_dec->p_description )
389 vlc_meta_AddExtra( p_dec->p_description, _("AAC extension"), psz_ext );
391 p_sys->b_sbr = b_sbr;
392 p_sys->b_ps = frame.ps;
395 /* Convert frame.channel_position to our own channel values */
396 p_dec->fmt_out.audio.i_physical_channels = 0;
397 for( i = 0; i < frame.channels; i++ )
399 /* Find the channel code */
400 for( j = 0; j < MAX_CHANNEL_POSITIONS; j++ )
402 if( frame.channel_position[i] == pi_channels_in[j] )
405 if( j >= MAX_CHANNEL_POSITIONS )
407 msg_Warn( p_dec, "unknown channel ordering" );
408 /* Invent something */
412 p_sys->pi_channel_positions[i] = pi_channels_out[j];
413 if( p_dec->fmt_out.audio.i_physical_channels & pi_channels_out[j] )
414 frame.channels--; /* We loose a duplicated channel */
416 p_dec->fmt_out.audio.i_physical_channels |= pi_channels_out[j];
418 p_dec->fmt_out.audio.i_original_channels =
419 p_dec->fmt_out.audio.i_physical_channels;
421 p_out = decoder_NewAudioBuffer(p_dec, frame.samples/frame.channels);
425 block_Release( p_block );
429 p_out->i_pts = date_Get( &p_sys->date );
430 p_out->i_length = date_Increment( &p_sys->date,
431 frame.samples / frame.channels )
434 DoReordering( (uint32_t *)p_out->p_buffer, samples,
435 frame.samples / frame.channels, frame.channels,
436 p_sys->pi_channel_positions );
438 p_sys->i_buffer -= frame.bytesconsumed;
439 if( p_sys->i_buffer > 0 )
441 memmove( p_sys->p_buffer, &p_sys->p_buffer[frame.bytesconsumed],
448 block_Release( p_block );
452 /*****************************************************************************
454 *****************************************************************************/
455 static void Close( vlc_object_t *p_this )
457 decoder_t *p_dec = (decoder_t *)p_this;
458 decoder_sys_t *p_sys = p_dec->p_sys;
460 faacDecClose( p_sys->hfaad );
461 free( p_sys->p_buffer );
465 /*****************************************************************************
466 * DoReordering: do some channel re-ordering (the ac3 channel order is
467 * different from the aac one).
468 *****************************************************************************/
469 static void DoReordering( uint32_t *p_out, uint32_t *p_in, int i_samples,
470 int i_nb_channels, uint32_t *pi_chan_positions )
472 int pi_chan_table[MAX_CHANNEL_POSITIONS];
475 /* Find the channels mapping */
476 for( i = 0, j = 0; i < MAX_CHANNEL_POSITIONS; i++ )
478 for( k = 0; k < i_nb_channels; k++ )
480 if( pi_channels_ordered[i] == pi_chan_positions[k] )
482 pi_chan_table[k] = j++;
488 /* Do the actual reordering */
490 for( i = 0; i < i_samples; i++ )
491 for( j = 0; j < i_nb_channels; j++ )
492 p_out[i * i_nb_channels + pi_chan_table[j]] =
493 p_in[i * i_nb_channels + j];
495 for( i = 0; i < i_samples; i++ )
496 for( j = 0; j < i_nb_channels; j++ )
497 ((uint16_t *)p_out)[i * i_nb_channels + pi_chan_table[j]] =
498 ((uint16_t *)p_in)[i * i_nb_channels + j];