1 /*****************************************************************************
2 * aout_internal.h : internal defines for audio output
3 *****************************************************************************
4 * Copyright (C) 2002 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 #if defined(__PLUGIN__) || defined(__BUILTIN__) || !defined(__LIBVLC__)
25 # error This header file can only be included from LibVLC.
28 #ifndef __LIBVLC_AOUT_INTERNAL_H
29 # define __LIBVLC_AOUT_INTERNAL_H 1
31 aout_buffer_t *aout_BufferAlloc(aout_alloc_t *allocation, mtime_t microseconds,
32 aout_buffer_t *old_buffer);
36 struct vout_thread_t *(*pf_request_vout)( void *, struct vout_thread_t *,
37 video_format_t *, bool );
39 } aout_request_vout_t;
41 struct aout_filter_owner_sys_t
43 aout_instance_t *p_aout;
44 aout_input_t *p_input;
47 /** an input stream for the audio output */
50 /* When this lock is taken, the pipeline cannot be changed by a
54 audio_sample_format_t input;
55 aout_alloc_t input_alloc;
58 aout_filter_t * pp_filters[AOUT_MAX_FILTERS];
61 aout_filter_t * p_playback_rate_filter;
64 aout_filter_t * pp_resamplers[AOUT_MAX_FILTERS];
66 int i_resampling_type;
67 mtime_t i_resamp_start_date;
68 int i_resamp_start_drift;
70 /* Mixer information */
71 audio_replay_gain_t replay_gain;
73 /* If b_restart == 1, the input pipeline will be re-created. */
76 /* If b_error == 1, there is no input pipeline. */
79 /* Did we just change the output format? (expect buffer inconsistencies) */
82 /* last rate from input */
83 int i_last_input_rate;
94 aout_request_vout_t request_vout;
97 aout_mixer_input_t mixer;
100 /****************************************************************************
102 *****************************************************************************/
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 );
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 );
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 );
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 );
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 * );
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 );
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 * );
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 * );
167 static inline void aout_lock_mixer( aout_instance_t *p_aout )
169 vlc_mutex_lock( &p_aout->mixer_lock );
172 static inline void aout_unlock_mixer( aout_instance_t *p_aout )
174 vlc_mutex_unlock( &p_aout->mixer_lock );
177 static inline void aout_lock_input_fifos( aout_instance_t *p_aout )
179 vlc_mutex_lock( &p_aout->input_fifos_lock );
182 static inline void aout_unlock_input_fifos( aout_instance_t *p_aout )
184 vlc_mutex_unlock( &p_aout->input_fifos_lock );
187 static inline void aout_lock_output_fifo( aout_instance_t *p_aout )
189 vlc_mutex_lock( &p_aout->output_fifo_lock );
192 static inline void aout_unlock_output_fifo( aout_instance_t *p_aout )
194 vlc_mutex_unlock( &p_aout->output_fifo_lock );
197 static inline void aout_lock_input( aout_instance_t *p_aout, aout_input_t * p_input )
200 vlc_mutex_lock( &p_input->lock );
203 static inline void aout_unlock_input( aout_instance_t *p_aout, aout_input_t * p_input )
206 vlc_mutex_unlock( &p_input->lock );
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 )
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 );
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 )
232 if( *psz_name == '\0' )
236 psz_val = var_GetString( p_aout, psz_variable );
238 psz_val = config_GetPsz( p_obj, "audio-filter" );
241 psz_val = strdup( "" );
243 psz_parser = strstr( psz_val, psz_name );
245 if( ( b_add && psz_parser ) || ( !b_add && !psz_parser ) )
254 char *psz_old = psz_val;
257 if( asprintf( &psz_val, "%s:%s", psz_old, psz_name ) == -1 )
261 psz_val = strdup( psz_name );
266 const int i_name = strlen( psz_name );
267 const char *psz_next;
269 psz_next = &psz_parser[i_name];
270 if( *psz_next == ':' )
273 memmove( psz_parser, psz_next, strlen(psz_next)+1 );
277 var_SetString( p_aout, psz_variable, psz_val );
279 config_PutPsz( p_obj, psz_variable, psz_val );
284 #endif /* !__LIBVLC_AOUT_INTERNAL_H */