-rw-r--r-- | libopie2/opiemm/osoundsystem.h | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/libopie2/opiemm/osoundsystem.h b/libopie2/opiemm/osoundsystem.h index cce90c0..5f6fb7a 100644 --- a/libopie2/opiemm/osoundsystem.h +++ b/libopie2/opiemm/osoundsystem.h | |||
@@ -1,245 +1,245 @@ | |||
1 | /* | 1 | /* |
2 | This file is part of the Opie Project | 2 | This file is part of the Opie Project |
3 | (C) 2003-2005 Michael 'Mickey' Lauer <mickey@Vanille.de> | 3 | (C) 2003-2005 Michael 'Mickey' Lauer <mickey@Vanille.de> |
4 | =. | 4 | =. |
5 | .=l. | 5 | .=l. |
6 | .>+-= | 6 | .>+-= |
7 | _;:, .> :=|. This program is free software; you can | 7 | _;:, .> :=|. This program is free software; you can |
8 | .> <`_, > . <= redistribute it and/or modify it under | 8 | .> <`_, > . <= redistribute it and/or modify it under |
9 | :`=1 )Y*s>-.-- : the terms of the GNU Library General Public | 9 | :`=1 )Y*s>-.-- : the terms of the GNU Library General Public |
10 | .="- .-=="i, .._ License as published by the Free Software | 10 | .="- .-=="i, .._ License as published by the Free Software |
11 | - . .-<_> .<> Foundation; either version 2 of the License, | 11 | - . .-<_> .<> Foundation; either version 2 of the License, |
12 | ._= =} : or (at your option) any later version. | 12 | ._= =} : or (at your option) any later version. |
13 | .%`+i> _;_. | 13 | .%`+i> _;_. |
14 | .i_,=:_. -<s. This program is distributed in the hope that | 14 | .i_,=:_. -<s. This program is distributed in the hope that |
15 | + . -:. = it will be useful, but WITHOUT ANY WARRANTY; | 15 | + . -:. = it will be useful, but WITHOUT ANY WARRANTY; |
16 | : .. .:, . . . without even the implied warranty of | 16 | : .. .:, . . . without even the implied warranty of |
17 | =_ + =;=|` MERCHANTABILITY or FITNESS FOR A | 17 | =_ + =;=|` MERCHANTABILITY or FITNESS FOR A |
18 | _.=:. : :=>`: PARTICULAR PURPOSE. See the GNU | 18 | _.=:. : :=>`: PARTICULAR PURPOSE. See the GNU |
19 | ..}^=.= = ; Library General Public License for more | 19 | ..}^=.= = ; Library General Public License for more |
20 | ++= -. .` .: details. | 20 | ++= -. .` .: details. |
21 | : = ...= . :.=- | 21 | : = ...= . :.=- |
22 | -. .:....=;==+<; You should have received a copy of the GNU | 22 | -. .:....=;==+<; You should have received a copy of the GNU |
23 | -_. . . )=. = Library General Public License along with | 23 | -_. . . )=. = Library General Public License along with |
24 | -- :-=` this library; see the file COPYING.LIB. | 24 | -- :-=` this library; see the file COPYING.LIB. |
25 | If not, write to the Free Software Foundation, | 25 | If not, write to the Free Software Foundation, |
26 | Inc., 59 Temple Place - Suite 330, | 26 | Inc., 59 Temple Place - Suite 330, |
27 | Boston, MA 02111-1307, USA. | 27 | Boston, MA 02111-1307, USA. |
28 | 28 | ||
29 | */ | 29 | */ |
30 | 30 | ||
31 | #ifndef OSOUNDSYSTEM_H | 31 | #ifndef OSOUNDSYSTEM_H |
32 | #define OSOUNDSYSTEM_H | 32 | #define OSOUNDSYSTEM_H |
33 | 33 | ||
34 | #include <qobject.h> | 34 | #include <qobject.h> |
35 | #include <qdict.h> | 35 | #include <qdict.h> |
36 | #include <qmap.h> | 36 | #include <qmap.h> |
37 | 37 | ||
38 | namespace Opie { | 38 | namespace Opie { |
39 | namespace MM { | 39 | namespace MM { |
40 | 40 | ||
41 | class OAudioInterface; | 41 | class OAudioInterface; |
42 | class OMixerInterface; | 42 | class OMixerInterface; |
43 | class OSoundCard; | 43 | class OSoundCard; |
44 | 44 | ||
45 | /*====================================================================================== | 45 | /*====================================================================================== |
46 | * OSoundSystem | 46 | * OSoundSystem |
47 | *======================================================================================*/ | 47 | *======================================================================================*/ |
48 | 48 | ||
49 | /** | 49 | /** |
50 | * @brief A container class for all audio interfaces | 50 | * @brief A container class for all audio interfaces |
51 | * | 51 | * |
52 | * This class provides access to all available audio/midi/sequencer interfaces of your computer. | 52 | * This class provides access to all available audio/midi/sequencer interfaces of your computer. |
53 | * | 53 | * |
54 | * @author Michael 'Mickey' Lauer <mickey@tm.informatik.uni-frankfurt.de> | 54 | * @author Michael 'Mickey' Lauer <mickey@tm.informatik.uni-frankfurt.de> |
55 | */ | 55 | */ |
56 | class OSoundSystem : public QObject | 56 | class OSoundSystem : public QObject |
57 | { | 57 | { |
58 | Q_OBJECT | 58 | Q_OBJECT |
59 | 59 | ||
60 | public: | 60 | public: |
61 | typedef QDict<OSoundCard> CardMap; | 61 | typedef QDict<OSoundCard> CardMap; |
62 | typedef QDictIterator<OSoundCard> CardIterator; | 62 | typedef QDictIterator<OSoundCard> CardIterator; |
63 | 63 | ||
64 | public: | 64 | public: |
65 | /** | 65 | /** |
66 | * @returns the number of available interfaces | 66 | * @returns the number of available interfaces |
67 | */ | 67 | */ |
68 | int count() const; | 68 | int count() const; |
69 | /** | 69 | /** |
70 | * @returns a pointer to the (one and only) @ref ONetwork instance. | 70 | * @returns a pointer to the (one and only) @ref OSystem instance. |
71 | */ | 71 | */ |
72 | static OSoundSystem* instance(); | 72 | static OSoundSystem* instance(); |
73 | /** | 73 | /** |
74 | * @returns an iterator usable for iterating through all network interfaces. | 74 | * @returns an iterator usable for iterating through all sound cards. |
75 | */ | 75 | */ |
76 | CardIterator iterator() const; | 76 | CardIterator iterator() const; |
77 | /** | 77 | /** |
78 | * @returns a pointer to the @ref OAudioInterface object for the specified @a interface or 0, if not found | 78 | * @returns a pointer to the @ref OAudioInterface object for the specified @a interface or 0, if not found |
79 | * @see OAudioInterface | 79 | * @see OAudioInterface |
80 | */ | 80 | */ |
81 | OSoundCard* card( const QString& interface ) const; | 81 | OSoundCard* card( const QString& interface ) const; |
82 | /** | 82 | /** |
83 | * @internal Rebuild the internal interface database | 83 | * @internal Rebuild the internal interface database |
84 | * @note Sometimes it might be useful to call this from client code, | 84 | * @note Sometimes it might be useful to call this from client code, |
85 | * e.g. after issuing a cardctl insert | 85 | * e.g. after issuing a cardctl insert |
86 | */ | 86 | */ |
87 | void synchronize(); | 87 | void synchronize(); |
88 | 88 | ||
89 | protected: | 89 | protected: |
90 | OSoundSystem(); | 90 | OSoundSystem(); |
91 | 91 | ||
92 | private: | 92 | private: |
93 | static OSoundSystem* _instance; | 93 | static OSoundSystem* _instance; |
94 | CardMap _interfaces; | 94 | CardMap _interfaces; |
95 | class Private; | 95 | class Private; |
96 | Private *d; | 96 | Private *d; |
97 | }; | 97 | }; |
98 | 98 | ||
99 | 99 | ||
100 | /*====================================================================================== | 100 | /*====================================================================================== |
101 | * OSoundCard | 101 | * OSoundCard |
102 | *======================================================================================*/ | 102 | *======================================================================================*/ |
103 | 103 | ||
104 | class OSoundCard : public QObject | 104 | class OSoundCard : public QObject |
105 | { | 105 | { |
106 | Q_OBJECT | 106 | Q_OBJECT |
107 | 107 | ||
108 | public: | 108 | public: |
109 | /** | 109 | /** |
110 | * Constructor. Normally you don't create @ref OSoundCard objects yourself, | 110 | * Constructor. Normally you don't create @ref OSoundCard objects yourself, |
111 | * but access them via @ref OSoundSystem::card(). | 111 | * but access them via @ref OSoundSystem::card(). |
112 | */ | 112 | */ |
113 | OSoundCard( QObject* parent, const char* name ); | 113 | OSoundCard( QObject* parent, const char* name ); |
114 | /** | 114 | /** |
115 | * Destructor. | 115 | * Destructor. |
116 | */ | 116 | */ |
117 | virtual ~OSoundCard(); | 117 | virtual ~OSoundCard(); |
118 | 118 | ||
119 | bool hasMixer() const { return _audio; }; | 119 | bool hasMixer() const { return _audio; }; |
120 | bool hasAudio() const { return _mixer; }; | 120 | bool hasAudio() const { return _mixer; }; |
121 | 121 | ||
122 | OAudioInterface* audio() const { return _audio; }; | 122 | OAudioInterface* audio() const { return _audio; }; |
123 | OMixerInterface* mixer() const { return _mixer; }; | 123 | OMixerInterface* mixer() const { return _mixer; }; |
124 | 124 | ||
125 | protected: | 125 | protected: |
126 | OAudioInterface* _audio; | 126 | OAudioInterface* _audio; |
127 | OMixerInterface* _mixer; | 127 | OMixerInterface* _mixer; |
128 | 128 | ||
129 | private: | 129 | private: |
130 | void init(); | 130 | void init(); |
131 | private: | 131 | private: |
132 | class Private; | 132 | class Private; |
133 | Private *d; | 133 | Private *d; |
134 | }; | 134 | }; |
135 | 135 | ||
136 | /*====================================================================================== | 136 | /*====================================================================================== |
137 | * OAudioInterface | 137 | * OAudioInterface |
138 | *======================================================================================*/ | 138 | *======================================================================================*/ |
139 | 139 | ||
140 | class OAudioInterface : public QObject | 140 | class OAudioInterface : public QObject |
141 | { | 141 | { |
142 | Q_OBJECT | 142 | Q_OBJECT |
143 | 143 | ||
144 | public: | 144 | public: |
145 | /** | 145 | /** |
146 | * Constructor. Normally you don't create @ref OAudioInterface objects yourself, | 146 | * Constructor. Normally you don't create @ref OAudioInterface objects yourself, |
147 | * but access them via the @ref OSoundCard interface. | 147 | * but access them via the @ref OSoundCard interface. |
148 | */ | 148 | */ |
149 | OAudioInterface( QObject* parent, const char* name ); | 149 | OAudioInterface( QObject* parent, const char* name ); |
150 | /** | 150 | /** |
151 | * Destructor. | 151 | * Destructor. |
152 | */ | 152 | */ |
153 | virtual ~OAudioInterface(); | 153 | virtual ~OAudioInterface(); |
154 | 154 | ||
155 | protected: | 155 | protected: |
156 | const int _sfd; | 156 | const int _sfd; |
157 | 157 | ||
158 | private: | 158 | private: |
159 | void init(); | 159 | void init(); |
160 | private: | 160 | private: |
161 | class Private; | 161 | class Private; |
162 | Private *d; | 162 | Private *d; |
163 | }; | 163 | }; |
164 | 164 | ||
165 | 165 | ||
166 | /*====================================================================================== | 166 | /*====================================================================================== |
167 | * OMixerInterface | 167 | * OMixerInterface |
168 | *======================================================================================*/ | 168 | *======================================================================================*/ |
169 | 169 | ||
170 | class OMixerInterface : public QObject | 170 | class OMixerInterface : public QObject |
171 | { | 171 | { |
172 | Q_OBJECT | 172 | Q_OBJECT |
173 | 173 | ||
174 | public: | 174 | public: |
175 | 175 | ||
176 | typedef QMap<QString,int>::ConstIterator ChannelIterator; | 176 | typedef QMap<QString,int>::ConstIterator ChannelIterator; |
177 | 177 | ||
178 | /** | 178 | /** |
179 | * Constructor. Normally you don't create @ref OMixerInterface objects yourself, | 179 | * Constructor. Normally you don't create @ref OMixerInterface objects yourself, |
180 | * but access them via the @ref OSoundCard interface. | 180 | * but access them via the @ref OSoundCard interface. |
181 | */ | 181 | */ |
182 | OMixerInterface( QObject* parent, const char* name ); | 182 | OMixerInterface( QObject* parent, const char* name ); |
183 | /** | 183 | /** |
184 | * Destructor. | 184 | * Destructor. |
185 | */ | 185 | */ |
186 | virtual ~OMixerInterface(); | 186 | virtual ~OMixerInterface(); |
187 | 187 | ||
188 | /** | 188 | /** |
189 | * @returns all available channels. | 189 | * @returns all available channels. |
190 | */ | 190 | */ |
191 | QStringList allChannels() const; | 191 | QStringList allChannels() const; |
192 | /** | 192 | /** |
193 | * @returns recordable channels. | 193 | * @returns recordable channels. |
194 | */ | 194 | */ |
195 | QStringList recChannels() const; | 195 | QStringList recChannels() const; |
196 | /** | 196 | /** |
197 | * @returns playable channels. | 197 | * @returns playable channels. |
198 | */ | 198 | */ |
199 | QStringList playChannels() const; | 199 | QStringList playChannels() const; |
200 | /** | 200 | /** |
201 | * @returns true, if the device features multiple recording sources. | 201 | * @returns true, if the device features multiple recording sources. |
202 | */ | 202 | */ |
203 | bool hasMultipleRecording() const; | 203 | bool hasMultipleRecording() const; |
204 | /** | 204 | /** |
205 | * @returns true, if @a channel exists. | 205 | * @returns true, if @a channel exists. |
206 | */ | 206 | */ |
207 | bool hasChannel( const QString& channel ) const; | 207 | bool hasChannel( const QString& channel ) const; |
208 | /** | 208 | /** |
209 | * @returns true, if @a channel is stereo. | 209 | * @returns true, if @a channel is stereo. |
210 | */ | 210 | */ |
211 | bool isStereo( const QString& channel ) const; | 211 | bool isStereo( const QString& channel ) const; |
212 | /** | 212 | /** |
213 | * @returns tru, if @a channel is a possible recording source. | 213 | * @returns tru, if @a channel is a possible recording source. |
214 | */ | 214 | */ |
215 | bool isRecordable( const QString& channel ) const; | 215 | bool isRecordable( const QString& channel ) const; |
216 | /** | 216 | /** |
217 | * Set the @a left and @a right volumes for @a channel. | 217 | * Set the @a left and @a right volumes for @a channel. |
218 | * If no value for right is given, the value for left is taken for that. | 218 | * If no value for right is given, the value for left is taken for that. |
219 | */ | 219 | */ |
220 | void setVolume( const QString& channel, int left, int right = -1 ); | 220 | void setVolume( const QString& channel, int left, int right = -1 ); |
221 | /** | 221 | /** |
222 | * @returns the volume of @a channel or -1, if the channel doesn't exist. | 222 | * @returns the volume of @a channel or -1, if the channel doesn't exist. |
223 | * @note You might want to use @ref hasChannel() to check if a channel exists. | 223 | * @note You might want to use @ref hasChannel() to check if a channel exists. |
224 | */ | 224 | */ |
225 | int volume( const QString& channel ) const; | 225 | int volume( const QString& channel ) const; |
226 | 226 | ||
227 | protected: | 227 | protected: |
228 | int _fd; | 228 | int _fd; |
229 | int _capmask; | 229 | int _capmask; |
230 | int _devmask; | 230 | int _devmask; |
231 | int _recmask; | 231 | int _recmask; |
232 | int _stmask; | 232 | int _stmask; |
233 | QMap<QString,int> _channels; | 233 | QMap<QString,int> _channels; |
234 | 234 | ||
235 | private: | 235 | private: |
236 | void init(); | 236 | void init(); |
237 | private: | 237 | private: |
238 | class Private; | 238 | class Private; |
239 | Private *d; | 239 | Private *d; |
240 | }; | 240 | }; |
241 | 241 | ||
242 | } | 242 | } |
243 | } | 243 | } |
244 | 244 | ||
245 | #endif // OSOUNDSYSTEM_H | 245 | #endif // OSOUNDSYSTEM_H |