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_renderer_discoverer.h>
34 #include <vlc/libvlc_picture.h>
35 #include <vlc/libvlc_media.h>
36 #include <vlc/libvlc_media_player.h>
38 #include <vlc_common.h>
39 #include <vlc_input.h>
41 #include <vlc_modules.h>
43 #include "libvlc_internal.h"
44 #include "media_player_internal.h"
47 * Remember to release the returned audio_output_t since it is locked at
48 * the end of this function.
50 static audio_output_t
*GetAOut( libvlc_media_player_t
*mp
)
54 audio_output_t
*p_aout
= input_resource_HoldAout( mp
->input
.p_resource
);
56 libvlc_printerr( "No active audio output" );
60 /*****************************************
61 * Get the list of available audio outputs
62 *****************************************/
63 libvlc_audio_output_t
*
64 libvlc_audio_output_list_get( libvlc_instance_t
*p_instance
)
67 module_t
**module_list
= module_list_get( &count
);
68 libvlc_audio_output_t
*list
= NULL
;
70 for (size_t i
= 0; i
< count
; i
++)
72 module_t
*module
= module_list
[i
];
74 if( !module_provides( module
, "audio output" ) )
77 libvlc_audio_output_t
*item
= malloc( sizeof( *item
) );
78 if( unlikely(item
== NULL
) )
81 libvlc_printerr( "Not enough memory" );
82 libvlc_audio_output_list_release( list
);
87 item
->psz_name
= strdup( module_get_object( module
) );
88 item
->psz_description
= strdup( module_get_name( module
, true ) );
89 if( unlikely(item
->psz_name
== NULL
|| item
->psz_description
== NULL
) )
91 free( item
->psz_name
);
92 free( item
->psz_description
);
99 module_list_free( module_list
);
101 VLC_UNUSED( p_instance
);
105 /********************************************
106 * Free the list of available audio outputs
107 ***********************************************/
108 void libvlc_audio_output_list_release( libvlc_audio_output_t
*list
)
110 while( list
!= NULL
)
112 libvlc_audio_output_t
*next
= list
->p_next
;
114 free( list
->psz_name
);
115 free( list
->psz_description
);
122 /***********************
123 * Set the audio output.
124 ***********************/
125 int libvlc_audio_output_set( libvlc_media_player_t
*mp
, const char *psz_name
)
129 if( !module_exists( psz_name
)
130 || asprintf( &value
, "%s,none", psz_name
) == -1 )
132 var_SetString( mp
, "aout", value
);
135 /* Forget the existing audio output */
136 input_resource_ResetAout(mp
->input
.p_resource
);
138 /* Create a new audio output */
139 audio_output_t
*aout
= input_resource_GetAout(mp
->input
.p_resource
);
141 input_resource_PutAout(mp
->input
.p_resource
, aout
);
146 libvlc_audio_output_device_t
*
147 libvlc_audio_output_device_enum( libvlc_media_player_t
*mp
)
149 audio_output_t
*aout
= GetAOut( mp
);
153 libvlc_audio_output_device_t
*list
, **pp
= &list
;
154 char **values
, **texts
;
156 int n
= aout_DevicesList( aout
, &values
, &texts
);
157 vlc_object_release( aout
);
161 for (int i
= 0; i
< n
; i
++)
163 libvlc_audio_output_device_t
*item
= malloc( sizeof(*item
) );
164 if( unlikely(item
== NULL
) )
173 item
->psz_device
= values
[i
];
174 item
->psz_description
= texts
[i
];
184 libvlc_audio_output_device_t
*
185 libvlc_audio_output_device_list_get( libvlc_instance_t
*p_instance
,
189 if( (size_t)snprintf( varname
, sizeof(varname
), "%s-audio-device", aout
)
193 if( config_GetType(varname
) != VLC_VAR_STRING
)
196 libvlc_audio_output_device_t
*list
= NULL
, **pp
= &list
;
197 char **values
, **texts
;
198 ssize_t count
= config_GetPszChoices( varname
, &values
, &texts
);
199 for( ssize_t i
= 0; i
< count
; i
++ )
201 libvlc_audio_output_device_t
*item
= malloc( sizeof(*item
) );
202 if( unlikely(item
== NULL
) )
207 item
->psz_device
= values
[i
];
208 item
->psz_description
= texts
[i
];
218 void libvlc_audio_output_device_list_release( libvlc_audio_output_device_t
*l
)
222 libvlc_audio_output_device_t
*next
= l
->p_next
;
224 free( l
->psz_description
);
225 free( l
->psz_device
);
231 /*****************************
232 * Set device for using
233 *****************************/
234 void libvlc_audio_output_device_set( libvlc_media_player_t
*mp
,
235 const char *module
, const char *devid
)
244 if( asprintf( &cfg_name
, "%s-audio-device", module
) == -1 )
247 if( !var_Type( mp
, cfg_name
) )
248 /* Don't recreate the same variable over and over and over... */
249 var_Create( mp
, cfg_name
, VLC_VAR_STRING
);
250 var_SetString( mp
, cfg_name
, devid
);
255 audio_output_t
*aout
= GetAOut( mp
);
259 aout_DeviceSet( aout
, devid
);
260 vlc_object_release( aout
);
263 char *libvlc_audio_output_device_get( libvlc_media_player_t
*mp
)
265 audio_output_t
*aout
= GetAOut( mp
);
269 char *devid
= aout_DeviceGet( aout
);
271 vlc_object_release( aout
);
276 void libvlc_audio_toggle_mute( libvlc_media_player_t
*mp
)
278 int mute
= libvlc_audio_get_mute( mp
);
280 libvlc_audio_set_mute( mp
, !mute
);
283 int libvlc_audio_get_mute( libvlc_media_player_t
*mp
)
287 audio_output_t
*aout
= GetAOut( mp
);
290 mute
= aout_MuteGet( aout
);
291 vlc_object_release( aout
);
296 void libvlc_audio_set_mute( libvlc_media_player_t
*mp
, int mute
)
298 audio_output_t
*aout
= GetAOut( mp
);
301 mute
= aout_MuteSet( aout
, mute
);
302 vlc_object_release( aout
);
306 int libvlc_audio_get_volume( libvlc_media_player_t
*mp
)
310 audio_output_t
*aout
= GetAOut( mp
);
313 float vol
= aout_VolumeGet( aout
);
314 vlc_object_release( aout
);
315 volume
= lroundf( vol
* 100.f
);
320 int libvlc_audio_set_volume( libvlc_media_player_t
*mp
, int volume
)
322 float vol
= volume
/ 100.f
;
323 if (!isgreaterequal(vol
, 0.f
))
325 libvlc_printerr( "Volume out of range" );
330 audio_output_t
*aout
= GetAOut( mp
);
333 ret
= aout_VolumeSet( aout
, vol
);
334 vlc_object_release( aout
);
339 /*****************************************************************************
340 * libvlc_audio_get_track_count : Get the number of available audio tracks
341 *****************************************************************************/
342 int libvlc_audio_get_track_count( libvlc_media_player_t
*p_mi
)
344 input_thread_t
*p_input_thread
= libvlc_get_input_thread( p_mi
);
347 if( !p_input_thread
)
350 i_track_count
= var_CountChoices( p_input_thread
, "audio-es" );
352 vlc_object_release( p_input_thread
);
353 return i_track_count
;
356 /*****************************************************************************
357 * libvlc_audio_get_track_description : Get the description of available audio tracks
358 *****************************************************************************/
359 libvlc_track_description_t
*
360 libvlc_audio_get_track_description( libvlc_media_player_t
*p_mi
)
362 return libvlc_get_track_description( p_mi
, "audio-es" );
365 /*****************************************************************************
366 * libvlc_audio_get_track : Get the current audio track
367 *****************************************************************************/
368 int libvlc_audio_get_track( libvlc_media_player_t
*p_mi
)
370 input_thread_t
*p_input_thread
= libvlc_get_input_thread( p_mi
);
371 if( !p_input_thread
)
374 int id
= var_GetInteger( p_input_thread
, "audio-es" );
375 vlc_object_release( p_input_thread
);
379 /*****************************************************************************
380 * libvlc_audio_set_track : Set the current audio track
381 *****************************************************************************/
382 int libvlc_audio_set_track( libvlc_media_player_t
*p_mi
, int i_track
)
384 input_thread_t
*p_input_thread
= libvlc_get_input_thread( p_mi
);
385 vlc_value_t
*val_list
;
389 if( !p_input_thread
)
392 var_Change( p_input_thread
, "audio-es", VLC_VAR_GETCHOICES
,
393 &count
, &val_list
, (char ***)NULL
);
394 for( size_t i
= 0; i
< count
; i
++ )
396 if( i_track
== val_list
[i
].i_int
)
398 if( var_SetInteger( p_input_thread
, "audio-es", i_track
) < 0 )
404 libvlc_printerr( "Track identifier not found" );
407 vlc_object_release( p_input_thread
);
411 /*****************************************************************************
412 * libvlc_audio_get_channel : Get the current audio channel
413 *****************************************************************************/
414 int libvlc_audio_get_channel( libvlc_media_player_t
*mp
)
416 audio_output_t
*p_aout
= GetAOut( mp
);
420 int val
= var_GetInteger( p_aout
, "stereo-mode" );
421 vlc_object_release( p_aout
);
425 /*****************************************************************************
426 * libvlc_audio_set_channel : Set the current audio channel
427 *****************************************************************************/
428 int libvlc_audio_set_channel( libvlc_media_player_t
*mp
, int channel
)
430 audio_output_t
*p_aout
= GetAOut( mp
);
436 if( var_SetInteger( p_aout
, "stereo-mode", channel
) < 0 )
438 libvlc_printerr( "Audio channel out of range" );
441 vlc_object_release( p_aout
);
445 /*****************************************************************************
446 * libvlc_audio_get_delay : Get the current audio delay
447 *****************************************************************************/
448 int64_t libvlc_audio_get_delay( libvlc_media_player_t
*p_mi
)
450 input_thread_t
*p_input_thread
= libvlc_get_input_thread ( p_mi
);
452 if( p_input_thread
!= NULL
)
454 val
= US_FROM_VLC_TICK( var_GetInteger( p_input_thread
, "audio-delay" ) );
455 vlc_object_release( p_input_thread
);
460 /*****************************************************************************
461 * libvlc_audio_set_delay : Set the current audio delay
462 *****************************************************************************/
463 int libvlc_audio_set_delay( libvlc_media_player_t
*p_mi
, int64_t i_delay
)
465 input_thread_t
*p_input_thread
= libvlc_get_input_thread ( p_mi
);
467 if( p_input_thread
!= NULL
)
469 var_SetInteger( p_input_thread
, "audio-delay", VLC_TICK_FROM_US( i_delay
) );
470 vlc_object_release( p_input_thread
);
479 /*****************************************************************************
480 * libvlc_audio_equalizer_get_preset_count : Get the number of equalizer presets
481 *****************************************************************************/
482 unsigned libvlc_audio_equalizer_get_preset_count( void )
487 /*****************************************************************************
488 * libvlc_audio_equalizer_get_preset_name : Get the name for a preset
489 *****************************************************************************/
490 const char *libvlc_audio_equalizer_get_preset_name( unsigned u_index
)
492 if ( u_index
>= NB_PRESETS
)
495 return preset_list_text
[ u_index
];
498 /*****************************************************************************
499 * libvlc_audio_equalizer_get_band_count : Get the number of equalizer frequency bands
500 *****************************************************************************/
501 unsigned libvlc_audio_equalizer_get_band_count( void )
503 return EQZ_BANDS_MAX
;
506 /*****************************************************************************
507 * libvlc_audio_equalizer_get_band_frequency : Get the frequency for a band
508 *****************************************************************************/
509 float libvlc_audio_equalizer_get_band_frequency( unsigned u_index
)
511 if ( u_index
>= EQZ_BANDS_MAX
)
514 return f_iso_frequency_table_10b
[ u_index
];
517 /*****************************************************************************
518 * libvlc_audio_equalizer_new : Create a new audio equalizer with zeroed values
519 *****************************************************************************/
520 libvlc_equalizer_t
*libvlc_audio_equalizer_new( void )
522 libvlc_equalizer_t
*p_equalizer
;
523 p_equalizer
= malloc( sizeof( *p_equalizer
) );
524 if ( unlikely( p_equalizer
== NULL
) )
527 p_equalizer
->f_preamp
= 0.f
;
528 for ( unsigned i
= 0; i
< EQZ_BANDS_MAX
; i
++ )
529 p_equalizer
->f_amp
[ i
] = 0.f
;
534 /*****************************************************************************
535 * libvlc_audio_equalizer_new_from_preset : Create a new audio equalizer based on a preset
536 *****************************************************************************/
537 libvlc_equalizer_t
*libvlc_audio_equalizer_new_from_preset( unsigned u_index
)
539 libvlc_equalizer_t
*p_equalizer
;
541 if ( u_index
>= NB_PRESETS
)
544 p_equalizer
= malloc( sizeof( *p_equalizer
) );
545 if ( unlikely( p_equalizer
== NULL
) )
548 p_equalizer
->f_preamp
= eqz_preset_10b
[ u_index
].f_preamp
;
550 for ( unsigned i
= 0; i
< EQZ_BANDS_MAX
; i
++ )
551 p_equalizer
->f_amp
[ i
] = eqz_preset_10b
[ u_index
].f_amp
[ i
];
556 /*****************************************************************************
557 * libvlc_audio_equalizer_release : Release a previously created equalizer
558 *****************************************************************************/
559 void libvlc_audio_equalizer_release( libvlc_equalizer_t
*p_equalizer
)
564 /*****************************************************************************
565 * libvlc_audio_equalizer_set_preamp : Set the preamp value for an equalizer
566 *****************************************************************************/
567 int libvlc_audio_equalizer_set_preamp( libvlc_equalizer_t
*p_equalizer
, float f_preamp
)
569 if( isnan(f_preamp
) )
571 if( f_preamp
< -20.f
)
573 else if( f_preamp
> 20.f
)
576 p_equalizer
->f_preamp
= f_preamp
;
580 /*****************************************************************************
581 * libvlc_audio_equalizer_get_preamp : Get the preamp value for an equalizer
582 *****************************************************************************/
583 float libvlc_audio_equalizer_get_preamp( libvlc_equalizer_t
*p_equalizer
)
585 return p_equalizer
->f_preamp
;
588 /*****************************************************************************
589 * libvlc_audio_equalizer_set_amp_at_index : Set the amplification value for an equalizer band
590 *****************************************************************************/
591 int libvlc_audio_equalizer_set_amp_at_index( libvlc_equalizer_t
*p_equalizer
, float f_amp
, unsigned u_band
)
593 if( u_band
>= EQZ_BANDS_MAX
|| isnan(f_amp
) )
599 else if( f_amp
> 20.f
)
602 p_equalizer
->f_amp
[ u_band
] = f_amp
;
606 /*****************************************************************************
607 * libvlc_audio_equalizer_get_amp_at_index : Get the amplification value for an equalizer band
608 *****************************************************************************/
609 float libvlc_audio_equalizer_get_amp_at_index( libvlc_equalizer_t
*p_equalizer
, unsigned u_band
)
611 if ( u_band
>= EQZ_BANDS_MAX
)
614 return p_equalizer
->f_amp
[ u_band
];