git.sesse.net Git - vlc/blob - src/audio_output/output.c

   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.24 2002/11/14 22:38:48 massiot Exp $
   6  *
   7  * Authors: Christophe Massiot <massiot@via.ecp.fr>
   8  *
   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.
  13  *
  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.
  18  *
  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  *****************************************************************************/
  23
  24 /*****************************************************************************
  25  * Preamble
  26  *****************************************************************************/
  27 #include <stdlib.h>                            /* calloc(), malloc(), free() */
  28 #include <string.h>
  29
  30 #include <vlc/vlc.h>
  31
  32 #include "audio_output.h"
  33 #include "aout_internal.h"
  34
  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 )
  42 {
  43     /* Retrieve user defaults. */
  44     char * psz_name = config_GetPsz( p_aout, "aout" );
  45     int i_rate = config_GetInt( p_aout, "aout-rate" );
  46
  47     memcpy( &p_aout->output.output, p_format, sizeof(audio_sample_format_t) );
  48     if ( i_rate != -1 )
  49         p_aout->output.output.i_rate = i_rate;
  50     aout_FormatPrepare( &p_aout->output.output );
  51
  52     vlc_mutex_lock( &p_aout->output_fifo_lock );
  53
  54     /* Find the best output plug-in. */
  55     p_aout->output.p_module = module_Need( p_aout, "audio output",
  56                                            psz_name );
  57     if ( psz_name != NULL ) free( psz_name );
  58     if ( p_aout->output.p_module == NULL )
  59     {
  60         msg_Err( p_aout, "no suitable aout module" );
  61         vlc_mutex_unlock( &p_aout->output_fifo_lock );
  62         return -1;
  63     }
  64
  65     if ( var_Type( p_aout, "audio-channels" ) ==
  66              (VLC_VAR_STRING | VLC_VAR_ISLIST) )
  67     {
  68         /* The user may have selected a different channels configuration. */
  69         vlc_value_t val;
  70         var_Get( p_aout, "audio-channels", &val );
  71
  72         if ( !strcmp( val.psz_string, N_("Both") ) )
  73         {
  74             p_aout->output.output.i_original_channels =
  75                 AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT;
  76         }
  77         else if ( !strcmp( val.psz_string, N_("Left") ) )
  78         {
  79             p_aout->output.output.i_original_channels = AOUT_CHAN_LEFT;
  80         }
  81         else if ( !strcmp( val.psz_string, N_("Right") ) )
  82         {
  83             p_aout->output.output.i_original_channels = AOUT_CHAN_RIGHT;
  84         }
  85         else if ( !strcmp( val.psz_string, N_("Dolby Surround") ) )
  86         {
  87             p_aout->output.output.i_original_channels
  88                 = AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT | AOUT_CHAN_DOLBYSTEREO;
  89         }
  90         free( val.psz_string );
  91     }
  92     else if ( p_aout->output.output.i_physical_channels == AOUT_CHAN_CENTER )
  93     {
  94         /* Mono - create the audio-channels variable. */
  95         vlc_value_t val;
  96         var_Create( p_aout, "audio-channels", VLC_VAR_STRING | VLC_VAR_ISLIST );
  97         if ( p_aout->output.output.i_original_channels & AOUT_CHAN_DUALMONO )
  98         {
  99             /* Go directly to the left channel. */
 100             p_aout->output.output.i_original_channels = AOUT_CHAN_LEFT;
 101         }
 102         else
 103         {
 104             val.psz_string = N_("Both");
 105             var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
 106         }
 107         val.psz_string = N_("Left");
 108         var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
 109         val.psz_string = N_("Right");
 110         var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
 111         var_AddCallback( p_aout, "audio-channels", aout_ChannelsRestart,
 112                          NULL );
 113     }
 114     else if ( p_aout->output.output.i_physical_channels ==
 115                  (AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT)
 116               && p_aout->output.output.i_original_channels ==
 117                  (AOUT_CHAN_LEFT | AOUT_CHAN_RIGHT) )
 118     {
 119         /* Stereo - create the audio-channels variable. */
 120         vlc_value_t val;
 121         var_Create( p_aout, "audio-channels", VLC_VAR_STRING | VLC_VAR_ISLIST );
 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 )
 129         {
 130             val.psz_string = N_("Dolby Surround");
 131             var_Change( p_aout, "audio-channels", VLC_VAR_ADDCHOICE, &val );
 132         }
 133         p_aout->output.output.i_original_channels &= ~AOUT_CHAN_DOLBYSTEREO;
 134         var_AddCallback( p_aout, "audio-channels", aout_ChannelsRestart,
 135                          NULL );
 136     }
 137
 138     aout_FormatPrepare( &p_aout->output.output );
 139
 140     /* Prepare FIFO. */
 141     aout_FifoInit( p_aout, &p_aout->output.fifo, p_aout->output.output.i_rate );
 142
 143     vlc_mutex_unlock( &p_aout->output_fifo_lock );
 144
 145     aout_FormatPrint( p_aout, "output", &p_aout->output.output );
 146
 147     /* Calculate the resulting mixer output format. */
 148     memcpy( &p_aout->mixer.mixer, &p_aout->output.output,
 149             sizeof(audio_sample_format_t) );
 150     if ( !AOUT_FMT_NON_LINEAR(&p_aout->output.output) )
 151     {
 152         /* Non-S/PDIF mixer only deals with float32 or fixed32. */
 153         p_aout->mixer.mixer.i_format
 154                      = (p_aout->p_libvlc->i_cpu & CPU_CAPABILITY_FPU) ?
 155                         VLC_FOURCC('f','l','3','2') :
 156                         VLC_FOURCC('f','i','3','2');
 157         aout_FormatPrepare( &p_aout->mixer.mixer );
 158     }
 159     else
 160     {
 161         p_aout->mixer.mixer.i_format = p_format->i_format;
 162     }
 163
 164     aout_FormatPrint( p_aout, "mixer", &p_aout->output.output );
 165
 166     /* Create filters. */
 167     if ( aout_FiltersCreatePipeline( p_aout, p_aout->output.pp_filters,
 168                                      &p_aout->output.i_nb_filters,
 169                                      &p_aout->mixer.mixer,
 170                                      &p_aout->output.output ) < 0 )
 171     {
 172         msg_Err( p_aout, "couldn't set an output pipeline" );
 173         module_Unneed( p_aout, p_aout->output.p_module );
 174         return -1;
 175     }
 176
 177     /* Prepare hints for the buffer allocator. */
 178     p_aout->mixer.output_alloc.i_alloc_type = AOUT_ALLOC_HEAP;
 179     p_aout->mixer.output_alloc.i_bytes_per_sec
 180                         = p_aout->mixer.mixer.i_bytes_per_frame
 181                            * p_aout->mixer.mixer.i_rate
 182                            / p_aout->mixer.mixer.i_frame_length;
 183
 184     aout_FiltersHintBuffers( p_aout, p_aout->output.pp_filters,
 185                              p_aout->output.i_nb_filters,
 186                              &p_aout->mixer.output_alloc );
 187
 188     return 0;
 189 }
 190
 191 /*****************************************************************************
 192  * aout_OutputDelete : delete the output
 193  *****************************************************************************
 194  * This function is entered with the mixer lock.
 195  *****************************************************************************/
 196 void aout_OutputDelete( aout_instance_t * p_aout )
 197 {
 198     module_Unneed( p_aout, p_aout->output.p_module );
 199
 200     aout_FiltersDestroyPipeline( p_aout, p_aout->output.pp_filters,
 201                                  p_aout->output.i_nb_filters );
 202     aout_FifoDestroy( p_aout, &p_aout->output.fifo );
 203 }
 204
 205 /*****************************************************************************
 206  * aout_OutputPlay : play a buffer
 207  *****************************************************************************
 208  * This function is entered with the mixer lock.
 209  *****************************************************************************/
 210 void aout_OutputPlay( aout_instance_t * p_aout, aout_buffer_t * p_buffer )
 211 {
 212     aout_FiltersPlay( p_aout, p_aout->output.pp_filters,
 213                       p_aout->output.i_nb_filters,
 214                       &p_buffer );
 215
 216     vlc_mutex_lock( &p_aout->output_fifo_lock );
 217     aout_FifoPush( p_aout, &p_aout->output.fifo, p_buffer );
 218     p_aout->output.pf_play( p_aout );
 219     vlc_mutex_unlock( &p_aout->output_fifo_lock );
 220 }
 221
 222 /*****************************************************************************
 223  * aout_OutputNextBuffer : give the audio output plug-in the right buffer
 224  *****************************************************************************
 225  * If b_can_sleek is 1, the aout core functions won't try to resample
 226  * new buffers to catch up - that is we suppose that the output plug-in can
 227  * compensate it by itself. S/PDIF outputs should always set b_can_sleek = 1.
 228  * This function is entered with no lock at all :-).
 229  *****************************************************************************/
 230 aout_buffer_t * aout_OutputNextBuffer( aout_instance_t * p_aout,
 231                                        mtime_t start_date,
 232                                        vlc_bool_t b_can_sleek )
 233 {
 234     aout_buffer_t * p_buffer;
 235
 236     vlc_mutex_lock( &p_aout->output_fifo_lock );
 237
 238     p_buffer = p_aout->output.fifo.p_first;
 239     while ( p_buffer && p_buffer->start_date < mdate() )
 240     {
 241         msg_Dbg( p_aout, "audio output is too slow ("I64Fd"), "
 242                  "trashing "I64Fd"us", mdate() - p_buffer->start_date,
 243                  p_buffer->end_date - p_buffer->start_date );
 244         p_buffer = p_buffer->p_next;
 245     }
 246
 247     p_aout->output.fifo.p_first = p_buffer;
 248     if ( p_buffer == NULL )
 249     {
 250         p_aout->output.fifo.pp_last = &p_aout->output.fifo.p_first;
 251
 252 #if 0 /* This is bad because the audio output might just be trying to fill
 253        * in it's internal buffers. And anyway, it's up to the audio output
 254        * to deal with this kind of starvation. */
 255
 256         /* Set date to 0, to allow the mixer to send a new buffer ASAP */
 257         aout_FifoSet( p_aout, &p_aout->output.fifo, 0 );
 258         if ( !p_aout->output.b_starving )
 259             msg_Dbg( p_aout,
 260                  "audio output is starving (no input), playing silence" );
 261         p_aout->output.b_starving = 1;
 262 #endif
 263
 264         vlc_mutex_unlock( &p_aout->output_fifo_lock );
 265         return NULL;
 266     }
 267
 268     /* Here we suppose that all buffers have the same duration - this is
 269      * generally true, and anyway if it's wrong it won't be a disaster. */
 270     if ( p_buffer->start_date > start_date
 271                          + (p_buffer->end_date - p_buffer->start_date) )
 272     {
 273         vlc_mutex_unlock( &p_aout->output_fifo_lock );
 274         if ( !p_aout->output.b_starving )
 275             msg_Dbg( p_aout, "audio output is starving ("I64Fd"), "
 276                      "playing silence", p_buffer->start_date - start_date );
 277         p_aout->output.b_starving = 1;
 278         return NULL;
 279     }
 280
 281     p_aout->output.b_starving = 0;
 282
 283     if ( !b_can_sleek &&
 284           ( (p_buffer->start_date - start_date > AOUT_PTS_TOLERANCE)
 285              || (start_date - p_buffer->start_date > AOUT_PTS_TOLERANCE) ) )
 286     {
 287         /* Try to compensate the drift by doing some resampling. */
 288         int i;
 289         mtime_t difference = start_date - p_buffer->start_date;
 290         msg_Warn( p_aout, "output date isn't PTS date, requesting "
 291                   "resampling ("I64Fd")", difference );
 292
 293         vlc_mutex_lock( &p_aout->input_fifos_lock );
 294         for ( i = 0; i < p_aout->i_nb_inputs; i++ )
 295         {
 296             aout_fifo_t * p_fifo = &p_aout->pp_inputs[i]->fifo;
 297
 298             aout_FifoMoveDates( p_aout, p_fifo, difference );
 299         }
 300
 301         aout_FifoMoveDates( p_aout, &p_aout->output.fifo, difference );
 302         vlc_mutex_unlock( &p_aout->input_fifos_lock );
 303     }
 304
 305     p_aout->output.fifo.p_first = p_buffer->p_next;
 306     if ( p_buffer->p_next == NULL )
 307     {
 308         p_aout->output.fifo.pp_last = &p_aout->output.fifo.p_first;
 309     }
 310
 311     vlc_mutex_unlock( &p_aout->output_fifo_lock );
 312     return p_buffer;
 313 }