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
, **pp
= &list
;
150 char **values
, **texts
;
152 int n
= aout_DevicesList( aout
, &values
, &texts
);
153 vlc_object_release( aout
);
157 for (int i
= 0; i
< n
; i
++)
159 libvlc_audio_output_device_t
*item
= malloc( sizeof(*item
) );
160 if( unlikely(item
== NULL
) )
169 item
->psz_device
= values
[i
];
170 item
->psz_description
= texts
[i
];
180 libvlc_audio_output_device_t
*
181 libvlc_audio_output_device_list_get( libvlc_instance_t
*p_instance
,
185 if( (size_t)snprintf( varname
, sizeof(varname
), "%s-audio-device", aout
)
189 libvlc_audio_output_device_t
*list
= NULL
, **pp
= &list
;
190 char **values
, **texts
;
191 ssize_t count
= config_GetPszChoices( VLC_OBJECT(p_instance
->p_libvlc_int
),
192 varname
, &values
, &texts
);
193 for( ssize_t i
= 0; i
< count
; i
++ )
195 libvlc_audio_output_device_t
*item
= malloc( sizeof(*item
) );
196 if( unlikely(item
== NULL
) )
201 item
->psz_device
= values
[i
];
202 item
->psz_description
= texts
[i
];
212 void libvlc_audio_output_device_list_release( libvlc_audio_output_device_t
*l
)
216 libvlc_audio_output_device_t
*next
= l
->p_next
;
218 free( l
->psz_description
);
219 free( l
->psz_device
);
225 int libvlc_audio_output_device_count( libvlc_instance_t
*p_instance
,
226 const char *psz_audio_output
)
228 (void) p_instance
; (void) psz_audio_output
;
232 char *libvlc_audio_output_device_longname( libvlc_instance_t
*p_instance
,
233 const char *psz_audio_output
,
236 (void) p_instance
; (void) psz_audio_output
; (void) i_device
;
240 char *libvlc_audio_output_device_id( libvlc_instance_t
*p_instance
,
241 const char *psz_audio_output
,
244 (void) p_instance
; (void) psz_audio_output
; (void) i_device
;
248 /*****************************
249 * Set device for using
250 *****************************/
251 void libvlc_audio_output_device_set( libvlc_media_player_t
*mp
,
252 const char *module
, const char *devid
)
261 if( asprintf( &cfg_name
, "%s-audio-device", module
) == -1 )
264 if( !var_Type( mp
, cfg_name
) )
265 /* Don't recreate the same variable over and over and over... */
266 var_Create( mp
, cfg_name
, VLC_VAR_STRING
);
267 var_SetString( mp
, cfg_name
, devid
);
272 audio_output_t
*aout
= GetAOut( mp
);
276 aout_DeviceSet( aout
, devid
);
277 vlc_object_release( aout
);
280 char *libvlc_audio_output_device_get( libvlc_media_player_t
*mp
)
282 audio_output_t
*aout
= GetAOut( mp
);
286 char *devid
= aout_DeviceGet( aout
);
288 vlc_object_release( aout
);
293 int libvlc_audio_output_get_device_type( libvlc_media_player_t
*mp
)
296 return libvlc_AudioOutputDevice_Error
;
299 void libvlc_audio_output_set_device_type( libvlc_media_player_t
*mp
,
302 (void) mp
; (void) device_type
;
305 void libvlc_audio_toggle_mute( libvlc_media_player_t
*mp
)
307 int mute
= libvlc_audio_get_mute( mp
);
309 libvlc_audio_set_mute( mp
, !mute
);
312 int libvlc_audio_get_mute( libvlc_media_player_t
*mp
)
316 audio_output_t
*aout
= GetAOut( mp
);
319 mute
= aout_MuteGet( aout
);
320 vlc_object_release( aout
);
325 void libvlc_audio_set_mute( libvlc_media_player_t
*mp
, int mute
)
327 audio_output_t
*aout
= GetAOut( mp
);
330 mute
= aout_MuteSet( aout
, mute
);
331 vlc_object_release( aout
);
335 int libvlc_audio_get_volume( libvlc_media_player_t
*mp
)
339 audio_output_t
*aout
= GetAOut( mp
);
342 float vol
= aout_VolumeGet( aout
);
343 vlc_object_release( aout
);
344 volume
= lroundf( vol
* 100.f
);
349 int libvlc_audio_set_volume( libvlc_media_player_t
*mp
, int volume
)
351 float vol
= volume
/ 100.f
;
352 if (!isgreaterequal(vol
, 0.f
))
354 libvlc_printerr( "Volume out of range" );
359 audio_output_t
*aout
= GetAOut( mp
);
362 ret
= aout_VolumeSet( aout
, vol
);
363 vlc_object_release( aout
);
368 /*****************************************************************************
369 * libvlc_audio_get_track_count : Get the number of available audio tracks
370 *****************************************************************************/
371 int libvlc_audio_get_track_count( libvlc_media_player_t
*p_mi
)
373 input_thread_t
*p_input_thread
= libvlc_get_input_thread( p_mi
);
376 if( !p_input_thread
)
379 i_track_count
= var_CountChoices( p_input_thread
, "audio-es" );
381 vlc_object_release( p_input_thread
);
382 return i_track_count
;
385 /*****************************************************************************
386 * libvlc_audio_get_track_description : Get the description of available audio tracks
387 *****************************************************************************/
388 libvlc_track_description_t
*
389 libvlc_audio_get_track_description( libvlc_media_player_t
*p_mi
)
391 return libvlc_get_track_description( p_mi
, "audio-es" );
394 /*****************************************************************************
395 * libvlc_audio_get_track : Get the current audio track
396 *****************************************************************************/
397 int libvlc_audio_get_track( libvlc_media_player_t
*p_mi
)
399 input_thread_t
*p_input_thread
= libvlc_get_input_thread( p_mi
);
400 if( !p_input_thread
)
403 int id
= var_GetInteger( p_input_thread
, "audio-es" );
404 vlc_object_release( p_input_thread
);
408 /*****************************************************************************
409 * libvlc_audio_set_track : Set the current audio track
410 *****************************************************************************/
411 int libvlc_audio_set_track( libvlc_media_player_t
*p_mi
, int i_track
)
413 input_thread_t
*p_input_thread
= libvlc_get_input_thread( p_mi
);
414 vlc_value_t val_list
;
417 if( !p_input_thread
)
420 var_Change( p_input_thread
, "audio-es", VLC_VAR_GETCHOICES
, &val_list
, NULL
);
421 for( int i
= 0; i
< val_list
.p_list
->i_count
; i
++ )
423 if( i_track
== val_list
.p_list
->p_values
[i
].i_int
)
425 if( var_SetInteger( p_input_thread
, "audio-es", i_track
) < 0 )
431 libvlc_printerr( "Track identifier not found" );
433 var_FreeList( &val_list
, NULL
);
434 vlc_object_release( p_input_thread
);
438 /*****************************************************************************
439 * libvlc_audio_get_channel : Get the current audio channel
440 *****************************************************************************/
441 int libvlc_audio_get_channel( libvlc_media_player_t
*mp
)
443 audio_output_t
*p_aout
= GetAOut( mp
);
447 int val
= var_GetInteger( p_aout
, "stereo-mode" );
448 vlc_object_release( p_aout
);
452 /*****************************************************************************
453 * libvlc_audio_set_channel : Set the current audio channel
454 *****************************************************************************/
455 int libvlc_audio_set_channel( libvlc_media_player_t
*mp
, int channel
)
457 audio_output_t
*p_aout
= GetAOut( mp
);
463 if( var_SetInteger( p_aout
, "stereo-mode", channel
) < 0 )
465 libvlc_printerr( "Audio channel out of range" );
468 vlc_object_release( p_aout
);
472 /*****************************************************************************
473 * libvlc_audio_get_delay : Get the current audio delay
474 *****************************************************************************/
475 int64_t libvlc_audio_get_delay( libvlc_media_player_t
*p_mi
)
477 input_thread_t
*p_input_thread
= libvlc_get_input_thread ( p_mi
);
479 if( p_input_thread
!= NULL
)
481 val
= var_GetTime( p_input_thread
, "audio-delay" );
482 vlc_object_release( p_input_thread
);
487 /*****************************************************************************
488 * libvlc_audio_set_delay : Set the current audio delay
489 *****************************************************************************/
490 int libvlc_audio_set_delay( libvlc_media_player_t
*p_mi
, int64_t i_delay
)
492 input_thread_t
*p_input_thread
= libvlc_get_input_thread ( p_mi
);
494 if( p_input_thread
!= NULL
)
496 var_SetTime( p_input_thread
, "audio-delay", i_delay
);
497 vlc_object_release( p_input_thread
);
506 /*****************************************************************************
507 * libvlc_audio_equalizer_get_preset_count : Get the number of equalizer presets
508 *****************************************************************************/
509 unsigned libvlc_audio_equalizer_get_preset_count( void )
514 /*****************************************************************************
515 * libvlc_audio_equalizer_get_preset_name : Get the name for a preset
516 *****************************************************************************/
517 const char *libvlc_audio_equalizer_get_preset_name( unsigned u_index
)
519 if ( u_index
>= NB_PRESETS
)
522 return preset_list_text
[ u_index
];
525 /*****************************************************************************
526 * libvlc_audio_equalizer_get_band_count : Get the number of equalizer frequency bands
527 *****************************************************************************/
528 unsigned libvlc_audio_equalizer_get_band_count( void )
530 return EQZ_BANDS_MAX
;
533 /*****************************************************************************
534 * libvlc_audio_equalizer_get_band_frequency : Get the frequency for a band
535 *****************************************************************************/
536 float libvlc_audio_equalizer_get_band_frequency( unsigned u_index
)
538 if ( u_index
>= EQZ_BANDS_MAX
)
541 return f_iso_frequency_table_10b
[ u_index
];
544 /*****************************************************************************
545 * libvlc_audio_equalizer_new : Create a new audio equalizer with zeroed values
546 *****************************************************************************/
547 libvlc_equalizer_t
*libvlc_audio_equalizer_new( void )
549 libvlc_equalizer_t
*p_equalizer
;
550 p_equalizer
= malloc( sizeof( *p_equalizer
) );
551 if ( unlikely( p_equalizer
== NULL
) )
554 p_equalizer
->f_preamp
= 0.f
;
555 for ( unsigned i
= 0; i
< EQZ_BANDS_MAX
; i
++ )
556 p_equalizer
->f_amp
[ i
] = 0.f
;
561 /*****************************************************************************
562 * libvlc_audio_equalizer_new_from_preset : Create a new audio equalizer based on a preset
563 *****************************************************************************/
564 libvlc_equalizer_t
*libvlc_audio_equalizer_new_from_preset( unsigned u_index
)
566 libvlc_equalizer_t
*p_equalizer
;
568 if ( u_index
>= NB_PRESETS
)
571 p_equalizer
= malloc( sizeof( *p_equalizer
) );
572 if ( unlikely( p_equalizer
== NULL
) )
575 p_equalizer
->f_preamp
= eqz_preset_10b
[ u_index
].f_preamp
;
577 for ( unsigned i
= 0; i
< EQZ_BANDS_MAX
; i
++ )
578 p_equalizer
->f_amp
[ i
] = eqz_preset_10b
[ u_index
].f_amp
[ i
];
583 /*****************************************************************************
584 * libvlc_audio_equalizer_release : Release a previously created equalizer
585 *****************************************************************************/
586 void libvlc_audio_equalizer_release( libvlc_equalizer_t
*p_equalizer
)
591 /*****************************************************************************
592 * libvlc_audio_equalizer_set_preamp : Set the preamp value for an equalizer
593 *****************************************************************************/
594 int libvlc_audio_equalizer_set_preamp( libvlc_equalizer_t
*p_equalizer
, float f_preamp
)
596 if( isnan(f_preamp
) )
598 if( f_preamp
< -20.f
)
600 else if( f_preamp
> 20.f
)
603 p_equalizer
->f_preamp
= f_preamp
;
607 /*****************************************************************************
608 * libvlc_audio_equalizer_get_preamp : Get the preamp value for an equalizer
609 *****************************************************************************/
610 float libvlc_audio_equalizer_get_preamp( libvlc_equalizer_t
*p_equalizer
)
612 return p_equalizer
->f_preamp
;
615 /*****************************************************************************
616 * libvlc_audio_equalizer_set_amp_at_index : Set the amplification value for an equalizer band
617 *****************************************************************************/
618 int libvlc_audio_equalizer_set_amp_at_index( libvlc_equalizer_t
*p_equalizer
, float f_amp
, unsigned u_band
)
620 if( u_band
>= EQZ_BANDS_MAX
|| isnan(f_amp
) )
626 else if( f_amp
> 20.f
)
629 p_equalizer
->f_amp
[ u_band
] = f_amp
;
633 /*****************************************************************************
634 * libvlc_audio_equalizer_get_amp_at_index : Get the amplification value for an equalizer band
635 *****************************************************************************/
636 float libvlc_audio_equalizer_get_amp_at_index( libvlc_equalizer_t
*p_equalizer
, unsigned u_band
)
638 if ( u_band
>= EQZ_BANDS_MAX
)
641 return p_equalizer
->f_amp
[ u_band
];