1 /*****************************************************************************
2 * libvlc_audio.c: New libvlc audio control API
3 *****************************************************************************
4 * Copyright (C) 2006 VLC authors and VideoLAN
7 * Authors: Filippo Carone <filippo@carone.org>
8 * Jean-Paul Saman <jpsaman _at_ m2x _dot_ nl>
10 * This program is free software; you can redistribute it and/or modify it
11 * under the terms of the GNU Lesser General Public License as published by
12 * the Free Software Foundation; either version 2.1 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU Lesser General Public License for more details.
20 * You should have received a copy of the GNU Lesser General Public License
21 * along with this program; if not, write to the Free Software Foundation,
22 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
32 #include <vlc/libvlc.h>
33 #include <vlc/libvlc_media.h>
34 #include <vlc/libvlc_media_player.h>
36 #include <vlc_common.h>
37 #include <vlc_input.h>
39 #include <vlc_modules.h>
41 #include "libvlc_internal.h"
42 #include "media_player_internal.h"
45 * Remember to release the returned audio_output_t since it is locked at
46 * the end of this function.
48 static audio_output_t *GetAOut( libvlc_media_player_t *mp )
52 audio_output_t *p_aout = input_resource_HoldAout( mp->input.p_resource );
54 libvlc_printerr( "No active audio output" );
58 /*****************************************
59 * Get the list of available audio outputs
60 *****************************************/
61 libvlc_audio_output_t *
62 libvlc_audio_output_list_get( libvlc_instance_t *p_instance )
65 module_t **module_list = module_list_get( &count );
66 libvlc_audio_output_t *list = NULL;
68 for (size_t i = 0; i < count; i++)
70 module_t *module = module_list[i];
72 if( !module_provides( module, "audio output" ) )
75 libvlc_audio_output_t *item = malloc( sizeof( *item ) );
76 if( unlikely(item == NULL) )
79 libvlc_printerr( "Not enough memory" );
80 libvlc_audio_output_list_release( list );
85 item->psz_name = strdup( module_get_object( module ) );
86 item->psz_description = strdup( module_get_name( module, true ) );
87 if( unlikely(item->psz_name == NULL || item->psz_description == NULL) )
95 module_list_free( module_list );
97 VLC_UNUSED( p_instance );
101 /********************************************
102 * Free the list of available audio outputs
103 ***********************************************/
104 void libvlc_audio_output_list_release( libvlc_audio_output_t *list )
106 while( list != NULL )
108 libvlc_audio_output_t *next = list->p_next;
110 free( list->psz_name );
111 free( list->psz_description );
118 /***********************
119 * Set the audio output.
120 ***********************/
121 int libvlc_audio_output_set( libvlc_media_player_t *mp, const char *psz_name )
125 if( !module_exists( psz_name )
126 || asprintf( &value, "%s,none", psz_name ) == -1 )
128 var_SetString( mp, "aout", value );
131 /* Forget the existing audio output */
132 input_resource_ResetAout(mp->input.p_resource);
134 /* Create a new audio output */
135 audio_output_t *aout = input_resource_GetAout(mp->input.p_resource);
137 input_resource_PutAout(mp->input.p_resource, aout);
142 libvlc_audio_output_device_t *
143 libvlc_audio_output_device_enum( libvlc_media_player_t *mp )
145 audio_output_t *aout = GetAOut( mp );
149 libvlc_audio_output_device_t *list = NULL, **pp = &list;
150 char **values, **texts;
152 int n = aout_DevicesList( aout, &values, &texts );
156 for (int i = 0; i < n; i++)
158 libvlc_audio_output_device_t *item = malloc( sizeof(*item) );
159 if( unlikely(item == NULL) )
168 item->psz_device = values[i];
169 item->psz_description = texts[i];
178 libvlc_audio_output_device_t *
179 libvlc_audio_output_device_list_get( libvlc_instance_t *p_instance,
183 if( (size_t)snprintf( varname, sizeof(varname), "%s-audio-device", aout )
187 libvlc_audio_output_device_t *list = NULL, **pp = &list;
188 char **values, **texts;
189 ssize_t count = config_GetPszChoices( VLC_OBJECT(p_instance->p_libvlc_int),
190 varname, &values, &texts );
191 for( ssize_t i = 0; i < count; i++ )
193 libvlc_audio_output_device_t *item = malloc( sizeof(*item) );
194 if( unlikely(item == NULL) )
199 item->psz_device = values[i];
200 item->psz_description = texts[i];
210 void libvlc_audio_output_device_list_release( libvlc_audio_output_device_t *l )
214 libvlc_audio_output_device_t *next = l->p_next;
216 free( l->psz_description );
217 free( l->psz_device );
223 int libvlc_audio_output_device_count( libvlc_instance_t *p_instance,
224 const char *psz_audio_output )
226 (void) p_instance; (void) psz_audio_output;
230 char *libvlc_audio_output_device_longname( libvlc_instance_t *p_instance,
231 const char *psz_audio_output,
234 (void) p_instance; (void) psz_audio_output; (void) i_device;
238 char *libvlc_audio_output_device_id( libvlc_instance_t *p_instance,
239 const char *psz_audio_output,
242 (void) p_instance; (void) psz_audio_output; (void) i_device;
246 /*****************************
247 * Set device for using
248 *****************************/
249 void libvlc_audio_output_device_set( libvlc_media_player_t *mp,
250 const char *module, const char *devid )
259 if( asprintf( &cfg_name, "%s-audio-device", module ) == -1 )
262 if( !var_Type( mp, cfg_name ) )
263 /* Don't recreate the same variable over and over and over... */
264 var_Create( mp, cfg_name, VLC_VAR_STRING );
265 var_SetString( mp, cfg_name, devid );
270 audio_output_t *aout = GetAOut( mp );
274 aout_DeviceSet( aout, devid );
275 vlc_object_release( aout );
278 int libvlc_audio_output_get_device_type( libvlc_media_player_t *mp )
281 return libvlc_AudioOutputDevice_Error;
284 void libvlc_audio_output_set_device_type( libvlc_media_player_t *mp,
287 (void) mp; (void) device_type;
290 void libvlc_audio_toggle_mute( libvlc_media_player_t *mp )
292 int mute = libvlc_audio_get_mute( mp );
294 libvlc_audio_set_mute( mp, !mute );
297 int libvlc_audio_get_mute( libvlc_media_player_t *mp )
301 audio_output_t *aout = GetAOut( mp );
304 mute = aout_MuteGet( aout );
305 vlc_object_release( aout );
310 void libvlc_audio_set_mute( libvlc_media_player_t *mp, int mute )
312 audio_output_t *aout = GetAOut( mp );
315 mute = aout_MuteSet( aout, mute );
316 vlc_object_release( aout );
320 int libvlc_audio_get_volume( libvlc_media_player_t *mp )
324 audio_output_t *aout = GetAOut( mp );
327 float vol = aout_VolumeGet( aout );
328 vlc_object_release( aout );
329 volume = lroundf( vol * 100.f );
334 int libvlc_audio_set_volume( libvlc_media_player_t *mp, int volume )
336 float vol = volume / 100.f;
337 if (!isgreaterequal(vol, 0.f))
339 libvlc_printerr( "Volume out of range" );
344 audio_output_t *aout = GetAOut( mp );
347 ret = aout_VolumeSet( aout, vol );
348 vlc_object_release( aout );
353 /*****************************************************************************
354 * libvlc_audio_get_track_count : Get the number of available audio tracks
355 *****************************************************************************/
356 int libvlc_audio_get_track_count( libvlc_media_player_t *p_mi )
358 input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi );
361 if( !p_input_thread )
364 i_track_count = var_CountChoices( p_input_thread, "audio-es" );
366 vlc_object_release( p_input_thread );
367 return i_track_count;
370 /*****************************************************************************
371 * libvlc_audio_get_track_description : Get the description of available audio tracks
372 *****************************************************************************/
373 libvlc_track_description_t *
374 libvlc_audio_get_track_description( libvlc_media_player_t *p_mi )
376 return libvlc_get_track_description( p_mi, "audio-es" );
379 /*****************************************************************************
380 * libvlc_audio_get_track : Get the current audio track
381 *****************************************************************************/
382 int libvlc_audio_get_track( libvlc_media_player_t *p_mi )
384 input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi );
385 if( !p_input_thread )
388 int id = var_GetInteger( p_input_thread, "audio-es" );
389 vlc_object_release( p_input_thread );
393 /*****************************************************************************
394 * libvlc_audio_set_track : Set the current audio track
395 *****************************************************************************/
396 int libvlc_audio_set_track( libvlc_media_player_t *p_mi, int i_track )
398 input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi );
399 vlc_value_t val_list;
402 if( !p_input_thread )
405 var_Change( p_input_thread, "audio-es", VLC_VAR_GETCHOICES, &val_list, NULL );
406 for( int i = 0; i < val_list.p_list->i_count; i++ )
408 if( i_track == val_list.p_list->p_values[i].i_int )
410 if( var_SetInteger( p_input_thread, "audio-es", i_track ) < 0 )
416 libvlc_printerr( "Track identifier not found" );
418 var_FreeList( &val_list, NULL );
419 vlc_object_release( p_input_thread );
423 /*****************************************************************************
424 * libvlc_audio_get_channel : Get the current audio channel
425 *****************************************************************************/
426 int libvlc_audio_get_channel( libvlc_media_player_t *mp )
428 audio_output_t *p_aout = GetAOut( mp );
432 int val = var_GetInteger( p_aout, "stereo-mode" );
433 vlc_object_release( p_aout );
437 /*****************************************************************************
438 * libvlc_audio_set_channel : Set the current audio channel
439 *****************************************************************************/
440 int libvlc_audio_set_channel( libvlc_media_player_t *mp, int channel )
442 audio_output_t *p_aout = GetAOut( mp );
448 if( var_SetInteger( p_aout, "stereo-mode", channel ) < 0 )
450 libvlc_printerr( "Audio channel out of range" );
453 vlc_object_release( p_aout );
457 /*****************************************************************************
458 * libvlc_audio_get_delay : Get the current audio delay
459 *****************************************************************************/
460 int64_t libvlc_audio_get_delay( libvlc_media_player_t *p_mi )
462 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
464 if( p_input_thread != NULL )
466 val = var_GetTime( p_input_thread, "audio-delay" );
467 vlc_object_release( p_input_thread );
472 /*****************************************************************************
473 * libvlc_audio_set_delay : Set the current audio delay
474 *****************************************************************************/
475 int libvlc_audio_set_delay( libvlc_media_player_t *p_mi, int64_t i_delay )
477 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
479 if( p_input_thread != NULL )
481 var_SetTime( p_input_thread, "audio-delay", i_delay );
482 vlc_object_release( p_input_thread );
491 /*****************************************************************************
492 * libvlc_audio_equalizer_get_preset_count : Get the number of equalizer presets
493 *****************************************************************************/
494 unsigned libvlc_audio_equalizer_get_preset_count( void )
499 /*****************************************************************************
500 * libvlc_audio_equalizer_get_preset_name : Get the name for a preset
501 *****************************************************************************/
502 const char *libvlc_audio_equalizer_get_preset_name( unsigned u_index )
504 if ( u_index >= NB_PRESETS )
507 return preset_list_text[ u_index ];
510 /*****************************************************************************
511 * libvlc_audio_equalizer_get_band_count : Get the number of equalizer frequency bands
512 *****************************************************************************/
513 unsigned libvlc_audio_equalizer_get_band_count( void )
515 return EQZ_BANDS_MAX;
518 /*****************************************************************************
519 * libvlc_audio_equalizer_get_band_frequency : Get the frequency for a band
520 *****************************************************************************/
521 float libvlc_audio_equalizer_get_band_frequency( unsigned u_index )
523 if ( u_index >= EQZ_BANDS_MAX )
526 return f_iso_frequency_table_10b[ u_index ];
529 /*****************************************************************************
530 * libvlc_audio_equalizer_new : Create a new audio equalizer with zeroed values
531 *****************************************************************************/
532 libvlc_equalizer_t *libvlc_audio_equalizer_new( void )
534 libvlc_equalizer_t *p_equalizer;
535 p_equalizer = malloc( sizeof( *p_equalizer ) );
536 if ( unlikely( p_equalizer == NULL ) )
539 p_equalizer->f_preamp = 0.f;
540 for ( unsigned i = 0; i < EQZ_BANDS_MAX; i++ )
541 p_equalizer->f_amp[ i ] = 0.f;
546 /*****************************************************************************
547 * libvlc_audio_equalizer_new_from_preset : Create a new audio equalizer based on a preset
548 *****************************************************************************/
549 libvlc_equalizer_t *libvlc_audio_equalizer_new_from_preset( unsigned u_index )
551 libvlc_equalizer_t *p_equalizer;
553 if ( u_index >= NB_PRESETS )
556 p_equalizer = malloc( sizeof( *p_equalizer ) );
557 if ( unlikely( p_equalizer == NULL ) )
560 p_equalizer->f_preamp = eqz_preset_10b[ u_index ].f_preamp;
562 for ( unsigned i = 0; i < EQZ_BANDS_MAX; i++ )
563 p_equalizer->f_amp[ i ] = eqz_preset_10b[ u_index ].f_amp[ i ];
568 /*****************************************************************************
569 * libvlc_audio_equalizer_release : Release a previously created equalizer
570 *****************************************************************************/
571 void libvlc_audio_equalizer_release( libvlc_equalizer_t *p_equalizer )
576 /*****************************************************************************
577 * libvlc_audio_equalizer_set_preamp : Set the preamp value for an equalizer
578 *****************************************************************************/
579 int libvlc_audio_equalizer_set_preamp( libvlc_equalizer_t *p_equalizer, float f_preamp )
581 if( isnan(f_preamp) )
583 if( f_preamp < -20.f )
585 else if( f_preamp > 20.f )
588 p_equalizer->f_preamp = f_preamp;
592 /*****************************************************************************
593 * libvlc_audio_equalizer_get_preamp : Get the preamp value for an equalizer
594 *****************************************************************************/
595 float libvlc_audio_equalizer_get_preamp( libvlc_equalizer_t *p_equalizer )
597 return p_equalizer->f_preamp;
600 /*****************************************************************************
601 * libvlc_audio_equalizer_set_amp_at_index : Set the amplification value for an equalizer band
602 *****************************************************************************/
603 int libvlc_audio_equalizer_set_amp_at_index( libvlc_equalizer_t *p_equalizer, float f_amp, unsigned u_band )
605 if( u_band >= EQZ_BANDS_MAX || isnan(f_amp) )
611 else if( f_amp > 20.f )
614 p_equalizer->f_amp[ u_band ] = f_amp;
618 /*****************************************************************************
619 * libvlc_audio_equalizer_get_amp_at_index : Get the amplification value for an equalizer band
620 *****************************************************************************/
621 float libvlc_audio_equalizer_get_amp_at_index( libvlc_equalizer_t *p_equalizer, unsigned u_band )
623 if ( u_band >= EQZ_BANDS_MAX )
626 return p_equalizer->f_amp[ u_band ];