1 /*****************************************************************************
2 * vorbis.c: vorbis decoder module making use of libvorbis.
3 *****************************************************************************
4 * Copyright (C) 1999-2001 VideoLAN
5 * $Id: vorbis.c,v 1.9 2002/12/19 23:23:25 sigmunau Exp $
7 * Authors: Gildas Bazin <gbazin@netcourrier.com>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
22 *****************************************************************************/
24 /*****************************************************************************
26 *****************************************************************************/
27 #include <stdlib.h> /* malloc(), free() */
28 #include <string.h> /* memcpy(), memset() */
32 #include <vlc/decoder.h>
33 #include <input_ext-dec.h>
35 #include <vlc/input.h>
38 #ifdef MODULE_NAME_IS_tremor
39 #include <tremor/ivorbiscodec.h>
41 #include <vorbis/codec.h>
44 /*****************************************************************************
45 * dec_thread_t : vorbis decoder thread descriptor
46 *****************************************************************************/
47 typedef struct dec_thread_t
52 vlc_thread_t thread_id; /* id for thread functions */
57 vorbis_info vi; /* struct that stores all the static vorbis bitstream
59 vorbis_comment vc; /* struct that stores all the bitstream user
61 vorbis_dsp_state vd; /* central working state for the packet->PCM
63 vorbis_block vb; /* local working space for packet->PCM decode */
68 decoder_fifo_t *p_fifo; /* stores the PES stream data */
69 pes_packet_t *p_pes; /* current PES we are decoding */
74 aout_instance_t *p_aout;
75 aout_input_t *p_aout_input;
76 audio_sample_format_t output_format;
77 audio_date_t end_date;
81 static int pi_channels_maps[6] =
84 AOUT_CHAN_CENTER, AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT,
85 AOUT_CHAN_CENTER | AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT,
86 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_REARLEFT
87 | AOUT_CHAN_REARRIGHT,
88 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_CENTER
89 | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT
92 /*****************************************************************************
94 *****************************************************************************/
95 static int OpenDecoder ( vlc_object_t * );
96 static int RunDecoder ( decoder_fifo_t * );
97 static void CloseDecoder ( dec_thread_t * );
99 static void DecodePacket ( dec_thread_t * );
100 static int GetOggPacket ( dec_thread_t *, ogg_packet *, mtime_t * );
102 #ifdef MODULE_NAME_IS_tremor
103 static void Interleave ( int32_t *, const int32_t **, int, int );
105 static void Interleave ( float *, const float **, int, int );
108 /*****************************************************************************
110 *****************************************************************************/
112 set_description( _("Vorbis decoder module") );
113 #ifdef MODULE_NAME_IS_tremor
114 set_capability( "decoder", 90 );
116 set_capability( "decoder", 100 );
118 set_callbacks( OpenDecoder, NULL );
121 /*****************************************************************************
122 * OpenDecoder: probe the decoder and return score
123 *****************************************************************************/
124 static int OpenDecoder( vlc_object_t *p_this )
126 decoder_fifo_t *p_fifo = (decoder_fifo_t*) p_this;
128 if( p_fifo->i_fourcc != VLC_FOURCC('v','o','r','b') )
133 p_fifo->pf_run = RunDecoder;
137 /*****************************************************************************
138 * RunDecoder: the vorbis decoder
139 *****************************************************************************/
140 static int RunDecoder( decoder_fifo_t * p_fifo )
143 ogg_packet oggpacket;
146 /* Allocate the memory needed to store the thread's structure */
147 if( (p_dec = (dec_thread_t *)malloc (sizeof(dec_thread_t)) )
150 msg_Err( p_fifo, "out of memory" );
154 /* Initialize the thread properties */
155 memset( p_dec, 0, sizeof(dec_thread_t) );
156 p_dec->p_fifo = p_fifo;
159 /* Take care of the initial Vorbis header */
160 vorbis_info_init( &p_dec->vi );
161 vorbis_comment_init( &p_dec->vc );
163 if( GetOggPacket( p_dec, &oggpacket, &i_pts ) != VLC_SUCCESS )
166 oggpacket.b_o_s = 1; /* yes this actually is a b_o_s packet :) */
167 if( vorbis_synthesis_headerin( &p_dec->vi, &p_dec->vc, &oggpacket ) < 0 )
169 msg_Err( p_dec->p_fifo, "This bitstream does not contain Vorbis "
174 /* The next two packets in order are the comment and codebook headers.
175 We need to watch out that these packets are not missing as a
176 missing or corrupted header is fatal. */
177 if( GetOggPacket( p_dec, &oggpacket, &i_pts ) != VLC_SUCCESS )
180 if( vorbis_synthesis_headerin( &p_dec->vi, &p_dec->vc, &oggpacket ) < 0 )
182 msg_Err( p_dec->p_fifo, "2nd Vorbis header is corrupted" );
185 /* parse the vorbis comment */
187 input_thread_t *p_input = p_fifo->p_parent;
188 input_info_category_t *p_cat = input_InfoCategory( p_input,
191 char *psz_name, *psz_value, *psz_comment;
192 while ( i < p_dec->vc.comments )
194 psz_comment = strdup( p_dec->vc.user_comments[i] );
195 psz_name = psz_comment;
196 psz_value = strchr( psz_comment, '=' );
199 input_AddInfo( p_cat, psz_name, psz_value );
205 if( GetOggPacket( p_dec, &oggpacket, &i_pts ) != VLC_SUCCESS )
208 if( vorbis_synthesis_headerin( &p_dec->vi, &p_dec->vc, &oggpacket ) < 0 )
210 msg_Err( p_dec->p_fifo, "3rd Vorbis header is corrupted" );
214 /* Initialize the Vorbis packet->PCM decoder */
215 vorbis_synthesis_init( &p_dec->vd, &p_dec->vi );
216 vorbis_block_init( &p_dec->vd, &p_dec->vb );
218 #ifdef MODULE_NAME_IS_tremor
219 p_dec->output_format.i_format = VLC_FOURCC('f','i','3','2');
221 p_dec->output_format.i_format = VLC_FOURCC('f','l','3','2');
223 p_dec->output_format.i_physical_channels =
224 p_dec->output_format.i_original_channels =
225 pi_channels_maps[p_dec->vi.channels];
226 p_dec->output_format.i_rate = p_dec->vi.rate;
228 aout_DateInit( &p_dec->end_date, p_dec->vi.rate );
229 p_dec->p_aout = NULL;
230 p_dec->p_aout_input = aout_DecNew( p_dec->p_fifo,
232 &p_dec->output_format );
234 if( p_dec->p_aout_input == NULL )
236 msg_Err( p_dec->p_fifo, "failed to create aout fifo" );
240 /* vorbis decoder thread's main loop */
241 while( (!p_dec->p_fifo->b_die) && (!p_dec->p_fifo->b_error) )
243 DecodePacket( p_dec );
246 /* If b_error is set, the vorbis decoder thread enters the error loop */
247 if( p_dec->p_fifo->b_error )
249 DecoderError( p_dec->p_fifo );
252 /* End of the vorbis decoder thread */
253 CloseDecoder( p_dec );
258 DecoderError( p_fifo );
262 p_dec->p_fifo->b_error = 1;
264 /* End of the vorbis decoder thread */
265 CloseDecoder( p_dec );
272 /*****************************************************************************
273 * DecodePacket: decodes a Vorbis packet.
274 *****************************************************************************/
275 static void DecodePacket( dec_thread_t *p_dec )
277 aout_buffer_t *p_aout_buffer;
278 ogg_packet oggpacket;
279 #ifdef MODULE_NAME_IS_tremor
287 if( GetOggPacket( p_dec, &oggpacket, &i_pts ) != VLC_SUCCESS )
289 /* This should mean an eos */
293 /* Date management */
294 if( i_pts > 0 && i_pts != aout_DateGet( &p_dec->end_date ) )
296 aout_DateSet( &p_dec->end_date, i_pts );
299 if( vorbis_synthesis( &p_dec->vb, &oggpacket ) == 0 )
300 vorbis_synthesis_blockin( &p_dec->vd, &p_dec->vb );
302 /* **pp_pcm is a multichannel float vector. In stereo, for
303 * example, pp_pcm[0] is left, and pp_pcm[1] is right. i_samples is
304 * the size of each channel. Convert the float values
305 * (-1.<=range<=1.) to whatever PCM format and write it out */
307 while( ( i_samples = vorbis_synthesis_pcmout( &p_dec->vd, &pp_pcm ) ) > 0 )
310 p_aout_buffer = aout_DecNewBuffer( p_dec->p_aout, p_dec->p_aout_input,
314 msg_Err( p_dec->p_fifo, "cannot get aout buffer" );
315 p_dec->p_fifo->b_error = 1;
319 /* Interleave the samples */
320 #ifdef MODULE_NAME_IS_tremor
321 Interleave( (int32_t *)p_aout_buffer->p_buffer,
322 (const int32_t **)pp_pcm, p_dec->vi.channels, i_samples );
324 Interleave( (float *)p_aout_buffer->p_buffer,
325 (const float **)pp_pcm, p_dec->vi.channels, i_samples );
328 /* Tell libvorbis how many samples we actually consumed */
329 vorbis_synthesis_read( &p_dec->vd, i_samples );
331 /* Date management */
332 p_aout_buffer->start_date = aout_DateGet( &p_dec->end_date );
333 p_aout_buffer->end_date = aout_DateIncrement( &p_dec->end_date,
336 aout_DecPlay( p_dec->p_aout, p_dec->p_aout_input, p_aout_buffer );
341 /*****************************************************************************
342 * GetOggPacket: get the following vorbis packet from the stream and send back
343 * the result in an ogg packet (for easy decoding by libvorbis).
344 *****************************************************************************
345 * Returns VLC_EGENERIC in case of eof.
346 *****************************************************************************/
347 static int GetOggPacket( dec_thread_t *p_dec, ogg_packet *p_oggpacket,
350 if( p_dec->p_pes ) input_DeletePES( p_dec->p_fifo->p_packets_mgt,
353 input_ExtractPES( p_dec->p_fifo, &p_dec->p_pes );
354 if( !p_dec->p_pes ) return VLC_EGENERIC;
356 p_oggpacket->packet = p_dec->p_pes->p_first->p_payload_start;
357 p_oggpacket->bytes = p_dec->p_pes->i_pes_size;
358 p_oggpacket->granulepos = p_dec->p_pes->i_dts;
359 p_oggpacket->b_o_s = 0;
360 p_oggpacket->e_o_s = 0;
361 p_oggpacket->packetno = 0;
363 *p_pts = p_dec->p_pes->i_pts;
368 /*****************************************************************************
369 * Interleave: helper function to interleave channels
370 *****************************************************************************/
371 #ifdef MODULE_NAME_IS_tremor
372 static void Interleave( int32_t *p_out, const int32_t **pp_in,
374 static void Interleave( float *p_out, const float **pp_in,
376 int i_nb_channels, int i_samples )
380 for ( j = 0; j < i_samples; j++ )
382 for ( i = 0; i < i_nb_channels; i++ )
384 p_out[j * i_nb_channels + i] = pp_in[i][j];
389 /*****************************************************************************
390 * CloseDecoder: vorbis decoder destruction
391 *****************************************************************************/
392 static void CloseDecoder( dec_thread_t * p_dec )
394 if( p_dec->p_aout_input != NULL )
396 aout_DecDelete( p_dec->p_aout, p_dec->p_aout_input );
402 input_DeletePES( p_dec->p_fifo->p_packets_mgt, p_dec->p_pes );
403 vorbis_block_clear( &p_dec->vb );
404 vorbis_dsp_clear( &p_dec->vd );
405 vorbis_comment_clear( &p_dec->vc );
406 vorbis_info_clear( &p_dec->vi ); /* must be called last */