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

   1 /*
   2  * This file is part of DisOrder.
   3  * Copyright (C) 2009 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
  28 /** @brief Options for chosen uaudio API */
  29 static hash *uaudio_options;
  30
  31 /** @brief Sample rate (Hz) */
  32 int uaudio_rate;
  33
  34 /** @brief Bits per channel */
  35 int uaudio_bits;
  36
  37 /** @brief Number of channels */
  38 int uaudio_channels;
  39
  40 /** @brief Whether samples are signed or unsigned */
  41 int uaudio_signed;
  42
  43 /** @brief Sample size in bytes
  44  *
  45  * NB one sample is a single point sample; up to @c uaudio_channels samples may
  46  * play at the same time through different speakers.  Thus this value is
  47  * independent of @ref uaudio_channels.
  48  */
  49 size_t uaudio_sample_size;
  50
  51 /** @brief Set a uaudio option */
  52 void uaudio_set(const char *name, const char *value) {
  53   if(!value) {
  54     if(uaudio_options)
  55       hash_remove(uaudio_options, name);
  56     return;
  57   }
  58   if(!uaudio_options)
  59     uaudio_options = hash_new(sizeof(char *));
  60   value = xstrdup(value);
  61   hash_add(uaudio_options, name, &value, HASH_INSERT_OR_REPLACE);
  62 }
  63
  64 /** @brief Get a uaudio option */
  65 char *uaudio_get(const char *name, const char *default_value) {
  66   if(!uaudio_options)
  67     return default_value ? xstrdup(default_value) : 0;
  68   char **valuep = hash_find(uaudio_options, name);
  69   if(!valuep)
  70     return default_value ? xstrdup(default_value) : 0;
  71   return xstrdup(*valuep);
  72 }
  73
  74 /** @brief Set sample format
  75  * @param rate Sample rate in KHz
  76  * @param channels Number of channels (i.e. 2 for stereo)
  77  * @param bits Number of bits per channel (typically 8 or 16)
  78  * @param signed_ True for signed samples, false for unsigned
  79  *
  80  * Sets @ref uaudio_rate, @ref uaudio_channels, @ref uaudio_bits, @ref
  81  * uaudio_signed and @ref uaudio_sample_size.
  82  *
  83  * Currently there is no way to specify non-native endian formats even if the
  84  * underlying API can conveniently handle them.  Actually this would be quite
  85  * convenient for playrtp, so it might be added at some point.
  86  *
  87  * Not all APIs can support all sample formats.  Generally the @c start
  88  * function will do some error checking but some may be deferred to the point
  89  * the device is opened (which might be @c activate).
  90  */
  91 void uaudio_set_format(int rate, int channels, int bits, int signed_) {
  92   uaudio_rate = rate;
  93   uaudio_channels = channels;
  94   uaudio_bits = bits;
  95   uaudio_signed = signed_;
  96   uaudio_sample_size = bits / CHAR_BIT;
  97 }
  98
  99 /*
 100 Local Variables:
 101 c-basic-offset:2
 102 comment-column:40
 103 fill-column:79
 104 indent-tabs-mode:nil
 105 End:
 106 */