1 /*****************************************************************************
2 * libvlc_audio.c: New libvlc audio control API
3 *****************************************************************************
4 * Copyright (C) 2006 the VideoLAN team
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
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 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 General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
29 #include <vlc/libvlc.h>
30 #include <vlc/libvlc_media.h>
31 #include <vlc/libvlc_media_player.h>
33 #include <vlc_common.h>
34 #include <vlc_input.h>
37 #include "libvlc_internal.h"
38 #include "media_player_internal.h"
41 * Remember to release the returned aout_instance_t since it is locked at
42 * the end of this function.
44 static aout_instance_t *GetAOut( libvlc_instance_t *p_instance,
45 libvlc_exception_t *p_exception )
50 aout_instance_t * p_aout = NULL;
52 p_aout = vlc_object_find( p_instance->p_libvlc_int, VLC_OBJECT_AOUT, FIND_CHILD );
55 libvlc_exception_raise( p_exception );
56 libvlc_printerr( "No active audio output" );
63 /*****************************************
64 * Get the list of available audio outputs
65 *****************************************/
66 libvlc_audio_output_t *
67 libvlc_audio_output_list_get( libvlc_instance_t *p_instance,
68 libvlc_exception_t *p_e )
70 VLC_UNUSED( p_instance );
71 libvlc_audio_output_t *p_list = NULL,
74 module_t **module_list = module_list_get( NULL );
76 for (size_t i = 0; module_list[i]; i++)
78 module_t *p_module = module_list[i];
80 if( module_provides( p_module, "audio output" ) )
84 p_actual = ( libvlc_audio_output_t * )
85 malloc( sizeof( libvlc_audio_output_t ) );
86 if( p_actual == NULL )
88 libvlc_exception_raise( p_e );
89 libvlc_printerr( "Not enough memory" );
90 libvlc_audio_output_list_release( p_list );
91 module_list_free( module_list );
97 p_previous = p_actual;
100 p_actual->psz_name = strdup( module_get_object( p_module ) );
101 p_actual->psz_description = strdup( module_get_name( p_module, true ) );
102 p_actual->p_next = NULL;
103 if( p_previous != p_actual ) /* not first item */
104 p_previous->p_next = p_actual;
105 p_previous = p_actual;
106 p_actual = p_actual->p_next;
110 module_list_free( module_list );
115 /********************************************
116 * Free the list of available audio outputs
117 ***********************************************/
118 void libvlc_audio_output_list_release( libvlc_audio_output_t *p_list )
120 libvlc_audio_output_t *p_actual, *p_before;
125 free( p_actual->psz_name );
126 free( p_actual->psz_description );
128 p_actual = p_before->p_next;
134 /***********************
135 * Set the audio output.
136 ***********************/
137 int libvlc_audio_output_set( libvlc_instance_t *p_instance,
138 const char *psz_name )
140 if( module_exists( psz_name ) )
142 config_PutPsz( p_instance->p_libvlc_int, "aout", psz_name );
149 /****************************
150 * Get count of devices.
151 *****************************/
152 int libvlc_audio_output_device_count( libvlc_instance_t *p_instance,
153 const char *psz_audio_output )
155 char *psz_config_name;
156 if( !psz_audio_output )
158 if( asprintf( &psz_config_name, "%s-audio-device", psz_audio_output ) == -1 )
161 module_config_t *p_module_config = config_FindConfig(
162 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name );
164 if( p_module_config && p_module_config->pf_update_list )
167 val.psz_string = strdup( p_module_config->value.psz );
169 p_module_config->pf_update_list(
170 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name, val, val, NULL );
171 free( val.psz_string );
172 free( psz_config_name );
174 return p_module_config->i_list;
177 free( psz_config_name );
181 /********************************
182 * Get long name of device
183 *********************************/
184 char * libvlc_audio_output_device_longname( libvlc_instance_t *p_instance,
185 const char *psz_audio_output,
188 char *psz_config_name;
189 if( !psz_audio_output )
191 if( asprintf( &psz_config_name, "%s-audio-device", psz_audio_output ) == -1 )
194 module_config_t *p_module_config = config_FindConfig(
195 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name );
197 if( p_module_config )
199 // refresh if there arent devices
200 if( p_module_config->i_list < 2 && p_module_config->pf_update_list )
203 val.psz_string = strdup( p_module_config->value.psz );
205 p_module_config->pf_update_list(
206 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name, val, val, NULL );
207 free( val.psz_string );
209 free( psz_config_name );
211 if( i_device >= 0 && i_device < p_module_config->i_list )
213 if( p_module_config->ppsz_list_text[i_device] )
214 return strdup( p_module_config->ppsz_list_text[i_device] );
216 return strdup( p_module_config->ppsz_list[i_device] );
220 free( psz_config_name );
224 /********************************
225 * Get id name of device
226 *********************************/
227 char * libvlc_audio_output_device_id( libvlc_instance_t *p_instance,
228 const char *psz_audio_output,
231 char *psz_config_name;
232 if( !psz_audio_output )
234 if( asprintf( &psz_config_name, "%s-audio-device", psz_audio_output ) == -1)
237 module_config_t *p_module_config = config_FindConfig(
238 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name );
240 if( p_module_config )
242 // refresh if there arent devices
243 if( p_module_config->i_list < 2 && p_module_config->pf_update_list )
246 val.psz_string = strdup( p_module_config->value.psz );
248 p_module_config->pf_update_list(
249 VLC_OBJECT( p_instance->p_libvlc_int ), psz_config_name, val, val, NULL );
250 free( val.psz_string );
252 free( psz_config_name );
254 if( i_device >= 0 && i_device < p_module_config->i_list )
255 return strdup( p_module_config->ppsz_list[i_device] );
259 free( psz_config_name );
263 /*****************************
264 * Set device for using
265 *****************************/
266 void libvlc_audio_output_device_set( libvlc_instance_t *p_instance,
267 const char *psz_audio_output,
268 const char *psz_device_id )
270 char *psz_config_name = NULL;
271 if( !psz_audio_output || !psz_device_id )
273 if( asprintf( &psz_config_name, "%s-audio-device", psz_audio_output ) == -1 )
275 config_PutPsz( p_instance->p_libvlc_int, psz_config_name, psz_device_id );
276 free( psz_config_name );
279 /*****************************************************************************
280 * libvlc_audio_output_get_device_type : Get the current audio device type
281 *****************************************************************************/
282 int libvlc_audio_output_get_device_type( libvlc_instance_t *p_instance,
283 libvlc_exception_t *p_e )
285 aout_instance_t *p_aout = GetAOut( p_instance, p_e );
288 int i_device_type = var_GetInteger( p_aout, "audio-device" );
289 vlc_object_release( p_aout );
290 return i_device_type;
292 return libvlc_AudioOutputDevice_Error;
295 /*****************************************************************************
296 * libvlc_audio_output_set_device_type : Set the audio device type
297 *****************************************************************************/
298 void libvlc_audio_output_set_device_type( libvlc_instance_t *p_instance,
300 libvlc_exception_t *p_e )
302 aout_instance_t *p_aout = GetAOut( p_instance, p_e );
305 if( var_SetInteger( p_aout, "audio-device", device_type ) < 0 )
307 libvlc_exception_raise( p_e );
308 libvlc_printerr( "Error setting audio device" );
310 vlc_object_release( p_aout );
313 /*****************************************************************************
314 * libvlc_audio_get_mute : Get the volume state, true if muted
315 *****************************************************************************/
316 void libvlc_audio_toggle_mute( libvlc_instance_t *p_instance )
318 aout_ToggleMute( p_instance->p_libvlc_int, NULL );
321 int libvlc_audio_get_mute( libvlc_instance_t *p_instance )
323 return (libvlc_audio_get_volume(p_instance) == 0);
326 void libvlc_audio_set_mute( libvlc_instance_t *p_instance, int mute )
328 if ( !mute != !libvlc_audio_get_mute( p_instance ) )
330 aout_ToggleMute( p_instance->p_libvlc_int, NULL );
334 /*****************************************************************************
335 * libvlc_audio_get_volume : Get the current volume (range 0-200 %)
336 *****************************************************************************/
337 int libvlc_audio_get_volume( libvlc_instance_t *p_instance )
339 audio_volume_t i_volume;
341 aout_VolumeGet( p_instance->p_libvlc_int, &i_volume );
343 return (i_volume*200+AOUT_VOLUME_MAX/2)/AOUT_VOLUME_MAX;
347 /*****************************************************************************
348 * libvlc_audio_set_volume : Set the current volume
349 *****************************************************************************/
350 void libvlc_audio_set_volume( libvlc_instance_t *p_instance, int i_volume,
351 libvlc_exception_t *p_e )
353 if( i_volume >= 0 && i_volume <= 200 )
355 i_volume = (i_volume * AOUT_VOLUME_MAX + 100) / 200;
357 aout_VolumeSet( p_instance->p_libvlc_int, i_volume );
361 libvlc_exception_raise( p_e );
362 libvlc_printerr( "Volume out of range" );
366 /*****************************************************************************
367 * libvlc_audio_get_track_count : Get the number of available audio tracks
368 *****************************************************************************/
369 int libvlc_audio_get_track_count( libvlc_media_player_t *p_mi,
370 libvlc_exception_t *p_e )
372 input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi, p_e );
375 if( !p_input_thread )
378 i_track_count = var_CountChoices( p_input_thread, "audio-es" );
380 vlc_object_release( p_input_thread );
381 return i_track_count;
384 /*****************************************************************************
385 * libvlc_audio_get_track_description : Get the description of available audio tracks
386 *****************************************************************************/
387 libvlc_track_description_t *
388 libvlc_audio_get_track_description( libvlc_media_player_t *p_mi,
389 libvlc_exception_t *p_e )
391 return libvlc_get_track_description( p_mi, "audio-es", p_e);
394 /*****************************************************************************
395 * libvlc_audio_get_track : Get the current audio track
396 *****************************************************************************/
397 int libvlc_audio_get_track( libvlc_media_player_t *p_mi,
398 libvlc_exception_t *p_e )
400 input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi, p_e );
401 vlc_value_t val_list;
406 if( !p_input_thread )
409 if( var_Get( p_input_thread, "audio-es", &val ) < 0 )
411 vlc_object_release( p_input_thread );
412 libvlc_exception_raise( p_e );
413 libvlc_printerr( "Audio track information not found" );
417 var_Change( p_input_thread, "audio-es", VLC_VAR_GETCHOICES, &val_list, NULL );
418 for( i = 0; i < val_list.p_list->i_count; i++ )
420 if( val_list.p_list->p_values[i].i_int == val.i_int )
426 var_FreeList( &val_list, NULL );
427 vlc_object_release( p_input_thread );
431 /*****************************************************************************
432 * libvlc_audio_set_track : Set the current audio track
433 *****************************************************************************/
434 void libvlc_audio_set_track( libvlc_media_player_t *p_mi, int i_track,
435 libvlc_exception_t *p_e )
437 input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi, p_e );
438 vlc_value_t val_list;
442 if( !p_input_thread )
445 var_Change( p_input_thread, "audio-es", VLC_VAR_GETCHOICES, &val_list, NULL );
446 if( (i_track < 0) || (i_track > val_list.p_list->i_count) )
448 libvlc_exception_raise( p_e );
449 libvlc_printerr( "Audio track out of range" );
453 newval = val_list.p_list->p_values[i_track];
454 i_ret = var_Set( p_input_thread, "audio-es", newval );
457 libvlc_exception_raise( p_e );
458 libvlc_printerr( "Audio track out of range" ); /* Race... */
462 var_FreeList( &val_list, NULL );
463 vlc_object_release( p_input_thread );
466 /*****************************************************************************
467 * libvlc_audio_get_channel : Get the current audio channel
468 *****************************************************************************/
469 int libvlc_audio_get_channel( libvlc_instance_t *p_instance,
470 libvlc_exception_t *p_e )
472 aout_instance_t *p_aout = GetAOut( p_instance, p_e );
476 int val = var_GetInteger( p_aout, "audio-channels" );
477 vlc_object_release( p_aout );
481 /*****************************************************************************
482 * libvlc_audio_set_channel : Set the current audio channel
483 *****************************************************************************/
484 void libvlc_audio_set_channel( libvlc_instance_t *p_instance,
486 libvlc_exception_t *p_e )
488 aout_instance_t *p_aout = GetAOut( p_instance, p_e );
492 if( var_SetInteger( p_aout, "audio-channels", channel ) < 0 )
494 libvlc_exception_raise( p_e );
495 libvlc_printerr( "Audio channel out of range" );
497 vlc_object_release( p_aout );