merge glitch-free branch back into trunk
[profile/ivi/pulseaudio.git] / src / pulsecore / sample-util.h
1 #ifndef foosampleutilhfoo
2 #define foosampleutilhfoo
3
4 /* $Id$ */
5
6 /***
7   This file is part of PulseAudio.
8
9   Copyright 2004-2006 Lennart Poettering
10   Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
11
12   PulseAudio is free software; you can redistribute it and/or modify
13   it under the terms of the GNU Lesser General Public License as published
14   by the Free Software Foundation; either version 2 of the License,
15   or (at your option) any later version.
16
17   PulseAudio is distributed in the hope that it will be useful, but
18   WITHOUT ANY WARRANTY; without even the implied warranty of
19   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20   General Public License for more details.
21
22   You should have received a copy of the GNU Lesser General Public License
23   along with PulseAudio; if not, write to the Free Software
24   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
25   USA.
26 ***/
27
28 #include <pulse/sample.h>
29 #include <pulse/volume.h>
30 #include <pulsecore/memblock.h>
31 #include <pulsecore/memchunk.h>
32
33 typedef struct pa_silence_cache {
34     pa_memblock* blocks[PA_SAMPLE_MAX];
35 } pa_silence_cache;
36
37 void pa_silence_cache_init(pa_silence_cache *cache);
38 void pa_silence_cache_done(pa_silence_cache *cache);
39
40 void *pa_silence_memory(void *p, size_t length, const pa_sample_spec *spec);
41 pa_memchunk* pa_silence_memchunk(pa_memchunk *c, const pa_sample_spec *spec);
42 pa_memblock* pa_silence_memblock(pa_memblock *b, const pa_sample_spec *spec);
43
44 pa_memchunk* pa_silence_memchunk_get(pa_silence_cache *cache, pa_mempool *pool, pa_memchunk* ret, const pa_sample_spec *spec, size_t length);
45
46 typedef struct pa_mix_info {
47     pa_memchunk chunk;
48     pa_cvolume volume;
49     void *userdata;
50
51     /* The following fields are used internally by pa_mix(), should
52      * not be initialised by the caller of pa_mix(). */
53     void *ptr;
54     union {
55         int32_t i;
56         float f;
57     } linear[PA_CHANNELS_MAX];
58 } pa_mix_info;
59
60 size_t pa_mix(
61     pa_mix_info channels[],
62     unsigned nchannels,
63     void *data,
64     size_t length,
65     const pa_sample_spec *spec,
66     const pa_cvolume *volume,
67     pa_bool_t mute);
68
69 void pa_volume_memchunk(
70     pa_memchunk*c,
71     const pa_sample_spec *spec,
72     const pa_cvolume *volume);
73
74 size_t pa_frame_align(size_t l, const pa_sample_spec *ss) PA_GCC_PURE;
75
76 int pa_frame_aligned(size_t l, const pa_sample_spec *ss) PA_GCC_PURE;
77
78 void pa_interleave(const void *src[], unsigned channels, void *dst, size_t ss, unsigned n);
79 void pa_deinterleave(const void *src, void *dst[], unsigned channels, size_t ss, unsigned n);
80
81 void pa_sample_clamp(pa_sample_format_t format, void *dst, size_t dstr, const void *src, size_t sstr, unsigned n);
82
83 #endif