chiark - git - mdw - disorder/blob - lib/uaudio.c

   1 /*
   2  * This file is part of DisOrder.
   3  * Copyright (C) 2009, 2013 Richard Kettlewell
   4  *
   5  * This program is free software: you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation, either version 3 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17  */
  18
  19 /** @file lib/uaudio.c
  20  * @brief Uniform audio interface
  21  */
  22
  23 #include "common.h"
  24 #include "uaudio.h"
  25 #include "hash.h"
  26 #include "mem.h"
  27 #include "log.h"
  28
  29 /** @brief Options for chosen uaudio API */
  30 static hash *uaudio_options;
  31
  32 /** @brief Sample rate (Hz) */
  33 int uaudio_rate;
  34
  35 /** @brief Bits per channel */
  36 int uaudio_bits;
  37
  38 /** @brief Number of channels */
  39 int uaudio_channels;
  40
  41 /** @brief Whether samples are signed or unsigned */
  42 int uaudio_signed;
  43
  44 /** @brief Frames of buffer to tolerate inside chosen API */
  45 int uaudio_buffer;
  46
  47 /** @brief Sample size in bytes
  48  *
  49  * NB one sample is a single point sample; up to @c uaudio_channels samples may
  50  * play at the same time through different speakers.  Thus this value is
  51  * independent of @ref uaudio_channels.
  52  */
  53 size_t uaudio_sample_size;
  54
  55 /** @brief Set a uaudio option */
  56 void uaudio_set(const char *name, const char *value) {
  57   if(!value) {
  58     if(uaudio_options)
  59       hash_remove(uaudio_options, name);
  60     return;
  61   }
  62   if(!uaudio_options)
  63     uaudio_options = hash_new(sizeof(char *));
  64   value = xstrdup(value);
  65   hash_add(uaudio_options, name, &value, HASH_INSERT_OR_REPLACE);
  66 }
  67
  68 /** @brief Get a uaudio option */
  69 char *uaudio_get(const char *name, const char *default_value) {
  70   if(!uaudio_options)
  71     return default_value ? xstrdup(default_value) : 0;
  72   char **valuep = hash_find(uaudio_options, name);
  73   if(!valuep)
  74     return default_value ? xstrdup(default_value) : 0;
  75   return xstrdup(*valuep);
  76 }
  77
  78 /** @brief Set sample format
  79  * @param rate Sample rate in KHz
  80  * @param channels Number of channels (i.e. 2 for stereo)
  81  * @param bits Number of bits per channel (typically 8 or 16)
  82  * @param signed_ True for signed samples, false for unsigned
  83  *
  84  * Sets @ref uaudio_rate, @ref uaudio_channels, @ref uaudio_bits, @ref
  85  * uaudio_signed and @ref uaudio_sample_size.
  86  *
  87  * Currently there is no way to specify non-native endian formats even if the
  88  * underlying API can conveniently handle them.  Actually this would be quite
  89  * convenient for playrtp, so it might be added at some point.
  90  *
  91  * Not all APIs can support all sample formats.  Generally the @c start
  92  * function will do some error checking but some may be deferred to the point
  93  * the device is opened (which might be @c activate).
  94  */
  95 void uaudio_set_format(int rate, int channels, int bits, int signed_) {
  96   uaudio_rate = rate;
  97   uaudio_channels = channels;
  98   uaudio_bits = bits;
  99   uaudio_signed = signed_;
 100   uaudio_sample_size = bits / CHAR_BIT;
 101 }
 102
 103 /** @brief Choose the default audio API by context
 104  * @param apis Table of APIs or a null pointer
 105  * @param context @ref UAUDIO_API_SERVER or @ref UAUDIO_API_CLIENT
 106  * @return Default API or a null pointer
 107  */
 108 const struct uaudio *uaudio_default(const struct uaudio *const *apis,
 109                                     unsigned context) {
 110   if(apis) {
 111     for(int n = 0; apis[n]; ++n)
 112       if(apis[n]->flags & context)
 113         return apis[n];
 114   }
 115   return 0;
 116 }
 117
 118 /*
 119 Local Variables:
 120 c-basic-offset:2
 121 comment-column:40
 122 fill-column:79
 123 indent-tabs-mode:nil
 124 End:
 125 */