source: GPL/trunk/alsa-kernel/include/sound/pcm_plugin.h@ 598

Last change on this file since 598 was 598, checked in by David Azarewicz, 8 years ago

Merged/reintegrated v2 branch into trunk. Trunk is now v2
File size: 10.7 KB
Line 
1#ifndef __PCM_PLUGIN_H
2#define __PCM_PLUGIN_H
3
4/*
5 * Digital Audio (Plugin interface) abstract layer
6 * Copyright (c) by Jaroslav Kysela <perex@suse.cz>
7 *
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
22 *
23 */
24
25#ifndef ATTRIBUTE_UNUSED
26#define ATTRIBUTE_UNUSED __attribute__ ((__unused__))
27#endif
28
29typedef unsigned int bitset_t;
30
31#ifdef TARGET_OS2
32#define bitset_size(nbits) ((nbits + sizeof(bitset_t) * 8 - 1) / (sizeof(bitset_t) * 8))
33
34#define bitset_alloc(nbits) snd_kcalloc(bitset_size(nbits) * sizeof(bitset_t), GFP_KERNEL)
35
36#define bitset_set(bitmap, pos) bitmap[pos / sizeof(*bitmap) * 8] |= 1 << (pos % sizeof(*bitmap) * 8)
37
38
39#define bitset_reset(bitmap, pos) bitmap[pos / sizeof(*bitmap) * 8] &= ~(1 << (pos % sizeof(*bitmap) * 8))
40
41#define bitset_get(bitmap, pos) (!!(bitmap[pos / (sizeof(*bitmap) * 8)] & (1 << (pos % (sizeof(*bitmap) * 8)))))
42
43#define bitset_copy(dst, src, nbits) memcpy(dst, src, bitset_size(nbits) * sizeof(bitset_t));
44
45#define bitset_and(dst, bs, nbits) \
46{ \
47 bitset_t *end = dst + bitset_size(nbits); \
48 while (dst < end) \
49 *dst++ &= *bs++; \
50}
51
52#define bitset_or(dst, bs, nbits) \
53{ \
54 bitset_t *end = dst + bitset_size(nbits); \
55 while (dst < end) \
56 *dst++ |= *bs++; \
57}
58
59#define bitset_zero(dst, nbits) \
60{ \
61 bitset_t *end = dst + bitset_size(nbits); \
62 while (dst < end) \
63 *dst++ = 0; \
64}
65
66#define bitset_one(dst, nbits) \
67{ \
68 bitset_t *end = dst + bitset_size(nbits); \
69 while (dst < end) \
70 *dst++ = ~(bitset_t)0; \
71}
72#else
73inline size_t bitset_size(int nbits)
74{
75 return (nbits + sizeof(bitset_t) * 8 - 1) / (sizeof(bitset_t) * 8);
76}
77
78inline bitset_t *bitset_alloc(int nbits)
79{
80 return snd_kcalloc(bitset_size(nbits) * sizeof(bitset_t), GFP_KERNEL);
81}
82
83inline void bitset_set(bitset_t *bitmap, unsigned int pos)
84{
85 size_t bits = sizeof(*bitmap) * 8;
86 bitmap[pos / bits] |= 1 << (pos % bits);
87}
88
89inline void bitset_reset(bitset_t *bitmap, unsigned int pos)
90{
91 size_t bits = sizeof(*bitmap) * 8;
92 bitmap[pos / bits] &= ~(1 << (pos % bits));
93}
94
95inline int bitset_get(bitset_t *bitmap, unsigned int pos)
96{
97 size_t bits = sizeof(*bitmap) * 8;
98 return !!(bitmap[pos / bits] & (1 << (pos % bits)));
99}
100
101inline void bitset_copy(bitset_t *dst, bitset_t *src, unsigned int nbits)
102{
103 memcpy(dst, src, bitset_size(nbits) * sizeof(bitset_t));
104}
105
106inline void bitset_and(bitset_t *dst, bitset_t *bs, unsigned int nbits)
107{
108 bitset_t *end = dst + bitset_size(nbits);
109 while (dst < end)
110 *dst++ &= *bs++;
111}
112
113inline void bitset_or(bitset_t *dst, bitset_t *bs, unsigned int nbits)
114{
115 bitset_t *end = dst + bitset_size(nbits);
116 while (dst < end)
117 *dst++ |= *bs++;
118}
119
120inline void bitset_zero(bitset_t *dst, unsigned int nbits)
121{
122 bitset_t *end = dst + bitset_size(nbits);
123 while (dst < end)
124 *dst++ = 0;
125}
126
127inline void bitset_one(bitset_t *dst, unsigned int nbits)
128{
129 bitset_t *end = dst + bitset_size(nbits);
130 while (dst < end)
131 *dst++ = ~(bitset_t)0;
132}
133#endif
134
135typedef struct _snd_pcm_plugin snd_pcm_plugin_t;
136#define snd_pcm_plug_t snd_pcm_substream_t
137#define snd_pcm_plug_stream(plug) ((plug)->stream)
138
139typedef enum {
140 INIT = 0,
141 PREPARE = 1,
142} snd_pcm_plugin_action_t;
143
144typedef struct _snd_pcm_channel_area {
145#ifdef TARGET_OS2
146 char *addr; /* base address of channel samples */
147#else
148 void *addr; /* base address of channel samples */
149#endif
150 unsigned int first; /* offset to first sample in bits */
151 unsigned int step; /* samples distance in bits */
152} snd_pcm_channel_area_t;
153
154typedef struct _snd_pcm_plugin_channel {
155 void *aptr; /* pointer to the allocated area */
156 snd_pcm_channel_area_t area;
157 unsigned int enabled:1; /* channel need to be processed */
158 unsigned int wanted:1; /* channel is wanted */
159} snd_pcm_plugin_channel_t;
160
161typedef struct _snd_pcm_plugin_format {
162 int format;
163 unsigned int rate;
164 unsigned int channels;
165} snd_pcm_plugin_format_t;
166
167struct _snd_pcm_plugin {
168 const char *name; /* plug-in name */
169 int stream;
170 snd_pcm_plugin_format_t src_format; /* source format */
171 snd_pcm_plugin_format_t dst_format; /* destination format */
172 int src_width; /* sample width in bits */
173 int dst_width; /* sample width in bits */
174 int access;
175 snd_pcm_sframes_t (*src_frames)(snd_pcm_plugin_t *plugin, snd_pcm_uframes_t dst_frames);
176 snd_pcm_sframes_t (*dst_frames)(snd_pcm_plugin_t *plugin, snd_pcm_uframes_t src_frames);
177 snd_pcm_sframes_t (*client_channels)(snd_pcm_plugin_t *plugin,
178 snd_pcm_uframes_t frames,
179 snd_pcm_plugin_channel_t **channels);
180 int (*src_channels_mask)(snd_pcm_plugin_t *plugin,
181 bitset_t *dst_vmask,
182 bitset_t **src_vmask);
183 int (*dst_channels_mask)(snd_pcm_plugin_t *plugin,
184 bitset_t *src_vmask,
185 bitset_t **dst_vmask);
186 snd_pcm_sframes_t (*transfer)(snd_pcm_plugin_t *plugin,
187 const snd_pcm_plugin_channel_t *src_channels,
188 snd_pcm_plugin_channel_t *dst_channels,
189 snd_pcm_uframes_t frames);
190 int (*action)(snd_pcm_plugin_t *plugin,
191 snd_pcm_plugin_action_t action,
192 unsigned long data);
193 snd_pcm_plugin_t *prev;
194 snd_pcm_plugin_t *next;
195 snd_pcm_plug_t *plug;
196 void *private_data;
197 void (*private_free)(snd_pcm_plugin_t *plugin);
198 char *buf;
199 snd_pcm_uframes_t buf_frames;
200 snd_pcm_plugin_channel_t *buf_channels;
201 bitset_t *src_vmask;
202 bitset_t *dst_vmask;
203#ifdef TARGET_OS2
204 char extra_data[1];
205#else
206 char extra_data[0];
207#endif
208};
209
210int snd_pcm_plugin_build(snd_pcm_plug_t *handle,
211 const char *name,
212 snd_pcm_plugin_format_t *src_format,
213 snd_pcm_plugin_format_t *dst_format,
214 size_t extra,
215 snd_pcm_plugin_t **ret);
216int snd_pcm_plugin_free(snd_pcm_plugin_t *plugin);
217int snd_pcm_plugin_clear(snd_pcm_plugin_t **first);
218int snd_pcm_plug_alloc(snd_pcm_plug_t *plug, snd_pcm_uframes_t frames);
219snd_pcm_sframes_t snd_pcm_plug_client_size(snd_pcm_plug_t *handle, snd_pcm_uframes_t drv_size);
220snd_pcm_sframes_t snd_pcm_plug_slave_size(snd_pcm_plug_t *handle, snd_pcm_uframes_t clt_size);
221
222#define ROUTE_PLUGIN_USE_FLOAT 0
223#define FULL ROUTE_PLUGIN_RESOLUTION
224#define HALF ROUTE_PLUGIN_RESOLUTION / 2
225typedef int route_ttable_entry_t;
226
227int snd_pcm_plugin_build_io(snd_pcm_plug_t *handle,
228 snd_pcm_hw_params_t *params,
229 snd_pcm_plugin_t **r_plugin);
230int snd_pcm_plugin_build_linear(snd_pcm_plug_t *handle,
231 snd_pcm_plugin_format_t *src_format,
232 snd_pcm_plugin_format_t *dst_format,
233 snd_pcm_plugin_t **r_plugin);
234int snd_pcm_plugin_build_mulaw(snd_pcm_plug_t *handle,
235 snd_pcm_plugin_format_t *src_format,
236 snd_pcm_plugin_format_t *dst_format,
237 snd_pcm_plugin_t **r_plugin);
238int snd_pcm_plugin_build_rate(snd_pcm_plug_t *handle,
239 snd_pcm_plugin_format_t *src_format,
240 snd_pcm_plugin_format_t *dst_format,
241 snd_pcm_plugin_t **r_plugin);
242int snd_pcm_plugin_build_route(snd_pcm_plug_t *handle,
243 snd_pcm_plugin_format_t *src_format,
244 snd_pcm_plugin_format_t *dst_format,
245 route_ttable_entry_t *ttable,
246 snd_pcm_plugin_t **r_plugin);
247int snd_pcm_plugin_build_copy(snd_pcm_plug_t *handle,
248 snd_pcm_plugin_format_t *src_format,
249 snd_pcm_plugin_format_t *dst_format,
250 snd_pcm_plugin_t **r_plugin);
251
252unsigned int snd_pcm_plug_formats(unsigned int formats);
253
254int snd_pcm_plug_format_plugins(snd_pcm_plug_t *substream,
255 snd_pcm_hw_params_t *params,
256 snd_pcm_hw_params_t *slave_params);
257
258int snd_pcm_plug_slave_format(int format, unsigned int format_mask);
259
260int snd_pcm_plugin_append(snd_pcm_plugin_t *plugin);
261
262snd_pcm_sframes_t snd_pcm_plug_write_transfer(snd_pcm_plug_t *handle, snd_pcm_plugin_channel_t *src_channels, snd_pcm_uframes_t size);
263snd_pcm_sframes_t snd_pcm_plug_read_transfer(snd_pcm_plug_t *handle, snd_pcm_plugin_channel_t *dst_channels_final, snd_pcm_uframes_t size);
264
265snd_pcm_sframes_t snd_pcm_plug_client_channels_buf(snd_pcm_plug_t *handle,
266 char *buf, snd_pcm_uframes_t count,
267 snd_pcm_plugin_channel_t **channels);
268
269snd_pcm_sframes_t snd_pcm_plugin_client_channels(snd_pcm_plugin_t *plugin,
270 snd_pcm_uframes_t frames,
271 snd_pcm_plugin_channel_t **channels);
272
273int snd_pcm_area_silence(const snd_pcm_channel_area_t *dst_channel, size_t dst_offset,
274 size_t samples, int format);
275int snd_pcm_areas_silence(const snd_pcm_channel_area_t *dst_channels, snd_pcm_uframes_t dst_offset,
276 unsigned int channels, snd_pcm_uframes_t frames, int format);
277int snd_pcm_area_copy(const snd_pcm_channel_area_t *src_channel, size_t src_offset,
278 const snd_pcm_channel_area_t *dst_channel, size_t dst_offset,
279 size_t samples, int format);
280int snd_pcm_areas_copy(const snd_pcm_channel_area_t *src_channels, snd_pcm_uframes_t src_offset,
281 const snd_pcm_channel_area_t *dst_channels, snd_pcm_uframes_t dst_offset,
282 unsigned int channels, snd_pcm_uframes_t frames, int format);
283
284void *snd_pcm_plug_buf_alloc(snd_pcm_plug_t *plug, snd_pcm_uframes_t size);
285void snd_pcm_plug_buf_unlock(snd_pcm_plug_t *plug, void *ptr);
286snd_pcm_sframes_t snd_pcm_oss_write3(snd_pcm_substream_t *substream, const char *ptr, snd_pcm_uframes_t size, int in_kernel);
287snd_pcm_sframes_t snd_pcm_oss_read3(snd_pcm_substream_t *substream, char *ptr, snd_pcm_uframes_t size, int in_kernel);
288snd_pcm_sframes_t snd_pcm_oss_writev3(snd_pcm_substream_t *substream, void **bufs, snd_pcm_uframes_t frames, int in_kernel);
289snd_pcm_sframes_t snd_pcm_oss_readv3(snd_pcm_substream_t *substream, void **bufs, snd_pcm_uframes_t frames, int in_kernel);
290
291
292
293#define ROUTE_PLUGIN_RESOLUTION 16
294
295int getput_index(int format);
296int copy_index(int format);
297int conv_index(int src_format, int dst_format);
298
299void zero_channel(snd_pcm_plugin_t *plugin,
300 const snd_pcm_plugin_channel_t *dst_channel,
301 size_t samples);
302
303#ifdef TARGET_OS2
304#define pdprintf snd_printk
305#else
306#ifdef PLUGIN_DEBUG
307#define pdprintf( args... ) printk( "plugin: " ##args)
308#else
309#define pdprintf( args... ) { ; }
310#endif
311#endif
312
313#endif /* __PCM_PLUGIN_H */
Note: See TracBrowser for help on using the repository browser.