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.29 2003/01/20 10:59:29 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_("Both") ) )
74 p_aout->output.output.i_original_channels =
75 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT;
77 else if ( !strcmp( val.psz_string, N_("Left") ) )
79 p_aout->output.output.i_original_channels = AOUT_CHAN_LEFT;
81 else if ( !strcmp( val.psz_string, N_("Right") ) )
83 p_aout->output.output.i_original_channels = AOUT_CHAN_RIGHT;
85 else if ( !strcmp( val.psz_string, N_("Dolby Surround") ) )
87 p_aout->output.output.i_original_channels
88 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_DOLBYSTEREO;
90 free( val.psz_string );
92 else if ( p_aout->output.output.i_physical_channels == AOUT_CHAN_CENTER
93 && (p_aout->output.output.i_original_channels
94 & AOUT_CHAN_PHYSMASK) == (AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT) )
96 /* Mono - create the audio-channels variable. */
97 var_Create( p_aout, "audio-channels", VLC_VAR_STRING | VLC_VAR_HASCHOICE );
98 if ( p_aout->output.output.i_original_channels & AOUT_CHAN_DUALMONO )
100 /* Go directly to the left channel. */
101 p_aout->output.output.i_original_channels = AOUT_CHAN_LEFT;
105 val.psz_string = N_("Both");
106 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
108 val.psz_string = N_("Left");
109 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
110 val.psz_string = N_("Right");
111 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
112 var_AddCallback( p_aout, "audio-channels", aout_ChannelsRestart,
115 else if ( p_aout->output.output.i_physical_channels ==
116 (AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT)
117 && (p_aout->output.output.i_original_channels
118 & AOUT_CHAN_PHYSMASK) == (AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT) )
120 /* Stereo - create the audio-channels variable. */
121 var_Create( p_aout, "audio-channels", VLC_VAR_STRING | VLC_VAR_HASCHOICE );
122 val.psz_string = N_("Both");
123 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
124 val.psz_string = N_("Left");
125 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
126 val.psz_string = N_("Right");
127 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
128 if ( p_aout->output.output.i_original_channels & AOUT_CHAN_DOLBYSTEREO )
130 val.psz_string = N_("Dolby Surround");
131 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
133 p_aout->output.output.i_original_channels &= ~AOUT_CHAN_DOLBYSTEREO;
134 var_AddCallback( p_aout, "audio-channels", aout_ChannelsRestart,
137 val.b_bool = VLC_TRUE;
138 var_Set( p_aout, "intf-change", val );
140 aout_FormatPrepare( &p_aout->output.output );
143 aout_FifoInit( p_aout, &p_aout->output.fifo,
144 p_aout->output.output.i_rate );
146 vlc_mutex_unlock( &p_aout->output_fifo_lock );
148 aout_FormatPrint( p_aout, "output", &p_aout->output.output );
150 /* Calculate the resulting mixer output format. */
151 memcpy( &p_aout->mixer.mixer, &p_aout->output.output,
152 sizeof(audio_sample_format_t) );
153 if ( !AOUT_FMT_NON_LINEAR(&p_aout->output.output) )
155 /* Non-S/PDIF mixer only deals with float32 or fixed32. */
156 p_aout->mixer.mixer.i_format
157 = (p_aout->p_libvlc->i_cpu & CPU_CAPABILITY_FPU) ?
158 VLC_FOURCC('f','l','3','2') :
159 VLC_FOURCC('f','i','3','2');
160 aout_FormatPrepare( &p_aout->mixer.mixer );
164 p_aout->mixer.mixer.i_format = p_format->i_format;
167 aout_FormatPrint( p_aout, "mixer", &p_aout->output.output );
169 /* Create filters. */
170 if ( aout_FiltersCreatePipeline( p_aout, p_aout->output.pp_filters,
171 &p_aout->output.i_nb_filters,
172 &p_aout->mixer.mixer,
173 &p_aout->output.output ) < 0 )
175 msg_Err( p_aout, "couldn't set an output pipeline" );
176 module_Unneed( p_aout, p_aout->output.p_module );
180 /* Prepare hints for the buffer allocator. */
181 p_aout->mixer.output_alloc.i_alloc_type = AOUT_ALLOC_HEAP;
182 p_aout->mixer.output_alloc.i_bytes_per_sec
183 = p_aout->mixer.mixer.i_bytes_per_frame
184 * p_aout->mixer.mixer.i_rate
185 / p_aout->mixer.mixer.i_frame_length;
187 aout_FiltersHintBuffers( p_aout, p_aout->output.pp_filters,
188 p_aout->output.i_nb_filters,
189 &p_aout->mixer.output_alloc );
194 /*****************************************************************************
195 * aout_OutputDelete : delete the output
196 *****************************************************************************
197 * This function is entered with the mixer lock.
198 *****************************************************************************/
199 void aout_OutputDelete( aout_instance_t * p_aout )
201 module_Unneed( p_aout, p_aout->output.p_module );
203 aout_FiltersDestroyPipeline( p_aout, p_aout->output.pp_filters,
204 p_aout->output.i_nb_filters );
205 aout_FifoDestroy( p_aout, &p_aout->output.fifo );
208 /*****************************************************************************
209 * aout_OutputPlay : play a buffer
210 *****************************************************************************
211 * This function is entered with the mixer lock.
212 *****************************************************************************/
213 void aout_OutputPlay( aout_instance_t * p_aout, aout_buffer_t * p_buffer )
215 aout_FiltersPlay( p_aout, p_aout->output.pp_filters,
216 p_aout->output.i_nb_filters,
219 vlc_mutex_lock( &p_aout->output_fifo_lock );
220 aout_FifoPush( p_aout, &p_aout->output.fifo, p_buffer );
221 p_aout->output.pf_play( p_aout );
222 vlc_mutex_unlock( &p_aout->output_fifo_lock );
225 /*****************************************************************************
226 * aout_OutputNextBuffer : give the audio output plug-in the right buffer
227 *****************************************************************************
228 * If b_can_sleek is 1, the aout core functions won't try to resample
229 * new buffers to catch up - that is we suppose that the output plug-in can
230 * compensate it by itself. S/PDIF outputs should always set b_can_sleek = 1.
231 * This function is entered with no lock at all :-).
232 *****************************************************************************/
233 aout_buffer_t * aout_OutputNextBuffer( aout_instance_t * p_aout,
235 vlc_bool_t b_can_sleek )
237 aout_buffer_t * p_buffer;
239 vlc_mutex_lock( &p_aout->output_fifo_lock );
241 p_buffer = p_aout->output.fifo.p_first;
242 while ( p_buffer && p_buffer->start_date < mdate() )
244 msg_Dbg( p_aout, "audio output is too slow ("I64Fd"), "
245 "trashing "I64Fd"us", mdate() - p_buffer->start_date,
246 p_buffer->end_date - p_buffer->start_date );
247 p_buffer = p_buffer->p_next;
248 aout_BufferFree( p_aout->output.fifo.p_first );
249 p_aout->output.fifo.p_first = p_buffer;
252 if ( p_buffer == NULL )
254 p_aout->output.fifo.pp_last = &p_aout->output.fifo.p_first;
256 #if 0 /* This is bad because the audio output might just be trying to fill
257 * in it's internal buffers. And anyway, it's up to the audio output
258 * to deal with this kind of starvation. */
260 /* Set date to 0, to allow the mixer to send a new buffer ASAP */
261 aout_FifoSet( p_aout, &p_aout->output.fifo, 0 );
262 if ( !p_aout->output.b_starving )
264 "audio output is starving (no input), playing silence" );
265 p_aout->output.b_starving = 1;
268 vlc_mutex_unlock( &p_aout->output_fifo_lock );
272 /* Here we suppose that all buffers have the same duration - this is
273 * generally true, and anyway if it's wrong it won't be a disaster. */
274 if ( p_buffer->start_date > start_date
275 + (p_buffer->end_date - p_buffer->start_date) )
277 vlc_mutex_unlock( &p_aout->output_fifo_lock );
278 if ( !p_aout->output.b_starving )
279 msg_Dbg( p_aout, "audio output is starving ("I64Fd"), "
280 "playing silence", p_buffer->start_date - start_date );
281 p_aout->output.b_starving = 1;
285 p_aout->output.b_starving = 0;
288 ( (p_buffer->start_date - start_date > AOUT_PTS_TOLERANCE)
289 || (start_date - p_buffer->start_date > AOUT_PTS_TOLERANCE) ) )
291 /* Try to compensate the drift by doing some resampling. */
293 mtime_t difference = start_date - p_buffer->start_date;
294 msg_Warn( p_aout, "output date isn't PTS date, requesting "
295 "resampling ("I64Fd")", difference );
297 vlc_mutex_lock( &p_aout->input_fifos_lock );
298 for ( i = 0; i < p_aout->i_nb_inputs; i++ )
300 aout_fifo_t * p_fifo = &p_aout->pp_inputs[i]->fifo;
302 aout_FifoMoveDates( p_aout, p_fifo, difference );
305 aout_FifoMoveDates( p_aout, &p_aout->output.fifo, difference );
306 vlc_mutex_unlock( &p_aout->input_fifos_lock );
309 p_aout->output.fifo.p_first = p_buffer->p_next;
310 if ( p_buffer->p_next == NULL )
312 p_aout->output.fifo.pp_last = &p_aout->output.fifo.p_first;
315 vlc_mutex_unlock( &p_aout->output_fifo_lock );