Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | #ifndef __PCM_PLUGIN_H |
2 | #define __PCM_PLUGIN_H | |
3 | ||
4 | /* | |
5 | * Digital Audio (Plugin interface) abstract layer | |
c1017a4c | 6 | * Copyright (c) by Jaroslav Kysela <perex@perex.cz> |
1da177e4 LT |
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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
22 | * | |
23 | */ | |
24 | ||
21a3479a JK |
25 | #ifdef CONFIG_SND_PCM_OSS_PLUGINS |
26 | ||
1da177e4 LT |
27 | #define snd_pcm_plug_stream(plug) ((plug)->stream) |
28 | ||
6ac77bc1 | 29 | enum snd_pcm_plugin_action { |
1da177e4 LT |
30 | INIT = 0, |
31 | PREPARE = 1, | |
6ac77bc1 | 32 | }; |
1da177e4 | 33 | |
6ac77bc1 | 34 | struct snd_pcm_channel_area { |
1da177e4 LT |
35 | void *addr; /* base address of channel samples */ |
36 | unsigned int first; /* offset to first sample in bits */ | |
37 | unsigned int step; /* samples distance in bits */ | |
6ac77bc1 | 38 | }; |
1da177e4 | 39 | |
6ac77bc1 | 40 | struct snd_pcm_plugin_channel { |
1da177e4 | 41 | void *aptr; /* pointer to the allocated area */ |
6ac77bc1 | 42 | struct snd_pcm_channel_area area; |
1da177e4 LT |
43 | snd_pcm_uframes_t frames; /* allocated frames */ |
44 | unsigned int enabled:1; /* channel need to be processed */ | |
45 | unsigned int wanted:1; /* channel is wanted */ | |
6ac77bc1 | 46 | }; |
1da177e4 | 47 | |
6ac77bc1 | 48 | struct snd_pcm_plugin_format { |
fea952e5 | 49 | snd_pcm_format_t format; |
1da177e4 LT |
50 | unsigned int rate; |
51 | unsigned int channels; | |
6ac77bc1 | 52 | }; |
1da177e4 | 53 | |
6ac77bc1 | 54 | struct snd_pcm_plugin { |
1da177e4 LT |
55 | const char *name; /* plug-in name */ |
56 | int stream; | |
6ac77bc1 TI |
57 | struct snd_pcm_plugin_format src_format; /* source format */ |
58 | struct snd_pcm_plugin_format dst_format; /* destination format */ | |
1da177e4 LT |
59 | int src_width; /* sample width in bits */ |
60 | int dst_width; /* sample width in bits */ | |
fea952e5 | 61 | snd_pcm_access_t access; |
6ac77bc1 TI |
62 | snd_pcm_sframes_t (*src_frames)(struct snd_pcm_plugin *plugin, snd_pcm_uframes_t dst_frames); |
63 | snd_pcm_sframes_t (*dst_frames)(struct snd_pcm_plugin *plugin, snd_pcm_uframes_t src_frames); | |
64 | snd_pcm_sframes_t (*client_channels)(struct snd_pcm_plugin *plugin, | |
65 | snd_pcm_uframes_t frames, | |
66 | struct snd_pcm_plugin_channel **channels); | |
6ac77bc1 TI |
67 | snd_pcm_sframes_t (*transfer)(struct snd_pcm_plugin *plugin, |
68 | const struct snd_pcm_plugin_channel *src_channels, | |
69 | struct snd_pcm_plugin_channel *dst_channels, | |
70 | snd_pcm_uframes_t frames); | |
71 | int (*action)(struct snd_pcm_plugin *plugin, | |
72 | enum snd_pcm_plugin_action action, | |
1da177e4 | 73 | unsigned long data); |
6ac77bc1 TI |
74 | struct snd_pcm_plugin *prev; |
75 | struct snd_pcm_plugin *next; | |
76 | struct snd_pcm_substream *plug; | |
1da177e4 | 77 | void *private_data; |
6ac77bc1 | 78 | void (*private_free)(struct snd_pcm_plugin *plugin); |
1da177e4 LT |
79 | char *buf; |
80 | snd_pcm_uframes_t buf_frames; | |
6ac77bc1 | 81 | struct snd_pcm_plugin_channel *buf_channels; |
1da177e4 LT |
82 | char extra_data[0]; |
83 | }; | |
84 | ||
6ac77bc1 | 85 | int snd_pcm_plugin_build(struct snd_pcm_substream *handle, |
1da177e4 | 86 | const char *name, |
6ac77bc1 TI |
87 | struct snd_pcm_plugin_format *src_format, |
88 | struct snd_pcm_plugin_format *dst_format, | |
1da177e4 | 89 | size_t extra, |
6ac77bc1 TI |
90 | struct snd_pcm_plugin **ret); |
91 | int snd_pcm_plugin_free(struct snd_pcm_plugin *plugin); | |
92 | int snd_pcm_plugin_clear(struct snd_pcm_plugin **first); | |
93 | int snd_pcm_plug_alloc(struct snd_pcm_substream *plug, snd_pcm_uframes_t frames); | |
94 | snd_pcm_sframes_t snd_pcm_plug_client_size(struct snd_pcm_substream *handle, snd_pcm_uframes_t drv_size); | |
95 | snd_pcm_sframes_t snd_pcm_plug_slave_size(struct snd_pcm_substream *handle, snd_pcm_uframes_t clt_size); | |
1da177e4 LT |
96 | |
97 | #define FULL ROUTE_PLUGIN_RESOLUTION | |
98 | #define HALF ROUTE_PLUGIN_RESOLUTION / 2 | |
6ac77bc1 TI |
99 | |
100 | int snd_pcm_plugin_build_io(struct snd_pcm_substream *handle, | |
101 | struct snd_pcm_hw_params *params, | |
102 | struct snd_pcm_plugin **r_plugin); | |
103 | int snd_pcm_plugin_build_linear(struct snd_pcm_substream *handle, | |
104 | struct snd_pcm_plugin_format *src_format, | |
105 | struct snd_pcm_plugin_format *dst_format, | |
106 | struct snd_pcm_plugin **r_plugin); | |
107 | int snd_pcm_plugin_build_mulaw(struct snd_pcm_substream *handle, | |
108 | struct snd_pcm_plugin_format *src_format, | |
109 | struct snd_pcm_plugin_format *dst_format, | |
110 | struct snd_pcm_plugin **r_plugin); | |
111 | int snd_pcm_plugin_build_rate(struct snd_pcm_substream *handle, | |
112 | struct snd_pcm_plugin_format *src_format, | |
113 | struct snd_pcm_plugin_format *dst_format, | |
114 | struct snd_pcm_plugin **r_plugin); | |
115 | int snd_pcm_plugin_build_route(struct snd_pcm_substream *handle, | |
116 | struct snd_pcm_plugin_format *src_format, | |
117 | struct snd_pcm_plugin_format *dst_format, | |
6ac77bc1 TI |
118 | struct snd_pcm_plugin **r_plugin); |
119 | int snd_pcm_plugin_build_copy(struct snd_pcm_substream *handle, | |
120 | struct snd_pcm_plugin_format *src_format, | |
121 | struct snd_pcm_plugin_format *dst_format, | |
122 | struct snd_pcm_plugin **r_plugin); | |
123 | ||
124 | int snd_pcm_plug_format_plugins(struct snd_pcm_substream *substream, | |
125 | struct snd_pcm_hw_params *params, | |
126 | struct snd_pcm_hw_params *slave_params); | |
127 | ||
fea952e5 CL |
128 | snd_pcm_format_t snd_pcm_plug_slave_format(snd_pcm_format_t format, |
129 | struct snd_mask *format_mask); | |
6ac77bc1 TI |
130 | |
131 | int snd_pcm_plugin_append(struct snd_pcm_plugin *plugin); | |
132 | ||
133 | snd_pcm_sframes_t snd_pcm_plug_write_transfer(struct snd_pcm_substream *handle, | |
134 | struct snd_pcm_plugin_channel *src_channels, | |
135 | snd_pcm_uframes_t size); | |
136 | snd_pcm_sframes_t snd_pcm_plug_read_transfer(struct snd_pcm_substream *handle, | |
137 | struct snd_pcm_plugin_channel *dst_channels_final, | |
138 | snd_pcm_uframes_t size); | |
139 | ||
140 | snd_pcm_sframes_t snd_pcm_plug_client_channels_buf(struct snd_pcm_substream *handle, | |
141 | char *buf, snd_pcm_uframes_t count, | |
142 | struct snd_pcm_plugin_channel **channels); | |
143 | ||
144 | snd_pcm_sframes_t snd_pcm_plugin_client_channels(struct snd_pcm_plugin *plugin, | |
145 | snd_pcm_uframes_t frames, | |
146 | struct snd_pcm_plugin_channel **channels); | |
147 | ||
148 | int snd_pcm_area_silence(const struct snd_pcm_channel_area *dst_channel, | |
149 | size_t dst_offset, | |
fea952e5 | 150 | size_t samples, snd_pcm_format_t format); |
6ac77bc1 TI |
151 | int snd_pcm_area_copy(const struct snd_pcm_channel_area *src_channel, |
152 | size_t src_offset, | |
153 | const struct snd_pcm_channel_area *dst_channel, | |
154 | size_t dst_offset, | |
fea952e5 | 155 | size_t samples, snd_pcm_format_t format); |
1da177e4 | 156 | |
6ac77bc1 TI |
157 | void *snd_pcm_plug_buf_alloc(struct snd_pcm_substream *plug, snd_pcm_uframes_t size); |
158 | void snd_pcm_plug_buf_unlock(struct snd_pcm_substream *plug, void *ptr); | |
159 | snd_pcm_sframes_t snd_pcm_oss_write3(struct snd_pcm_substream *substream, | |
160 | const char *ptr, snd_pcm_uframes_t size, | |
161 | int in_kernel); | |
162 | snd_pcm_sframes_t snd_pcm_oss_read3(struct snd_pcm_substream *substream, | |
163 | char *ptr, snd_pcm_uframes_t size, int in_kernel); | |
164 | snd_pcm_sframes_t snd_pcm_oss_writev3(struct snd_pcm_substream *substream, | |
165 | void **bufs, snd_pcm_uframes_t frames, | |
166 | int in_kernel); | |
167 | snd_pcm_sframes_t snd_pcm_oss_readv3(struct snd_pcm_substream *substream, | |
168 | void **bufs, snd_pcm_uframes_t frames, | |
169 | int in_kernel); | |
1da177e4 | 170 | |
21a3479a JK |
171 | #else |
172 | ||
173 | static inline snd_pcm_sframes_t snd_pcm_plug_client_size(struct snd_pcm_substream *handle, snd_pcm_uframes_t drv_size) { return drv_size; } | |
174 | static inline snd_pcm_sframes_t snd_pcm_plug_slave_size(struct snd_pcm_substream *handle, snd_pcm_uframes_t clt_size) { return clt_size; } | |
175 | static inline int snd_pcm_plug_slave_format(int format, struct snd_mask *format_mask) { return format; } | |
176 | ||
177 | #endif | |
178 | ||
1da177e4 | 179 | #ifdef PLUGIN_DEBUG |
006de267 | 180 | #define pdprintf(fmt, args...) printk(KERN_DEBUG "plugin: " fmt, ##args) |
1da177e4 | 181 | #else |
006de267 | 182 | #define pdprintf(fmt, args...) |
1da177e4 LT |
183 | #endif |
184 | ||
185 | #endif /* __PCM_PLUGIN_H */ |