]> git.sesse.net Git - vlc/blobdiff - src/audio_output/dec.c
Replace the bitmap structures of Microsoft with ones of VLC
[vlc] / src / audio_output / dec.c
index 26dba558e0c3b4326b8675e4344d7ef03619cedd..7d0316fb9040690723d017fa9820aec2041c4f4e 100644 (file)
 /*****************************************************************************
  * dec.c : audio output API towards decoders
  *****************************************************************************
- * Copyright (C) 2002-2007 the VideoLAN team
+ * Copyright (C) 2002-2007 VLC authors and VideoLAN
  * $Id$
  *
  * Authors: Christophe Massiot <massiot@via.ecp.fr>
  *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation; either version 2.1 of the License, or
  * (at your option) any later version.
  *
  * This program is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
  *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  *****************************************************************************/
 
 /*****************************************************************************
  * Preamble
  *****************************************************************************/
-#include <vlc/vlc.h>
-
-#ifdef HAVE_ALLOCA_H
-#   include <alloca.h>
+#ifdef HAVE_CONFIG_H
+# include "config.h"
 #endif
 
+#include <assert.h>
+
+#include <vlc_common.h>
 #include <vlc_aout.h>
 #include <vlc_input.h>
+#include <vlc_atomic.h>
 
 #include "aout_internal.h"
+#include "libvlc.h"
 
-/** FIXME: Ugly but needed to access the counters */
-#include "input/input_internal.h"
+static int ReplayGainCallback (vlc_object_t *, char const *,
+                               vlc_value_t, vlc_value_t, void *);
 
-/*****************************************************************************
- * aout_DecNew : create a decoder
- *****************************************************************************/
-static aout_input_t * DecNew( vlc_object_t * p_this, aout_instance_t * p_aout,
-                              audio_sample_format_t *p_format,
-                              audio_replay_gain_t *p_replay_gain )
+/**
+ * Creates an audio output
+ */
+int aout_DecNew( audio_output_t *p_aout,
+                 const audio_sample_format_t *p_format,
+                 const audio_replay_gain_t *p_replay_gain,
+                 const aout_request_vout_t *p_request_vout )
 {
-    aout_input_t * p_input;
-    input_thread_t * p_input_thread;
-    vlc_value_t val;
-
     /* Sanitize audio format */
     if( p_format->i_channels > 32 )
     {
         msg_Err( p_aout, "too many audio channels (%u)",
                  p_format->i_channels );
-        goto error;
+        return -1;
+    }
+    if( p_format->i_channels <= 0 )
+    {
+        msg_Err( p_aout, "no audio channels" );
+        return -1;
+    }
+    if( p_format->i_channels != aout_FormatNbChannels( p_format ) )
+    {
+        msg_Err( p_aout, "incompatible audio channels count with layout mask" );
+        return -1;
     }
 
     if( p_format->i_rate > 192000 )
     {
         msg_Err( p_aout, "excessive audio sample frequency (%u)",
                  p_format->i_rate );
-        goto error;
+        return -1;
     }
-
-    /* We can only be called by the decoder, so no need to lock
-     * p_input->lock. */
-    vlc_mutex_lock( &p_aout->mixer_lock );
-
-    if ( p_aout->i_nb_inputs >= AOUT_MAX_INPUTS )
+    if( p_format->i_rate < 4000 )
     {
-        msg_Err( p_aout, "too many inputs already (%d)", p_aout->i_nb_inputs );
-        goto error;
+        msg_Err( p_aout, "too low audio sample frequency (%u)",
+                 p_format->i_rate );
+        return -1;
     }
 
-    p_input = malloc(sizeof(aout_input_t));
-    if ( p_input == NULL )
-    {
-        msg_Err( p_aout, "out of memory" );
-        goto error;
+    aout_owner_t *owner = aout_owner(p_aout);
+#ifdef RECYCLE
+    /* Calling decoder is responsible for serializing aout_DecNew() and
+     * aout_DecDelete(). So no need to lock to _read_ those properties. */
+    if (owner->module != NULL) /* <- output exists */
+    {   /* Check if we can recycle the existing output and pipelines */
+        if (AOUT_FMTS_IDENTICAL(&owner->input_format, p_format))
+            return 0;
+
+        /* TODO? If the new input format is closer to the output format than
+         * the old input format was, then the output could be recycled. The
+         * input pipeline however would need to be restarted. */
+
+        /* No recycling: delete everything and restart from scratch */
+        aout_Shutdown (p_aout);
     }
-    memset( p_input, 0, sizeof(aout_input_t) );
+#endif
+    int ret = -1;
 
-    vlc_mutex_init( p_aout, &p_input->lock );
+    /* TODO: reduce lock scope depending on decoder's real need */
+    aout_lock( p_aout );
+    assert (owner->module == NULL);
 
-    p_input->b_changed = 0;
-    p_input->b_error = 1;
+    /* Create the audio output stream */
+    var_Destroy( p_aout, "audio-device" );
+    var_Destroy( p_aout, "audio-channels" );
 
-    aout_FormatPrepare( p_format );
+    owner->input_format = *p_format;
+    vlc_atomic_set (&owner->restart, 0);
+    if( aout_OutputNew( p_aout, p_format ) < 0 )
+        goto error;
 
-    memcpy( &p_input->input, p_format,
-            sizeof(audio_sample_format_t) );
-    if( p_replay_gain )
-        p_input->replay_gain = *p_replay_gain;
+    /* Allocate a software mixer */
+    assert (owner->volume.mixer == NULL);
+    owner->volume.mixer = aout_MixerNew (p_aout, owner->mixer_format.i_format);
 
-    p_aout->pp_inputs[p_aout->i_nb_inputs] = p_input;
-    p_aout->i_nb_inputs++;
+    aout_ReplayGainInit (&owner->gain.data, p_replay_gain);
+    var_AddCallback (p_aout, "audio-replay-gain-mode",
+                     ReplayGainCallback, owner);
+    var_TriggerCallback (p_aout, "audio-replay-gain-mode");
 
-    if ( p_aout->mixer.b_error )
-    {
-        int i;
+    /* Create the audio filtering "input" pipeline */
+    date_Init (&owner->sync.date, owner->mixer_format.i_rate, 1);
+    date_Set (&owner->sync.date, VLC_TS_INVALID);
 
-        var_Destroy( p_aout, "audio-device" );
-        var_Destroy( p_aout, "audio-channels" );
+    assert (owner->input == NULL);
+    owner->input = aout_InputNew (p_aout, p_format, &owner->mixer_format,
+                                  p_request_vout);
+    if (owner->input == NULL)
+        aout_OutputDelete (p_aout);
+    else
+        ret = 0;
+error:
+    aout_unlock( p_aout );
+    return ret;
+}
 
-        /* Recreate the output using the new format. */
-        if ( aout_OutputNew( p_aout, p_format ) < 0 )
-        {
-            for ( i = 0; i < p_aout->i_nb_inputs - 1; i++ )
-            {
-                vlc_mutex_lock( &p_aout->pp_inputs[i]->lock );
-                aout_InputDelete( p_aout, p_aout->pp_inputs[i] );
-                vlc_mutex_unlock( &p_aout->pp_inputs[i]->lock );
-            }
-            vlc_mutex_unlock( &p_aout->mixer_lock );
-            return p_input;
-        }
+/**
+ * Stops all plugins involved in the audio output.
+ */
+void aout_Shutdown (audio_output_t *p_aout)
+{
+    aout_owner_t *owner = aout_owner (p_aout);
+    aout_input_t *input;
+    struct audio_mixer *mixer;
 
-        /* Create other input streams. */
-        for ( i = 0; i < p_aout->i_nb_inputs - 1; i++ )
-        {
-            vlc_mutex_lock( &p_aout->pp_inputs[i]->lock );
-            aout_InputDelete( p_aout, p_aout->pp_inputs[i] );
-            aout_InputNew( p_aout, p_aout->pp_inputs[i] );
-            vlc_mutex_unlock( &p_aout->pp_inputs[i]->lock );
-        }
-    }
-    else
-    {
-        aout_MixerDelete( p_aout );
-    }
+    aout_lock( p_aout );
+    /* Remove the input. */
+    input = owner->input;
+    if (likely(input != NULL))
+        aout_InputDelete (p_aout, input);
+    owner->input = NULL;
 
-    if ( aout_MixerNew( p_aout ) == -1 )
-    {
-        aout_OutputDelete( p_aout );
-        goto error;
-    }
+    mixer = owner->volume.mixer;
+    owner->volume.mixer = NULL;
 
-    aout_InputNew( p_aout, p_input );
+    var_DelCallback (p_aout, "audio-replay-gain-mode",
+                     ReplayGainCallback, owner);
 
-    vlc_mutex_unlock( &p_aout->mixer_lock );
-    p_input->i_desync = var_CreateGet( p_this, "audio-desync" ) * 1000;
+    aout_OutputDelete( p_aout );
+    var_Destroy( p_aout, "audio-device" );
+    var_Destroy( p_aout, "audio-channels" );
 
-    p_input_thread = (input_thread_t *)vlc_object_find( p_this,
-                                           VLC_OBJECT_INPUT, FIND_PARENT );
-    if( p_input_thread )
-    {
-        p_input->i_pts_delay = p_input_thread->i_pts_delay;
-        p_input->i_pts_delay += p_input->i_desync;
-        p_input->p_input_thread = p_input_thread;
-        vlc_object_release( p_input_thread );
-    }
-    else
-    {
-        p_input->i_pts_delay = DEFAULT_PTS_DELAY;
-        p_input->i_pts_delay += p_input->i_desync;
-        p_input->p_input_thread = NULL;
-    }
+    aout_unlock( p_aout );
 
-    return p_input;
+    aout_MixerDelete (mixer);
+    free (input);
+}
 
-error:
-    vlc_mutex_unlock( &p_aout->mixer_lock );
-    return NULL;
+/**
+ * Stops the decoded audio input.
+ * @note Due to output recycling, this function is esssentially a stub.
+ */
+void aout_DecDelete (audio_output_t *aout)
+{
+#ifdef RECYCLE
+    (void) aout;
+#else
+    aout_Shutdown (aout);
+#endif
 }
 
-aout_input_t * __aout_DecNew( vlc_object_t * p_this,
-                              aout_instance_t ** pp_aout,
-                              audio_sample_format_t * p_format,
-                              audio_replay_gain_t *p_replay_gain )
+#define AOUT_RESTART_OUTPUT 1
+#define AOUT_RESTART_INPUT  2
+static void aout_CheckRestart (audio_output_t *aout)
 {
-    if ( *pp_aout == NULL )
-    {
-        /* Create an audio output if there is none. */
-        *pp_aout = vlc_object_find( p_this, VLC_OBJECT_AOUT, FIND_ANYWHERE );
+    aout_owner_t *owner = aout_owner (aout);
 
-        if( *pp_aout == NULL )
-        {
-            msg_Dbg( p_this, "no aout present, spawning one" );
-
-            *pp_aout = aout_New( p_this );
-            /* Everything failed, I'm a loser, I just wanna die */
-            if( *pp_aout == NULL )
-            {
-                return NULL;
-            }
-            vlc_object_attach( *pp_aout, p_this->p_libvlc );
-        }
-        else
-        {
-            vlc_object_release( *pp_aout );
-        }
-    }
+    aout_assert_locked (aout);
 
-    return DecNew( p_this, *pp_aout, p_format, p_replay_gain );
-}
+    int restart = vlc_atomic_swap (&owner->restart, 0);
+    if (likely(restart == 0))
+        return;
 
-/*****************************************************************************
- * aout_DecDelete : delete a decoder
- *****************************************************************************/
-int aout_DecDelete( aout_instance_t * p_aout, aout_input_t * p_input )
-{
-    int i_input;
+    assert (restart & AOUT_RESTART_INPUT);
 
-    /* This function can only be called by the decoder itself, so no need
-     * to lock p_input->lock. */
-    vlc_mutex_lock( &p_aout->mixer_lock );
+    const aout_request_vout_t request_vout = owner->input->request_vout;
 
-    for ( i_input = 0; i_input < p_aout->i_nb_inputs; i_input++ )
-    {
-        if ( p_aout->pp_inputs[i_input] == p_input )
-        {
-            break;
-        }
-    }
+    if (likely(owner->input != NULL))
+        aout_InputDelete (aout, owner->input);
+    owner->input = NULL;
 
-    if ( i_input == p_aout->i_nb_inputs )
+    /* Reinitializes the output */
+    if (restart & AOUT_RESTART_OUTPUT)
     {
-        msg_Err( p_aout, "cannot find an input to delete" );
-        return -1;
+        aout_MixerDelete (owner->volume.mixer);
+        owner->volume.mixer = NULL;
+        aout_OutputDelete (aout);
+
+        if (aout_OutputNew (aout, &owner->input_format))
+            return; /* we are officially screwed */
+        owner->volume.mixer = aout_MixerNew (aout,
+                                             owner->mixer_format.i_format);
     }
 
-    /* Remove the input from the list. */
-    memmove( &p_aout->pp_inputs[i_input], &p_aout->pp_inputs[i_input + 1],
-             (AOUT_MAX_INPUTS - i_input - 1) * sizeof(aout_input_t *) );
-    p_aout->i_nb_inputs--;
-
-    aout_InputDelete( p_aout, p_input );
+    owner->input = aout_InputNew (aout, &owner->input_format,
+                                  &owner->mixer_format, &request_vout);
+}
 
-    vlc_mutex_destroy( &p_input->lock );
-    free( p_input );
+/**
+ * Marks the audio output for restart, to update any parameter of the output
+ * plug-in (e.g. output device or channel mapping).
+ */
+void aout_RequestRestart (audio_output_t *aout)
+{
+    aout_owner_t *owner = aout_owner (aout);
 
-    if ( !p_aout->i_nb_inputs )
-    {
-        aout_OutputDelete( p_aout );
-        aout_MixerDelete( p_aout );
-        if ( var_Type( p_aout, "audio-device" ) != 0 )
-        {
-            var_Destroy( p_aout, "audio-device" );
-        }
-        if ( var_Type( p_aout, "audio-channels" ) != 0 )
-        {
-            var_Destroy( p_aout, "audio-channels" );
-        }
-    }
+    /* DO NOT remove AOUT_RESTART_INPUT. You need to change the atomic ops. */
+    vlc_atomic_set (&owner->restart, AOUT_RESTART_OUTPUT|AOUT_RESTART_INPUT);
+}
 
-    vlc_mutex_unlock( &p_aout->mixer_lock );
+/**
+ * This function will safely mark aout input to be restarted as soon as
+ * possible to take configuration changes into account
+ */
+void aout_InputRequestRestart (audio_output_t *aout)
+{
+    aout_owner_t *owner = aout_owner (aout);
 
-    return 0;
+    vlc_atomic_compare_swap (&owner->restart, 0, AOUT_RESTART_INPUT);
 }
 
 
@@ -258,148 +250,188 @@ int aout_DecDelete( aout_instance_t * p_aout, aout_input_t * p_input )
 /*****************************************************************************
  * aout_DecNewBuffer : ask for a new empty buffer
  *****************************************************************************/
-aout_buffer_t * aout_DecNewBuffer( aout_instance_t * p_aout,
-                                   aout_input_t * p_input,
-                                   size_t i_nb_samples )
+block_t *aout_DecNewBuffer (audio_output_t *aout, size_t samples)
 {
-    aout_buffer_t * p_buffer;
-    mtime_t duration;
+    /* NOTE: the caller is responsible for serializing input change */
+    aout_owner_t *owner = aout_owner (aout);
 
-    vlc_mutex_lock( &p_input->lock );
-
-    if ( p_input->b_error )
+    size_t length = samples * owner->input_format.i_bytes_per_frame
+                            / owner->input_format.i_frame_length;
+    block_t *block = block_Alloc( length );
+    if( likely(block != NULL) )
     {
-        vlc_mutex_unlock( &p_input->lock );
-        return NULL;
+        block->i_nb_samples = samples;
+        block->i_pts = block->i_length = 0;
     }
-
-    duration = (1000000 * (mtime_t)i_nb_samples) / p_input->input.i_rate;
-
-    /* This necessarily allocates in the heap. */
-    aout_BufferAlloc( &p_input->input_alloc, duration, NULL, p_buffer );
-    if( p_buffer != NULL )
-        p_buffer->i_nb_bytes = i_nb_samples * p_input->input.i_bytes_per_frame
-                                  / p_input->input.i_frame_length;
-
-    /* Suppose the decoder doesn't have more than one buffered buffer */
-    p_input->b_changed = 0;
-
-    vlc_mutex_unlock( &p_input->lock );
-
-    if( p_buffer == NULL )
-        return NULL;
-
-    p_buffer->i_nb_samples = i_nb_samples;
-    p_buffer->start_date = p_buffer->end_date = 0;
-    return p_buffer;
+    return block;
 }
 
 /*****************************************************************************
  * aout_DecDeleteBuffer : destroy an undecoded buffer
  *****************************************************************************/
-void aout_DecDeleteBuffer( aout_instance_t * p_aout, aout_input_t * p_input,
-                           aout_buffer_t * p_buffer )
+void aout_DecDeleteBuffer (audio_output_t *aout, block_t *block)
 {
-    (void)p_aout; (void)p_input;
-    aout_BufferFree( p_buffer );
+    (void) aout;
+    aout_BufferFree (block);
 }
 
 /*****************************************************************************
  * aout_DecPlay : filter & mix the decoded buffer
  *****************************************************************************/
-int aout_DecPlay( aout_instance_t * p_aout, aout_input_t * p_input,
-                  aout_buffer_t * p_buffer, int i_input_rate )
+int aout_DecPlay (audio_output_t *p_aout, block_t *p_buffer, int i_input_rate)
 {
-    if ( p_buffer->start_date == 0 )
+    aout_owner_t *owner = aout_owner (p_aout);
+    aout_input_t *input;
+
+    assert( i_input_rate >= INPUT_RATE_DEFAULT / AOUT_MAX_INPUT_RATE &&
+            i_input_rate <= INPUT_RATE_DEFAULT * AOUT_MAX_INPUT_RATE );
+    assert( p_buffer->i_pts > 0 );
+
+    p_buffer->i_length = (mtime_t)p_buffer->i_nb_samples * 1000000
+                                / owner->input_format.i_rate;
+
+    aout_lock( p_aout );
+    aout_CheckRestart( p_aout );
+
+    input = owner->input;
+    if (unlikely(input == NULL)) /* can happen due to restart */
     {
-        msg_Warn( p_aout, "non-dated buffer received" );
+        aout_unlock( p_aout );
         aout_BufferFree( p_buffer );
         return -1;
     }
 
-    if( i_input_rate > INPUT_RATE_DEFAULT * AOUT_MAX_INPUT_RATE ||
-        i_input_rate < INPUT_RATE_DEFAULT / AOUT_MAX_INPUT_RATE )
+    /* Input */
+    p_buffer = aout_InputPlay (p_aout, input, p_buffer, i_input_rate,
+                               &owner->sync.date);
+    if( p_buffer != NULL )
     {
-        aout_BufferFree( p_buffer );
-        return 0;
-    }
-
-    /* Apply the desynchronisation requested by the user */
-    p_buffer->start_date += p_input->i_desync;
-    p_buffer->end_date += p_input->i_desync;
+        date_Increment (&owner->sync.date, p_buffer->i_nb_samples);
 
-    if ( p_buffer->start_date > mdate() + p_input->i_pts_delay +
-         AOUT_MAX_ADVANCE_TIME )
-    {
-        msg_Warn( p_aout, "received buffer in the future ("I64Fd")",
-                  p_buffer->start_date - mdate());
-        if( p_input->p_input_thread )
+        /* Mixer */
+        if (owner->volume.mixer != NULL)
         {
-            vlc_mutex_lock( &p_input->p_input_thread->p->counters.counters_lock);
-            stats_UpdateInteger( p_aout,
-                           p_input->p_input_thread->p->counters.p_lost_abuffers,
-                           1, NULL );
-            vlc_mutex_unlock( &p_input->p_input_thread->p->counters.counters_lock);
+            float amp = owner->volume.multiplier
+                      * vlc_atomic_getf (&owner->gain.multiplier);
+            aout_MixerRun (owner->volume.mixer, p_buffer, amp);
         }
-        aout_BufferFree( p_buffer );
-        return -1;
+
+        /* Output */
+        aout_OutputPlay( p_aout, p_buffer );
     }
 
-    p_buffer->end_date = p_buffer->start_date
-                            + (mtime_t)p_buffer->i_nb_samples * 1000000
-                                / p_input->input.i_rate;
+    aout_unlock( p_aout );
+    return 0;
+}
 
-    vlc_mutex_lock( &p_input->lock );
+int aout_DecGetResetLost (audio_output_t *aout)
+{
+    aout_owner_t *owner = aout_owner (aout);
+    aout_input_t *input = owner->input;
+    int val;
 
-    if ( p_input->b_error )
+    aout_lock (aout);
+    if (likely(input != NULL))
     {
-        vlc_mutex_unlock( &p_input->lock );
-        aout_BufferFree( p_buffer );
-        return -1;
+        val = input->i_buffer_lost;
+        input->i_buffer_lost = 0;
     }
+    else
+        val = 0; /* if aout_CheckRestart() failed */
+    aout_unlock (aout);
 
-    if ( p_input->b_changed )
-    {
-        /* Maybe the allocation size has changed. Re-allocate a buffer. */
-        aout_buffer_t * p_new_buffer;
-        mtime_t duration = (1000000 * (mtime_t)p_buffer->i_nb_samples)
-                            / p_input->input.i_rate;
-
-        aout_BufferAlloc( &p_input->input_alloc, duration, NULL, p_new_buffer );
-        p_aout->p_libvlc->pf_memcpy( p_new_buffer->p_buffer, p_buffer->p_buffer,
-                                  p_buffer->i_nb_bytes );
-        p_new_buffer->i_nb_samples = p_buffer->i_nb_samples;
-        p_new_buffer->i_nb_bytes = p_buffer->i_nb_bytes;
-        p_new_buffer->start_date = p_buffer->start_date;
-        p_new_buffer->end_date = p_buffer->end_date;
-        aout_BufferFree( p_buffer );
-        p_buffer = p_new_buffer;
-        p_input->b_changed = 0;
-    }
+    return val;
+}
 
-    /* If the buffer is too early, wait a while. */
-    mwait( p_buffer->start_date - AOUT_MAX_PREPARE_TIME );
+void aout_DecChangePause (audio_output_t *aout, bool paused, mtime_t date)
+{
+    aout_owner_t *owner = aout_owner (aout);
 
-    if ( aout_InputPlay( p_aout, p_input, p_buffer, i_input_rate ) == -1 )
-    {
-        vlc_mutex_unlock( &p_input->lock );
-        return -1;
-    }
+    aout_lock (aout);
+    /* XXX: Should the date be offset by the pause duration instead? */
+    date_Set (&owner->sync.date, VLC_TS_INVALID);
+    aout_OutputPause (aout, paused, date);
+    aout_unlock (aout);
+}
 
-    vlc_mutex_unlock( &p_input->lock );
+void aout_DecFlush (audio_output_t *aout)
+{
+    aout_owner_t *owner = aout_owner (aout);
+
+    aout_lock (aout);
+    date_Set (&owner->sync.date, VLC_TS_INVALID);
+    aout_OutputFlush (aout, false);
+    aout_unlock (aout);
+}
+
+bool aout_DecIsEmpty (audio_output_t *aout)
+{
+    aout_owner_t *owner = aout_owner (aout);
+    mtime_t end_date, now = mdate ();
+    bool empty;
+
+    aout_lock (aout);
+    end_date = date_Get (&owner->sync.date);
+    empty = end_date == VLC_TS_INVALID || end_date <= now;
+    if (empty)
+        /* The last PTS has elapsed already. So the underlying audio output
+         * buffer should be empty or almost. Thus draining should be fast
+         * and will not block the caller too long. */
+        aout_OutputFlush (aout, true);
+    aout_unlock (aout);
+    return empty;
+}
+
+/**
+ * Notifies the audio input of the drift from the requested audio
+ * playback timestamp (@ref block_t.i_pts) to the anticipated playback time
+ * as reported by the audio output hardware.
+ * Depending on the drift amplitude, the input core may ignore the drift
+ * trigger upsampling or downsampling, or even discard samples.
+ * Future VLC versions may instead adjust the input decoding speed.
+ *
+ * The audio output plugin is responsible for estimating the ideal current
+ * playback time defined as follows:
+ *  ideal time = buffer timestamp - (output latency + pending buffer duration)
+ *
+ * Practically, this is the PTS (block_t.i_pts) of the current buffer minus
+ * the latency reported by the output programming interface.
+ * Computing the estimated drift directly would probably be more intuitive.
+ * However the use of an absolute time value does not introduce extra
+ * measurement errors due to the CPU scheduling jitter and clock resolution.
+ * Furthermore, the ideal while it is an abstract value, is easy for most
+ * audio output plugins to compute.
+ * The following definition is equivalent but depends on the clock time:
+ *  ideal time = real time + drift
+
+ * @note If aout_LatencyReport() is never called, the core will assume that
+ * there is no drift.
+ *
+ * @param ideal estimated ideal time as defined above.
+ */
+void aout_TimeReport (audio_output_t *aout, mtime_t ideal)
+{
+    mtime_t delta = mdate() - ideal /* = -drift */;
 
-    /* Run the mixer if it is able to run. */
-    vlc_mutex_lock( &p_aout->mixer_lock );
-    aout_MixerRun( p_aout );
-    if( p_input->p_input_thread )
+    aout_assert_locked (aout);
+    if (delta < -AOUT_MAX_PTS_ADVANCE || +AOUT_MAX_PTS_DELAY < delta)
     {
-        vlc_mutex_lock( &p_input->p_input_thread->p->counters.counters_lock);
-        stats_UpdateInteger( p_aout,
-                             p_input->p_input_thread->p->counters.p_played_abuffers,
-                             1, NULL );
-        vlc_mutex_unlock( &p_input->p_input_thread->p->counters.counters_lock);
+        aout_owner_t *owner = aout_owner (aout);
+
+        msg_Warn (aout, "not synchronized (%"PRId64" us), resampling",
+                  delta);
+        if (date_Get (&owner->sync.date) != VLC_TS_INVALID)
+            date_Move (&owner->sync.date, delta);
     }
-    vlc_mutex_unlock( &p_aout->mixer_lock );
+}
 
-    return 0;
+static int ReplayGainCallback (vlc_object_t *obj, char const *var,
+                               vlc_value_t oldval, vlc_value_t val, void *data)
+{
+    aout_owner_t *owner = data;
+    float multiplier = aout_ReplayGainSelect (obj, val.psz_string,
+                                              &owner->gain.data);
+    vlc_atomic_setf (&owner->gain.multiplier, multiplier);
+    VLC_UNUSED(var); VLC_UNUSED(oldval);
+    return VLC_SUCCESS;
 }