chiark / gitweb /
Merge from 3.0 fixes branch
[disorder] / lib / mixer.c
1 /*
2  * This file is part of DisOrder
3  * Copyright (C) 2007 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 2 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, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * 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, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
18  * USA
19  */
20 /** @file lib/mixer.c
21  * @brief Mixer support
22  */
23
24 #include <config.h>
25 #include "types.h"
26
27 #include "configuration.h"
28 #include "mixer.h"
29 #include "log.h"
30 #include "mem.h"
31
32 /** @brief Whether lack of volume support has been reported yet */
33 static int none_reported;
34
35 /** @brief Get/set volume stub if volume control is not supported */
36 static int none_get_set(int attribute((unused)) *left,
37                         int attribute((unused)) *right) {
38   if(!none_reported) {
39     error(0, "don't know how to get/set volume with this api");
40     none_reported = 1;
41   }
42   return -1;
43 }
44
45 /** @brief Stub mixer control */
46 static const struct mixer mixer_none = {
47   -1,
48   none_get_set,
49   none_get_set,
50   "",
51   ""
52 };
53
54 /** @brief Table of mixer definitions */
55 static const struct mixer *mixers[] = {
56 #if HAVE_SYS_SOUNDCARD_H
57   &mixer_oss,
58 #endif
59 #if HAVE_ALSA_ASOUNDLIB_H
60   &mixer_alsa,
61 #endif
62   &mixer_none                           /* make sure array is never empty */
63 };
64
65 /** @brief Number of mixer definitions */
66 #define NMIXERS (sizeof mixers / sizeof *mixers)
67
68 /** @brief Find the mixer definition */
69 static const struct mixer *find_mixer(int api) {
70   size_t n;
71
72   for(n = 0; n < NMIXERS; ++n)
73     if(mixers[n]->api == api)
74       return mixers[n];
75   return &mixer_none;
76 }
77
78 /** @brief Get/set volume
79  * @param left Left channel level, 0-100
80  * @param right Right channel level, 0-100
81  * @param set Set volume if non-0
82  * @return 0 on success, non-0 on error
83  *
84  * If getting the volume then @p left and @p right are filled in.
85  *
86  * If setting the volume then the target levels are read from @p left and
87  * @p right, and the actual level set is stored in them.
88  */
89 int mixer_control(int *left, int *right, int set) {
90   const struct mixer *const m = find_mixer(config->api);
91
92   /* We impose defaults bizarrely late, but this has the advantage of
93    * not making everything depend on sound libraries */
94   if(!config->mixer)
95     config->mixer = xstrdup(m->device);
96   if(!config->channel)
97     config->channel = xstrdup(m->channel);
98   if(set)
99     return m->set(left, right);
100   else
101     return m->get(left, right);
102 }
103
104 /*
105 Local Variables:
106 c-basic-offset:2
107 comment-column:40
108 End:
109 */