libvlc_release() has only 1 parameter now
[vlc.git] / src / control / audio.c
1 /*****************************************************************************
2  * libvlc_audio.c: New libvlc audio control API
3  *****************************************************************************
4  * Copyright (C) 2006 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Filippo Carone <filippo@carone.org>
8  *          Jean-Paul Saman <jpsaman _at_ m2x _dot_ nl>
9  *
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.
14  *
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.
19  *
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  *****************************************************************************/
24
25 #include "libvlc_internal.h"
26 #include <vlc/libvlc.h>
27
28 #include <vlc_input.h>
29 #include <vlc_aout.h>
30
31
32 /*
33  * Remember to release the returned aout_instance_t since it is locked at
34  * the end of this function.
35  */
36 static aout_instance_t *GetAOut( libvlc_instance_t *p_instance,
37                                  libvlc_exception_t *p_exception )
38 {
39     aout_instance_t * p_aout = NULL;
40
41     p_aout = vlc_object_find( p_instance->p_libvlc_int, VLC_OBJECT_AOUT, FIND_CHILD );
42     if( !p_aout )
43     {
44         libvlc_exception_raise( p_exception, "No active audio output" );
45         return NULL;
46     }
47
48     return p_aout;
49 }
50
51
52 /*****************************************************************************
53  * libvlc_audio_get_mute : Get the volume state, true if muted
54  *****************************************************************************/
55 void libvlc_audio_toggle_mute( libvlc_instance_t *p_instance,
56                                libvlc_exception_t *p_e )
57 {
58     aout_VolumeMute( p_instance->p_libvlc_int, NULL );
59 }
60
61 vlc_bool_t libvlc_audio_get_mute( libvlc_instance_t *p_instance,
62                                   libvlc_exception_t *p_e )
63 {
64     /*
65      * If the volume level is 0, then the channel is muted
66      */
67     audio_volume_t i_volume;
68
69     i_volume = libvlc_audio_get_volume(p_instance, p_e);
70     if ( i_volume == 0 )
71         return VLC_TRUE;
72     return VLC_FALSE;
73 }
74
75 void libvlc_audio_set_mute( libvlc_instance_t *p_instance, vlc_bool_t mute,
76                             libvlc_exception_t *p_e )
77 {
78     if ( mute ^ libvlc_audio_get_mute( p_instance, p_e ) )
79     {
80         aout_VolumeMute( p_instance->p_libvlc_int, NULL );
81     }
82 }
83
84 /*****************************************************************************
85  * libvlc_audio_get_volume : Get the current volume (range 0-200 %)
86  *****************************************************************************/
87 int libvlc_audio_get_volume( libvlc_instance_t *p_instance,
88                              libvlc_exception_t *p_e )
89 {
90     audio_volume_t i_volume;
91
92     aout_VolumeGet( p_instance->p_libvlc_int, &i_volume );
93
94     return (i_volume*200+AOUT_VOLUME_MAX/2)/AOUT_VOLUME_MAX;
95 }
96
97
98 /*****************************************************************************
99  * libvlc_audio_set_volume : Set the current volume
100  *****************************************************************************/
101 void libvlc_audio_set_volume( libvlc_instance_t *p_instance, int i_volume,
102                               libvlc_exception_t *p_e )
103 {
104     if( i_volume >= 0 && i_volume <= 200 )
105     {
106         i_volume = (i_volume * AOUT_VOLUME_MAX + 100) / 200;
107
108         aout_VolumeSet( p_instance->p_libvlc_int, i_volume );
109     }
110     else
111     {
112         libvlc_exception_raise( p_e, "Volume out of range" );
113     }
114 }
115
116 /*****************************************************************************
117  * libvlc_audio_get_track_count : Get the number of available audio tracks
118  *****************************************************************************/
119 int libvlc_audio_get_track_count( libvlc_media_instance_t *p_mi, 
120                                   libvlc_exception_t *p_e )
121 {
122     input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi, p_e );
123     vlc_value_t val_list;
124
125     if( !p_input_thread )
126         return -1;
127
128     var_Change( p_input_thread, "audio-es", VLC_VAR_GETCHOICES, &val_list, NULL );
129     vlc_object_release( p_input_thread );
130     return val_list.p_list->i_count;
131 }
132
133 /*****************************************************************************
134  * libvlc_audio_get_track : Get the current audio track
135  *****************************************************************************/
136 int libvlc_audio_get_track( libvlc_media_instance_t *p_mi,
137                             libvlc_exception_t *p_e )
138 {
139     input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi, p_e );
140     vlc_value_t val_list;
141     vlc_value_t val;
142     int i_track = -1;
143     int i_ret = -1;
144     int i;
145
146     if( !p_input_thread )
147         return -1;
148
149     i_ret = var_Get( p_input_thread, "audio-es", &val );
150     if( i_ret < 0 )
151     {
152         libvlc_exception_raise( p_e, "Getting Audio track information failed" );
153         vlc_object_release( p_input_thread );
154         return i_ret;
155     }
156
157     var_Change( p_input_thread, "audio-es", VLC_VAR_GETCHOICES, &val_list, NULL );
158     for( i = 0; i < val_list.p_list->i_count; i++ )
159     {
160         vlc_value_t track_val = val_list.p_list->p_values[i];
161         if( track_val.i_int == val.i_int )
162         {
163             i_track = i;
164             break;
165        }
166     }
167     vlc_object_release( p_input_thread );
168     return i_track;
169 }
170
171
172 /*****************************************************************************
173  * libvlc_audio_set_track : Set the current audio track
174  *****************************************************************************/
175 void libvlc_audio_set_track( libvlc_media_instance_t *p_mi, int i_track,
176                              libvlc_exception_t *p_e )
177 {
178     input_thread_t *p_input_thread = libvlc_get_input_thread( p_mi, p_e );
179     vlc_value_t val_list;
180     int i_ret = -1;
181     int i;
182
183     if( !p_input_thread )
184         return;
185
186     var_Change( p_input_thread, "audio-es", VLC_VAR_GETCHOICES, &val_list, NULL );
187     for( i = 0; i < val_list.p_list->i_count; i++ )
188     {
189         vlc_value_t val = val_list.p_list->p_values[i];
190         if( i_track == i )
191         {
192             i_ret = var_Set( p_input_thread, "audio-es", val );
193             if( i_ret < 0 )
194             {
195                 libvlc_exception_raise( p_e, "Setting audio track failed" );
196             }
197             vlc_object_release( p_input_thread );
198             return;
199         }
200     }
201     libvlc_exception_raise( p_e, "Audio track out of range" );
202     vlc_object_release( p_input_thread );
203 }
204
205 /*****************************************************************************
206  * libvlc_audio_get_channel : Get the current audio channel
207  *****************************************************************************/
208 int libvlc_audio_get_channel( libvlc_instance_t *p_instance,
209                                 libvlc_exception_t *p_e )
210 {
211     aout_instance_t *p_aout = GetAOut( p_instance, p_e );
212     if( p_aout )
213     {
214         vlc_value_t val;
215
216         var_Get( p_aout, "audio-channels", &val );
217         vlc_object_release( p_aout );
218         return val.i_int;
219     }
220     return -1;
221 }
222
223 /*****************************************************************************
224  * libvlc_audio_set_channel : Set the current audio channel
225  *****************************************************************************/
226 void libvlc_audio_set_channel( libvlc_instance_t *p_instance, int i_channel,
227                                libvlc_exception_t *p_e )
228 {
229     aout_instance_t *p_aout = GetAOut( p_instance, p_e );
230     if( p_aout )
231     {
232         vlc_value_t val;
233         int i_ret = -1;
234
235         val.i_int = i_channel;
236         switch( i_channel )
237         {
238             case AOUT_VAR_CHAN_RSTEREO:
239             case AOUT_VAR_CHAN_STEREO:
240             case AOUT_VAR_CHAN_LEFT:
241             case AOUT_VAR_CHAN_RIGHT:
242             case AOUT_VAR_CHAN_DOLBYS:
243                 i_ret = var_Set( p_aout, "audio-channels", val );
244                 if( i_ret < 0 )
245                 {
246                     libvlc_exception_raise( p_e, "Failed setting audio channel" );
247                     vlc_object_release( p_aout );
248                     return;
249                 }
250                 vlc_object_release( p_aout );
251                 return; /* Found */
252             default:
253                 libvlc_exception_raise( p_e, "Audio channel out of range" );
254                 break;
255         }
256         vlc_object_release( p_aout );
257     }
258 }