]> git.sesse.net Git - vlc/blob - modules/codec/vorbis.c
meta-data handling cleanup
[vlc] / modules / codec / vorbis.c
1 /*****************************************************************************
2  * vorbis.c: vorbis decoder/encoder/packetizer module using of libvorbis.
3  *****************************************************************************
4  * Copyright (C) 2001-2003 the VideoLAN team
5  * Copyright (C) 2007 Société des arts technologiques
6  * Copyright (C) 2007 Savoir-faire Linux
7  *
8  * $Id$
9  *
10  * Authors: Gildas Bazin <gbazin@videolan.org>
11  *
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.
16  *
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.
21  *
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., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
25  *****************************************************************************/
26
27 /*****************************************************************************
28  * Preamble
29  *****************************************************************************/
30 #ifdef HAVE_CONFIG_H
31 # include "config.h"
32 #endif
33
34 #include <vlc/vlc.h>
35 #include <vlc_codec.h>
36 #include <vlc_aout.h>
37 #include <vlc_input.h>
38 #include <vlc_playlist.h>
39 #include <vlc_sout.h>
40
41 #include <ogg/ogg.h>
42
43 #ifdef MODULE_NAME_IS_tremor
44 #include <tremor/ivorbiscodec.h>
45
46 #else
47 #include <vorbis/codec.h>
48
49 /* vorbis header */
50 #ifdef HAVE_VORBIS_VORBISENC_H
51 #   include <vorbis/vorbisenc.h>
52 #   ifndef OV_ECTL_RATEMANAGE_AVG
53 #       define OV_ECTL_RATEMANAGE_AVG 0x0
54 #   endif
55 #endif
56
57 #endif
58
59 /*****************************************************************************
60  * decoder_sys_t : vorbis decoder descriptor
61  *****************************************************************************/
62 struct decoder_sys_t
63 {
64     /* Module mode */
65     bool b_packetizer;
66
67     /*
68      * Input properties
69      */
70     int i_headers;
71
72     /*
73      * Vorbis properties
74      */
75     vorbis_info      vi; /* struct that stores all the static vorbis bitstream
76                             settings */
77     vorbis_comment   vc; /* struct that stores all the bitstream user
78                           * comments */
79     vorbis_dsp_state vd; /* central working state for the packet->PCM
80                           * decoder */
81     vorbis_block     vb; /* local working space for packet->PCM decode */
82
83     /*
84      * Common properties
85      */
86     audio_date_t end_date;
87     int          i_last_block_size;
88
89     int i_input_rate;
90
91     /*
92     ** Channel reordering
93     */
94     int pi_chan_table[AOUT_CHAN_MAX];
95 };
96
97 static int pi_channels_maps[9] =
98 {
99     0,
100     AOUT_CHAN_CENTER,
101     AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT,
102     AOUT_CHAN_CENTER | AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT,
103     AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_REARLEFT
104      | AOUT_CHAN_REARRIGHT,
105     AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_CENTER
106      | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT,
107     AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_CENTER
108      | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT | AOUT_CHAN_LFE,
109     AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_CENTER
110      | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT | AOUT_CHAN_MIDDLELEFT
111      | AOUT_CHAN_MIDDLERIGHT,
112     AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_CENTER | AOUT_CHAN_REARLEFT
113      | AOUT_CHAN_REARRIGHT | AOUT_CHAN_MIDDLELEFT | AOUT_CHAN_MIDDLERIGHT
114      | AOUT_CHAN_LFE
115 };
116
117 /*
118 **  channel order as defined in http://www.ogghelp.com/ogg/glossary.cfm#Audio_Channels
119 */
120
121 /* recommended vorbis channel order for 6 channels */
122 static const uint32_t pi_6channels_in[] =
123 { AOUT_CHAN_LEFT, AOUT_CHAN_CENTER, AOUT_CHAN_RIGHT,
124   AOUT_CHAN_REARLEFT, AOUT_CHAN_REARRIGHT,AOUT_CHAN_LFE,0 };
125
126 /* recommended vorbis channel order for 4 channels */
127 static const uint32_t pi_4channels_in[] =
128 { AOUT_CHAN_LEFT, AOUT_CHAN_RIGHT, AOUT_CHAN_CENTER, AOUT_CHAN_LFE, 0 };
129
130 /* recommended vorbis channel order for 3 channels */
131 static const uint32_t pi_3channels_in[] =
132 { AOUT_CHAN_LEFT, AOUT_CHAN_CENTER, AOUT_CHAN_RIGHT, 0 };
133
134 /* our internal channel order (WG-4 order) */
135 static const uint32_t pi_channels_out[] =
136 { AOUT_CHAN_LEFT, AOUT_CHAN_RIGHT, AOUT_CHAN_REARLEFT, AOUT_CHAN_REARRIGHT,
137   AOUT_CHAN_CENTER, AOUT_CHAN_LFE, 0 };
138
139 /****************************************************************************
140  * Local prototypes
141  ****************************************************************************/
142 static int  OpenDecoder   ( vlc_object_t * );
143 static int  OpenPacketizer( vlc_object_t * );
144 static void CloseDecoder  ( vlc_object_t * );
145 static void *DecodeBlock  ( decoder_t *, block_t ** );
146
147 static int  ProcessHeaders( decoder_t * );
148 static void *ProcessPacket ( decoder_t *, ogg_packet *, block_t ** );
149
150 static aout_buffer_t *DecodePacket  ( decoder_t *, ogg_packet * );
151 static block_t *SendPacket( decoder_t *, ogg_packet *, block_t * );
152
153 static void ParseVorbisComments( decoder_t * );
154
155 static void ConfigureChannelOrder(int *, int, uint32_t, bool );
156
157 #ifdef MODULE_NAME_IS_tremor
158 static void Interleave   ( int32_t *, const int32_t **, int, int, int * );
159 #else
160 static void Interleave   ( float *, const float **, int, int, int * );
161 #endif
162
163 #ifndef MODULE_NAME_IS_tremor
164 static int OpenEncoder   ( vlc_object_t * );
165 static void CloseEncoder ( vlc_object_t * );
166 static block_t *Encode   ( encoder_t *, aout_buffer_t * );
167 #endif
168
169 /*****************************************************************************
170  * Module descriptor
171  *****************************************************************************/
172 #define ENC_QUALITY_TEXT N_("Encoding quality")
173 #define ENC_QUALITY_LONGTEXT N_( \
174   "Enforce a quality between 1 (low) and 10 (high), instead " \
175   "of specifying a particular bitrate. This will produce a VBR stream." )
176 #define ENC_MAXBR_TEXT N_("Maximum encoding bitrate")
177 #define ENC_MAXBR_LONGTEXT N_( \
178   "Maximum bitrate in kbps. This is useful for streaming applications." )
179 #define ENC_MINBR_TEXT N_("Minimum encoding bitrate")
180 #define ENC_MINBR_LONGTEXT N_( \
181   "Minimum bitrate in kbps. This is useful for encoding for a fixed-size channel." )
182 #define ENC_CBR_TEXT N_("CBR encoding")
183 #define ENC_CBR_LONGTEXT N_( \
184   "Force a constant bitrate encoding (CBR)." )
185
186 vlc_module_begin();
187     set_shortname( "Vorbis" );
188     set_description( _("Vorbis audio decoder") );
189 #ifdef MODULE_NAME_IS_tremor
190     set_capability( "decoder", 90 );
191 #else
192     set_capability( "decoder", 100 );
193 #endif
194     set_category( CAT_INPUT );
195     set_subcategory( SUBCAT_INPUT_ACODEC );
196     set_callbacks( OpenDecoder, CloseDecoder );
197
198     add_submodule();
199     set_description( _("Vorbis audio packetizer") );
200     set_capability( "packetizer", 100 );
201     set_callbacks( OpenPacketizer, CloseDecoder );
202
203 #ifndef MODULE_NAME_IS_tremor
204 #   define ENC_CFG_PREFIX "sout-vorbis-"
205     add_submodule();
206     set_description( _("Vorbis audio encoder") );
207     set_capability( "encoder", 100 );
208 #if defined(HAVE_VORBIS_VORBISENC_H)
209     set_callbacks( OpenEncoder, CloseEncoder );
210 #endif
211
212     add_integer( ENC_CFG_PREFIX "quality", 0, NULL, ENC_QUALITY_TEXT,
213                  ENC_QUALITY_LONGTEXT, false );
214     add_integer( ENC_CFG_PREFIX "max-bitrate", 0, NULL, ENC_MAXBR_TEXT,
215                  ENC_MAXBR_LONGTEXT, false );
216     add_integer( ENC_CFG_PREFIX "min-bitrate", 0, NULL, ENC_MINBR_TEXT,
217                  ENC_MINBR_LONGTEXT, false );
218     add_bool( ENC_CFG_PREFIX "cbr", 0, NULL, ENC_CBR_TEXT,
219                  ENC_CBR_LONGTEXT, false );
220 #endif
221
222 vlc_module_end();
223
224 #ifndef MODULE_NAME_IS_tremor
225 static const char *ppsz_enc_options[] = {
226     "quality", "max-bitrate", "min-bitrate", "cbr", NULL
227 };
228 #endif
229
230 /*****************************************************************************
231  * OpenDecoder: probe the decoder and return score
232  *****************************************************************************/
233 static int OpenDecoder( vlc_object_t *p_this )
234 {
235     decoder_t *p_dec = (decoder_t*)p_this;
236     decoder_sys_t *p_sys;
237
238     if( p_dec->fmt_in.i_codec != VLC_FOURCC('v','o','r','b') )
239     {
240         return VLC_EGENERIC;
241     }
242
243     /* Allocate the memory needed to store the decoder's structure */
244     if( ( p_dec->p_sys = p_sys =
245           (decoder_sys_t *)malloc(sizeof(decoder_sys_t)) ) == NULL )
246     {
247         msg_Err( p_dec, "out of memory" );
248         return VLC_EGENERIC;
249     }
250
251     /* Misc init */
252     aout_DateSet( &p_sys->end_date, 0 );
253     p_sys->i_last_block_size = 0;
254     p_sys->b_packetizer = false;
255     p_sys->i_headers = 0;
256     p_sys->i_input_rate = INPUT_RATE_DEFAULT;
257
258     /* Take care of vorbis init */
259     vorbis_info_init( &p_sys->vi );
260     vorbis_comment_init( &p_sys->vc );
261
262     /* Set output properties */
263     p_dec->fmt_out.i_cat = AUDIO_ES;
264 #ifdef MODULE_NAME_IS_tremor
265     p_dec->fmt_out.i_codec = VLC_FOURCC('f','i','3','2');
266 #else
267     p_dec->fmt_out.i_codec = VLC_FOURCC('f','l','3','2');
268 #endif
269
270     /* Set callbacks */
271     p_dec->pf_decode_audio = (aout_buffer_t *(*)(decoder_t *, block_t **))
272         DecodeBlock;
273     p_dec->pf_packetize    = (block_t *(*)(decoder_t *, block_t **))
274         DecodeBlock;
275
276     return VLC_SUCCESS;
277 }
278
279 static int OpenPacketizer( vlc_object_t *p_this )
280 {
281     decoder_t *p_dec = (decoder_t*)p_this;
282
283     int i_ret = OpenDecoder( p_this );
284
285     if( i_ret == VLC_SUCCESS )
286     {
287         p_dec->p_sys->b_packetizer = true;
288         p_dec->fmt_out.i_codec = VLC_FOURCC('v','o','r','b');
289     }
290
291     return i_ret;
292 }
293
294 /****************************************************************************
295  * DecodeBlock: the whole thing
296  ****************************************************************************
297  * This function must be fed with ogg packets.
298  ****************************************************************************/
299 static void *DecodeBlock( decoder_t *p_dec, block_t **pp_block )
300 {
301     decoder_sys_t *p_sys = p_dec->p_sys;
302     ogg_packet oggpacket;
303
304     if( !pp_block ) return NULL;
305
306     if( *pp_block )
307     {
308         /* Block to Ogg packet */
309         oggpacket.packet = (*pp_block)->p_buffer;
310         oggpacket.bytes = (*pp_block)->i_buffer;
311
312         if( (*pp_block)->i_rate > 0 )
313             p_sys->i_input_rate = (*pp_block)->i_rate;
314     }
315     else
316     {
317         if( p_sys->b_packetizer ) return NULL;
318
319         /* Block to Ogg packet */
320         oggpacket.packet = NULL;
321         oggpacket.bytes = 0;
322     }
323
324     oggpacket.granulepos = -1;
325     oggpacket.b_o_s = 0;
326     oggpacket.e_o_s = 0;
327     oggpacket.packetno = 0;
328
329     /* Check for headers */
330     if( p_sys->i_headers == 0 && p_dec->fmt_in.i_extra )
331     {
332         /* Headers already available as extra data */
333         msg_Dbg( p_dec, "headers already available as extra data" );
334         p_sys->i_headers = 3;
335     }
336     else if( oggpacket.bytes && p_sys->i_headers < 3 )
337     {
338         /* Backup headers as extra data */
339         uint8_t *p_extra;
340
341         p_dec->fmt_in.p_extra =
342             realloc( p_dec->fmt_in.p_extra, p_dec->fmt_in.i_extra +
343                      oggpacket.bytes + 2 );
344         p_extra = (uint8_t *)p_dec->fmt_in.p_extra + p_dec->fmt_in.i_extra;
345         *(p_extra++) = oggpacket.bytes >> 8;
346         *(p_extra++) = oggpacket.bytes & 0xFF;
347
348         memcpy( p_extra, oggpacket.packet, oggpacket.bytes );
349         p_dec->fmt_in.i_extra += oggpacket.bytes + 2;
350
351         block_Release( *pp_block );
352         p_sys->i_headers++;
353         return NULL;
354     }
355
356     if( p_sys->i_headers == 3 )
357     {
358         if( ProcessHeaders( p_dec ) != VLC_SUCCESS )
359         {
360             p_sys->i_headers = 0;
361             p_dec->fmt_in.i_extra = 0;
362             block_Release( *pp_block );
363             return NULL;
364         }
365         else p_sys->i_headers++;
366     }
367
368     return ProcessPacket( p_dec, &oggpacket, pp_block );
369 }
370
371 /*****************************************************************************
372  * ProcessHeaders: process Vorbis headers.
373  *****************************************************************************/
374 static int ProcessHeaders( decoder_t *p_dec )
375 {
376     decoder_sys_t *p_sys = p_dec->p_sys;
377     ogg_packet oggpacket;
378     uint8_t *p_extra;
379     int i_extra;
380
381     if( !p_dec->fmt_in.i_extra ) return VLC_EGENERIC;
382
383     oggpacket.granulepos = -1;
384     oggpacket.b_o_s = 1; /* yes this actually is a b_o_s packet :) */
385     oggpacket.e_o_s = 0;
386     oggpacket.packetno = 0;
387     p_extra = p_dec->fmt_in.p_extra;
388     i_extra = p_dec->fmt_in.i_extra;
389
390     /* Take care of the initial Vorbis header */
391     oggpacket.bytes = *(p_extra++) << 8;
392     oggpacket.bytes |= (*(p_extra++) & 0xFF);
393     oggpacket.packet = p_extra;
394     p_extra += oggpacket.bytes;
395     i_extra -= (oggpacket.bytes + 2);
396     if( i_extra < 0 )
397     {
398         msg_Err( p_dec, "header data corrupted");
399         return VLC_EGENERIC;
400     }
401
402     if( vorbis_synthesis_headerin( &p_sys->vi, &p_sys->vc, &oggpacket ) < 0 )
403     {
404         msg_Err( p_dec, "this bitstream does not contain Vorbis audio data");
405         return VLC_EGENERIC;
406     }
407
408     /* Setup the format */
409     p_dec->fmt_out.audio.i_rate     = p_sys->vi.rate;
410     p_dec->fmt_out.audio.i_channels = p_sys->vi.channels;
411
412     if( p_dec->fmt_out.audio.i_channels > 9 )
413     {
414         msg_Err( p_dec, "invalid number of channels (not between 1 and 9): %i",
415                  p_dec->fmt_out.audio.i_channels );
416         return VLC_EGENERIC;
417     }
418
419     p_dec->fmt_out.audio.i_physical_channels =
420         p_dec->fmt_out.audio.i_original_channels =
421             pi_channels_maps[p_sys->vi.channels];
422     p_dec->fmt_out.i_bitrate = p_sys->vi.bitrate_nominal;
423
424     aout_DateInit( &p_sys->end_date, p_sys->vi.rate );
425
426     msg_Dbg( p_dec, "channels:%d samplerate:%ld bitrate:%ld",
427              p_sys->vi.channels, p_sys->vi.rate, p_sys->vi.bitrate_nominal );
428
429     /* The next packet in order is the comments header */
430     oggpacket.b_o_s = 0;
431     oggpacket.bytes = *(p_extra++) << 8;
432     oggpacket.bytes |= (*(p_extra++) & 0xFF);
433     oggpacket.packet = p_extra;
434     p_extra += oggpacket.bytes;
435     i_extra -= (oggpacket.bytes + 2);
436     if( i_extra < 0 )
437     {
438         msg_Err( p_dec, "header data corrupted");
439         return VLC_EGENERIC;
440     }
441
442     if( vorbis_synthesis_headerin( &p_sys->vi, &p_sys->vc, &oggpacket ) < 0 )
443     {
444         msg_Err( p_dec, "2nd Vorbis header is corrupted" );
445         return VLC_EGENERIC;
446     }
447     ParseVorbisComments( p_dec );
448
449     /* The next packet in order is the codebooks header
450      * We need to watch out that this packet is not missing as a
451      * missing or corrupted header is fatal. */
452     oggpacket.bytes = *(p_extra++) << 8;
453     oggpacket.bytes |= (*(p_extra++) & 0xFF);
454     oggpacket.packet = p_extra;
455     i_extra -= (oggpacket.bytes + 2);
456     if( i_extra < 0 )
457     {
458         msg_Err( p_dec, "header data corrupted");
459         return VLC_EGENERIC;
460     }
461
462     if( vorbis_synthesis_headerin( &p_sys->vi, &p_sys->vc, &oggpacket ) < 0 )
463     {
464         msg_Err( p_dec, "3rd Vorbis header is corrupted" );
465         return VLC_EGENERIC;
466     }
467
468     if( !p_sys->b_packetizer )
469     {
470         /* Initialize the Vorbis packet->PCM decoder */
471         vorbis_synthesis_init( &p_sys->vd, &p_sys->vi );
472         vorbis_block_init( &p_sys->vd, &p_sys->vb );
473     }
474     else
475     {
476         p_dec->fmt_out.i_extra = p_dec->fmt_in.i_extra;
477         p_dec->fmt_out.p_extra =
478             realloc( p_dec->fmt_out.p_extra, p_dec->fmt_out.i_extra );
479         memcpy( p_dec->fmt_out.p_extra,
480                 p_dec->fmt_in.p_extra, p_dec->fmt_out.i_extra );
481     }
482
483     ConfigureChannelOrder(p_sys->pi_chan_table, p_sys->vi.channels,
484             p_dec->fmt_out.audio.i_physical_channels, true);
485
486     return VLC_SUCCESS;
487 }
488
489 /*****************************************************************************
490  * ProcessPacket: processes a Vorbis packet.
491  *****************************************************************************/
492 static void *ProcessPacket( decoder_t *p_dec, ogg_packet *p_oggpacket,
493                             block_t **pp_block )
494 {
495     decoder_sys_t *p_sys = p_dec->p_sys;
496     block_t *p_block = *pp_block;
497
498     /* Date management */
499     if( p_block && p_block->i_pts > 0 &&
500         p_block->i_pts != aout_DateGet( &p_sys->end_date ) )
501     {
502         aout_DateSet( &p_sys->end_date, p_block->i_pts );
503     }
504
505     if( !aout_DateGet( &p_sys->end_date ) )
506     {
507         /* We've just started the stream, wait for the first PTS. */
508         if( p_block ) block_Release( p_block );
509         return NULL;
510     }
511
512     *pp_block = NULL; /* To avoid being fed the same packet again */
513
514     if( p_sys->b_packetizer )
515     {
516         return SendPacket( p_dec, p_oggpacket, p_block );
517     }
518     else
519     {
520         aout_buffer_t *p_aout_buffer;
521
522         if( p_sys->i_headers >= 3 )
523             p_aout_buffer = DecodePacket( p_dec, p_oggpacket );
524         else
525             p_aout_buffer = NULL;
526
527         if( p_block ) block_Release( p_block );
528         return p_aout_buffer;
529     }
530 }
531
532 /*****************************************************************************
533  * DecodePacket: decodes a Vorbis packet.
534  *****************************************************************************/
535 static aout_buffer_t *DecodePacket( decoder_t *p_dec, ogg_packet *p_oggpacket )
536 {
537     decoder_sys_t *p_sys = p_dec->p_sys;
538     int           i_samples;
539
540 #ifdef MODULE_NAME_IS_tremor
541     int32_t       **pp_pcm;
542 #else
543     float         **pp_pcm;
544 #endif
545
546     if( p_oggpacket->bytes &&
547 #ifdef MODULE_NAME_IS_tremor
548         vorbis_synthesis( &p_sys->vb, p_oggpacket, 1 ) == 0 )
549 #else
550         vorbis_synthesis( &p_sys->vb, p_oggpacket ) == 0 )
551 #endif
552         vorbis_synthesis_blockin( &p_sys->vd, &p_sys->vb );
553
554     /* **pp_pcm is a multichannel float vector. In stereo, for
555      * example, pp_pcm[0] is left, and pp_pcm[1] is right. i_samples is
556      * the size of each channel. Convert the float values
557      * (-1.<=range<=1.) to whatever PCM format and write it out */
558
559     if( ( i_samples = vorbis_synthesis_pcmout( &p_sys->vd, &pp_pcm ) ) > 0 )
560     {
561
562         aout_buffer_t *p_aout_buffer;
563
564         p_aout_buffer =
565             p_dec->pf_aout_buffer_new( p_dec, i_samples );
566
567         if( p_aout_buffer == NULL ) return NULL;
568
569         /* Interleave the samples */
570 #ifdef MODULE_NAME_IS_tremor
571         Interleave( (int32_t *)p_aout_buffer->p_buffer,
572                     (const int32_t **)pp_pcm, p_sys->vi.channels, i_samples, p_sys->pi_chan_table);
573 #else
574         Interleave( (float *)p_aout_buffer->p_buffer,
575                     (const float **)pp_pcm, p_sys->vi.channels, i_samples, p_sys->pi_chan_table);
576 #endif
577
578         /* Tell libvorbis how many samples we actually consumed */
579         vorbis_synthesis_read( &p_sys->vd, i_samples );
580
581         /* Date management */
582         p_aout_buffer->start_date = aout_DateGet( &p_sys->end_date );
583         p_aout_buffer->end_date = aout_DateIncrement( &p_sys->end_date,
584                                                       i_samples * p_sys->i_input_rate / INPUT_RATE_DEFAULT );
585         return p_aout_buffer;
586     }
587     else
588     {
589         return NULL;
590     }
591 }
592
593 /*****************************************************************************
594  * SendPacket: send an ogg dated packet to the stream output.
595  *****************************************************************************/
596 static block_t *SendPacket( decoder_t *p_dec, ogg_packet *p_oggpacket,
597                             block_t *p_block )
598 {
599     decoder_sys_t *p_sys = p_dec->p_sys;
600     int i_block_size, i_samples;
601
602     i_block_size = vorbis_packet_blocksize( &p_sys->vi, p_oggpacket );
603     if( i_block_size < 0 ) i_block_size = 0; /* non audio packet */
604     i_samples = ( p_sys->i_last_block_size + i_block_size ) >> 2;
605     p_sys->i_last_block_size = i_block_size;
606
607     /* Date management */
608     p_block->i_dts = p_block->i_pts = aout_DateGet( &p_sys->end_date );
609
610     if( p_sys->i_headers >= 3 )
611         p_block->i_length = aout_DateIncrement( &p_sys->end_date,
612             i_samples * p_sys->i_input_rate / INPUT_RATE_DEFAULT ) -
613                 p_block->i_pts;
614     else
615         p_block->i_length = 0;
616
617     return p_block;
618 }
619
620 /*****************************************************************************
621  * ParseVorbisComments
622  *****************************************************************************/
623 static void ParseVorbisComments( decoder_t *p_dec )
624 {
625     input_thread_t *p_input = (input_thread_t *)p_dec->p_parent;
626     char *psz_name, *psz_value, *psz_comment;
627     input_item_t *p_item;
628     int i = 0;
629
630     if( p_input->i_object_type != VLC_OBJECT_INPUT ) return;
631
632     p_item = input_GetItem( p_input );
633
634     while( i < p_dec->p_sys->vc.comments )
635     {
636         psz_comment = strdup( p_dec->p_sys->vc.user_comments[i] );
637         if( !psz_comment )
638         {
639             msg_Warn( p_dec, "out of memory" );
640             break;
641         }
642         psz_name = psz_comment;
643         psz_value = strchr( psz_comment, '=' );
644         if( psz_value )
645         {
646             *psz_value = '\0';
647             psz_value++;
648             input_Control( p_input, INPUT_ADD_INFO, _("Vorbis comment"),
649                            psz_name, "%s", psz_value );
650 #ifndef HAVE_TAGLIB
651             if( !strcasecmp( psz_name, "artist" ) )
652             {
653                 if( psz_value && ( *psz_value != '\0' ) )
654                 {
655                     input_item_SetArtist( p_item, psz_value );
656                 }
657             }
658             else if( !strcasecmp( psz_name, "title" ) )
659             {
660                 if( psz_value && ( *psz_value != '\0' ) )
661                 {
662                     input_item_SetTitle( p_item, psz_value );
663                     p_item->psz_name = strdup( psz_value );
664                 }
665             }
666             else if( !strcasecmp( psz_name, "album" ) )
667             {
668                 if( psz_value && ( *psz_value != '\0' ) )
669                 {
670                     input_item_SetAlbum( p_item, psz_value );
671                 }
672             }
673             else if( !strcasecmp( psz_name, "musicbrainz_trackid" ) )
674             {
675                 if( psz_value && ( *psz_value != '\0' ) )
676                 {
677                     input_item_SetTrackID( p_item, psz_value );
678                 }
679             }
680 #if 0 //not used
681             else if( !strcasecmp( psz_name, "musicbrainz_artistid" ) )
682             {
683                 if( psz_value && ( *psz_value != '\0' ) )
684                 {
685                     vlc_meta_SetArtistID( p_item, psz_value );
686                 }
687             }
688             else if( !strcasecmp( psz_name, "musicbrainz_albumid" ) )
689             {
690                 if( psz_value && ( *psz_value != '\0' ) )
691                 {
692                     input_item_SetAlbumID( p_item, psz_value );
693                 }
694             }
695 #endif
696 #endif
697             if( !strcasecmp( psz_name, "REPLAYGAIN_TRACK_GAIN" ) ||
698                      !strcasecmp( psz_name, "RG_RADIO" ) )
699             {
700                 audio_replay_gain_t *r = &p_dec->fmt_out.audio_replay_gain;
701
702                 r->pb_gain[AUDIO_REPLAY_GAIN_TRACK] = true;
703                 r->pf_gain[AUDIO_REPLAY_GAIN_TRACK] = atof( psz_value );
704             }
705             else if( !strcasecmp( psz_name, "REPLAYGAIN_TRACK_PEAK" ) ||
706                      !strcasecmp( psz_name, "RG_PEAK" ) )
707             {
708                 audio_replay_gain_t *r = &p_dec->fmt_out.audio_replay_gain;
709
710                 r->pb_peak[AUDIO_REPLAY_GAIN_TRACK] = true;
711                 r->pf_peak[AUDIO_REPLAY_GAIN_TRACK] = atof( psz_value );
712             }
713             else if( !strcasecmp( psz_name, "REPLAYGAIN_ALBUM_GAIN" ) ||
714                      !strcasecmp( psz_name, "RG_AUDIOPHILE" ) )
715             {
716                 audio_replay_gain_t *r = &p_dec->fmt_out.audio_replay_gain;
717
718                 r->pb_gain[AUDIO_REPLAY_GAIN_ALBUM] = true;
719                 r->pf_gain[AUDIO_REPLAY_GAIN_ALBUM] = atof( psz_value );
720             }
721             else if( !strcasecmp( psz_name, "REPLAYGAIN_ALBUM_PEAK" ) )
722             {
723                 audio_replay_gain_t *r = &p_dec->fmt_out.audio_replay_gain;
724
725                 r->pb_peak[AUDIO_REPLAY_GAIN_ALBUM] = true;
726                 r->pf_peak[AUDIO_REPLAY_GAIN_ALBUM] = atof( psz_value );
727             }
728         }
729         var_SetInteger( pl_Get( p_input ), "item-change", p_item->i_id );
730         free( psz_comment );
731         i++;
732     }
733 }
734
735 /*****************************************************************************
736  * Interleave: helper function to interleave channels
737  *****************************************************************************/
738 static void ConfigureChannelOrder(int *pi_chan_table, int i_channels, uint32_t i_channel_mask, bool b_decode)
739 {
740     const uint32_t *pi_channels_in;
741     switch( i_channels )
742     {
743         case 6:
744         case 5:
745             pi_channels_in = pi_6channels_in;
746             break;
747         case 4:
748             pi_channels_in = pi_4channels_in;
749             break;
750         case 3:
751             pi_channels_in = pi_3channels_in;
752             break;
753         default:
754             {
755                 int i;
756                 for( i = 0; i< i_channels; ++i )
757                 {
758                     pi_chan_table[i] = i;
759                 }
760                 return;
761             }
762     }
763
764     if( b_decode )
765         aout_CheckChannelReorder( pi_channels_in, pi_channels_out,
766                                   i_channel_mask & AOUT_CHAN_PHYSMASK,
767                                   i_channels,
768                                   pi_chan_table );
769     else
770         aout_CheckChannelReorder( pi_channels_out, pi_channels_in,
771                                   i_channel_mask & AOUT_CHAN_PHYSMASK,
772                                   i_channels,
773                                   pi_chan_table );
774 }
775
776 /*****************************************************************************
777  * Interleave: helper function to interleave channels
778  *****************************************************************************/
779 #ifdef MODULE_NAME_IS_tremor
780 static void Interleave( int32_t *p_out, const int32_t **pp_in,
781                         int i_nb_channels, int i_samples, int *pi_chan_table)
782 {
783     int i, j;
784
785     for ( j = 0; j < i_samples; j++ )
786         for ( i = 0; i < i_nb_channels; i++ )
787             p_out[j * i_nb_channels + pi_chan_table[i]] = pp_in[i][j] * (FIXED32_ONE >> 24);
788 }
789 #else
790 static void Interleave( float *p_out, const float **pp_in,
791                         int i_nb_channels, int i_samples, int *pi_chan_table )
792 {
793     int i, j;
794
795     for ( j = 0; j < i_samples; j++ )
796         for ( i = 0; i < i_nb_channels; i++ )
797             p_out[j * i_nb_channels + pi_chan_table[i]] = pp_in[i][j];
798 }
799 #endif
800
801 /*****************************************************************************
802  * CloseDecoder: vorbis decoder destruction
803  *****************************************************************************/
804 static void CloseDecoder( vlc_object_t *p_this )
805 {
806     decoder_t *p_dec = (decoder_t *)p_this;
807     decoder_sys_t *p_sys = p_dec->p_sys;
808
809     if( !p_sys->b_packetizer && p_sys->i_headers > 3 )
810     {
811         vorbis_block_clear( &p_sys->vb );
812         vorbis_dsp_clear( &p_sys->vd );
813     }
814
815     vorbis_comment_clear( &p_sys->vc );
816     vorbis_info_clear( &p_sys->vi );  /* must be called last */
817
818     free( p_sys );
819 }
820
821 #if defined(HAVE_VORBIS_VORBISENC_H) && !defined(MODULE_NAME_IS_tremor)
822
823 /*****************************************************************************
824  * encoder_sys_t : vorbis encoder descriptor
825  *****************************************************************************/
826 struct encoder_sys_t
827 {
828     /*
829      * Vorbis properties
830      */
831     vorbis_info      vi; /* struct that stores all the static vorbis bitstream
832                             settings */
833     vorbis_comment   vc; /* struct that stores all the bitstream user
834                           * comments */
835     vorbis_dsp_state vd; /* central working state for the packet->PCM
836                           * decoder */
837     vorbis_block     vb; /* local working space for packet->PCM decode */
838
839     int i_last_block_size;
840     int i_samples_delay;
841     int i_channels;
842
843     /*
844      * Common properties
845      */
846     mtime_t i_pts;
847
848     /*
849     ** Channel reordering
850     */
851     int pi_chan_table[AOUT_CHAN_MAX];
852
853 };
854
855 /*****************************************************************************
856  * OpenEncoder: probe the encoder and return score
857  *****************************************************************************/
858 static int OpenEncoder( vlc_object_t *p_this )
859 {
860     encoder_t *p_enc = (encoder_t *)p_this;
861     encoder_sys_t *p_sys;
862     int i_quality, i_min_bitrate, i_max_bitrate, i;
863     ogg_packet header[3];
864     vlc_value_t val;
865     uint8_t *p_extra;
866
867     if( p_enc->fmt_out.i_codec != VLC_FOURCC('v','o','r','b') &&
868         !p_enc->b_force )
869     {
870         return VLC_EGENERIC;
871     }
872
873     /* Allocate the memory needed to store the decoder's structure */
874     if( ( p_sys = (encoder_sys_t *)malloc(sizeof(encoder_sys_t)) ) == NULL )
875     {
876         msg_Err( p_enc, "out of memory" );
877         return VLC_EGENERIC;
878     }
879     p_enc->p_sys = p_sys;
880
881     p_enc->pf_encode_audio = Encode;
882     p_enc->fmt_in.i_codec = VLC_FOURCC('f','l','3','2');
883     p_enc->fmt_out.i_codec = VLC_FOURCC('v','o','r','b');
884
885     config_ChainParse( p_enc, ENC_CFG_PREFIX, ppsz_enc_options, p_enc->p_cfg );
886
887     var_Get( p_enc, ENC_CFG_PREFIX "quality", &val );
888     i_quality = val.i_int;
889     if( i_quality > 10 ) i_quality = 10;
890     if( i_quality < 0 ) i_quality = 0;
891     var_Get( p_enc, ENC_CFG_PREFIX "cbr", &val );
892     if( val.b_bool ) i_quality = 0;
893     var_Get( p_enc, ENC_CFG_PREFIX "max-bitrate", &val );
894     i_max_bitrate = val.i_int;
895     var_Get( p_enc, ENC_CFG_PREFIX "min-bitrate", &val );
896     i_min_bitrate = val.i_int;
897
898     /* Initialize vorbis encoder */
899     vorbis_info_init( &p_sys->vi );
900
901     if( i_quality > 0 )
902     {
903         /* VBR mode */
904         if( vorbis_encode_setup_vbr( &p_sys->vi,
905               p_enc->fmt_in.audio.i_channels, p_enc->fmt_in.audio.i_rate,
906               i_quality * 0.1 ) )
907         {
908             vorbis_info_clear( &p_sys->vi );
909             free( p_enc->p_sys );
910             msg_Err( p_enc, "VBR mode initialisation failed" );
911             return VLC_EGENERIC;
912         }
913
914         /* Do we have optional hard quality restrictions? */
915         if( i_max_bitrate > 0 || i_min_bitrate > 0 )
916         {
917             struct ovectl_ratemanage_arg ai;
918             vorbis_encode_ctl( &p_sys->vi, OV_ECTL_RATEMANAGE_GET, &ai );
919
920             ai.bitrate_hard_min = i_min_bitrate;
921             ai.bitrate_hard_max = i_max_bitrate;
922             ai.management_active = 1;
923
924             vorbis_encode_ctl( &p_sys->vi, OV_ECTL_RATEMANAGE_SET, &ai );
925
926         }
927         else
928         {
929             /* Turn off management entirely */
930             vorbis_encode_ctl( &p_sys->vi, OV_ECTL_RATEMANAGE_SET, NULL );
931         }
932     }
933     else
934     {
935         if( vorbis_encode_setup_managed( &p_sys->vi,
936               p_enc->fmt_in.audio.i_channels, p_enc->fmt_in.audio.i_rate,
937               i_min_bitrate > 0 ? i_min_bitrate * 1000: -1,
938               p_enc->fmt_out.i_bitrate,
939               i_max_bitrate > 0 ? i_max_bitrate * 1000: -1 ) )
940           {
941               vorbis_info_clear( &p_sys->vi );
942               msg_Err( p_enc, "CBR mode initialisation failed" );
943               free( p_enc->p_sys );
944               return VLC_EGENERIC;
945           }
946     }
947
948     vorbis_encode_setup_init( &p_sys->vi );
949
950     /* Add a comment */
951     vorbis_comment_init( &p_sys->vc);
952     vorbis_comment_add_tag( &p_sys->vc, "ENCODER", "VLC media player");
953
954     /* Set up the analysis state and auxiliary encoding storage */
955     vorbis_analysis_init( &p_sys->vd, &p_sys->vi );
956     vorbis_block_init( &p_sys->vd, &p_sys->vb );
957
958     /* Create and store headers */
959     vorbis_analysis_headerout( &p_sys->vd, &p_sys->vc,
960                                &header[0], &header[1], &header[2]);
961     p_enc->fmt_out.i_extra = 3 * 2 + header[0].bytes +
962        header[1].bytes + header[2].bytes;
963     p_extra = p_enc->fmt_out.p_extra = malloc( p_enc->fmt_out.i_extra );
964     for( i = 0; i < 3; i++ )
965     {
966         *(p_extra++) = header[i].bytes >> 8;
967         *(p_extra++) = header[i].bytes & 0xFF;
968         memcpy( p_extra, header[i].packet, header[i].bytes );
969         p_extra += header[i].bytes;
970     }
971
972     p_sys->i_channels = p_enc->fmt_in.audio.i_channels;
973     p_sys->i_last_block_size = 0;
974     p_sys->i_samples_delay = 0;
975     p_sys->i_pts = 0;
976
977     ConfigureChannelOrder(p_sys->pi_chan_table, p_sys->vi.channels,
978             p_enc->fmt_in.audio.i_physical_channels, true);
979
980     return VLC_SUCCESS;
981 }
982
983 /****************************************************************************
984  * Encode: the whole thing
985  ****************************************************************************
986  * This function spits out ogg packets.
987  ****************************************************************************/
988 static block_t *Encode( encoder_t *p_enc, aout_buffer_t *p_aout_buf )
989 {
990     encoder_sys_t *p_sys = p_enc->p_sys;
991     ogg_packet oggpacket;
992     block_t *p_block, *p_chain = NULL;
993     float **buffer;
994     int i;
995     unsigned int j;
996
997     p_sys->i_pts = p_aout_buf->start_date -
998                 (mtime_t)1000000 * (mtime_t)p_sys->i_samples_delay /
999                 (mtime_t)p_enc->fmt_in.audio.i_rate;
1000
1001     p_sys->i_samples_delay += p_aout_buf->i_nb_samples;
1002
1003     buffer = vorbis_analysis_buffer( &p_sys->vd, p_aout_buf->i_nb_samples );
1004
1005     /* convert samples to float and uninterleave */
1006     for( i = 0; i < p_sys->i_channels; i++ )
1007     {
1008         for( j = 0 ; j < p_aout_buf->i_nb_samples ; j++ )
1009         {
1010             buffer[i][j]= ((float *)p_aout_buf->p_buffer)
1011                                     [j * p_sys->i_channels + p_sys->pi_chan_table[i]];
1012         }
1013     }
1014
1015     vorbis_analysis_wrote( &p_sys->vd, p_aout_buf->i_nb_samples );
1016
1017     while( vorbis_analysis_blockout( &p_sys->vd, &p_sys->vb ) == 1 )
1018     {
1019         int i_samples;
1020
1021         vorbis_analysis( &p_sys->vb, NULL );
1022         vorbis_bitrate_addblock( &p_sys->vb );
1023
1024         while( vorbis_bitrate_flushpacket( &p_sys->vd, &oggpacket ) )
1025         {
1026             int i_block_size;
1027             p_block = block_New( p_enc, oggpacket.bytes );
1028             memcpy( p_block->p_buffer, oggpacket.packet, oggpacket.bytes );
1029
1030             i_block_size = vorbis_packet_blocksize( &p_sys->vi, &oggpacket );
1031
1032             if( i_block_size < 0 ) i_block_size = 0;
1033             i_samples = ( p_sys->i_last_block_size + i_block_size ) >> 2;
1034             p_sys->i_last_block_size = i_block_size;
1035
1036             p_block->i_length = (mtime_t)1000000 *
1037                 (mtime_t)i_samples / (mtime_t)p_enc->fmt_in.audio.i_rate;
1038
1039             p_block->i_dts = p_block->i_pts = p_sys->i_pts;
1040
1041             p_sys->i_samples_delay -= i_samples;
1042
1043             /* Update pts */
1044             p_sys->i_pts += p_block->i_length;
1045             block_ChainAppend( &p_chain, p_block );
1046         }
1047     }
1048
1049     return p_chain;
1050 }
1051
1052 /*****************************************************************************
1053  * CloseEncoder: vorbis encoder destruction
1054  *****************************************************************************/
1055 static void CloseEncoder( vlc_object_t *p_this )
1056 {
1057     encoder_t *p_enc = (encoder_t *)p_this;
1058     encoder_sys_t *p_sys = p_enc->p_sys;
1059
1060     vorbis_block_clear( &p_sys->vb );
1061     vorbis_dsp_clear( &p_sys->vd );
1062     vorbis_comment_clear( &p_sys->vc );
1063     vorbis_info_clear( &p_sys->vi );  /* must be called last */
1064
1065     free( p_sys );
1066 }
1067
1068 #endif /* HAVE_VORBIS_VORBISENC_H && !MODULE_NAME_IS_tremor */