1 /*****************************************************************************
2 * flac.c : FLAC demux module for vlc
3 *****************************************************************************
4 * Copyright (C) 2001-2008 VLC authors and VideoLAN
7 * Authors: Gildas Bazin <gbazin@netcourrier.com>
8 * Laurent Aimar <fenrir@via.ecp.fr>
10 * This program is free software; you can redistribute it and/or modify it
11 * under the terms of the GNU Lesser General Public License as published by
12 * the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details.
20 * You should have received a copy of the GNU Lesser General Public License
21 * along with this program; if not, write to the Free Software Foundation,
22 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
25 /*****************************************************************************
27 *****************************************************************************/
32 #include <vlc_common.h>
33 #include <vlc_plugin.h>
34 #include <vlc_demux.h>
35 #include <vlc_meta.h> /* vlc_meta_* */
36 #include <vlc_input.h> /* vlc_input_attachment, vlc_seekpoint */
37 #include <vlc_codec.h> /* decoder_t */
38 #include <vlc_charset.h> /* EnsureUTF8 */
41 #include "xiph_metadata.h" /* vorbis comments */
43 /*****************************************************************************
45 *****************************************************************************/
46 static int Open ( vlc_object_t * );
47 static void Close ( vlc_object_t * );
50 set_description( N_("FLAC demuxer") )
51 set_capability( "demux", 155 )
52 set_category( CAT_INPUT )
53 set_subcategory( SUBCAT_INPUT_DEMUX )
54 set_callbacks( Open, Close )
55 add_shortcut( "flac" )
58 /*****************************************************************************
60 *****************************************************************************/
61 static int Demux ( demux_t * );
62 static int Control( demux_t *, int, va_list );
64 static int ReadMeta( demux_t *, uint8_t **pp_streaminfo, int *pi_streaminfo );
72 decoder_t *p_packetizer;
76 int64_t i_time_offset;
80 int64_t i_length; /* Length from stream info */
85 seekpoint_t **seekpoint;
89 input_attachment_t **attachments;
94 #define STREAMINFO_SIZE 34
95 #define FLAC_PACKET_SIZE 16384
97 /*****************************************************************************
98 * Open: initializes ES structures
99 *****************************************************************************/
100 static int Open( vlc_object_t * p_this )
102 demux_t *p_demux = (demux_t*)p_this;
104 const uint8_t *p_peek;
105 uint8_t *p_streaminfo;
109 /* Have a peep at the show. */
110 if( stream_Peek( p_demux->s, &p_peek, 4 ) < 4 ) return VLC_EGENERIC;
112 if( p_peek[0]!='f' || p_peek[1]!='L' || p_peek[2]!='a' || p_peek[3]!='C' )
114 if( !p_demux->b_force ) return VLC_EGENERIC;
117 msg_Err( p_demux, "this doesn't look like a flac stream, "
118 "continuing anyway" );
121 p_sys = malloc( sizeof( demux_sys_t ) );
122 if( unlikely(p_sys == NULL) )
125 p_demux->pf_demux = Demux;
126 p_demux->pf_control = Control;
127 p_demux->p_sys = p_sys;
128 p_sys->b_start = true;
129 p_sys->p_meta = NULL;
131 p_sys->i_time_offset = 0;
133 p_sys->i_pts_start = 0;
135 TAB_INIT( p_sys->i_seekpoint, p_sys->seekpoint );
136 TAB_INIT( p_sys->i_attachments, p_sys->attachments);
137 p_sys->i_cover_idx = 0;
138 p_sys->i_cover_score = 0;
140 /* We need to read and store the STREAMINFO metadata */
141 if( ReadMeta( p_demux, &p_streaminfo, &i_streaminfo ) )
147 /* Load the FLAC packetizer */
148 /* Store STREAMINFO for the decoder and packetizer */
149 es_format_Init( &fmt, AUDIO_ES, VLC_CODEC_FLAC );
150 fmt.i_extra = i_streaminfo;
151 fmt.p_extra = p_streaminfo;
153 p_sys->p_packetizer = demux_PacketizerNew( p_demux, &fmt, "flac" );
154 if( !p_sys->p_packetizer )
160 if( p_sys->i_cover_idx < p_sys->i_attachments )
164 p_sys->p_meta = vlc_meta_New();
165 snprintf( psz_url, sizeof(psz_url), "attachment://%s",
166 p_sys->attachments[p_sys->i_cover_idx]->psz_name );
167 vlc_meta_Set( p_sys->p_meta, vlc_meta_ArtworkURL, psz_url );
172 /*****************************************************************************
173 * Close: frees unused data
174 *****************************************************************************/
175 static void Close( vlc_object_t * p_this )
177 demux_t *p_demux = (demux_t*)p_this;
178 demux_sys_t *p_sys = p_demux->p_sys;
180 for( int i = 0; i < p_sys->i_seekpoint; i++ )
181 vlc_seekpoint_Delete(p_sys->seekpoint[i]);
182 TAB_CLEAN( p_sys->i_seekpoint, p_sys->seekpoint );
184 for( int i = 0; i < p_sys->i_attachments; i++ )
185 vlc_input_attachment_Delete( p_sys->attachments[i] );
186 TAB_CLEAN( p_sys->i_attachments, p_sys->attachments);
188 /* Delete the decoder */
189 demux_PacketizerDestroy( p_sys->p_packetizer );
192 vlc_meta_Delete( p_sys->p_meta );
196 /*****************************************************************************
197 * Demux: reads and demuxes data packets
198 *****************************************************************************
199 * Returns -1 in case of error, 0 in case of EOF, 1 otherwise
200 *****************************************************************************/
201 static int Demux( demux_t *p_demux )
203 demux_sys_t *p_sys = p_demux->p_sys;
204 block_t *p_block_in, *p_block_out;
206 if( !( p_block_in = stream_Block( p_demux->s, FLAC_PACKET_SIZE ) ) )
209 p_block_in->i_pts = p_block_in->i_dts = p_sys->b_start ? VLC_TS_0 : VLC_TS_INVALID;
210 p_sys->b_start = false;
212 while( (p_block_out = p_sys->p_packetizer->pf_packetize(
213 p_sys->p_packetizer, &p_block_in )) )
217 block_t *p_next = p_block_out->p_next;
219 p_block_out->p_next = NULL;
221 if( p_sys->p_es == NULL )
223 p_sys->p_packetizer->fmt_out.b_packetized = true;
224 p_sys->p_es = es_out_Add( p_demux->out, &p_sys->p_packetizer->fmt_out);
227 p_sys->i_pts = p_block_out->i_dts - VLC_TS_0;
229 /* Correct timestamp */
230 p_block_out->i_pts += p_sys->i_time_offset;
231 p_block_out->i_dts += p_sys->i_time_offset;
234 es_out_Control( p_demux->out, ES_OUT_SET_PCR, p_block_out->i_dts );
236 es_out_Send( p_demux->out, p_sys->p_es, p_block_out );
238 p_block_out = p_next;
244 /*****************************************************************************
246 *****************************************************************************/
247 static int64_t ControlGetLength( demux_t *p_demux )
249 demux_sys_t *p_sys = p_demux->p_sys;
250 const int64_t i_size = stream_Size(p_demux->s) - p_sys->i_data_pos;
251 int64_t i_length = p_sys->i_length;
254 /* Try to fix length using seekpoint and current size for truncated file */
255 for( i = p_sys->i_seekpoint-1; i >= 0; i-- )
257 seekpoint_t *s = p_sys->seekpoint[i];
258 if( s->i_byte_offset <= i_size )
260 if( i+1 < p_sys->i_seekpoint )
263 seekpoint_t *n = p_sys->seekpoint[i+1];
264 assert( n->i_byte_offset != s->i_byte_offset); /* Should be ensured by ParseSeekTable */
265 i_length = s->i_time_offset + (n->i_time_offset-s->i_time_offset) * (i_size-s->i_byte_offset) / (n->i_byte_offset-s->i_byte_offset);
273 static int64_t ControlGetTime( demux_t *p_demux )
275 demux_sys_t *p_sys = p_demux->p_sys;
276 return __MAX(p_sys->i_pts, p_sys->i_pts_start) + p_sys->i_time_offset;
279 static int ControlSetTime( demux_t *p_demux, int64_t i_time )
281 demux_sys_t *p_sys = p_demux->p_sys;
282 int64_t i_delta_time;
287 stream_Control( p_demux->s, STREAM_CAN_SEEK, &b_seekable );
292 assert( p_sys->i_seekpoint > 0 ); /* ReadMeta ensure at least (0,0) */
293 for( i = p_sys->i_seekpoint-1; i >= 0; i-- )
295 if( p_sys->seekpoint[i]->i_time_offset <= i_time )
298 i_delta_time = i_time - p_sys->seekpoint[i]->i_time_offset;
300 /* XXX We do exact seek if it's not too far away(45s) */
301 if( i_delta_time < 45*INT64_C(1000000) )
303 if( stream_Seek( p_demux->s, p_sys->seekpoint[i]->i_byte_offset+p_sys->i_data_pos ) )
306 p_sys->i_time_offset = p_sys->seekpoint[i]->i_time_offset - p_sys->i_pts;
307 p_sys->i_pts_start = p_sys->i_pts+i_delta_time;
308 es_out_Control( p_demux->out, ES_OUT_SET_NEXT_DISPLAY_TIME, p_sys->i_pts_start + p_sys->i_time_offset );
312 int64_t i_delta_offset;
314 int64_t i_next_offset;
316 if( i+1 < p_sys->i_seekpoint )
318 i_next_time = p_sys->seekpoint[i+1]->i_time_offset;
319 i_next_offset = p_sys->seekpoint[i+1]->i_byte_offset;
323 i_next_time = p_sys->i_length;
324 i_next_offset = stream_Size(p_demux->s)-p_sys->i_data_pos;
328 if( i_next_time-p_sys->seekpoint[i]->i_time_offset > 0 )
329 i_delta_offset = (i_next_offset - p_sys->seekpoint[i]->i_byte_offset) * i_delta_time /
330 (i_next_time-p_sys->seekpoint[i]->i_time_offset);
332 if( stream_Seek( p_demux->s, p_sys->seekpoint[i]->i_byte_offset+p_sys->i_data_pos + i_delta_offset ) )
335 p_sys->i_pts_start = p_sys->i_pts;
336 p_sys->i_time_offset = (p_sys->seekpoint[i]->i_time_offset+i_delta_time) - p_sys->i_pts;
341 static int Control( demux_t *p_demux, int i_query, va_list args )
343 demux_sys_t *p_sys = p_demux->p_sys;
345 if( i_query == DEMUX_GET_META )
347 vlc_meta_t *p_meta = (vlc_meta_t *)va_arg( args, vlc_meta_t* );
348 if( p_demux->p_sys->p_meta )
349 vlc_meta_Merge( p_meta, p_demux->p_sys->p_meta );
352 else if( i_query == DEMUX_HAS_UNSUPPORTED_META )
354 bool *pb_bool = (bool*)va_arg( args, bool* );
358 else if( i_query == DEMUX_GET_LENGTH )
360 int64_t *pi64 = (int64_t*)va_arg( args, int64_t * );
361 *pi64 = ControlGetLength( p_demux );
364 else if( i_query == DEMUX_SET_TIME )
366 int64_t i_time = (int64_t)va_arg( args, int64_t );
367 return ControlSetTime( p_demux, i_time );
369 else if( i_query == DEMUX_SET_POSITION )
371 const double f = (double)va_arg( args, double );
372 int64_t i_time = f * ControlGetLength( p_demux );
373 return ControlSetTime( p_demux, i_time );
375 else if( i_query == DEMUX_GET_TIME )
377 int64_t *pi64 = (int64_t*)va_arg( args, int64_t * );
378 *pi64 = ControlGetTime( p_demux );
381 else if( i_query == DEMUX_GET_POSITION )
383 double *pf = (double*)va_arg( args, double * );
384 const int64_t i_length = ControlGetLength(p_demux);
387 double current = ControlGetTime(p_demux);
388 *pf = current / (double)i_length;
394 else if( i_query == DEMUX_GET_ATTACHMENTS )
396 input_attachment_t ***ppp_attach =
397 (input_attachment_t***)va_arg( args, input_attachment_t*** );
398 int *pi_int = (int*)va_arg( args, int * );
400 if( p_sys->i_attachments <= 0 )
403 *pi_int = p_sys->i_attachments;
404 *ppp_attach = xmalloc( sizeof(input_attachment_t*) * p_sys->i_attachments );
405 for( int i = 0; i < p_sys->i_attachments; i++ )
406 (*ppp_attach)[i] = vlc_input_attachment_Duplicate( p_sys->attachments[i] );
410 return demux_vaControlHelper( p_demux->s, p_sys->i_data_pos, -1,
411 8*0, 1, i_query, args );
422 static inline int Get24bBE( const uint8_t *p )
424 return (p[0] << 16)|(p[1] << 8)|(p[2]);
427 static void ParseStreamInfo( int *pi_rate, int64_t *pi_count, uint8_t *p_data );
428 static void ParseSeekTable( demux_t *p_demux, const uint8_t *p_data, int i_data,
430 static void ParseComment( demux_t *, const uint8_t *p_data, int i_data );
431 static void ParsePicture( demux_t *, const uint8_t *p_data, int i_data );
433 static int ReadMeta( demux_t *p_demux, uint8_t **pp_streaminfo, int *pi_streaminfo )
435 demux_sys_t *p_sys = p_demux->p_sys;
437 const uint8_t *p_peek;
439 int i_sample_rate = 0;
440 int64_t i_sample_count;
442 *pp_streaminfo = NULL;
444 /* Be sure we have seekpoint 0 */
445 seekpoint_t *s = vlc_seekpoint_New();
446 s->i_time_offset = 0;
447 s->i_byte_offset = 0;
448 TAB_APPEND( p_sys->i_seekpoint, p_sys->seekpoint, s );
451 if( stream_Read( p_demux->s, header, 4) < 4)
454 if (memcmp(header, "fLaC", 4))
463 i_peek = stream_Peek( p_demux->s, &p_peek, 4 );
466 b_last = p_peek[0]&0x80;
467 i_type = p_peek[0]&0x7f;
468 i_len = Get24bBE( &p_peek[1] );
470 if( i_type == META_STREAMINFO && !*pp_streaminfo )
472 if( i_len != STREAMINFO_SIZE ) {
473 msg_Err( p_demux, "invalid size %d for a STREAMINFO metadata block", i_len );
477 *pi_streaminfo = STREAMINFO_SIZE;
478 *pp_streaminfo = malloc( STREAMINFO_SIZE);
479 if( *pp_streaminfo == NULL )
482 if( stream_Read( p_demux->s, NULL, 4) < 4)
484 if( stream_Read( p_demux->s, *pp_streaminfo, STREAMINFO_SIZE ) != STREAMINFO_SIZE )
486 msg_Err( p_demux, "failed to read STREAMINFO metadata block" );
487 free( *pp_streaminfo );
492 ParseStreamInfo( &i_sample_rate, &i_sample_count, *pp_streaminfo );
493 if( i_sample_rate > 0 )
494 p_sys->i_length = i_sample_count * INT64_C(1000000)/i_sample_rate;
497 else if( i_type == META_SEEKTABLE )
499 i_peek = stream_Peek( p_demux->s, &p_peek, 4+i_len );
500 if( i_peek == 4+i_len )
501 ParseSeekTable( p_demux, p_peek, i_peek, i_sample_rate );
503 else if( i_type == META_COMMENT )
505 i_peek = stream_Peek( p_demux->s, &p_peek, 4+i_len );
506 if( i_peek == 4+i_len )
507 ParseComment( p_demux, p_peek, i_peek );
509 else if( i_type == META_PICTURE )
511 i_peek = stream_Peek( p_demux->s, &p_peek, 4+i_len );
512 if( i_peek == 4+i_len )
513 ParsePicture( p_demux, p_peek, i_peek );
516 if( stream_Read( p_demux->s, NULL, 4+i_len ) < 4+i_len )
521 p_sys->i_data_pos = stream_Tell( p_demux->s );
528 static void ParseStreamInfo( int *pi_rate, int64_t *pi_count, uint8_t *p_data )
530 *pi_rate = GetDWBE(&p_data[4+6]) >> 12;
531 *pi_count = GetQWBE(&p_data[4+6]) & ((INT64_C(1)<<36)-1);
534 static void ParseSeekTable( demux_t *p_demux, const uint8_t *p_data, int i_data,
537 demux_sys_t *p_sys = p_demux->p_sys;
541 if( i_sample_rate <= 0 )
545 for( i = 0; i < (i_data-4)/18; i++ )
547 const int64_t i_sample = GetQWBE( &p_data[4+18*i+0] );
550 if( i_sample < 0 || i_sample >= INT64_MAX )
553 s = vlc_seekpoint_New();
554 s->i_time_offset = i_sample * INT64_C(1000000)/i_sample_rate;
555 s->i_byte_offset = GetQWBE( &p_data[4+18*i+8] );
557 /* Check for duplicate entry */
558 for( j = 0; j < p_sys->i_seekpoint; j++ )
560 if( p_sys->seekpoint[j]->i_time_offset == s->i_time_offset ||
561 p_sys->seekpoint[j]->i_byte_offset == s->i_byte_offset )
563 vlc_seekpoint_Delete( s );
570 TAB_APPEND( p_sys->i_seekpoint, p_sys->seekpoint, s );
573 /* TODO sort it by size and remove wrong seek entry (time not increasing) */
576 static void ParseComment( demux_t *p_demux, const uint8_t *p_data, int i_data )
578 demux_sys_t *p_sys = p_demux->p_sys;
583 vorbis_ParseComment( &p_sys->p_meta, &p_data[4], i_data - 4,
584 &p_sys->i_attachments, &p_sys->attachments,
585 &p_sys->i_cover_score, &p_sys->i_cover_idx, NULL, NULL );
588 static void ParsePicture( demux_t *p_demux, const uint8_t *p_data, int i_data )
590 demux_sys_t *p_sys = p_demux->p_sys;
592 i_data -= 4; p_data += 4;
594 input_attachment_t *p_attachment = ParseFlacPicture( p_data, i_data,
595 p_sys->i_attachments, &p_sys->i_cover_score, &p_sys->i_cover_idx );
596 if( p_attachment == NULL )
599 TAB_APPEND( p_sys->i_attachments, p_sys->attachments, p_attachment );