libao2/ao_sdl.c

   1 /*
   2  * SDLlib audio output driver for MPlayer
   3  *
   4  * Copyleft 2001 by Felix Bünemann (atmosfear@users.sf.net)
   5  *
   6  * This file is part of MPlayer.
   7  *
   8  * MPlayer is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * MPlayer is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License along
  19  * along with MPlayer; if not, write to the Free Software
  20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  21  */
  22
  23 #include <stdio.h>
  24 #include <stdlib.h>
  25 #include <string.h>
  26
  27 #include "config.h"
  28 #include "mp_msg.h"
  29 #include "help_mp.h"
  30
  31 #include "audio_out.h"
  32 #include "audio_out_internal.h"
  33 #include "libaf/af_format.h"
  34 #ifdef CONFIG_SDL_SDL_H
  35 #include <SDL/SDL.h>
  36 #else
  37 #include <SDL.h>
  38 #endif
  39 #include "osdep/timer.h"
  40
  41 #include "libavutil/fifo.h"
  42
  43 static const ao_info_t info =
  44 {
  45         "SDLlib audio output",
  46         "sdl",
  47         "Felix Buenemann <atmosfear@users.sourceforge.net>",
  48         ""
  49 };
  50
  51 LIBAO_EXTERN(sdl)
  52
  53 // turn this on if you want to use the slower SDL_MixAudio
  54 #undef USE_SDL_INTERNAL_MIXER
  55
  56 // Samplesize used by the SDLlib AudioSpec struct
  57 #if defined(__MINGW32__) || defined(__CYGWIN__) || defined(__AMIGAOS4__)
  58 #define SAMPLESIZE 2048
  59 #else
  60 #define SAMPLESIZE 1024
  61 #endif
  62
  63 #define CHUNK_SIZE 4096
  64 #define NUM_CHUNKS 8
  65 #define BUFFSIZE (NUM_CHUNKS * CHUNK_SIZE)
  66
  67 static AVFifoBuffer *buffer;
  68
  69 #ifdef USE_SDL_INTERNAL_MIXER
  70 static unsigned char volume=SDL_MIX_MAXVOLUME;
  71 #endif
  72
  73 static int write_buffer(unsigned char* data,int len){
  74   int free = av_fifo_space(buffer);
  75   if (len > free) len = free;
  76   return av_fifo_generic_write(buffer, data, len, NULL);
  77 }
  78
  79 #ifdef USE_SDL_INTERNAL_MIXER
  80 static void mix_audio(void *dst, void *src, int len) {
  81   SDL_MixAudio(dst, src, len, volume);
  82 }
  83 #endif
  84
  85 static int read_buffer(unsigned char* data,int len){
  86   int buffered = av_fifo_size(buffer);
  87   if (len > buffered) len = buffered;
  88 #ifdef USE_SDL_INTERNAL_MIXER
  89   av_fifo_generic_read(buffer, data, len, mix_audio);
  90 #else
  91   av_fifo_generic_read(buffer, data, len, NULL);
  92 #endif
  93   return len;
  94 }
  95
  96 // end ring buffer stuff
  97
  98
  99 // to set/get/query special features/parameters
 100 static int control(int cmd,void *arg){
 101 #ifdef USE_SDL_INTERNAL_MIXER
 102         switch (cmd) {
 103                 case AOCONTROL_GET_VOLUME:
 104                 {
 105                         ao_control_vol_t* vol = (ao_control_vol_t*)arg;
 106                         vol->left = vol->right = volume * 100 / SDL_MIX_MAXVOLUME;
 107                         return CONTROL_OK;
 108                 }
 109                 case AOCONTROL_SET_VOLUME:
 110                 {
 111                         int diff;
 112                         ao_control_vol_t* vol = (ao_control_vol_t*)arg;
 113                         diff = (vol->left+vol->right) / 2;
 114                         volume = diff * SDL_MIX_MAXVOLUME / 100;
 115                         return CONTROL_OK;
 116                 }
 117         }
 118 #endif
 119         return CONTROL_UNKNOWN;
 120 }
 121
 122 // SDL Callback function
 123 static void outputaudio(void *unused, Uint8 *stream, int len) {
 124         //SDL_MixAudio(stream, read_buffer(buffers, len), len, SDL_MIX_MAXVOLUME);
 125         //if(!full_buffers) printf("SDL: Buffer underrun!\n");
 126
 127         read_buffer(stream, len);
 128         //printf("SDL: Full Buffers: %i\n", full_buffers);
 129 }
 130
 131 // open & setup audio device
 132 // return: 1=success 0=fail
 133 static int init(int rate,int channels,int format,int flags){
 134
 135         /* SDL Audio Specifications */
 136         SDL_AudioSpec aspec, obtained;
 137
 138         /* Allocate ring-buffer memory */
 139         buffer = av_fifo_alloc(BUFFSIZE);
 140
 141         mp_tmsg(MSGT_AO,MSGL_INFO,"[AO SDL] Samplerate: %iHz Channels: %s Format %s\n", rate, (channels > 1) ? "Stereo" : "Mono", af_fmt2str_short(format));
 142
 143         if(ao_subdevice) {
 144                 setenv("SDL_AUDIODRIVER", ao_subdevice, 1);
 145                 mp_tmsg(MSGT_AO,MSGL_INFO,"[AO SDL] using %s audio driver.\n", ao_subdevice);
 146         }
 147
 148         ao_data.channels=channels;
 149         ao_data.samplerate=rate;
 150         ao_data.format=format;
 151
 152         ao_data.bps=channels*rate;
 153         if(format != AF_FORMAT_U8 && format != AF_FORMAT_S8)
 154           ao_data.bps*=2;
 155
 156         /* The desired audio format (see SDL_AudioSpec) */
 157         switch(format) {
 158             case AF_FORMAT_U8:
 159                 aspec.format = AUDIO_U8;
 160             break;
 161             case AF_FORMAT_S16_LE:
 162                 aspec.format = AUDIO_S16LSB;
 163             break;
 164             case AF_FORMAT_S16_BE:
 165                 aspec.format = AUDIO_S16MSB;
 166             break;
 167             case AF_FORMAT_S8:
 168                 aspec.format = AUDIO_S8;
 169             break;
 170             case AF_FORMAT_U16_LE:
 171                 aspec.format = AUDIO_U16LSB;
 172             break;
 173             case AF_FORMAT_U16_BE:
 174                 aspec.format = AUDIO_U16MSB;
 175             break;
 176             default:
 177                 aspec.format = AUDIO_S16LSB;
 178                 ao_data.format = AF_FORMAT_S16_LE;
 179                 mp_tmsg(MSGT_AO,MSGL_WARN,"[AO SDL] Unsupported audio format: 0x%x.\n", format);
 180         }
 181
 182         /* The desired audio frequency in samples-per-second. */
 183         aspec.freq     = rate;
 184
 185         /* Number of channels (mono/stereo) */
 186         aspec.channels = channels;
 187
 188         /* The desired size of the audio buffer in samples. This number should be a power of two, and may be adjusted by the audio driver to a value more suitable for the hardware. Good values seem to range between 512 and 8192 inclusive, depending on the application and CPU speed. Smaller values yield faster response time, but can lead to underflow if the application is doing heavy processing and cannot fill the audio buffer in time. A stereo sample consists of both right and left channels in LR ordering. Note that the number of samples is directly related to time by the following formula: ms = (samples*1000)/freq */
 189         aspec.samples  = SAMPLESIZE;
 190
 191         /* This should be set to a function that will be called when the audio device is ready for more data. It is passed a pointer to the audio buffer, and the length in bytes of the audio buffer. This function usually runs in a separate thread, and so you should protect data structures that it accesses by calling SDL_LockAudio and SDL_UnlockAudio in your code. The callback prototype is:
 192 void callback(void *userdata, Uint8 *stream, int len); userdata is the pointer stored in userdata field of the SDL_AudioSpec. stream is a pointer to the audio buffer you want to fill with information and len is the length of the audio buffer in bytes. */
 193         aspec.callback = outputaudio;
 194
 195         /* This pointer is passed as the first parameter to the callback function. */
 196         aspec.userdata = NULL;
 197
 198         /* initialize the SDL Audio system */
 199         if (SDL_Init (SDL_INIT_AUDIO/*|SDL_INIT_NOPARACHUTE*/)) {
 200                 mp_tmsg(MSGT_AO,MSGL_ERR,"[AO SDL] SDL Audio initialization failed: %s\n", SDL_GetError());
 201                 return 0;
 202         }
 203
 204         /* Open the audio device and start playing sound! */
 205         if(SDL_OpenAudio(&aspec, &obtained) < 0) {
 206                 mp_tmsg(MSGT_AO,MSGL_ERR,"[AO SDL] Unable to open audio: %s\n", SDL_GetError());
 207                 return 0;
 208         }
 209
 210         /* did we got what we wanted ? */
 211         ao_data.channels=obtained.channels;
 212         ao_data.samplerate=obtained.freq;
 213
 214         switch(obtained.format) {
 215             case AUDIO_U8 :
 216                 ao_data.format = AF_FORMAT_U8;
 217             break;
 218             case AUDIO_S16LSB :
 219                 ao_data.format = AF_FORMAT_S16_LE;
 220             break;
 221             case AUDIO_S16MSB :
 222                 ao_data.format = AF_FORMAT_S16_BE;
 223             break;
 224             case AUDIO_S8 :
 225                 ao_data.format = AF_FORMAT_S8;
 226             break;
 227             case AUDIO_U16LSB :
 228                 ao_data.format = AF_FORMAT_U16_LE;
 229             break;
 230             case AUDIO_U16MSB :
 231                 ao_data.format = AF_FORMAT_U16_BE;
 232             break;
 233             default:
 234                 mp_tmsg(MSGT_AO,MSGL_WARN,"[AO SDL] Unsupported audio format: 0x%x.\n", obtained.format);
 235                 return 0;
 236         }
 237
 238         mp_msg(MSGT_AO,MSGL_V,"SDL: buf size = %d\n",obtained.size);
 239         ao_data.buffersize=obtained.size;
 240         ao_data.outburst = CHUNK_SIZE;
 241
 242         /* unsilence audio, if callback is ready */
 243         SDL_PauseAudio(0);
 244
 245         return 1;
 246 }
 247
 248 // close audio device
 249 static void uninit(int immed){
 250         mp_msg(MSGT_AO,MSGL_V,"SDL: Audio Subsystem shutting down!\n");
 251         if (!immed)
 252           usec_sleep(get_delay() * 1000 * 1000);
 253         SDL_CloseAudio();
 254         SDL_QuitSubSystem(SDL_INIT_AUDIO);
 255         av_fifo_free(buffer);
 256 }
 257
 258 // stop playing and empty buffers (for seeking/pause)
 259 static void reset(void){
 260
 261         //printf("SDL: reset called!\n");
 262
 263         SDL_PauseAudio(1);
 264         /* Reset ring-buffer state */
 265         av_fifo_reset(buffer);
 266         SDL_PauseAudio(0);
 267 }
 268
 269 // stop playing, keep buffers (for pause)
 270 static void audio_pause(void)
 271 {
 272
 273         //printf("SDL: audio_pause called!\n");
 274         SDL_PauseAudio(1);
 275
 276 }
 277
 278 // resume playing, after audio_pause()
 279 static void audio_resume(void)
 280 {
 281         //printf("SDL: audio_resume called!\n");
 282         SDL_PauseAudio(0);
 283 }
 284
 285
 286 // return: how many bytes can be played without blocking
 287 static int get_space(void){
 288     return av_fifo_space(buffer);
 289 }
 290
 291 // plays 'len' bytes of 'data'
 292 // it should round it down to outburst*n
 293 // return: number of bytes played
 294 static int play(void* data,int len,int flags){
 295
 296         if (!(flags & AOPLAY_FINAL_CHUNK))
 297         len = (len/ao_data.outburst)*ao_data.outburst;
 298 #if 0
 299         int ret;
 300
 301         /* Audio locking prohibits call of outputaudio */
 302         SDL_LockAudio();
 303         // copy audio stream into ring-buffer
 304         ret = write_buffer(data, len);
 305         SDL_UnlockAudio();
 306
 307         return ret;
 308 #else
 309         return write_buffer(data, len);
 310 #endif
 311 }
 312
 313 // return: delay in seconds between first and last sample in buffer
 314 static float get_delay(void){
 315     int buffered = av_fifo_size(buffer); // could be less
 316     return (float)(buffered + ao_data.buffersize)/(float)ao_data.bps;
 317 }