git.sesse.net Git - vlc/blob - src/audio_output/aout_internal.h

   1 /*****************************************************************************
   2  * aout_internal.h : internal defines for audio output
   3  *****************************************************************************
   4  * Copyright (C) 2002 the VideoLAN team
   5  * $Id$
   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., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 #if defined(__PLUGIN__) || defined(__BUILTIN__) || !defined(__LIBVLC__)
  25 # error This header file can only be included from LibVLC.
  26 #endif
  27
  28 #ifndef __LIBVLC_AOUT_INTERNAL_H
  29 # define __LIBVLC_AOUT_INTERNAL_H 1
  30
  31 aout_buffer_t *aout_BufferAlloc(aout_alloc_t *allocation, mtime_t microseconds,
  32         aout_buffer_t *old_buffer);
  33
  34 typedef struct
  35 {
  36     struct vout_thread_t  *(*pf_request_vout)( void *, struct vout_thread_t *,
  37                                                video_format_t *, bool );
  38     void *p_private;
  39 } aout_request_vout_t;
  40
  41 struct aout_filter_owner_sys_t
  42 {
  43     aout_instance_t *p_aout;
  44     aout_input_t    *p_input;
  45 };
  46
  47 /** an input stream for the audio output */
  48 struct aout_input_t
  49 {
  50     /* When this lock is taken, the pipeline cannot be changed by a
  51      * third-party. */
  52     vlc_mutex_t             lock;
  53
  54     audio_sample_format_t   input;
  55     aout_alloc_t            input_alloc;
  56
  57     /* pre-filters */
  58     aout_filter_t *         pp_filters[AOUT_MAX_FILTERS];
  59     int                     i_nb_filters;
  60
  61     aout_filter_t *         p_playback_rate_filter;
  62
  63     /* resamplers */
  64     aout_filter_t *         pp_resamplers[AOUT_MAX_FILTERS];
  65     int                     i_nb_resamplers;
  66     int                     i_resampling_type;
  67     mtime_t                 i_resamp_start_date;
  68     int                     i_resamp_start_drift;
  69
  70     /* Mixer information */
  71     audio_replay_gain_t     replay_gain;
  72
  73     /* If b_restart == 1, the input pipeline will be re-created. */
  74     bool              b_restart;
  75
  76     /* If b_error == 1, there is no input pipeline. */
  77     bool              b_error;
  78
  79     /* Did we just change the output format? (expect buffer inconsistencies) */
  80     bool              b_changed;
  81
  82     /* last rate from input */
  83     int               i_last_input_rate;
  84
  85     /* */
  86     int               i_buffer_lost;
  87
  88     /* */
  89     bool              b_paused;
  90     mtime_t           i_pause_date;
  91
  92     /* */
  93     bool                b_recycle_vout;
  94     aout_request_vout_t request_vout;
  95
  96     /* */
  97     aout_mixer_input_t mixer;
  98  };
  99
 100 /****************************************************************************
 101  * Prototypes
 102  *****************************************************************************/
 103
 104 /* From input.c : */
 105 int aout_InputNew( aout_instance_t * p_aout, aout_input_t * p_input, const aout_request_vout_t * );
 106 int aout_InputDelete( aout_instance_t * p_aout, aout_input_t * p_input );
 107 int aout_InputPlay( aout_instance_t * p_aout, aout_input_t * p_input,
 108                     aout_buffer_t * p_buffer, int i_input_rate );
 109
 110 /* From filters.c : */
 111 int aout_FiltersCreatePipeline ( aout_instance_t * p_aout, aout_filter_t ** pp_filters, int * pi_nb_filters, const audio_sample_format_t * p_input_format, const audio_sample_format_t * p_output_format );
 112 void aout_FiltersDestroyPipeline ( aout_instance_t * p_aout, aout_filter_t ** pp_filters, int i_nb_filters );
 113 void  aout_FiltersPlay ( aout_instance_t * p_aout, aout_filter_t ** pp_filters, int i_nb_filters, aout_buffer_t ** pp_input_buffer );
 114 void aout_FiltersHintBuffers( aout_instance_t * p_aout, aout_filter_t ** pp_filters, int i_nb_filters, aout_alloc_t * p_first_alloc );
 115
 116 /* From mixer.c : */
 117 int aout_MixerNew( aout_instance_t * p_aout );
 118 void aout_MixerDelete( aout_instance_t * p_aout );
 119 void aout_MixerRun( aout_instance_t * p_aout );
 120 int aout_MixerMultiplierSet( aout_instance_t * p_aout, float f_multiplier );
 121 int aout_MixerMultiplierGet( aout_instance_t * p_aout, float * pf_multiplier );
 122
 123 /* From output.c : */
 124 int aout_OutputNew( aout_instance_t * p_aout,
 125                     audio_sample_format_t * p_format );
 126 void aout_OutputPlay( aout_instance_t * p_aout, aout_buffer_t * p_buffer );
 127 void aout_OutputDelete( aout_instance_t * p_aout );
 128
 129
 130 /* From common.c : */
 131 #define aout_New(a) __aout_New(VLC_OBJECT(a))
 132 /* Release with vlc_object_release() */
 133 aout_instance_t * __aout_New ( vlc_object_t * );
 134
 135 void aout_FifoInit( aout_instance_t *, aout_fifo_t *, uint32_t );
 136 mtime_t aout_FifoNextStart( aout_instance_t *, aout_fifo_t * );
 137 void aout_FifoPush( aout_instance_t *, aout_fifo_t *, aout_buffer_t * );
 138 void aout_FifoSet( aout_instance_t *, aout_fifo_t *, mtime_t );
 139 void aout_FifoMoveDates( aout_instance_t *, aout_fifo_t *, mtime_t );
 140 void aout_FifoDestroy( aout_instance_t * p_aout, aout_fifo_t * p_fifo );
 141 void aout_FormatsPrint( aout_instance_t * p_aout, const char * psz_text, const audio_sample_format_t * p_format1, const audio_sample_format_t * p_format2 );
 142
 143
 144 /* From intf.c :*/
 145 int aout_VolumeSoftGet( aout_instance_t *, audio_volume_t * );
 146 int aout_VolumeSoftSet( aout_instance_t *, audio_volume_t );
 147 int aout_VolumeSoftInfos( aout_instance_t *, audio_volume_t * );
 148 int aout_VolumeNoneGet( aout_instance_t *, audio_volume_t * );
 149 int aout_VolumeNoneSet( aout_instance_t *, audio_volume_t );
 150 int aout_VolumeNoneInfos( aout_instance_t *, audio_volume_t * );
 151
 152 /* From dec.c */
 153 #define aout_DecNew(a, b, c, d, e) __aout_DecNew(VLC_OBJECT(a), b, c, d, e)
 154 aout_input_t * __aout_DecNew( vlc_object_t *, aout_instance_t **,
 155                               audio_sample_format_t *, const audio_replay_gain_t *,
 156                               const aout_request_vout_t * );
 157 int aout_DecDelete ( aout_instance_t *, aout_input_t * );
 158 aout_buffer_t * aout_DecNewBuffer( aout_input_t *, size_t );
 159 void aout_DecDeleteBuffer( aout_instance_t *, aout_input_t *, aout_buffer_t * );
 160 int aout_DecPlay( aout_instance_t *, aout_input_t *, aout_buffer_t *, int i_input_rate );
 161 int aout_DecGetResetLost( aout_instance_t *, aout_input_t * );
 162 void aout_DecChangePause( aout_instance_t *, aout_input_t *, bool b_paused, mtime_t i_date );
 163 void aout_DecFlush( aout_instance_t *, aout_input_t * );
 164
 165 /* Helpers */
 166
 167 static inline void aout_lock_mixer( aout_instance_t *p_aout )
 168 {
 169     vlc_mutex_lock( &p_aout->mixer_lock );
 170 }
 171
 172 static inline void aout_unlock_mixer( aout_instance_t *p_aout )
 173 {
 174     vlc_mutex_unlock( &p_aout->mixer_lock );
 175 }
 176
 177 static inline void aout_lock_input_fifos( aout_instance_t *p_aout )
 178 {
 179     vlc_mutex_lock( &p_aout->input_fifos_lock );
 180 }
 181
 182 static inline void aout_unlock_input_fifos( aout_instance_t *p_aout )
 183 {
 184     vlc_mutex_unlock( &p_aout->input_fifos_lock );
 185 }
 186
 187 static inline void aout_lock_output_fifo( aout_instance_t *p_aout )
 188 {
 189     vlc_mutex_lock( &p_aout->output_fifo_lock );
 190 }
 191
 192 static inline void aout_unlock_output_fifo( aout_instance_t *p_aout )
 193 {
 194     vlc_mutex_unlock( &p_aout->output_fifo_lock );
 195 }
 196
 197 static inline void aout_lock_input( aout_instance_t *p_aout, aout_input_t * p_input )
 198 {
 199     (void)p_aout;
 200     vlc_mutex_lock( &p_input->lock );
 201 }
 202
 203 static inline void aout_unlock_input( aout_instance_t *p_aout, aout_input_t * p_input )
 204 {
 205     (void)p_aout;
 206     vlc_mutex_unlock( &p_input->lock );
 207 }
 208
 209
 210 /**
 211  * This function will safely mark aout input to be restarted as soon as
 212  * possible to take configuration changes into account */
 213 static inline void AoutInputsMarkToRestart( aout_instance_t *p_aout )
 214 {
 215     int i;
 216     aout_lock_mixer( p_aout );
 217     for( i = 0; i < p_aout->i_nb_inputs; i++ )
 218         p_aout->pp_inputs[i]->b_restart = true;
 219     aout_unlock_mixer( p_aout );
 220 }
 221
 222 /* This function will add or remove a a module from a string list (comma
 223  * separated). It will return true if there is a modification
 224  * In case p_aout is NULL, we will use configuration instead of variable */
 225 static inline bool AoutChangeFilterString( vlc_object_t *p_obj, aout_instance_t * p_aout,
 226                                            const char* psz_variable,
 227                                            const char *psz_name, bool b_add )
 228 {
 229     char *psz_val;
 230     char *psz_parser;
 231
 232     if( *psz_name == '\0' )
 233         return false;
 234
 235     if( p_aout )
 236         psz_val = var_GetString( p_aout, psz_variable );
 237     else
 238         psz_val = config_GetPsz( p_obj, "audio-filter" );
 239
 240     if( !psz_val )
 241         psz_val = strdup( "" );
 242
 243     psz_parser = strstr( psz_val, psz_name );
 244
 245     if( ( b_add && psz_parser ) || ( !b_add && !psz_parser ) )
 246     {
 247         /* Nothing to do */
 248         free( psz_val );
 249         return false;
 250     }
 251
 252     if( b_add )
 253     {
 254         char *psz_old = psz_val;
 255         if( *psz_old )
 256         {
 257             if( asprintf( &psz_val, "%s:%s", psz_old, psz_name ) == -1 )
 258                 psz_val = NULL;
 259         }
 260         else
 261             psz_val = strdup( psz_name );
 262         free( psz_old );
 263     }
 264     else
 265     {
 266         const int i_name = strlen( psz_name );
 267         const char *psz_next;
 268
 269         psz_next = &psz_parser[i_name];
 270         if( *psz_next == ':' )
 271             psz_next++;
 272
 273         memmove( psz_parser, psz_next, strlen(psz_next)+1 );
 274     }
 275
 276     if( p_aout )
 277         var_SetString( p_aout, psz_variable, psz_val );
 278     else
 279         config_PutPsz( p_obj, psz_variable, psz_val );
 280     free( psz_val );
 281     return true;
 282 }
 283
 284 #endif /* !__LIBVLC_AOUT_INTERNAL_H */