1 /*****************************************************************************
2 * portaudio.c : portaudio (v19) audio output plugin
3 *****************************************************************************
4 * Copyright (C) 2002, 2006 the VideoLAN team
7 * Authors: Frederic Ruget <frederic.ruget@free.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 *****************************************************************************/
25 /*****************************************************************************
27 *****************************************************************************/
33 #include <vlc_common.h>
34 #include <vlc_plugin.h>
38 #include <portaudio.h>
40 #define FRAME_SIZE 1024 /* The size is in samples, not in bytes */
43 # define PORTAUDIO_IS_SERIOUSLY_BROKEN 1
46 /*****************************************************************************
47 * aout_sys_t: portaudio audio output method descriptor
48 *****************************************************************************/
49 typedef struct pa_thread_t
52 aout_instance_t *p_aout;
55 vlc_mutex_t lock_wait;
58 vlc_mutex_t lock_signal;
65 aout_instance_t *p_aout;
68 PaDeviceIndex i_devices;
70 PaDeviceIndex i_device_id;
71 const PaDeviceInfo *deviceInfo;
73 bool b_chan_reorder; /* do we need channel reordering */
74 int pi_chan_table[AOUT_CHAN_MAX];
75 uint32_t i_channel_mask;
76 uint32_t i_bits_per_sample;
80 static const uint32_t pi_channels_out[] =
81 { AOUT_CHAN_LEFT, AOUT_CHAN_RIGHT,
82 AOUT_CHAN_CENTER, AOUT_CHAN_LFE,
83 AOUT_CHAN_REARLEFT, AOUT_CHAN_REARRIGHT, AOUT_CHAN_REARCENTER,
84 AOUT_CHAN_MIDDLELEFT, AOUT_CHAN_MIDDLERIGHT, 0 };
86 #ifdef PORTAUDIO_IS_SERIOUSLY_BROKEN
87 static bool b_init = 0;
88 static pa_thread_t *pa_thread;
89 static void* PORTAUDIOThread( vlc_object_t * );
92 /*****************************************************************************
94 *****************************************************************************/
95 static int Open ( vlc_object_t * );
96 static void Close ( vlc_object_t * );
97 static void Play ( aout_instance_t * );
99 static int PAOpenDevice( aout_instance_t * );
100 static int PAOpenStream( aout_instance_t * );
102 /*****************************************************************************
104 *****************************************************************************/
105 #define DEVICE_TEXT N_("Output device")
106 #define DEVICE_LONGTEXT N_("Portaudio identifier for the output device")
109 set_shortname( "PortAudio" )
110 set_description( N_("PORTAUDIO audio output") )
111 set_category( CAT_AUDIO )
112 set_subcategory( SUBCAT_AUDIO_AOUT )
113 add_integer( "portaudio-audio-device", 0, NULL,
114 DEVICE_TEXT, DEVICE_LONGTEXT, false )
115 add_deprecated_alias( "portaudio-device" ) /* deprecated since 0.9.3 */
116 set_capability( "audio output", 0 )
117 set_callbacks( Open, Close )
120 /* This routine will be called by the PortAudio engine when audio is needed.
121 * It may called at interrupt level on some machines so don't do anything
122 * that could mess up the system like calling malloc() or free().
124 static int paCallback( const void *inputBuffer, void *outputBuffer,
125 unsigned long framesPerBuffer,
126 const PaStreamCallbackTimeInfo *paDate,
127 PaStreamCallbackFlags statusFlags, void *p_cookie )
129 struct aout_sys_t *p_sys = (struct aout_sys_t*) p_cookie;
130 aout_instance_t *p_aout = p_sys->p_aout;
131 aout_buffer_t *p_buffer;
134 out_date = mdate() + (mtime_t) ( 1000000 *
135 ( paDate->outputBufferDacTime - paDate->currentTime ) );
136 p_buffer = aout_OutputNextBuffer( p_aout, out_date, true );
138 if ( p_buffer != NULL )
140 if( p_sys->b_chan_reorder )
142 /* Do the channel reordering here */
143 aout_ChannelReorder( p_buffer->p_buffer, p_buffer->i_nb_bytes,
144 p_sys->i_channels, p_sys->pi_chan_table,
145 p_sys->i_bits_per_sample );
147 vlc_memcpy( outputBuffer, p_buffer->p_buffer,
148 framesPerBuffer * p_sys->i_sample_size );
149 /* aout_BufferFree may be dangereous here, but then so is
150 * aout_OutputNextBuffer (calls aout_BufferFree internally).
151 * one solution would be to link the no longer useful buffers
152 * in a second fifo (in aout_OutputNextBuffer too) and to
153 * wait until we are in Play to do the actual free.
155 aout_BufferFree( p_buffer );
158 /* Audio output buffer shortage -> stop the fill process and wait */
160 vlc_memset( outputBuffer, 0, framesPerBuffer * p_sys->i_sample_size );
165 /*****************************************************************************
166 * Open: open the audio device
167 *****************************************************************************/
168 static int Open( vlc_object_t * p_this )
170 aout_instance_t *p_aout = (aout_instance_t *)p_this;
171 struct aout_sys_t * p_sys;
174 msg_Dbg( p_aout, "entering Open()");
176 /* Allocate p_sys structure */
177 p_sys = malloc( sizeof(aout_sys_t) );
180 p_sys->p_aout = p_aout;
182 p_aout->output.p_sys = p_sys;
183 p_aout->output.pf_play = Play;
185 /* Retrieve output device id from config */
186 p_sys->i_device_id = var_CreateGetInteger( p_aout, "portaudio-audio-device" );
188 #ifdef PORTAUDIO_IS_SERIOUSLY_BROKEN
192 if( PAOpenDevice( p_aout ) != VLC_SUCCESS )
194 msg_Err( p_aout, "cannot open portaudio device" );
199 /* Close device for now. We'll re-open it later on */
200 if( ( i_err = Pa_Terminate() ) != paNoError )
202 msg_Err( p_aout, "closing the device returned %d", i_err );
207 /* Now we need to setup our DirectSound play notification structure */
208 pa_thread = vlc_object_create( p_aout, sizeof(pa_thread_t) );
209 pa_thread->p_aout = p_aout;
210 pa_thread->b_error = false;
211 vlc_mutex_init( &pa_thread->lock_wait );
212 vlc_cond_init( &pa_thread->wait );
213 pa_thread->b_wait = false;
214 vlc_mutex_init( &pa_thread->lock_signal );
215 vlc_cond_init( &pa_thread->signal );
216 pa_thread->b_signal = false;
218 /* Create PORTAUDIOThread */
219 if( vlc_thread_create( pa_thread, "aout", PORTAUDIOThread,
220 VLC_THREAD_PRIORITY_OUTPUT ) )
222 msg_Err( p_aout, "cannot create PORTAUDIO thread" );
228 pa_thread->p_aout = p_aout;
229 pa_thread->b_wait = false;
230 pa_thread->b_signal = false;
231 pa_thread->b_error = false;
234 /* Signal start of stream */
235 vlc_mutex_lock( &pa_thread->lock_signal );
236 pa_thread->b_signal = true;
237 vlc_cond_signal( &pa_thread->signal );
238 vlc_mutex_unlock( &pa_thread->lock_signal );
240 /* Wait until thread is ready */
241 vlc_mutex_lock( &pa_thread->lock_wait );
242 if( !pa_thread->b_wait )
243 vlc_cond_wait( &pa_thread->wait, &pa_thread->lock_wait );
244 vlc_mutex_unlock( &pa_thread->lock_wait );
245 pa_thread->b_wait = false;
247 if( pa_thread->b_error )
249 msg_Err( p_aout, "PORTAUDIO thread failed" );
258 if( PAOpenDevice( p_aout ) != VLC_SUCCESS )
260 msg_Err( p_aout, "cannot open portaudio device" );
265 if( PAOpenStream( p_aout ) != VLC_SUCCESS )
267 msg_Err( p_aout, "cannot open portaudio device" );
275 /*****************************************************************************
276 * Close: close the audio device
277 *****************************************************************************/
278 static void Close ( vlc_object_t *p_this )
280 aout_instance_t *p_aout = (aout_instance_t *)p_this;
281 aout_sys_t *p_sys = p_aout->output.p_sys;
284 msg_Dbg( p_aout, "closing portaudio");
286 #ifdef PORTAUDIO_IS_SERIOUSLY_BROKEN
288 /* Signal end of stream */
289 vlc_mutex_lock( &pa_thread->lock_signal );
290 pa_thread->b_signal = true;
291 vlc_cond_signal( &pa_thread->signal );
292 vlc_mutex_unlock( &pa_thread->lock_signal );
294 /* Wait until thread is ready */
295 vlc_mutex_lock( &pa_thread->lock_wait );
296 if( !pa_thread->b_wait )
297 vlc_cond_wait( &pa_thread->wait, &pa_thread->lock_wait );
298 vlc_mutex_unlock( &pa_thread->lock_wait );
299 pa_thread->b_wait = false;
303 i_err = Pa_StopStream( p_sys->p_stream );
304 if( i_err != paNoError )
306 msg_Err( p_aout, "Pa_StopStream: %d (%s)", i_err,
307 Pa_GetErrorText( i_err ) );
309 i_err = Pa_CloseStream( p_sys->p_stream );
310 if( i_err != paNoError )
312 msg_Err( p_aout, "Pa_CloseStream: %d (%s)", i_err,
313 Pa_GetErrorText( i_err ) );
316 i_err = Pa_Terminate();
317 if( i_err != paNoError )
319 msg_Err( p_aout, "Pa_Terminate: %d (%s)", i_err,
320 Pa_GetErrorText( i_err ) );
325 msg_Dbg( p_aout, "portaudio closed");
329 static int PAOpenDevice( aout_instance_t *p_aout )
331 aout_sys_t *p_sys = p_aout->output.p_sys;
332 const PaDeviceInfo *p_pdi;
334 vlc_value_t val, text;
337 /* Initialize portaudio */
338 i_err = Pa_Initialize();
339 if( i_err != paNoError )
341 msg_Err( p_aout, "Pa_Initialize returned %d : %s",
342 i_err, Pa_GetErrorText( i_err ) );
347 p_sys->i_devices = Pa_GetDeviceCount();
348 if( p_sys->i_devices < 0 )
350 i_err = p_sys->i_devices;
351 msg_Err( p_aout, "Pa_GetDeviceCount returned %d : %s", i_err,
352 Pa_GetErrorText( i_err ) );
357 /* Display all devices info */
358 msg_Dbg( p_aout, "number of devices = %d", p_sys->i_devices );
359 for( i = 0; i < p_sys->i_devices; i++ )
361 p_pdi = Pa_GetDeviceInfo( i );
362 msg_Dbg( p_aout, "------------------------------------- #%d", i );
363 msg_Dbg( p_aout, "Name = %s", p_pdi->name );
364 msg_Dbg( p_aout, "Max Inputs = %d, Max Outputs = %d",
365 p_pdi->maxInputChannels, p_pdi->maxOutputChannels );
367 msg_Dbg( p_aout, "-------------------------------------" );
369 msg_Dbg( p_aout, "requested device is #%d", p_sys->i_device_id );
370 if( p_sys->i_device_id >= p_sys->i_devices )
372 msg_Err( p_aout, "device %d does not exist", p_sys->i_device_id );
375 p_sys->deviceInfo = Pa_GetDeviceInfo( p_sys->i_device_id );
377 if( p_sys->deviceInfo->maxOutputChannels < 1 )
379 msg_Err( p_aout, "no channel available" );
383 if( var_Type( p_aout, "audio-device" ) == 0 )
385 var_Create( p_aout, "audio-device", VLC_VAR_INTEGER|VLC_VAR_HASCHOICE);
386 text.psz_string = _("Audio Device");
387 var_Change( p_aout, "audio-device", VLC_VAR_SETTEXT, &text, NULL );
389 if( p_sys->deviceInfo->maxOutputChannels >= 1 )
391 val.i_int = AOUT_VAR_MONO;
392 text.psz_string = _("Mono");
393 var_Change( p_aout, "audio-device", VLC_VAR_ADDCHOICE,
395 msg_Dbg( p_aout, "device supports 1 channel" );
397 if( p_sys->deviceInfo->maxOutputChannels >= 2 )
399 val.i_int = AOUT_VAR_STEREO;
400 text.psz_string = _("Stereo");
401 var_Change( p_aout, "audio-device", VLC_VAR_ADDCHOICE,
403 var_Change( p_aout, "audio-device", VLC_VAR_SETDEFAULT,
405 var_Set( p_aout, "audio-device", val );
406 msg_Dbg( p_aout, "device supports 2 channels" );
408 if( p_sys->deviceInfo->maxOutputChannels >= 4 )
410 val.i_int = AOUT_VAR_2F2R;
411 text.psz_string = _("2 Front 2 Rear");
412 var_Change( p_aout, "audio-device", VLC_VAR_ADDCHOICE,
414 msg_Dbg( p_aout, "device supports 4 channels" );
416 if( p_sys->deviceInfo->maxOutputChannels >= 5 )
418 val.i_int = AOUT_VAR_3F2R;
419 text.psz_string = _("3 Front 2 Rear");
420 var_Change( p_aout, "audio-device",
421 VLC_VAR_ADDCHOICE, &val, &text );
422 msg_Dbg( p_aout, "device supports 5 channels" );
424 if( p_sys->deviceInfo->maxOutputChannels >= 6 )
426 val.i_int = AOUT_VAR_5_1;
427 text.psz_string = "5.1";
428 var_Change( p_aout, "audio-device", VLC_VAR_ADDCHOICE,
430 msg_Dbg( p_aout, "device supports 5.1 channels" );
433 var_AddCallback( p_aout, "audio-device", aout_ChannelsRestart, NULL );
434 var_SetBool( p_aout, "intf-change", true );
437 /* Audio format is paFloat32 (always supported by portaudio v19) */
438 p_aout->output.output.i_format = VLC_FOURCC('f','l','3','2');
443 if( ( i_err = Pa_Terminate() ) != paNoError )
445 msg_Err( p_aout, "Pa_Terminate returned %d", i_err );
450 static int PAOpenStream( aout_instance_t *p_aout )
452 aout_sys_t *p_sys = p_aout->output.p_sys;
453 const PaHostErrorInfo* paLastHostErrorInfo = Pa_GetLastHostErrorInfo();
454 PaStreamParameters paStreamParameters;
456 int i_channels, i_err;
457 uint32_t i_channel_mask;
459 if( var_Get( p_aout, "audio-device", &val ) < 0 )
464 if( val.i_int == AOUT_VAR_5_1 )
466 p_aout->output.output.i_physical_channels
467 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_CENTER
468 | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT
471 else if( val.i_int == AOUT_VAR_3F2R )
473 p_aout->output.output.i_physical_channels
474 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_CENTER
475 | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT;
477 else if( val.i_int == AOUT_VAR_2F2R )
479 p_aout->output.output.i_physical_channels
480 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT
481 | AOUT_CHAN_REARLEFT | AOUT_CHAN_REARRIGHT;
483 else if( val.i_int == AOUT_VAR_MONO )
485 p_aout->output.output.i_physical_channels = AOUT_CHAN_CENTER;
489 p_aout->output.output.i_physical_channels
490 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT;
493 i_channels = aout_FormatNbChannels( &p_aout->output.output );
494 msg_Dbg( p_aout, "nb_channels requested = %d", i_channels );
495 i_channel_mask = p_aout->output.output.i_physical_channels;
497 /* Calculate the frame size in bytes */
498 p_sys->i_sample_size = 4 * i_channels;
499 p_aout->output.i_nb_samples = FRAME_SIZE;
500 aout_FormatPrepare( &p_aout->output.output );
501 aout_VolumeSoftInit( p_aout );
503 /* Check for channel reordering */
504 p_aout->output.p_sys->i_channel_mask = i_channel_mask;
505 p_aout->output.p_sys->i_bits_per_sample = 32; /* forced to paFloat32 */
506 p_aout->output.p_sys->i_channels = i_channels;
508 p_aout->output.p_sys->b_chan_reorder =
509 aout_CheckChannelReorder( NULL, pi_channels_out,
510 i_channel_mask, i_channels,
511 p_aout->output.p_sys->pi_chan_table );
513 if( p_aout->output.p_sys->b_chan_reorder )
515 msg_Dbg( p_aout, "channel reordering needed" );
518 paStreamParameters.device = p_sys->i_device_id;
519 paStreamParameters.channelCount = i_channels;
520 paStreamParameters.sampleFormat = paFloat32;
521 paStreamParameters.suggestedLatency =
522 p_sys->deviceInfo->defaultLowOutputLatency;
523 paStreamParameters.hostApiSpecificStreamInfo = NULL;
525 i_err = Pa_OpenStream( &p_sys->p_stream, NULL /* no input */,
526 &paStreamParameters, (double)p_aout->output.output.i_rate,
527 FRAME_SIZE, paClipOff, paCallback, p_sys );
528 if( i_err != paNoError )
530 msg_Err( p_aout, "Pa_OpenStream returns %d : %s", i_err,
531 Pa_GetErrorText( i_err ) );
532 if( i_err == paUnanticipatedHostError )
534 msg_Err( p_aout, "type %d code %ld : %s",
535 paLastHostErrorInfo->hostApiType,
536 paLastHostErrorInfo->errorCode,
537 paLastHostErrorInfo->errorText );
543 i_err = Pa_StartStream( p_sys->p_stream );
544 if( i_err != paNoError )
546 msg_Err( p_aout, "Pa_StartStream() failed" );
547 Pa_CloseStream( p_sys->p_stream );
554 /*****************************************************************************
556 *****************************************************************************/
557 static void Play( aout_instance_t * p_aout )
561 #ifdef PORTAUDIO_IS_SERIOUSLY_BROKEN
562 /*****************************************************************************
563 * PORTAUDIOThread: all interactions with libportaudio.a are handled
564 * in this single thread. Otherwise libportaudio.a is _not_ happy :-(
565 *****************************************************************************/
566 static void* PORTAUDIOThread( vlc_object_t *p_this )
568 pa_thread_t *pa_thread = (pa_thread_t*)p_this;
569 aout_instance_t *p_aout;
572 int canc = vlc_savecancel ();
574 while( vlc_object_alive (pa_thread) )
576 /* Wait for start of stream */
577 vlc_mutex_lock( &pa_thread->lock_signal );
578 if( !pa_thread->b_signal )
579 vlc_cond_wait( &pa_thread->signal, &pa_thread->lock_signal );
580 vlc_mutex_unlock( &pa_thread->lock_signal );
581 pa_thread->b_signal = false;
583 p_aout = pa_thread->p_aout;
584 p_sys = p_aout->output.p_sys;
586 if( PAOpenDevice( p_aout ) != VLC_SUCCESS )
588 msg_Err( p_aout, "cannot open portaudio device" );
589 pa_thread->b_error = true;
592 if( !pa_thread->b_error && PAOpenStream( p_aout ) != VLC_SUCCESS )
594 msg_Err( p_aout, "cannot open portaudio device" );
595 pa_thread->b_error = true;
597 i_err = Pa_Terminate();
598 if( i_err != paNoError )
600 msg_Err( p_aout, "Pa_Terminate: %d (%s)", i_err,
601 Pa_GetErrorText( i_err ) );
605 /* Tell the main thread that we are ready */
606 vlc_mutex_lock( &pa_thread->lock_wait );
607 pa_thread->b_wait = true;
608 vlc_cond_signal( &pa_thread->wait );
609 vlc_mutex_unlock( &pa_thread->lock_wait );
611 /* Wait for end of stream */
612 vlc_mutex_lock( &pa_thread->lock_signal );
613 if( !pa_thread->b_signal )
614 vlc_cond_wait( &pa_thread->signal, &pa_thread->lock_signal );
615 vlc_mutex_unlock( &pa_thread->lock_signal );
616 pa_thread->b_signal = false;
618 if( pa_thread->b_error ) continue;
620 i_err = Pa_StopStream( p_sys->p_stream );
621 if( i_err != paNoError )
623 msg_Err( p_aout, "Pa_StopStream: %d (%s)", i_err,
624 Pa_GetErrorText( i_err ) );
626 i_err = Pa_CloseStream( p_sys->p_stream );
627 if( i_err != paNoError )
629 msg_Err( p_aout, "Pa_CloseStream: %d (%s)", i_err,
630 Pa_GetErrorText( i_err ) );
632 i_err = Pa_Terminate();
633 if( i_err != paNoError )
635 msg_Err( p_aout, "Pa_Terminate: %d (%s)", i_err,
636 Pa_GetErrorText( i_err ) );
639 /* Tell the main thread that we are ready */
640 vlc_mutex_lock( &pa_thread->lock_wait );
641 pa_thread->b_wait = true;
642 vlc_cond_signal( &pa_thread->wait );
643 vlc_mutex_unlock( &pa_thread->lock_wait );
645 vlc_restorecancel (canc);