chiark / gitweb /
Switch to GPL v3
[disorder] / lib / mixer.c
index b4704b915dcff885a302665f94ec2cb901ca1572..a24f7eb3fef975a318f4633b97749abd0df26e00 100644 (file)
 /*
  * This file is part of DisOrder
- * Copyright (C) 2004 Richard Kettlewell
+ * Copyright (C) 2007 Richard Kettlewell
  *
- * This program is free software; you can redistribute it and/or modify
+ * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
+ * the Free Software Foundation, either version 3 of the License, or
  * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful, but
- * WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
- * General Public License for more details.
- *
+ * 
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ * 
  * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
- * USA
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+/** @file lib/mixer.c
+ * @brief Mixer support
  */
 
-#include <config.h>
-
-#include <stdio.h>
-#include <string.h>
-#include <fcntl.h>
-#include <unistd.h>
-#include <stdlib.h>
-#include <errno.h>
-#include <stddef.h>
-#include <sys/ioctl.h>
+#include "common.h"
 
 #include "configuration.h"
 #include "mixer.h"
 #include "log.h"
-#include "syscalls.h"
+#include "mem.h"
 
-#if HAVE_SYS_SOUNDCARD_H
-#include <sys/soundcard.h>
+/** @brief Whether lack of volume support has been reported yet */
+static int none_reported;
 
-/* documentation does not match implementation! */
-#ifndef SOUND_MIXER_READ
-# define SOUND_MIXER_READ(x) MIXER_READ(x)
+/** @brief Get/set volume stub if volume control is not supported */
+static int none_get_set(int attribute((unused)) *left,
+                       int attribute((unused)) *right) {
+  if(!none_reported) {
+    error(0, "don't know how to get/set volume with this api");
+    none_reported = 1;
+  }
+  return -1;
+}
+
+/** @brief Stub mixer control */
+static const struct mixer mixer_none = {
+  -1,
+  none_get_set,
+  none_get_set,
+  "",
+  ""
+};
+
+/** @brief Table of mixer definitions */
+static const struct mixer *mixers[] = {
+#if HAVE_SYS_SOUNDCARD_H
+  &mixer_oss,
 #endif
-#ifndef SOUND_MIXER_WRITE
-# define SOUND_MIXER_WRITE(x) MIXER_WRITE(x)
+#if HAVE_ALSA_ASOUNDLIB_H
+  &mixer_alsa,
 #endif
+  &mixer_none                          /* make sure array is never empty */
+};
 
-static const char *channels[] = SOUND_DEVICE_NAMES;
+/** @brief Number of mixer definitions */
+#define NMIXERS (sizeof mixers / sizeof *mixers)
 
-int mixer_channel(const char *c) {
-  unsigned n;
-  
-  if(!c[strspn(c, "0123456789")])
-    return atoi(c);
-  else {
-    for(n = 0; n < sizeof channels / sizeof *channels; ++n)
-      if(!strcmp(channels[n], c))
-       return n;
-    return -1;
-  }
-}
+/** @brief Find the mixer definition */
+static const struct mixer *find_mixer(int api) {
+  size_t n;
 
-int mixer_control(int *left, int *right, int set) {
-  int fd, ch, r;
-    
-  if(config->mixer
-     && config->channel
-     && (ch = mixer_channel(config->channel)) != -1) {
-    if((fd = open(config->mixer, O_RDWR, 0)) < 0) {
-      error(errno, "error opening %s", config->mixer);
-      return -1;
-    }
-    if(set) {
-      r = (*left & 0xff) + (*right & 0xff) * 256;
-      if(ioctl(fd, SOUND_MIXER_WRITE(ch), &r) == -1) {
-       error(errno, "error changing %s channel %s",
-             config->mixer, config->channel);
-       xclose(fd);
-       return -1;
-      }
-    }
-    if(ioctl(fd, SOUND_MIXER_READ(ch), &r) == -1) {
-      error(errno, "error reading %s channel %s",
-           config->mixer, config->channel);
-      xclose(fd);
-      return -1;
-    }
-    *left = r & 0xff;
-    *right = (r >> 8) & 0xff;
-    xclose(fd);
-    return 0;
-  } else
-    return -1;
+  if(api == -1)
+    api = config->api;
+  for(n = 0; n < NMIXERS; ++n)
+    if(mixers[n]->api == api)
+      return mixers[n];
+  return &mixer_none;
 }
-#else
-int mixer_channel(const char attribute((unused)) *c) {
-  return 0;
+
+/** @brief Return true if we know how to drive the mixer
+ * @param api Sound api or -1 for default
+ * @return true if suppored, false otherwise
+ */
+int mixer_supported(int api) {
+  const struct mixer *const m = find_mixer(api);
+  return m != &mixer_none;
 }
 
-int mixer_control(int attribute((unused)) *left, 
-                 int attribute((unused)) *right,
-                 int attribute((unused)) set) {
-  error(0, "don't know how to set volume on this platform");
-  return -1;
+/** @brief Get/set volume
+ * @param api Sound api or -1 for default
+ * @param left Left channel level, 0-100
+ * @param right Right channel level, 0-100
+ * @param set Set volume if non-0
+ * @return 0 on success, non-0 on error
+ *
+ * If getting the volume then @p left and @p right are filled in.
+ *
+ * If setting the volume then the target levels are read from @p left and
+ * @p right, and the actual level set is stored in them.
+ */
+int mixer_control(int api, int *left, int *right, int set) {
+  const struct mixer *const m = find_mixer(api);
+
+  /* We impose defaults bizarrely late, but this has the advantage of
+   * not making everything depend on sound libraries */
+  if(!config->mixer)
+    config->mixer = xstrdup(m->device);
+  if(!config->channel)
+    config->channel = xstrdup(m->channel);
+  if(set)
+    return m->set(left, right);
+  else
+    return m->get(left, right);
 }
-#endif
 
 /*
 Local Variables: