git.sesse.net Git - vlc/blob - 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 }