1 /*****************************************************************************
2 * output.c : internal management of output streams for the audio output
3 *****************************************************************************
4 * Copyright (C) 2002-2004 the VideoLAN team
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., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22 *****************************************************************************/
24 /*****************************************************************************
26 *****************************************************************************/
31 #include <vlc_common.h>
35 #include "aout_internal.h"
37 /*****************************************************************************
38 * aout_OutputNew : allocate a new output and rework the filter pipeline
39 *****************************************************************************
40 * This function is entered with the mixer lock.
41 *****************************************************************************/
42 int aout_OutputNew( aout_instance_t * p_aout,
43 audio_sample_format_t * p_format )
45 /* Retrieve user defaults. */
46 int i_rate = config_GetInt( p_aout, "aout-rate" );
47 vlc_value_t val, text;
48 /* kludge to avoid a fpu error when rate is 0... */
49 if( i_rate == 0 ) i_rate = -1;
51 memcpy( &p_aout->output.output, p_format, sizeof(audio_sample_format_t) );
53 p_aout->output.output.i_rate = i_rate;
54 aout_FormatPrepare( &p_aout->output.output );
56 aout_lock_output_fifo( p_aout );
58 /* Find the best output plug-in. */
59 p_aout->output.p_module = module_need( p_aout, "audio output", "$aout", false );
60 if ( p_aout->output.p_module == NULL )
62 msg_Err( p_aout, "no suitable audio output module" );
63 aout_unlock_output_fifo( p_aout );
67 if ( var_Type( p_aout, "audio-channels" ) ==
68 (VLC_VAR_INTEGER | VLC_VAR_HASCHOICE) )
70 /* The user may have selected a different channels configuration. */
71 var_Get( p_aout, "audio-channels", &val );
73 if ( val.i_int == AOUT_VAR_CHAN_RSTEREO )
75 p_aout->output.output.i_original_channels |=
76 AOUT_CHAN_REVERSESTEREO;
78 else if ( val.i_int == AOUT_VAR_CHAN_STEREO )
80 p_aout->output.output.i_original_channels =
81 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT;
83 else if ( val.i_int == AOUT_VAR_CHAN_LEFT )
85 p_aout->output.output.i_original_channels = AOUT_CHAN_LEFT;
87 else if ( val.i_int == AOUT_VAR_CHAN_RIGHT )
89 p_aout->output.output.i_original_channels = AOUT_CHAN_RIGHT;
91 else if ( val.i_int == AOUT_VAR_CHAN_DOLBYS )
93 p_aout->output.output.i_original_channels
94 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_DOLBYSTEREO;
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",
103 VLC_VAR_INTEGER | VLC_VAR_HASCHOICE );
104 text.psz_string = _("Audio Channels");
105 var_Change( p_aout, "audio-channels", VLC_VAR_SETTEXT, &text, NULL );
107 val.i_int = AOUT_VAR_CHAN_STEREO; text.psz_string = _("Stereo");
108 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val, &text );
109 val.i_int = AOUT_VAR_CHAN_LEFT; text.psz_string = _("Left");
110 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val, &text );
111 val.i_int = AOUT_VAR_CHAN_RIGHT; text.psz_string = _("Right");
112 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val, &text );
113 if ( p_aout->output.output.i_original_channels & AOUT_CHAN_DUALMONO )
115 /* Go directly to the left channel. */
116 p_aout->output.output.i_original_channels = AOUT_CHAN_LEFT;
117 val.i_int = AOUT_VAR_CHAN_LEFT;
118 var_Set( p_aout, "audio-channels", val );
120 var_AddCallback( p_aout, "audio-channels", aout_ChannelsRestart,
123 else if ( p_aout->output.output.i_physical_channels ==
124 (AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT)
125 && (p_aout->output.output.i_original_channels &
126 (AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT)) )
128 /* Stereo - create the audio-channels variable. */
129 var_Create( p_aout, "audio-channels",
130 VLC_VAR_INTEGER | VLC_VAR_HASCHOICE );
131 text.psz_string = _("Audio Channels");
132 var_Change( p_aout, "audio-channels", VLC_VAR_SETTEXT, &text, NULL );
134 if ( p_aout->output.output.i_original_channels & AOUT_CHAN_DOLBYSTEREO )
136 val.i_int = AOUT_VAR_CHAN_DOLBYS;
137 text.psz_string = _("Dolby Surround");
141 val.i_int = AOUT_VAR_CHAN_STEREO;
142 text.psz_string = _("Stereo");
144 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val, &text );
145 val.i_int = AOUT_VAR_CHAN_LEFT; text.psz_string = _("Left");
146 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val, &text );
147 val.i_int = AOUT_VAR_CHAN_RIGHT; text.psz_string = _("Right");
148 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val, &text );
149 val.i_int = AOUT_VAR_CHAN_RSTEREO; text.psz_string=_("Reverse stereo");
150 var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val, &text );
151 if ( p_aout->output.output.i_original_channels & AOUT_CHAN_DUALMONO )
153 /* Go directly to the left channel. */
154 p_aout->output.output.i_original_channels = AOUT_CHAN_LEFT;
155 val.i_int = AOUT_VAR_CHAN_LEFT;
156 var_Set( p_aout, "audio-channels", val );
158 var_AddCallback( p_aout, "audio-channels", aout_ChannelsRestart,
162 var_Set( p_aout, "intf-change", val );
164 aout_FormatPrepare( &p_aout->output.output );
167 aout_FifoInit( p_aout, &p_aout->output.fifo,
168 p_aout->output.output.i_rate );
170 aout_unlock_output_fifo( p_aout );
172 aout_FormatPrint( p_aout, "output", &p_aout->output.output );
174 /* Calculate the resulting mixer output format. */
175 p_aout->mixer_format = p_aout->output.output;
176 if ( !AOUT_FMT_NON_LINEAR(&p_aout->output.output) )
178 /* Non-S/PDIF mixer only deals with float32 or fixed32. */
179 p_aout->mixer_format.i_format
180 = (vlc_CPU() & CPU_CAPABILITY_FPU) ?
181 VLC_CODEC_FL32 : VLC_CODEC_FI32;
182 aout_FormatPrepare( &p_aout->mixer_format );
186 p_aout->mixer_format.i_format = p_format->i_format;
189 aout_FormatPrint( p_aout, "mixer", &p_aout->mixer_format );
191 /* Create filters. */
192 p_aout->output.i_nb_filters = 0;
193 if ( aout_FiltersCreatePipeline( p_aout, p_aout->output.pp_filters,
194 &p_aout->output.i_nb_filters,
195 &p_aout->mixer_format,
196 &p_aout->output.output ) < 0 )
198 msg_Err( p_aout, "couldn't create audio output pipeline" );
199 module_unneed( p_aout, p_aout->output.p_module );
203 /* Prepare hints for the buffer allocator. */
204 p_aout->mixer_allocation.b_alloc = true;
205 p_aout->mixer_allocation.i_bytes_per_sec
206 = p_aout->mixer_format.i_bytes_per_frame
207 * p_aout->mixer_format.i_rate
208 / p_aout->mixer_format.i_frame_length;
210 aout_FiltersHintBuffers( p_aout, p_aout->output.pp_filters,
211 p_aout->output.i_nb_filters,
212 &p_aout->mixer_allocation );
214 p_aout->output.b_error = 0;
218 /*****************************************************************************
219 * aout_OutputDelete : delete the output
220 *****************************************************************************
221 * This function is entered with the mixer lock.
222 *****************************************************************************/
223 void aout_OutputDelete( aout_instance_t * p_aout )
225 if ( p_aout->output.b_error )
230 module_unneed( p_aout, p_aout->output.p_module );
232 aout_FiltersDestroyPipeline( p_aout, p_aout->output.pp_filters,
233 p_aout->output.i_nb_filters );
235 aout_lock_output_fifo( p_aout );
236 aout_FifoDestroy( p_aout, &p_aout->output.fifo );
237 aout_unlock_output_fifo( p_aout );
239 p_aout->output.b_error = true;
242 /*****************************************************************************
243 * aout_OutputPlay : play a buffer
244 *****************************************************************************
245 * This function is entered with the mixer lock.
246 *****************************************************************************/
247 void aout_OutputPlay( aout_instance_t * p_aout, aout_buffer_t * p_buffer )
249 aout_FiltersPlay( p_aout, p_aout->output.pp_filters,
250 p_aout->output.i_nb_filters,
253 if( p_buffer->i_nb_bytes == 0 )
255 aout_BufferFree( p_buffer );
259 aout_lock_output_fifo( p_aout );
260 aout_FifoPush( p_aout, &p_aout->output.fifo, p_buffer );
261 p_aout->output.pf_play( p_aout );
262 aout_unlock_output_fifo( p_aout );
265 /*****************************************************************************
266 * aout_OutputNextBuffer : give the audio output plug-in the right buffer
267 *****************************************************************************
268 * If b_can_sleek is 1, the aout core functions won't try to resample
269 * new buffers to catch up - that is we suppose that the output plug-in can
270 * compensate it by itself. S/PDIF outputs should always set b_can_sleek = 1.
271 * This function is entered with no lock at all :-).
272 *****************************************************************************/
273 aout_buffer_t * aout_OutputNextBuffer( aout_instance_t * p_aout,
277 aout_buffer_t * p_buffer;
279 aout_lock_output_fifo( p_aout );
281 p_buffer = p_aout->output.fifo.p_first;
283 /* Drop the audio sample if the audio output is really late.
284 * In the case of b_can_sleek, we don't use a resampler so we need to be
285 * a lot more severe. */
286 while ( p_buffer && p_buffer->i_pts <
287 (b_can_sleek ? start_date : mdate()) - AOUT_PTS_TOLERANCE )
289 msg_Dbg( p_aout, "audio output is too slow (%"PRId64"), "
290 "trashing %"PRId64"us", mdate() - p_buffer->i_pts,
291 p_buffer->end_date - p_buffer->i_pts );
292 p_buffer = p_buffer->p_next;
293 aout_BufferFree( p_aout->output.fifo.p_first );
294 p_aout->output.fifo.p_first = p_buffer;
297 if ( p_buffer == NULL )
299 p_aout->output.fifo.pp_last = &p_aout->output.fifo.p_first;
301 #if 0 /* This is bad because the audio output might just be trying to fill
302 * in its internal buffers. And anyway, it's up to the audio output
303 * to deal with this kind of starvation. */
305 /* Set date to 0, to allow the mixer to send a new buffer ASAP */
306 aout_FifoSet( p_aout, &p_aout->output.fifo, 0 );
307 if ( !p_aout->output.b_starving )
309 "audio output is starving (no input), playing silence" );
310 p_aout->output.b_starving = 1;
313 aout_unlock_output_fifo( p_aout );
317 /* Here we suppose that all buffers have the same duration - this is
318 * generally true, and anyway if it's wrong it won't be a disaster.
320 if ( p_buffer->i_pts > start_date
321 + (p_buffer->end_date - p_buffer->i_pts) )
323 * + AOUT_PTS_TOLERANCE )
324 * There is no reason to want that, it just worsen the scheduling of
325 * an audio sample after an output starvation (ie. on start or on resume)
329 const mtime_t i_delta = p_buffer->i_pts - start_date;
330 aout_unlock_output_fifo( p_aout );
332 if ( !p_aout->output.b_starving )
333 msg_Dbg( p_aout, "audio output is starving (%"PRId64"), "
334 "playing silence", i_delta );
335 p_aout->output.b_starving = 1;
339 p_aout->output.b_starving = 0;
342 ( (p_buffer->i_pts - start_date > AOUT_PTS_TOLERANCE)
343 || (start_date - p_buffer->i_pts > AOUT_PTS_TOLERANCE) ) )
345 /* Try to compensate the drift by doing some resampling. */
347 mtime_t difference = start_date - p_buffer->i_pts;
348 msg_Warn( p_aout, "output date isn't PTS date, requesting "
349 "resampling (%"PRId64")", difference );
351 aout_lock_input_fifos( p_aout );
352 for ( i = 0; i < p_aout->i_nb_inputs; i++ )
354 aout_fifo_t * p_fifo = &p_aout->pp_inputs[i]->mixer.fifo;
356 aout_FifoMoveDates( p_aout, p_fifo, difference );
359 aout_FifoMoveDates( p_aout, &p_aout->output.fifo, difference );
360 aout_unlock_input_fifos( p_aout );
363 p_aout->output.fifo.p_first = p_buffer->p_next;
364 if ( p_buffer->p_next == NULL )
366 p_aout->output.fifo.pp_last = &p_aout->output.fifo.p_first;
369 aout_unlock_output_fifo( p_aout );