1 /*****************************************************************************
2 * output.c : internal management of output streams for the audio output
3 *****************************************************************************
4 * Copyright (C) 2002 VideoLAN
5 * $Id: output.c,v 1.33 2003/01/23 17:13:28 massiot Exp $
7 * Authors: Christophe Massiot <massiot@via.ecp.fr>
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> /* calloc(), malloc(), free() */
32 #include "audio_output.h"
33 #include "aout_internal.h"
35 /*****************************************************************************
36 * aout_OutputNew : allocate a new output and rework the filter pipeline
37 *****************************************************************************
38 * This function is entered with the mixer lock.
39 *****************************************************************************/
40 int aout_OutputNew( aout_instance_t * p_aout,
41 audio_sample_format_t * p_format )
43 /* Retrieve user defaults. */
44 char * psz_name = config_GetPsz( p_aout, "aout" );
45 int i_rate = config_GetInt( p_aout, "aout-rate" );
48 memcpy( &p_aout->output.output, p_format, sizeof(audio_sample_format_t) );
50 p_aout->output.output.i_rate = i_rate;
51 aout_FormatPrepare( &p_aout->output.output );
53 vlc_mutex_lock( &p_aout->output_fifo_lock );
55 /* Find the best output plug-in. */
56 p_aout->output.p_module = module_Need( p_aout, "audio output",
58 if ( psz_name != NULL ) free( psz_name );
59 if ( p_aout->output.p_module == NULL )
61 msg_Err( p_aout, "no suitable aout module" );
62 vlc_mutex_unlock( &p_aout->output_fifo_lock );
66 if ( var_Type( p_aout, "audio-channels" ) ==
67 (VLC_VAR_STRING | VLC_VAR_HASCHOICE) )
69 /* The user may have selected a different channels configuration. */
70 var_Get( p_aout, "audio-channels", &val );
72 if ( !strcmp( val.psz_string, N_("Reverse stereo") ) )
74 p_aout->output.output.i_original_channels |=
75 AOUT_CHAN_REVERSESTEREO;
77 else if ( !strcmp( val.psz_string, N_("Both") ) )
79 p_aout->output.output.i_original_channels =
80 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT;
82 else if ( !strcmp( val.psz_string, N_("Left") ) )
84 p_aout->output.output.i_original_channels = AOUT_CHAN_LEFT;
86 else if ( !strcmp( val.psz_string, N_("Right") ) )
88 p_aout->output.output.i_original_channels = AOUT_CHAN_RIGHT;
90 else if ( !strcmp( val.psz_string, N_("Dolby Surround") ) )
92 p_aout->output.output.i_original_channels
93 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_DOLBYSTEREO;
95 free( val.psz_string );
97 else if ( p_aout->output.output.i_physical_channels == AOUT_CHAN_CENTER
98 && (p_aout->output.output.i_original_channels
99 & AOUT_CHAN_PHYSMASK) == (AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT) )
101 /* Mono - create the audio-channels variable. */
102 var_Create( p_aout, "audio-channels", VLC_VAR_STRING | VLC_VAR_HASCHOICE );
103 val.psz_string = N_("Both");
104 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
105 val.psz_string = N_("Left");
106 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
107 val.psz_string = N_("Right");
108 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
109 if ( p_aout->output.output.i_original_channels & AOUT_CHAN_DUALMONO )
111 /* Go directly to the left channel. */
112 p_aout->output.output.i_original_channels = AOUT_CHAN_LEFT;
113 val.psz_string = N_("Left");
114 var_Set( p_aout, "audio-channels", val );
116 var_AddCallback( p_aout, "audio-channels", aout_ChannelsRestart,
119 else if ( p_aout->output.output.i_physical_channels ==
120 (AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT) )
122 /* Stereo - create the audio-channels variable. */
123 var_Create( p_aout, "audio-channels", VLC_VAR_STRING | VLC_VAR_HASCHOICE );
124 if ( p_aout->output.output.i_original_channels & AOUT_CHAN_DOLBYSTEREO )
126 val.psz_string = N_("Dolby Surround");
130 val.psz_string = N_("Both");
132 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
133 val.psz_string = N_("Left");
134 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
135 val.psz_string = N_("Right");
136 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
137 val.psz_string = N_("Reverse stereo");
138 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
139 if ( p_aout->output.output.i_original_channels & AOUT_CHAN_DUALMONO )
141 /* Go directly to the left channel. */
142 p_aout->output.output.i_original_channels = AOUT_CHAN_LEFT;
143 val.psz_string = N_("Left");
144 var_Set( p_aout, "audio-channels", val );
146 var_AddCallback( p_aout, "audio-channels", aout_ChannelsRestart,
149 val.b_bool = VLC_TRUE;
150 var_Set( p_aout, "intf-change", val );
152 aout_FormatPrepare( &p_aout->output.output );
155 aout_FifoInit( p_aout, &p_aout->output.fifo,
156 p_aout->output.output.i_rate );
158 vlc_mutex_unlock( &p_aout->output_fifo_lock );
160 aout_FormatPrint( p_aout, "output", &p_aout->output.output );
162 /* Calculate the resulting mixer output format. */
163 memcpy( &p_aout->mixer.mixer, &p_aout->output.output,
164 sizeof(audio_sample_format_t) );
165 if ( !AOUT_FMT_NON_LINEAR(&p_aout->output.output) )
167 /* Non-S/PDIF mixer only deals with float32 or fixed32. */
168 p_aout->mixer.mixer.i_format
169 = (p_aout->p_libvlc->i_cpu & CPU_CAPABILITY_FPU) ?
170 VLC_FOURCC('f','l','3','2') :
171 VLC_FOURCC('f','i','3','2');
172 aout_FormatPrepare( &p_aout->mixer.mixer );
176 p_aout->mixer.mixer.i_format = p_format->i_format;
179 aout_FormatPrint( p_aout, "mixer", &p_aout->output.output );
181 /* Create filters. */
182 if ( aout_FiltersCreatePipeline( p_aout, p_aout->output.pp_filters,
183 &p_aout->output.i_nb_filters,
184 &p_aout->mixer.mixer,
185 &p_aout->output.output ) < 0 )
187 msg_Err( p_aout, "couldn't set an output pipeline" );
188 module_Unneed( p_aout, p_aout->output.p_module );
192 /* Prepare hints for the buffer allocator. */
193 p_aout->mixer.output_alloc.i_alloc_type = AOUT_ALLOC_HEAP;
194 p_aout->mixer.output_alloc.i_bytes_per_sec
195 = p_aout->mixer.mixer.i_bytes_per_frame
196 * p_aout->mixer.mixer.i_rate
197 / p_aout->mixer.mixer.i_frame_length;
199 aout_FiltersHintBuffers( p_aout, p_aout->output.pp_filters,
200 p_aout->output.i_nb_filters,
201 &p_aout->mixer.output_alloc );
203 p_aout->output.b_error = 0;
207 /*****************************************************************************
208 * aout_OutputDelete : delete the output
209 *****************************************************************************
210 * This function is entered with the mixer lock.
211 *****************************************************************************/
212 void aout_OutputDelete( aout_instance_t * p_aout )
214 if ( p_aout->output.b_error ) return 0;
215 module_Unneed( p_aout, p_aout->output.p_module );
217 aout_FiltersDestroyPipeline( p_aout, p_aout->output.pp_filters,
218 p_aout->output.i_nb_filters );
219 aout_FifoDestroy( p_aout, &p_aout->output.fifo );
221 p_aout->output.b_error = 1;
224 /*****************************************************************************
225 * aout_OutputPlay : play a buffer
226 *****************************************************************************
227 * This function is entered with the mixer lock.
228 *****************************************************************************/
229 void aout_OutputPlay( aout_instance_t * p_aout, aout_buffer_t * p_buffer )
231 aout_FiltersPlay( p_aout, p_aout->output.pp_filters,
232 p_aout->output.i_nb_filters,
235 vlc_mutex_lock( &p_aout->output_fifo_lock );
236 aout_FifoPush( p_aout, &p_aout->output.fifo, p_buffer );
237 p_aout->output.pf_play( p_aout );
238 vlc_mutex_unlock( &p_aout->output_fifo_lock );
241 /*****************************************************************************
242 * aout_OutputNextBuffer : give the audio output plug-in the right buffer
243 *****************************************************************************
244 * If b_can_sleek is 1, the aout core functions won't try to resample
245 * new buffers to catch up - that is we suppose that the output plug-in can
246 * compensate it by itself. S/PDIF outputs should always set b_can_sleek = 1.
247 * This function is entered with no lock at all :-).
248 *****************************************************************************/
249 aout_buffer_t * aout_OutputNextBuffer( aout_instance_t * p_aout,
251 vlc_bool_t b_can_sleek )
253 aout_buffer_t * p_buffer;
255 vlc_mutex_lock( &p_aout->output_fifo_lock );
257 p_buffer = p_aout->output.fifo.p_first;
258 while ( p_buffer && p_buffer->start_date < mdate() )
260 msg_Dbg( p_aout, "audio output is too slow ("I64Fd"), "
261 "trashing "I64Fd"us", mdate() - p_buffer->start_date,
262 p_buffer->end_date - p_buffer->start_date );
263 p_buffer = p_buffer->p_next;
264 aout_BufferFree( p_aout->output.fifo.p_first );
265 p_aout->output.fifo.p_first = p_buffer;
268 if ( p_buffer == NULL )
270 p_aout->output.fifo.pp_last = &p_aout->output.fifo.p_first;
272 #if 0 /* This is bad because the audio output might just be trying to fill
273 * in it's internal buffers. And anyway, it's up to the audio output
274 * to deal with this kind of starvation. */
276 /* Set date to 0, to allow the mixer to send a new buffer ASAP */
277 aout_FifoSet( p_aout, &p_aout->output.fifo, 0 );
278 if ( !p_aout->output.b_starving )
280 "audio output is starving (no input), playing silence" );
281 p_aout->output.b_starving = 1;
284 vlc_mutex_unlock( &p_aout->output_fifo_lock );
288 /* Here we suppose that all buffers have the same duration - this is
289 * generally true, and anyway if it's wrong it won't be a disaster. */
290 if ( p_buffer->start_date > start_date
291 + (p_buffer->end_date - p_buffer->start_date) )
293 vlc_mutex_unlock( &p_aout->output_fifo_lock );
294 if ( !p_aout->output.b_starving )
295 msg_Dbg( p_aout, "audio output is starving ("I64Fd"), "
296 "playing silence", p_buffer->start_date - start_date );
297 p_aout->output.b_starving = 1;
301 p_aout->output.b_starving = 0;
304 ( (p_buffer->start_date - start_date > AOUT_PTS_TOLERANCE)
305 || (start_date - p_buffer->start_date > AOUT_PTS_TOLERANCE) ) )
307 /* Try to compensate the drift by doing some resampling. */
309 mtime_t difference = start_date - p_buffer->start_date;
310 msg_Warn( p_aout, "output date isn't PTS date, requesting "
311 "resampling ("I64Fd")", difference );
313 vlc_mutex_lock( &p_aout->input_fifos_lock );
314 for ( i = 0; i < p_aout->i_nb_inputs; i++ )
316 aout_fifo_t * p_fifo = &p_aout->pp_inputs[i]->fifo;
318 aout_FifoMoveDates( p_aout, p_fifo, difference );
321 aout_FifoMoveDates( p_aout, &p_aout->output.fifo, difference );
322 vlc_mutex_unlock( &p_aout->input_fifos_lock );
325 p_aout->output.fifo.p_first = p_buffer->p_next;
326 if ( p_buffer->p_next == NULL )
328 p_aout->output.fifo.pp_last = &p_aout->output.fifo.p_first;
331 vlc_mutex_unlock( &p_aout->output_fifo_lock );