libspeex/sb_celp.h

/* Copyright (C) 2002 Jean-Marc Valin */
/**
   @file sb_celp.h
   @brief Sub-band CELP mode used for wideband encoding
*/
/*
   Redistribution and use in source and binary forms, with or without
   modification, are permitted provided that the following conditions
   are met:
   
   - Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
   
   - Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or other materials provided with the distribution.
   
   - Neither the name of the Xiph.org Foundation nor the names of its
   contributors may be used to endorse or promote products derived from
   this software without specific prior written permission.
   
   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
   A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR
   CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

*/

#ifndef SB_CELP_H
#define SB_CELP_H

#include "modes.h"
#include "speex_bits.h"
#include "nb_celp.h"

/**Structure representing the full state of the sub-band encoder*/
typedef struct SBEncState {
   SpeexMode *mode;            /**< Pointer to the mode (containing for vtable info) */
   void *st_low;               /**< State of the low-band (narrowband) encoder */
   int    full_frame_size;     /**< Length of full-band frames*/
   int    frame_size;          /**< Length of high-band frames*/
   int    subframeSize;        /**< Length of high-band sub-frames*/
   int    nbSubframes;         /**< Number of high-band sub-frames*/
   int    windowSize;          /**< Length of high-band LPC window*/
   int    lpcSize;             /**< Order of high-band LPC analysis */
   int    bufSize;             /**< Buffer size */
   int    first;               /**< First frame? */
   float  lag_factor;          /**< Lag-windowing control parameter */
   float  lpc_floor;           /**< Controls LPC analysis noise floor */
   float  gamma1;              /**< Perceptual weighting coef 1 */
   float  gamma2;              /**< Perceptual weighting coef 2 */

   void  *stack;               /**< Temporary allocation stack */
   float *x0d, *x1d; /**< QMF filter signals*/
   float *high;                /**< High-band signal (buffer) */
   float *y0, *y1;             /**< QMF synthesis signals */
   float *h0_mem, *h1_mem, *g0_mem, *g1_mem; /**< QMF memories */

   float *excBuf;              /**< High-band excitation */
   float *exc;                 /**< High-band excitation (for QMF only)*/
   float *buf;                 /**< Temporary buffer */
   float *res;                 /**< Zero-input response (ringing) */
   float *sw;                  /**< Perceptually weighted signal */
   float *target;              /**< Weighted target signal (analysis by synthesis) */
   float *window;              /**< LPC analysis window */
   float *lagWindow;           /**< Auto-correlation window */
   float *autocorr;            /**< Auto-correlation (for LPC analysis) */
   float *rc;                  /**< Reflection coefficients (unused) */
   float *lpc;                 /**< LPC coefficients */
   float *lsp;                 /**< LSP coefficients */
   float *qlsp;                /**< Quantized LSPs */
   float *old_lsp;             /**< LSPs of previous frame */
   float *old_qlsp;            /**< Quantized LSPs of previous frame */
   float *interp_lsp;          /**< Interpolated LSPs for current sub-frame */
   float *interp_qlsp;         /**< Interpolated quantized LSPs for current sub-frame */
   float *interp_lpc;          /**< Interpolated LPCs for current sub-frame */
   float *interp_qlpc;         /**< Interpolated quantized LPCs for current sub-frame */
   float *bw_lpc1;             /**< Bandwidth-expanded version of LPCs (#1) */
   float *bw_lpc2;             /**< Bandwidth-expanded version of LPCs (#2) */

   float *mem_sp;              /**< Synthesis signal memory */
   float *mem_sp2;
   float *mem_sw;              /**< Perceptual signal memory */
   float *pi_gain;

   float  vbr_quality;         /**< Quality setting for VBR encoding */
   int    vbr_enabled;         /**< 1 for enabling VBR, 0 otherwise */
   int    vad_enabled;         /**< 1 for enabling VAD, 0 otherwise */
   float  relative_quality;

   SpeexSubmode **submodes;
   int    submodeID;
   int    submodeSelect;
   int    complexity;
   int    sampling_rate;

} SBEncState;


/**Structure representing the full state of the sub-band decoder*/
typedef struct SBDecState {
   SpeexMode *mode;            /**< Pointer to the mode (containing for vtable info) */
   void *st_low;               /**< State of the low-band (narrowband) encoder */
   int    full_frame_size;
   int    frame_size;
   int    subframeSize;
   int    nbSubframes;
   int    lpcSize;
   int    first;
   int    sampling_rate;
   int    lpc_enh_enabled;

   void  *stack;
   float *x0d, *x1d;
   float *high;
   float *y0, *y1;
   float *h0_mem, *h1_mem, *g0_mem, *g1_mem;

   float *exc;
   float *qlsp;
   float *old_qlsp;
   float *interp_qlsp;
   float *interp_qlpc;

   float *mem_sp;
   float *pi_gain;

   SpeexSubmode **submodes;
   int    submodeID;
} SBDecState;


/**Initializes encoder state*/
void *sb_encoder_init(SpeexMode *m);

/**De-allocates encoder state resources*/
void sb_encoder_destroy(void *state);

/**Encodes one frame*/
void sb_encode(void *state, float *in, SpeexBits *bits);


/**Initializes decoder state*/
void *sb_decoder_init(SpeexMode *m);

/**De-allocates decoder state resources*/
void sb_decoder_destroy(void *state);

/**Decodes one frame*/
int sb_decode(void *state, SpeexBits *bits, float *out);

void sb_encoder_ctl(void *state, int request, void *ptr);

void sb_decoder_ctl(void *state, int request, void *ptr);

#endif