code.delx.au - pulseaudio/blob - src/pulsecore/sample-util.h

   1 #ifndef foosampleutilhfoo
   2 #define foosampleutilhfoo
   3
   4 /***
   5   This file is part of PulseAudio.
   6
   7   Copyright 2004-2006 Lennart Poettering
   8   Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
   9
  10   PulseAudio is free software; you can redistribute it and/or modify
  11   it under the terms of the GNU Lesser General Public License as published
  12   by the Free Software Foundation; either version 2.1 of the License,
  13   or (at your option) any later version.
  14
  15   PulseAudio is distributed in the hope that it will be useful, but
  16   WITHOUT ANY WARRANTY; without even the implied warranty of
  17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18   General Public License for more details.
  19
  20   You should have received a copy of the GNU Lesser General Public License
  21   along with PulseAudio; if not, write to the Free Software
  22   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  23   USA.
  24 ***/
  25
  26 #include <inttypes.h>
  27 #include <limits.h>
  28
  29 #include <pulse/gccmacro.h>
  30 #include <pulse/sample.h>
  31 #include <pulse/volume.h>
  32 #include <pulse/channelmap.h>
  33
  34 #include <pulsecore/memblock.h>
  35 #include <pulsecore/memchunk.h>
  36
  37 typedef struct pa_silence_cache {
  38     pa_memblock* blocks[PA_SAMPLE_MAX];
  39 } pa_silence_cache;
  40
  41 void pa_silence_cache_init(pa_silence_cache *cache);
  42 void pa_silence_cache_done(pa_silence_cache *cache);
  43
  44 void *pa_silence_memory(void *p, size_t length, const pa_sample_spec *spec);
  45 pa_memchunk* pa_silence_memchunk(pa_memchunk *c, const pa_sample_spec *spec);
  46 pa_memblock* pa_silence_memblock(pa_memblock *b, const pa_sample_spec *spec);
  47
  48 pa_memchunk* pa_silence_memchunk_get(pa_silence_cache *cache, pa_mempool *pool, pa_memchunk* ret, const pa_sample_spec *spec, size_t length);
  49
  50 size_t pa_frame_align(size_t l, const pa_sample_spec *ss) PA_GCC_PURE;
  51
  52 bool pa_frame_aligned(size_t l, const pa_sample_spec *ss) PA_GCC_PURE;
  53
  54 void pa_interleave(const void *src[], unsigned channels, void *dst, size_t ss, unsigned n);
  55 void pa_deinterleave(const void *src, void *dst[], unsigned channels, size_t ss, unsigned n);
  56
  57 void pa_sample_clamp(pa_sample_format_t format, void *dst, size_t dstr, const void *src, size_t sstr, unsigned n);
  58
  59 static inline int32_t pa_mult_s16_volume(int16_t v, int32_t cv) {
  60 #if __WORDSIZE == 64 || ((ULONG_MAX) > (UINT_MAX))
  61     /* Multiply with 64 bit integers on 64 bit platforms */
  62     return (v * (int64_t) cv) >> 16;
  63 #else
  64     /* Multiplying the 32 bit volume factor with the
  65      * 16 bit sample might result in an 48 bit value. We
  66      * want to do without 64 bit integers and hence do
  67      * the multiplication independently for the HI and
  68      * LO part of the volume. */
  69
  70     int32_t hi = cv >> 16;
  71     int32_t lo = cv & 0xFFFF;
  72     return ((v * lo) >> 16) + (v * hi);
  73 #endif
  74 }
  75
  76 pa_usec_t pa_bytes_to_usec_round_up(uint64_t length, const pa_sample_spec *spec);
  77 size_t pa_usec_to_bytes_round_up(pa_usec_t t, const pa_sample_spec *spec);
  78
  79 void pa_memchunk_dump_to_file(pa_memchunk *c, const char *fn);
  80
  81 void pa_memchunk_sine(pa_memchunk *c, pa_mempool *pool, unsigned rate, unsigned freq);
  82
  83 typedef void (*pa_do_volume_func_t) (void *samples, const void *volumes, unsigned channels, unsigned length);
  84
  85 pa_do_volume_func_t pa_get_volume_func(pa_sample_format_t f);
  86 void pa_set_volume_func(pa_sample_format_t f, pa_do_volume_func_t func);
  87
  88 size_t pa_convert_size(size_t size, const pa_sample_spec *from, const pa_sample_spec *to);
  89
  90 #define PA_CHANNEL_POSITION_MASK_LEFT                                   \
  91     (PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_FRONT_LEFT)           \
  92      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_REAR_LEFT)          \
  93      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER) \
  94      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_SIDE_LEFT)          \
  95      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_FRONT_LEFT)     \
  96      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_REAR_LEFT))     \
  97
  98 #define PA_CHANNEL_POSITION_MASK_RIGHT                                  \
  99     (PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_FRONT_RIGHT)          \
 100      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_REAR_RIGHT)         \
 101      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER) \
 102      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_SIDE_RIGHT)         \
 103      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_FRONT_RIGHT)    \
 104      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_REAR_RIGHT))
 105
 106 #define PA_CHANNEL_POSITION_MASK_CENTER                                 \
 107     (PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_FRONT_CENTER)         \
 108      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_REAR_CENTER)        \
 109      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_CENTER)         \
 110      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_FRONT_CENTER)   \
 111      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_REAR_CENTER))
 112
 113 #define PA_CHANNEL_POSITION_MASK_FRONT                                  \
 114     (PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_FRONT_LEFT)           \
 115      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_FRONT_RIGHT)        \
 116      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_FRONT_CENTER)       \
 117      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER) \
 118      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER) \
 119      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_FRONT_LEFT)     \
 120      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_FRONT_RIGHT)    \
 121      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_FRONT_CENTER))
 122
 123 #define PA_CHANNEL_POSITION_MASK_REAR                                   \
 124     (PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_REAR_LEFT)            \
 125      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_REAR_RIGHT)         \
 126      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_REAR_CENTER)        \
 127      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_REAR_LEFT)      \
 128      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_REAR_RIGHT)     \
 129      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_REAR_CENTER))
 130
 131 #define PA_CHANNEL_POSITION_MASK_SIDE_OR_TOP_CENTER                     \
 132     (PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_SIDE_LEFT)            \
 133      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_SIDE_RIGHT)         \
 134      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_CENTER))
 135
 136 #define PA_CHANNEL_POSITION_MASK_TOP                                    \
 137     (PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_CENTER)           \
 138      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_FRONT_LEFT)     \
 139      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_FRONT_RIGHT)    \
 140      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_FRONT_CENTER)   \
 141      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_REAR_LEFT)      \
 142      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_REAR_RIGHT)     \
 143      | PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_TOP_REAR_CENTER))
 144
 145 #define PA_CHANNEL_POSITION_MASK_ALL            \
 146     ((pa_channel_position_mask_t) (PA_CHANNEL_POSITION_MASK(PA_CHANNEL_POSITION_MAX)-1))
 147
 148 #endif