1 /*****************************************************************************
2 * filters.c : audio output filters management
3 *****************************************************************************
4 * Copyright (C) 2002-2007 VLC authors and VideoLAN
7 * Authors: Christophe Massiot <massiot@via.ecp.fr>
9 * This program is free software; you can redistribute it and/or modify it
10 * under the terms of the GNU Lesser General Public License as published by
11 * the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public License
20 * along with this program; if not, write to the Free Software Foundation,
21 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22 *****************************************************************************/
24 /*****************************************************************************
26 *****************************************************************************/
34 #include <vlc_common.h>
35 #include <vlc_dialog.h>
36 #include <vlc_modules.h>
38 #include <vlc_filter.h>
39 #include <vlc_vout.h> /* for vout_Request */
42 #include "aout_internal.h"
44 /*****************************************************************************
45 * FindFilter: find an audio filter for a specific transformation
46 *****************************************************************************/
47 static filter_t * FindFilter( vlc_object_t *obj,
48 const audio_sample_format_t *infmt,
49 const audio_sample_format_t *outfmt )
51 static const char typename[] = "audio converter";
52 const char *type = "audio converter", *name = NULL;
55 p_filter = vlc_custom_create( obj, sizeof(*p_filter), typename );
57 if ( p_filter == NULL ) return NULL;
59 p_filter->fmt_in.audio = *infmt;
60 p_filter->fmt_in.i_codec = infmt->i_format;
61 p_filter->fmt_out.audio = *outfmt;
62 p_filter->fmt_out.i_codec = outfmt->i_format;
64 if( infmt->i_format == outfmt->i_format
65 && infmt->i_physical_channels == outfmt->i_physical_channels
66 && infmt->i_original_channels == outfmt->i_original_channels )
68 assert( infmt->i_rate != outfmt->i_rate );
69 type = "audio resampler";
70 name = "$audio-resampler";
73 p_filter->p_module = module_need( p_filter, type, name, false );
74 if ( p_filter->p_module == NULL )
76 vlc_object_release( p_filter );
80 assert( p_filter->pf_audio_filter );
85 * Splits audio format conversion in two simpler conversions
86 * @return 0 on successful split, -1 if the input and output formats are too
87 * similar to split the conversion.
89 static int SplitConversion( const audio_sample_format_t *restrict infmt,
90 const audio_sample_format_t *restrict outfmt,
91 audio_sample_format_t *midfmt )
95 /* Lastly: resample (after format conversion and remixing) */
96 if( infmt->i_rate != outfmt->i_rate )
97 midfmt->i_rate = infmt->i_rate;
99 /* Penultimately: remix channels (after format conversion) */
100 if( infmt->i_physical_channels != outfmt->i_physical_channels
101 || infmt->i_original_channels != outfmt->i_original_channels )
103 midfmt->i_physical_channels = infmt->i_physical_channels;
104 midfmt->i_original_channels = infmt->i_original_channels;
107 /* Second: convert linear to S16N as intermediate format */
108 if( AOUT_FMT_LINEAR( infmt ) )
110 /* All conversion from linear to S16N must be supported directly. */
111 if( outfmt->i_format == VLC_CODEC_S16N )
113 midfmt->i_format = VLC_CODEC_S16N;
116 /* First: convert non-linear to FI32 as intermediate format */
118 if( outfmt->i_format == VLC_CODEC_FI32 )
120 midfmt->i_format = VLC_CODEC_FI32;
123 assert( !AOUT_FMTS_IDENTICAL( infmt, midfmt ) );
124 aout_FormatPrepare( midfmt );
129 * Allocates audio format conversion filters
130 * @param obj parent VLC object for new filters
131 * @param filters table of filters [IN/OUT]
132 * @param nb_filters pointer to the number of filters in the table [IN/OUT]
133 * @param max_filters size of filters table [IN]
134 * @param infmt input audio format
135 * @param outfmt output audio format
136 * @return 0 on success, -1 on failure
138 int (aout_FiltersPipelineCreate)(vlc_object_t *obj, filter_t **filters,
139 unsigned *nb_filters, unsigned max_filters,
140 const audio_sample_format_t *restrict infmt,
141 const audio_sample_format_t *restrict outfmt)
143 audio_sample_format_t curfmt = *outfmt;
146 max_filters -= *nb_filters;
147 filters += *nb_filters;
148 aout_FormatsPrint( obj, "filter(s)", infmt, outfmt );
150 while( !AOUT_FMTS_IDENTICAL( infmt, &curfmt ) )
152 if( i >= max_filters )
154 msg_Err( obj, "maximum of %u filters reached", max_filters );
155 dialog_Fatal( obj, _("Audio filtering failed"),
156 _("The maximum number of filters (%u) was reached."),
161 /* Make room and prepend a filter */
162 memmove( filters + 1, filters, i * sizeof( *filters ) );
164 *filters = FindFilter( obj, infmt, &curfmt );
165 if( *filters != NULL )
171 audio_sample_format_t midfmt;
172 /* Split the conversion */
173 if( SplitConversion( infmt, &curfmt, &midfmt ) )
175 msg_Err( obj, "conversion pipeline failed: %4.4s -> %4.4s",
176 (const char *)&infmt->i_format,
177 (const char *)&outfmt->i_format );
181 *filters = FindFilter( obj, &midfmt, &curfmt );
182 if( *filters == NULL )
184 msg_Err( obj, "cannot find filter for simple conversion" );
191 msg_Dbg( obj, "conversion pipeline completed" );
196 aout_FiltersPipelineDestroy (filters, i);
201 * Destroys a chain of audio filters.
203 void aout_FiltersPipelineDestroy(filter_t *const *filters, unsigned n)
205 for( unsigned i = 0; i < n; i++ )
207 filter_t *p_filter = filters[i];
209 module_unneed( p_filter, p_filter->p_module );
210 vlc_object_release( p_filter );
214 static inline bool ChangeFiltersString (vlc_object_t *aout, const char *var,
215 const char *filter, bool add)
217 return aout_ChangeFilterString (aout, aout, var, filter, add);
221 * Filters an audio buffer through a chain of filters.
223 block_t *aout_FiltersPipelinePlay(filter_t *const *filters, unsigned count,
226 /* TODO: use filter chain */
227 for (unsigned i = 0; (i < count) && (block != NULL); i++)
229 filter_t *filter = filters[i];
231 /* Please note that p_block->i_nb_samples & i_buffer
232 * shall be set by the filter plug-in. */
233 block = filter->pf_audio_filter (filter, block);
238 /** Callback for visualization selection */
239 static int VisualizationCallback (vlc_object_t *obj, char const *var,
240 vlc_value_t oldval, vlc_value_t newval,
243 audio_output_t *aout = (audio_output_t *)obj;
244 const char *mode = newval.psz_string;
248 ChangeFiltersString (obj, "audio-visual", "goom", false);
249 ChangeFiltersString (obj, "audio-visual", "visual", false);
250 ChangeFiltersString (obj, "audio-visual", "projectm", false);
251 ChangeFiltersString (obj, "audio-visual", "vsxu", false);
253 else if (!strcmp ("goom", mode))
255 ChangeFiltersString (obj, "audio-visual", "visual", false );
256 ChangeFiltersString (obj, "audio-visual", "goom", true );
257 ChangeFiltersString (obj, "audio-visual", "projectm", false );
258 ChangeFiltersString (obj, "audio-visual", "vsxu", false);
260 else if (!strcmp ("projectm", mode))
262 ChangeFiltersString (obj, "audio-visual", "visual", false);
263 ChangeFiltersString (obj, "audio-visual", "goom", false);
264 ChangeFiltersString (obj, "audio-visual", "projectm", true);
265 ChangeFiltersString (obj, "audio-visual", "vsxu", false);
267 else if (!strcmp ("vsxu", mode))
269 ChangeFiltersString (obj, "audio-visual", "visual", false);
270 ChangeFiltersString (obj, "audio-visual", "goom", false);
271 ChangeFiltersString (obj, "audio-visual", "projectm", false);
272 ChangeFiltersString (obj, "audio-visual", "vsxu", true);
276 var_Create (obj, "effect-list", VLC_VAR_STRING);
277 var_SetString (obj, "effect-list", mode);
279 ChangeFiltersString (obj, "audio-visual", "goom", false);
280 ChangeFiltersString (obj, "audio-visual", "visual", true);
281 ChangeFiltersString (obj, "audio-visual", "projectm", false);
284 aout_InputRequestRestart (aout);
285 (void) var; (void) oldval; (void) data;
289 static int EqualizerCallback (vlc_object_t *obj, char const *var,
290 vlc_value_t oldval, vlc_value_t newval,
293 audio_output_t *aout = (audio_output_t *)obj;
294 char *mode = newval.psz_string;
298 ret = ChangeFiltersString (obj, "audio-filter", "equalizer", false);
301 var_Create (obj, "equalizer-preset", VLC_VAR_STRING);
302 var_SetString (obj, "equalizer-preset", mode);
303 ret = ChangeFiltersString (obj, "audio-filter", "equalizer", true);
308 aout_InputRequestRestart (aout);
309 (void) var; (void) oldval; (void) data;
313 static vout_thread_t *RequestVout (void *data, vout_thread_t *vout,
314 video_format_t *fmt, bool recycle)
316 audio_output_t *aout = data;
317 vout_configuration_t cfg = {
326 return vout_Request (aout, &cfg);
329 vout_thread_t *aout_filter_RequestVout (filter_t *filter, vout_thread_t *vout,
332 /* NOTE: This only works from audio output.
333 * If you want to use visualization filters from another place, you will
334 * need to add a new pf_aout_request_vout callback or store a pointer
335 * to aout_request_vout_t inside filter_t (i.e. a level of indirection). */
336 aout_owner_t *owner = aout_owner ((audio_output_t *)filter->p_parent);
337 aout_request_vout_t *req = &owner->request_vout;
339 return req->pf_request_vout (req->p_private, vout, fmt,
340 owner->recycle_vout);
343 static filter_t *CreateFilter (vlc_object_t *parent, const char *name,
344 const audio_sample_format_t *restrict infmt,
345 const audio_sample_format_t *restrict outfmt,
348 filter_t *filter = vlc_custom_create (parent, sizeof (*filter),
350 if (unlikely(filter == NULL))
353 /*filter->p_owner = NOT NEEDED;*/
354 filter->fmt_in.i_codec = infmt->i_format;
355 filter->fmt_in.audio = *infmt;
356 filter->fmt_out.i_codec = outfmt->i_format;
357 filter->fmt_out.audio = *outfmt;
361 filter->p_module = module_need (filter, "audio filter", name, true);
362 if (filter->p_module != NULL)
365 /* If probing failed, formats shall not have been modified. */
366 assert (AOUT_FMTS_IDENTICAL(&filter->fmt_in.audio, infmt));
367 assert (AOUT_FMTS_IDENTICAL(&filter->fmt_out.audio, outfmt));
370 filter->p_module = module_need (filter, "visualization2", name, true);
371 if (filter->p_module != NULL)
374 vlc_object_release (filter);
379 * Sets up the audio filters.
381 int aout_FiltersNew (audio_output_t *aout,
382 const audio_sample_format_t *restrict infmt,
383 const audio_sample_format_t *restrict outfmt,
384 const aout_request_vout_t *request_vout)
386 aout_owner_t *owner = aout_owner (aout);
388 /* Prepare format structure */
389 aout_FormatPrint (aout, "input", infmt);
390 audio_sample_format_t input_format = *infmt;
391 audio_sample_format_t output_format = *outfmt;
393 /* Now add user filters */
394 owner->nb_filters = 0;
395 owner->rate_filter = NULL;
396 owner->resampler = NULL;
398 var_AddCallback (aout, "visual", VisualizationCallback, NULL);
399 var_AddCallback (aout, "equalizer", EqualizerCallback, NULL);
401 if (!AOUT_FMT_LINEAR(outfmt))
404 const char *scaletempo =
405 var_InheritBool (aout, "audio-time-stretch") ? "scaletempo" : NULL;
406 char *filters = var_InheritString (aout, "audio-filter");
407 char *visual = var_InheritString (aout, "audio-visual");
409 if (request_vout != NULL)
410 owner->request_vout = *request_vout;
413 owner->request_vout.pf_request_vout = RequestVout;
414 owner->request_vout.p_private = aout;
416 owner->recycle_vout = (visual != NULL) && *visual;
418 /* parse user filter lists */
419 const char *list[AOUT_MAX_FILTERS];
422 if (scaletempo != NULL)
423 list[n++] = scaletempo;
426 char *p = filters, *name;
427 while ((name = strsep (&p, " :")) != NULL && n < AOUT_MAX_FILTERS)
430 if (visual != NULL && n < AOUT_MAX_FILTERS)
433 for (unsigned i = 0; i < n; i++)
435 const char *name = list[i];
437 if (owner->nb_filters >= AOUT_MAX_FILTERS)
439 msg_Err (aout, "maximum of %u filters reached", AOUT_MAX_FILTERS);
440 msg_Err (aout, "cannot add user filter %s (skipped)", name);
444 filter_t *filter = CreateFilter (VLC_OBJECT(aout), name,
445 &input_format, &output_format,
449 msg_Err (aout, "cannot add user filter %s (skipped)", name);
453 /* convert to the filter input format if necessary */
454 if (aout_FiltersPipelineCreate (aout, owner->filters,
456 AOUT_MAX_FILTERS - 1,
457 &input_format, &filter->fmt_in.audio))
459 msg_Err (aout, "cannot add user filter %s (skipped)", name);
460 module_unneed (filter, filter->p_module);
461 vlc_object_release (filter);
465 assert (owner->nb_filters < AOUT_MAX_FILTERS);
466 owner->filters[owner->nb_filters++] = filter;
467 input_format = filter->fmt_out.audio;
469 if (name == scaletempo)
470 owner->rate_filter = filter;
475 /* convert to the output format (minus resampling) if necessary */
476 output_format.i_rate = input_format.i_rate;
477 if (aout_FiltersPipelineCreate (aout, owner->filters, &owner->nb_filters,
479 &input_format, &output_format))
481 msg_Err (aout, "cannot setup filtering pipeline");
484 input_format = output_format;
486 /* insert the resampler */
487 output_format.i_rate = outfmt->i_rate;
488 assert (AOUT_FMTS_IDENTICAL(&output_format, outfmt));
490 unsigned rate_bak = input_format.i_rate;
491 if (output_format.i_rate == input_format.i_rate)
492 /* For historical reasons, a different rate is required to probe
493 * resampling filters. */
494 input_format.i_rate++;
495 owner->resampler = FindFilter (VLC_OBJECT(aout), &input_format,
497 if (owner->resampler == NULL)
499 msg_Err (aout, "cannot setup a resampler");
502 owner->resampler->fmt_in.audio.i_rate = rate_bak;
503 if (owner->rate_filter == NULL)
504 owner->rate_filter = owner->resampler;
509 aout_FiltersPipelineDestroy (owner->filters, owner->nb_filters);
510 var_DelCallback (aout, "equalizer", EqualizerCallback, NULL);
511 var_DelCallback (aout, "visual", VisualizationCallback, NULL);
516 * Destroys the audio filters.
518 void aout_FiltersDelete (audio_output_t *aout)
520 aout_owner_t *owner = aout_owner (aout);
522 if (owner->resampler != NULL)
523 aout_FiltersPipelineDestroy (&owner->resampler, 1);
524 aout_FiltersPipelineDestroy (owner->filters, owner->nb_filters);
525 var_DelCallback (aout, "equalizer", EqualizerCallback, NULL);
526 var_DelCallback (aout, "visual", VisualizationCallback, NULL);
528 /* XXX We need to update recycle_vout before calling
529 * aout_FiltersPipelineDestroy().
530 * FIXME There may be a race condition if audio-visual is updated between
531 * aout_FiltersDestroy() and the next aout_FiltersNew().
533 char *visual = var_InheritString (aout, "audio-visual");
534 owner->recycle_vout = (visual != NULL) && *visual;