chiark / gitweb /
typo fix
[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 "common.h"
25
26 #include "configuration.h"
27 #include "mixer.h"
28 #include "log.h"
29 #include "mem.h"
30
31 /** @brief Whether lack of volume support has been reported yet */
32 static int none_reported;
33
34 /** @brief Get/set volume stub if volume control is not supported */
35 static int none_get_set(int attribute((unused)) *left,
36                         int attribute((unused)) *right) {
37   if(!none_reported) {
38     error(0, "don't know how to get/set volume with this api");
39     none_reported = 1;
40   }
41   return -1;
42 }
43
44 /** @brief Stub mixer control */
45 static const struct mixer mixer_none = {
46   -1,
47   none_get_set,
48   none_get_set,
49   "",
50   ""
51 };
52
53 /** @brief Table of mixer definitions */
54 static const struct mixer *mixers[] = {
55 #if HAVE_SYS_SOUNDCARD_H
56   &mixer_oss,
57 #endif
58 #if HAVE_ALSA_ASOUNDLIB_H
59   &mixer_alsa,
60 #endif
61   &mixer_none                           /* make sure array is never empty */
62 };
63
64 /** @brief Number of mixer definitions */
65 #define NMIXERS (sizeof mixers / sizeof *mixers)
66
67 /** @brief Find the mixer definition */
68 static const struct mixer *find_mixer(int api) {
69   size_t n;
70
71   if(api == -1)
72     api = config->api;
73   for(n = 0; n < NMIXERS; ++n)
74     if(mixers[n]->api == api)
75       return mixers[n];
76   return &mixer_none;
77 }
78
79 /** @brief Return true if we know how to drive the mixer
80  * @param api Sound api or -1 for default
81  * @return true if suppored, false otherwise
82  */
83 int mixer_supported(int api) {
84   const struct mixer *const m = find_mixer(api);
85   return m != &mixer_none;
86 }
87
88 /** @brief Get/set volume
89  * @param api Sound api or -1 for default
90  * @param left Left channel level, 0-100
91  * @param right Right channel level, 0-100
92  * @param set Set volume if non-0
93  * @return 0 on success, non-0 on error
94  *
95  * If getting the volume then @p left and @p right are filled in.
96  *
97  * If setting the volume then the target levels are read from @p left and
98  * @p right, and the actual level set is stored in them.
99  */
100 int mixer_control(int api, int *left, int *right, int set) {
101   const struct mixer *const m = find_mixer(api);
102
103   /* We impose defaults bizarrely late, but this has the advantage of
104    * not making everything depend on sound libraries */
105   if(!config->mixer)
106     config->mixer = xstrdup(m->device);
107   if(!config->channel)
108     config->channel = xstrdup(m->channel);
109   if(set)
110     return m->set(left, right);
111   else
112     return m->get(left, right);
113 }
114
115 /*
116 Local Variables:
117 c-basic-offset:2
118 comment-column:40
119 End:
120 */