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
);
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
];
179 libvlc_audio_output_device_t
*
180 libvlc_audio_output_device_list_get( libvlc_instance_t
*p_instance
,
184 if( (size_t)snprintf( varname
, sizeof(varname
), "%s-audio-device", aout
)
188 libvlc_audio_output_device_t
*list
= NULL
, **pp
= &list
;
189 char **values
, **texts
;
190 ssize_t count
= config_GetPszChoices( VLC_OBJECT(p_instance
->p_libvlc_int
),
191 varname
, &values
, &texts
);
192 for( ssize_t i
= 0; i
< count
; i
++ )
194 libvlc_audio_output_device_t
*item
= malloc( sizeof(*item
) );
195 if( unlikely(item
== NULL
) )
200 item
->psz_device
= values
[i
];
201 item
->psz_description
= texts
[i
];
211 void libvlc_audio_output_device_list_release( libvlc_audio_output_device_t
*l
)
215 libvlc_audio_output_device_t
*next
= l
->p_next
;
217 free( l
->psz_description
);
218 free( l
->psz_device
);
224 int libvlc_audio_output_device_count( libvlc_instance_t
*p_instance
,
225 const char *psz_audio_output
)
227 (void) p_instance
; (void) psz_audio_output
;
231 char *libvlc_audio_output_device_longname( libvlc_instance_t
*p_instance
,
232 const char *psz_audio_output
,
235 (void) p_instance
; (void) psz_audio_output
; (void) i_device
;
239 char *libvlc_audio_output_device_id( libvlc_instance_t
*p_instance
,
240 const char *psz_audio_output
,
243 (void) p_instance
; (void) psz_audio_output
; (void) i_device
;
247 /*****************************
248 * Set device for using
249 *****************************/
250 void libvlc_audio_output_device_set( libvlc_media_player_t
*mp
,
251 const char *module
, const char *devid
)
260 if( asprintf( &cfg_name
, "%s-audio-device", module
) == -1 )
263 if( !var_Type( mp
, cfg_name
) )
264 /* Don't recreate the same variable over and over and over... */
265 var_Create( mp
, cfg_name
, VLC_VAR_STRING
);
266 var_SetString( mp
, cfg_name
, devid
);
271 audio_output_t
*aout
= GetAOut( mp
);
275 aout_DeviceSet( aout
, devid
);
276 vlc_object_release( aout
);
279 int libvlc_audio_output_get_device_type( libvlc_media_player_t
*mp
)
282 return libvlc_AudioOutputDevice_Error
;
285 void libvlc_audio_output_set_device_type( libvlc_media_player_t
*mp
,
288 (void) mp
; (void) device_type
;
291 void libvlc_audio_toggle_mute( libvlc_media_player_t
*mp
)
293 int mute
= libvlc_audio_get_mute( mp
);
295 libvlc_audio_set_mute( mp
, !mute
);
298 int libvlc_audio_get_mute( libvlc_media_player_t
*mp
)
302 audio_output_t
*aout
= GetAOut( mp
);
305 mute
= aout_MuteGet( aout
);
306 vlc_object_release( aout
);
311 void libvlc_audio_set_mute( libvlc_media_player_t
*mp
, int mute
)
313 audio_output_t
*aout
= GetAOut( mp
);
316 mute
= aout_MuteSet( aout
, mute
);
317 vlc_object_release( aout
);
321 int libvlc_audio_get_volume( libvlc_media_player_t
*mp
)
325 audio_output_t
*aout
= GetAOut( mp
);
328 float vol
= aout_VolumeGet( aout
);
329 vlc_object_release( aout
);
330 volume
= lroundf( vol
* 100.f
);
335 int libvlc_audio_set_volume( libvlc_media_player_t
*mp
, int volume
)
337 float vol
= volume
/ 100.f
;
338 if (!isgreaterequal(vol
, 0.f
))
340 libvlc_printerr( "Volume out of range" );
345 audio_output_t
*aout
= GetAOut( mp
);
348 ret
= aout_VolumeSet( aout
, vol
);
349 vlc_object_release( aout
);
354 /*****************************************************************************
355 * libvlc_audio_get_track_count : Get the number of available audio tracks
356 *****************************************************************************/
357 int libvlc_audio_get_track_count( libvlc_media_player_t
*p_mi
)
359 input_thread_t
*p_input_thread
= libvlc_get_input_thread( p_mi
);
362 if( !p_input_thread
)
365 i_track_count
= var_CountChoices( p_input_thread
, "audio-es" );
367 vlc_object_release( p_input_thread
);
368 return i_track_count
;
371 /*****************************************************************************
372 * libvlc_audio_get_track_description : Get the description of available audio tracks
373 *****************************************************************************/
374 libvlc_track_description_t
*
375 libvlc_audio_get_track_description( libvlc_media_player_t
*p_mi
)
377 return libvlc_get_track_description( p_mi
, "audio-es" );
380 /*****************************************************************************
381 * libvlc_audio_get_track : Get the current audio track
382 *****************************************************************************/
383 int libvlc_audio_get_track( libvlc_media_player_t
*p_mi
)
385 input_thread_t
*p_input_thread
= libvlc_get_input_thread( p_mi
);
386 if( !p_input_thread
)
389 int id
= var_GetInteger( p_input_thread
, "audio-es" );
390 vlc_object_release( p_input_thread
);
394 /*****************************************************************************
395 * libvlc_audio_set_track : Set the current audio track
396 *****************************************************************************/
397 int libvlc_audio_set_track( libvlc_media_player_t
*p_mi
, int i_track
)
399 input_thread_t
*p_input_thread
= libvlc_get_input_thread( p_mi
);
400 vlc_value_t val_list
;
403 if( !p_input_thread
)
406 var_Change( p_input_thread
, "audio-es", VLC_VAR_GETCHOICES
, &val_list
, NULL
);
407 for( int i
= 0; i
< val_list
.p_list
->i_count
; i
++ )
409 if( i_track
== val_list
.p_list
->p_values
[i
].i_int
)
411 if( var_SetInteger( p_input_thread
, "audio-es", i_track
) < 0 )
417 libvlc_printerr( "Track identifier not found" );
419 var_FreeList( &val_list
, NULL
);
420 vlc_object_release( p_input_thread
);
424 /*****************************************************************************
425 * libvlc_audio_get_channel : Get the current audio channel
426 *****************************************************************************/
427 int libvlc_audio_get_channel( libvlc_media_player_t
*mp
)
429 audio_output_t
*p_aout
= GetAOut( mp
);
433 int val
= var_GetInteger( p_aout
, "stereo-mode" );
434 vlc_object_release( p_aout
);
438 /*****************************************************************************
439 * libvlc_audio_set_channel : Set the current audio channel
440 *****************************************************************************/
441 int libvlc_audio_set_channel( libvlc_media_player_t
*mp
, int channel
)
443 audio_output_t
*p_aout
= GetAOut( mp
);
449 if( var_SetInteger( p_aout
, "stereo-mode", channel
) < 0 )
451 libvlc_printerr( "Audio channel out of range" );
454 vlc_object_release( p_aout
);
458 /*****************************************************************************
459 * libvlc_audio_get_delay : Get the current audio delay
460 *****************************************************************************/
461 int64_t libvlc_audio_get_delay( libvlc_media_player_t
*p_mi
)
463 input_thread_t
*p_input_thread
= libvlc_get_input_thread ( p_mi
);
465 if( p_input_thread
!= NULL
)
467 val
= var_GetTime( p_input_thread
, "audio-delay" );
468 vlc_object_release( p_input_thread
);
473 /*****************************************************************************
474 * libvlc_audio_set_delay : Set the current audio delay
475 *****************************************************************************/
476 int libvlc_audio_set_delay( libvlc_media_player_t
*p_mi
, int64_t i_delay
)
478 input_thread_t
*p_input_thread
= libvlc_get_input_thread ( p_mi
);
480 if( p_input_thread
!= NULL
)
482 var_SetTime( p_input_thread
, "audio-delay", i_delay
);
483 vlc_object_release( p_input_thread
);
492 /*****************************************************************************
493 * libvlc_audio_equalizer_get_preset_count : Get the number of equalizer presets
494 *****************************************************************************/
495 unsigned libvlc_audio_equalizer_get_preset_count( void )
500 /*****************************************************************************
501 * libvlc_audio_equalizer_get_preset_name : Get the name for a preset
502 *****************************************************************************/
503 const char *libvlc_audio_equalizer_get_preset_name( unsigned u_index
)
505 if ( u_index
>= NB_PRESETS
)
508 return preset_list_text
[ u_index
];
511 /*****************************************************************************
512 * libvlc_audio_equalizer_get_band_count : Get the number of equalizer frequency bands
513 *****************************************************************************/
514 unsigned libvlc_audio_equalizer_get_band_count( void )
516 return EQZ_BANDS_MAX
;
519 /*****************************************************************************
520 * libvlc_audio_equalizer_get_band_frequency : Get the frequency for a band
521 *****************************************************************************/
522 float libvlc_audio_equalizer_get_band_frequency( unsigned u_index
)
524 if ( u_index
>= EQZ_BANDS_MAX
)
527 return f_iso_frequency_table_10b
[ u_index
];
530 /*****************************************************************************
531 * libvlc_audio_equalizer_new : Create a new audio equalizer with zeroed values
532 *****************************************************************************/
533 libvlc_equalizer_t
*libvlc_audio_equalizer_new( void )
535 libvlc_equalizer_t
*p_equalizer
;
536 p_equalizer
= malloc( sizeof( *p_equalizer
) );
537 if ( unlikely( p_equalizer
== NULL
) )
540 p_equalizer
->f_preamp
= 0.f
;
541 for ( unsigned i
= 0; i
< EQZ_BANDS_MAX
; i
++ )
542 p_equalizer
->f_amp
[ i
] = 0.f
;
547 /*****************************************************************************
548 * libvlc_audio_equalizer_new_from_preset : Create a new audio equalizer based on a preset
549 *****************************************************************************/
550 libvlc_equalizer_t
*libvlc_audio_equalizer_new_from_preset( unsigned u_index
)
552 libvlc_equalizer_t
*p_equalizer
;
554 if ( u_index
>= NB_PRESETS
)
557 p_equalizer
= malloc( sizeof( *p_equalizer
) );
558 if ( unlikely( p_equalizer
== NULL
) )
561 p_equalizer
->f_preamp
= eqz_preset_10b
[ u_index
].f_preamp
;
563 for ( unsigned i
= 0; i
< EQZ_BANDS_MAX
; i
++ )
564 p_equalizer
->f_amp
[ i
] = eqz_preset_10b
[ u_index
].f_amp
[ i
];
569 /*****************************************************************************
570 * libvlc_audio_equalizer_release : Release a previously created equalizer
571 *****************************************************************************/
572 void libvlc_audio_equalizer_release( libvlc_equalizer_t
*p_equalizer
)
577 /*****************************************************************************
578 * libvlc_audio_equalizer_set_preamp : Set the preamp value for an equalizer
579 *****************************************************************************/
580 int libvlc_audio_equalizer_set_preamp( libvlc_equalizer_t
*p_equalizer
, float f_preamp
)
582 if( isnan(f_preamp
) )
584 if( f_preamp
< -20.f
)
586 else if( f_preamp
> 20.f
)
589 p_equalizer
->f_preamp
= f_preamp
;
593 /*****************************************************************************
594 * libvlc_audio_equalizer_get_preamp : Get the preamp value for an equalizer
595 *****************************************************************************/
596 float libvlc_audio_equalizer_get_preamp( libvlc_equalizer_t
*p_equalizer
)
598 return p_equalizer
->f_preamp
;
601 /*****************************************************************************
602 * libvlc_audio_equalizer_set_amp_at_index : Set the amplification value for an equalizer band
603 *****************************************************************************/
604 int libvlc_audio_equalizer_set_amp_at_index( libvlc_equalizer_t
*p_equalizer
, float f_amp
, unsigned u_band
)
606 if( u_band
>= EQZ_BANDS_MAX
|| isnan(f_amp
) )
612 else if( f_amp
> 20.f
)
615 p_equalizer
->f_amp
[ u_band
] = f_amp
;
619 /*****************************************************************************
620 * libvlc_audio_equalizer_get_amp_at_index : Get the amplification value for an equalizer band
621 *****************************************************************************/
622 float libvlc_audio_equalizer_get_amp_at_index( libvlc_equalizer_t
*p_equalizer
, unsigned u_band
)
624 if ( u_band
>= EQZ_BANDS_MAX
)
627 return p_equalizer
->f_amp
[ u_band
];