code.delx.au - pulseaudio/blob - src/modules/echo-cancel/echo-cancel.h

   1 /***
   2     This file is part of PulseAudio.
   3
   4     Copyright 2010 Arun Raghavan <arun.raghavan@collabora.co.uk>
   5
   6     PulseAudio is free software; you can redistribute it and/or modify
   7     it under the terms of the GNU Lesser General Public License as published
   8     by the Free Software Foundation; either version 2.1 of the License,
   9     or (at your option) any later version.
  10
  11     PulseAudio is distributed in the hope that it will be useful, but
  12     WITHOUT ANY WARRANTY; without even the implied warranty of
  13     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  14     General Public License for more details.
  15
  16     You should have received a copy of the GNU Lesser General Public License
  17     along with PulseAudio; if not, write to the Free Software
  18     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  19     USA.
  20 ***/
  21
  22 #ifdef HAVE_CONFIG_H
  23 #include <config.h>
  24 #endif
  25
  26 #include <pulse/sample.h>
  27 #include <pulse/channelmap.h>
  28 #include <pulsecore/macro.h>
  29
  30 #include <speex/speex_echo.h>
  31 #include "adrian.h"
  32
  33 /* Common data structures */
  34
  35 typedef struct pa_echo_canceller_params pa_echo_canceller_params;
  36
  37 struct pa_echo_canceller_params {
  38     union {
  39         struct {
  40             uint32_t blocksize;
  41             SpeexEchoState *state;
  42         } speex;
  43         struct {
  44             uint32_t blocksize;
  45             AEC *aec;
  46         } adrian;
  47         /* each canceller-specific structure goes here */
  48     } priv;
  49 };
  50
  51 typedef struct pa_echo_canceller pa_echo_canceller;
  52
  53 struct pa_echo_canceller {
  54     pa_bool_t   (*init)                 (pa_echo_canceller *ec,
  55                                          pa_sample_spec *source_ss,
  56                                          pa_channel_map *source_map,
  57                                          pa_sample_spec *sink_ss,
  58                                          pa_channel_map *sink_map,
  59                                          const char *args);
  60     void        (*run)                  (pa_echo_canceller *ec, uint8_t *rec, uint8_t *play, uint8_t *out);
  61     void        (*done)                 (pa_echo_canceller *ec);
  62     uint32_t    (*get_block_size)       (pa_echo_canceller *ec);
  63
  64     pa_echo_canceller_params params;
  65 };
  66
  67 /* Speex canceller functions */
  68 pa_bool_t pa_speex_ec_init(pa_echo_canceller *ec,
  69                            pa_sample_spec *source_ss, pa_channel_map *source_map,
  70                            pa_sample_spec *sink_ss, pa_channel_map *sink_map,
  71                            const char *args);
  72 void pa_speex_ec_run(pa_echo_canceller *ec, uint8_t *rec, uint8_t *play, uint8_t *out);
  73 void pa_speex_ec_done(pa_echo_canceller *ec);
  74 uint32_t pa_speex_ec_get_block_size(pa_echo_canceller *ec);
  75
  76 /* Adrian Andre's echo canceller */
  77 pa_bool_t pa_adrian_ec_init(pa_echo_canceller *ec,
  78                            pa_sample_spec *source_ss, pa_channel_map *source_map,
  79                            pa_sample_spec *sink_ss, pa_channel_map *sink_map,
  80                            const char *args);
  81 void pa_adrian_ec_run(pa_echo_canceller *ec, uint8_t *rec, uint8_t *play, uint8_t *out);
  82 void pa_adrian_ec_done(pa_echo_canceller *ec);
  83 uint32_t pa_adrian_ec_get_block_size(pa_echo_canceller *ec);