2 * consumer_sdl_audio.c -- A Simple DirectMedia Layer audio-only consumer
3 * Copyright (C) 2009-2012 Ushodaya Enterprises Limited
4 * Author: Dan Dennedy <dan@dennedy.org>
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 #include <framework/mlt_consumer.h>
22 #include <framework/mlt_frame.h>
23 #include <framework/mlt_deque.h>
24 #include <framework/mlt_factory.h>
25 #include <framework/mlt_filter.h>
26 #include <framework/mlt_log.h>
34 extern pthread_mutex_t mlt_sdl_mutex;
36 /** This classes definition.
39 typedef struct consumer_sdl_s *consumer_sdl;
43 struct mlt_consumer_s parent;
44 mlt_properties properties;
49 uint8_t audio_buffer[ 4096 * 10 ];
51 pthread_mutex_t audio_mutex;
52 pthread_cond_t audio_cond;
53 pthread_mutex_t video_mutex;
54 pthread_cond_t video_cond;
57 pthread_cond_t refresh_cond;
58 pthread_mutex_t refresh_mutex;
63 /** Forward references to static functions.
66 static int consumer_start( mlt_consumer parent );
67 static int consumer_stop( mlt_consumer parent );
68 static int consumer_is_stopped( mlt_consumer parent );
69 static void consumer_purge( mlt_consumer parent );
70 static void consumer_close( mlt_consumer parent );
71 static void *consumer_thread( void * );
72 static void consumer_refresh_cb( mlt_consumer sdl, mlt_consumer self, char *name );
74 /** This is what will be called by the factory - anything can be passed in
75 via the argument, but keep it simple.
78 mlt_consumer consumer_sdl_audio_init( mlt_profile profile, mlt_service_type type, const char *id, char *arg )
80 // Create the consumer object
81 consumer_sdl self = calloc( 1, sizeof( struct consumer_sdl_s ) );
83 // If no malloc'd and consumer init ok
84 if ( self != NULL && mlt_consumer_init( &self->parent, self, profile ) == 0 )
87 self->queue = mlt_deque_init( );
89 // Get the parent consumer object
90 mlt_consumer parent = &self->parent;
92 // We have stuff to clean up, so override the close method
93 parent->close = consumer_close;
95 // get a handle on properties
96 mlt_service service = MLT_CONSUMER_SERVICE( parent );
97 self->properties = MLT_SERVICE_PROPERTIES( service );
99 // Set the default volume
100 mlt_properties_set_double( self->properties, "volume", 1.0 );
102 // This is the initialisation of the consumer
103 pthread_mutex_init( &self->audio_mutex, NULL );
104 pthread_cond_init( &self->audio_cond, NULL);
105 pthread_mutex_init( &self->video_mutex, NULL );
106 pthread_cond_init( &self->video_cond, NULL);
108 // Default scaler (for now we'll use nearest)
109 mlt_properties_set( self->properties, "rescale", "nearest" );
110 mlt_properties_set( self->properties, "deinterlace_method", "onefield" );
111 mlt_properties_set_int( self->properties, "top_field_first", -1 );
113 // Default buffer for low latency
114 mlt_properties_set_int( self->properties, "buffer", 1 );
116 // Default audio buffer
117 mlt_properties_set_int( self->properties, "audio_buffer", 2048 );
119 // Ensure we don't join on a non-running object
122 // Allow thread to be started/stopped
123 parent->start = consumer_start;
124 parent->stop = consumer_stop;
125 parent->is_stopped = consumer_is_stopped;
126 parent->purge = consumer_purge;
128 // Initialize the refresh handler
129 pthread_cond_init( &self->refresh_cond, NULL );
130 pthread_mutex_init( &self->refresh_mutex, NULL );
131 mlt_events_listen( MLT_CONSUMER_PROPERTIES( parent ), self, "property-changed", ( mlt_listener )consumer_refresh_cb );
133 // Return the consumer produced
137 // malloc or consumer init failed
144 static void consumer_refresh_cb( mlt_consumer sdl, mlt_consumer parent, char *name )
146 if ( !strcmp( name, "refresh" ) )
148 consumer_sdl self = parent->child;
149 pthread_mutex_lock( &self->refresh_mutex );
150 if ( self->refresh_count < 2 )
151 self->refresh_count = self->refresh_count <= 0 ? 1 : self->refresh_count + 1;
152 pthread_cond_broadcast( &self->refresh_cond );
153 pthread_mutex_unlock( &self->refresh_mutex );
157 int consumer_start( mlt_consumer parent )
159 consumer_sdl self = parent->child;
161 if ( !self->running )
163 consumer_stop( parent );
165 pthread_mutex_lock( &mlt_sdl_mutex );
166 int ret = SDL_Init( SDL_INIT_AUDIO | SDL_INIT_NOPARACHUTE );
167 pthread_mutex_unlock( &mlt_sdl_mutex );
170 mlt_log_error( MLT_CONSUMER_SERVICE(parent), "Failed to initialize SDL: %s\n", SDL_GetError() );
176 pthread_create( &self->thread, NULL, consumer_thread, self );
182 int consumer_stop( mlt_consumer parent )
184 // Get the actual object
185 consumer_sdl self = parent->child;
187 if ( self->running && !self->joined )
189 // Kill the thread and clean up
193 // Unlatch the consumer thread
194 pthread_mutex_lock( &self->refresh_mutex );
195 pthread_cond_broadcast( &self->refresh_cond );
196 pthread_mutex_unlock( &self->refresh_mutex );
198 // Cleanup the main thread
202 pthread_join( self->thread, NULL );
204 // Unlatch the video thread
205 pthread_mutex_lock( &self->video_mutex );
206 pthread_cond_broadcast( &self->video_cond );
207 pthread_mutex_unlock( &self->video_mutex );
209 // Unlatch the audio callback
210 pthread_mutex_lock( &self->audio_mutex );
211 pthread_cond_broadcast( &self->audio_cond );
212 pthread_mutex_unlock( &self->audio_mutex );
214 SDL_QuitSubSystem( SDL_INIT_AUDIO );
220 int consumer_is_stopped( mlt_consumer parent )
222 consumer_sdl self = parent->child;
223 return !self->running;
226 void consumer_purge( mlt_consumer parent )
228 consumer_sdl self = parent->child;
231 pthread_mutex_lock( &self->video_mutex );
232 mlt_frame frame = MLT_FRAME( mlt_deque_peek_back( self->queue ) );
233 // When playing rewind or fast forward then we need to keep one
234 // frame in the queue to prevent playback stalling.
235 double speed = frame? mlt_properties_get_double( MLT_FRAME_PROPERTIES(frame), "_speed" ) : 0;
236 int n = ( speed == 0.0 || speed == 1.0 ) ? 0 : 1;
237 while ( mlt_deque_count( self->queue ) > n )
238 mlt_frame_close( mlt_deque_pop_back( self->queue ) );
240 pthread_cond_broadcast( &self->video_cond );
241 pthread_mutex_unlock( &self->video_mutex );
245 static void sdl_fill_audio( void *udata, uint8_t *stream, int len )
247 consumer_sdl self = udata;
250 double volume = mlt_properties_get_double( self->properties, "volume" );
252 pthread_mutex_lock( &self->audio_mutex );
254 // Block until audio received
256 while ( self->running && len > self->audio_avail )
257 pthread_cond_wait( &self->audio_cond, &self->audio_mutex );
260 if ( self->audio_avail >= len )
262 // Place in the audio buffer
264 SDL_MixAudio( stream, self->audio_buffer, len, ( int )( ( float )SDL_MIX_MAXVOLUME * volume ) );
266 memcpy( stream, self->audio_buffer, len );
268 // Remove len from the audio available
269 self->audio_avail -= len;
271 // Remove the samples
272 memmove( self->audio_buffer, self->audio_buffer + len, self->audio_avail );
276 // Just to be safe, wipe the stream first
277 memset( stream, 0, len );
280 SDL_MixAudio( stream, self->audio_buffer, self->audio_avail,
281 ( int )( ( float )SDL_MIX_MAXVOLUME * volume ) );
284 self->audio_avail = 0;
287 // We're definitely playing now
290 pthread_cond_broadcast( &self->audio_cond );
291 pthread_mutex_unlock( &self->audio_mutex );
294 static int consumer_play_audio( consumer_sdl self, mlt_frame frame, int init_audio, int *duration )
296 // Get the properties of this consumer
297 mlt_properties properties = self->properties;
298 mlt_audio_format afmt = mlt_audio_s16;
300 // Set the preferred params of the test card signal
301 int channels = mlt_properties_get_int( properties, "channels" );
302 int frequency = mlt_properties_get_int( properties, "frequency" );
303 int scrub = mlt_properties_get_int( properties, "scrub_audio" );
304 static int counter = 0;
306 int samples = mlt_sample_calculator( mlt_properties_get_double( self->properties, "fps" ), frequency, counter++ );
311 mlt_frame_get_audio( frame, (void**) &pcm, &afmt, &frequency, &channels, &samples );
312 *duration = ( ( samples * 1000 ) / frequency );
314 if ( mlt_properties_get_int( properties, "audio_off" ) )
321 if ( init_audio == 1 )
323 SDL_AudioSpec request;
326 int audio_buffer = mlt_properties_get_int( properties, "audio_buffer" );
328 // specify audio format
329 memset( &request, 0, sizeof( SDL_AudioSpec ) );
331 request.freq = frequency;
332 request.format = AUDIO_S16SYS;
333 request.channels = channels;
334 request.samples = audio_buffer;
335 request.callback = sdl_fill_audio;
336 request.userdata = (void *)self;
337 if ( SDL_OpenAudio( &request, &got ) != 0 )
339 mlt_log_error( MLT_CONSUMER_SERVICE( self ), "SDL failed to open audio: %s\n", SDL_GetError() );
342 else if ( got.size != 0 )
349 if ( init_audio == 0 )
351 mlt_properties properties = MLT_FRAME_PROPERTIES( frame );
352 bytes = ( samples * channels * 2 );
353 pthread_mutex_lock( &self->audio_mutex );
354 while ( self->running && bytes > ( sizeof( self->audio_buffer) - self->audio_avail ) )
355 pthread_cond_wait( &self->audio_cond, &self->audio_mutex );
358 if ( scrub || mlt_properties_get_double( properties, "_speed" ) == 1 )
359 memcpy( &self->audio_buffer[ self->audio_avail ], pcm, bytes );
361 memset( &self->audio_buffer[ self->audio_avail ], 0, bytes );
362 self->audio_avail += bytes;
364 pthread_cond_broadcast( &self->audio_cond );
365 pthread_mutex_unlock( &self->audio_mutex );
375 static int consumer_play_video( consumer_sdl self, mlt_frame frame )
377 // Get the properties of this consumer
378 mlt_properties properties = self->properties;
379 if ( self->running && !mlt_consumer_is_stopped( &self->parent ) )
380 mlt_events_fire( properties, "consumer-frame-show", frame, NULL );
384 static void *video_thread( void *arg )
387 consumer_sdl self = arg;
389 // Obtain time of thread start
394 mlt_frame next = NULL;
395 mlt_properties properties = NULL;
398 // Get real time flag
399 int real_time = mlt_properties_get_int( self->properties, "real_time" );
401 // Get the current time
402 gettimeofday( &now, NULL );
404 // Determine start time
405 start = ( int64_t )now.tv_sec * 1000000 + now.tv_usec;
407 while ( self->running )
409 // Pop the next frame
410 pthread_mutex_lock( &self->video_mutex );
411 next = mlt_deque_pop_front( self->queue );
412 while ( next == NULL && self->running )
414 pthread_cond_wait( &self->video_cond, &self->video_mutex );
415 next = mlt_deque_pop_front( self->queue );
417 pthread_mutex_unlock( &self->video_mutex );
419 if ( !self->running || next == NULL ) break;
421 // Get the properties
422 properties = MLT_FRAME_PROPERTIES( next );
424 // Get the speed of the frame
425 speed = mlt_properties_get_double( properties, "_speed" );
427 // Get the current time
428 gettimeofday( &now, NULL );
430 // Get the elapsed time
431 elapsed = ( ( int64_t )now.tv_sec * 1000000 + now.tv_usec ) - start;
433 // See if we have to delay the display of the current frame
434 if ( mlt_properties_get_int( properties, "rendered" ) == 1 && self->running )
436 // Obtain the scheduled playout time
437 int64_t scheduled = mlt_properties_get_int( properties, "playtime" );
439 // Determine the difference between the elapsed time and the scheduled playout time
440 int64_t difference = scheduled - elapsed;
442 // Smooth playback a bit
443 if ( real_time && ( difference > 20000 && speed == 1.0 ) )
445 tm.tv_sec = difference / 1000000;
446 tm.tv_nsec = ( difference % 1000000 ) * 500;
447 nanosleep( &tm, NULL );
450 // Show current frame if not too old
451 if ( !real_time || ( difference > -10000 || speed != 1.0 || mlt_deque_count( self->queue ) < 2 ) )
452 consumer_play_video( self, next );
454 // If the queue is empty, recalculate start to allow build up again
455 if ( real_time && ( mlt_deque_count( self->queue ) == 0 && speed == 1.0 ) )
457 gettimeofday( &now, NULL );
458 start = ( ( int64_t )now.tv_sec * 1000000 + now.tv_usec ) - scheduled + 20000;
462 // This frame can now be closed
463 mlt_frame_close( next );
468 mlt_frame_close( next );
470 mlt_consumer_stopped( &self->parent );
475 /** Threaded wrapper for pipe.
478 static void *consumer_thread( void *arg )
481 consumer_sdl self = arg;
484 mlt_consumer consumer = &self->parent;
486 // Get the properties
487 mlt_properties consumer_props = MLT_CONSUMER_PROPERTIES( consumer );
492 // internal intialization
495 mlt_frame frame = NULL;
496 mlt_properties properties = NULL;
498 int64_t playtime = 0;
499 struct timespec tm = { 0, 100000 };
500 // int last_position = -1;
502 pthread_mutex_lock( &self->refresh_mutex );
503 self->refresh_count = 0;
504 pthread_mutex_unlock( &self->refresh_mutex );
506 // Loop until told not to
507 while( self->running )
509 // Get a frame from the attached producer
510 frame = mlt_consumer_rt_frame( consumer );
512 // Ensure that we have a frame
515 // Get the frame properties
516 properties = MLT_FRAME_PROPERTIES( frame );
518 // Get the speed of the frame
519 double speed = mlt_properties_get_double( properties, "_speed" );
521 // Get refresh request for the current frame
522 int refresh = mlt_properties_get_int( consumer_props, "refresh" );
525 mlt_events_block( consumer_props, consumer_props );
526 mlt_properties_set_int( consumer_props, "refresh", 0 );
527 mlt_events_unblock( consumer_props, consumer_props );
530 init_audio = consumer_play_audio( self, frame, init_audio, &duration );
532 // Determine the start time now
533 if ( self->playing && init_video )
535 // Create the video thread
536 pthread_create( &thread, NULL, video_thread, self );
538 // Video doesn't need to be initialised any more
542 // Set playtime for this frame
543 mlt_properties_set_int( properties, "playtime", playtime );
545 while ( self->running && speed != 0 && mlt_deque_count( self->queue ) > 15 )
546 nanosleep( &tm, NULL );
548 // Push this frame to the back of the queue
549 if ( self->running && speed )
551 pthread_mutex_lock( &self->video_mutex );
552 if ( self->is_purge && speed == 1.0 )
554 mlt_frame_close( frame );
559 mlt_deque_push_back( self->queue, frame );
560 pthread_cond_broadcast( &self->video_cond );
562 pthread_mutex_unlock( &self->video_mutex );
564 // Calculate the next playtime
565 playtime += ( duration * 1000 );
567 else if ( self->running )
569 pthread_mutex_lock( &self->refresh_mutex );
570 if ( ( refresh == 0 && self->refresh_count <= 0 ) || self->refresh_count > 1 )
572 consumer_play_video( self, frame );
573 pthread_cond_wait( &self->refresh_cond, &self->refresh_mutex );
575 mlt_frame_close( frame );
576 self->refresh_count --;
577 pthread_mutex_unlock( &self->refresh_mutex );
581 mlt_frame_close( frame );
585 // Optimisation to reduce latency
586 if ( frame && speed == 1.0 )
588 // TODO: disabled due to misbehavior on parallel-consumer
589 // if ( last_position != -1 && last_position + 1 != mlt_frame_get_position( frame ) )
590 // mlt_consumer_purge( consumer );
591 // last_position = mlt_frame_get_position( frame );
595 mlt_consumer_purge( consumer );
596 // last_position = -1;
601 // Kill the video thread
602 if ( init_video == 0 )
604 pthread_mutex_lock( &self->video_mutex );
605 pthread_cond_broadcast( &self->video_cond );
606 pthread_mutex_unlock( &self->video_mutex );
607 pthread_join( thread, NULL );
610 while( mlt_deque_count( self->queue ) )
611 mlt_frame_close( mlt_deque_pop_back( self->queue ) );
613 self->audio_avail = 0;
618 /** Callback to allow override of the close method.
621 static void consumer_close( mlt_consumer parent )
623 // Get the actual object
624 consumer_sdl self = parent->child;
627 mlt_consumer_stop( parent );
629 // Now clean up the rest
630 mlt_consumer_close( parent );
633 mlt_deque_close( self->queue );
636 pthread_mutex_destroy( &self->audio_mutex );
637 pthread_cond_destroy( &self->audio_cond );
638 pthread_mutex_destroy( &self->video_mutex );
639 pthread_cond_destroy( &self->video_cond );
640 pthread_mutex_destroy( &self->refresh_mutex );
641 pthread_cond_destroy( &self->refresh_cond );
643 // Finally clean up this