198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project/* Copyright (C) 2002-2006 Jean-Marc Valin */ 298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project/** 398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project @file sb_celp.h 498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project @brief Sub-band CELP mode used for wideband encoding 598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project*/ 698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project/* 798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project Redistribution and use in source and binary forms, with or without 898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project modification, are permitted provided that the following conditions 998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project are met: 1098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 1198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project - Redistributions of source code must retain the above copyright 1298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project notice, this list of conditions and the following disclaimer. 1398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 1498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project - Redistributions in binary form must reproduce the above copyright 1598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project notice, this list of conditions and the following disclaimer in the 1698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project documentation and/or other materials provided with the distribution. 1798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 1898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project - Neither the name of the Xiph.org Foundation nor the names of its 1998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project contributors may be used to endorse or promote products derived from 2098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project this software without specific prior written permission. 2198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 2298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 2398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 2498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 2598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR 2698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 2798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 2898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 2998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 3098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 3198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 3298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 3398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 3498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project*/ 3598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 3698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project#ifndef SB_CELP_H 3798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project#define SB_CELP_H 3898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 3998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project#include "modes.h" 4098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project#include <speex/speex_bits.h> 4198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project#include "nb_celp.h" 4298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 4398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project/**Structure representing the full state of the sub-band encoder*/ 4498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Projecttypedef struct SBEncState { 4598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project const SpeexMode *mode; /**< Pointer to the mode (containing for vtable info) */ 4698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project void *st_low; /**< State of the low-band (narrowband) encoder */ 4798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int full_frame_size; /**< Length of full-band frames*/ 4898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int frame_size; /**< Length of high-band frames*/ 4998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int subframeSize; /**< Length of high-band sub-frames*/ 5098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int nbSubframes; /**< Number of high-band sub-frames*/ 5198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int windowSize; /**< Length of high-band LPC window*/ 5298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int lpcSize; /**< Order of high-band LPC analysis */ 5398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int first; /**< First frame? */ 5498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t lpc_floor; /**< Controls LPC analysis noise floor */ 5598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t gamma1; /**< Perceptual weighting coef 1 */ 5698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t gamma2; /**< Perceptual weighting coef 2 */ 5798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 5898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project char *stack; /**< Temporary allocation stack */ 5998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t *high; /**< High-band signal (buffer) */ 6098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t *h0_mem, *h1_mem; 6198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 6298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project const spx_word16_t *window; /**< LPC analysis window */ 6398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project const spx_word16_t *lagWindow; /**< Auto-correlation window */ 6498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_lsp_t *old_lsp; /**< LSPs of previous frame */ 6598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_lsp_t *old_qlsp; /**< Quantized LSPs of previous frame */ 6698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_coef_t *interp_qlpc; /**< Interpolated quantized LPCs for current sub-frame */ 6798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 6898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_mem_t *mem_sp; /**< Synthesis signal memory */ 6998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_mem_t *mem_sp2; 7098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_mem_t *mem_sw; /**< Perceptual signal memory */ 7198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word32_t *pi_gain; 7298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t *exc_rms; 7398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t *innov_rms_save; /**< If non-NULL, innovation is copied here */ 7498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 7598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project#ifndef DISABLE_VBR 7698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project float vbr_quality; /**< Quality setting for VBR encoding */ 7798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int vbr_enabled; /**< 1 for enabling VBR, 0 otherwise */ 7898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_int32_t vbr_max; /**< Max bit-rate allowed in VBR mode (total) */ 7998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_int32_t vbr_max_high; /**< Max bit-rate allowed in VBR mode for the high-band */ 8098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_int32_t abr_enabled; /**< ABR setting (in bps), 0 if off */ 8198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project float abr_drift; 8298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project float abr_drift2; 8398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project float abr_count; 8498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int vad_enabled; /**< 1 for enabling VAD, 0 otherwise */ 8598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project float relative_quality; 8698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project#endif /* #ifndef DISABLE_VBR */ 8798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 8898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int encode_submode; 8998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project const SpeexSubmode * const *submodes; 9098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int submodeID; 9198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int submodeSelect; 9298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int complexity; 9398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_int32_t sampling_rate; 9498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 9598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project} SBEncState; 9698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 9798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 9898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project/**Structure representing the full state of the sub-band decoder*/ 9998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Projecttypedef struct SBDecState { 10098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project const SpeexMode *mode; /**< Pointer to the mode (containing for vtable info) */ 10198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project void *st_low; /**< State of the low-band (narrowband) encoder */ 10298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int full_frame_size; 10398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int frame_size; 10498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int subframeSize; 10598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int nbSubframes; 10698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int lpcSize; 10798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int first; 10898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_int32_t sampling_rate; 10998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int lpc_enh_enabled; 11098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 11198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project char *stack; 11298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t *g0_mem, *g1_mem; 11398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 11498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t *excBuf; 11598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_lsp_t *old_qlsp; 11698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_coef_t *interp_qlpc; 11798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 11898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_mem_t *mem_sp; 11998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word32_t *pi_gain; 12098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t *exc_rms; 12198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t *innov_save; /** If non-NULL, innovation is copied here */ 12298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 12398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_word16_t last_ener; 12498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project spx_int32_t seed; 12598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 12698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int encode_submode; 12798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project const SpeexSubmode * const *submodes; 12898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project int submodeID; 12998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project} SBDecState; 13098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 13198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 13298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project/**Initializes encoder state*/ 13398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Projectvoid *sb_encoder_init(const SpeexMode *m); 13498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 13598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project/**De-allocates encoder state resources*/ 13698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Projectvoid sb_encoder_destroy(void *state); 13798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 13898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project/**Encodes one frame*/ 13998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Projectint sb_encode(void *state, void *in, SpeexBits *bits); 14098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 14198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 14298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project/**Initializes decoder state*/ 14398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Projectvoid *sb_decoder_init(const SpeexMode *m); 14498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 14598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project/**De-allocates decoder state resources*/ 14698913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Projectvoid sb_decoder_destroy(void *state); 14798913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 14898913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project/**Decodes one frame*/ 14998913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Projectint sb_decode(void *state, SpeexBits *bits, void *out); 15098913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 15198913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Projectint sb_encoder_ctl(void *state, int request, void *ptr); 15298913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 15398913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Projectint sb_decoder_ctl(void *state, int request, void *ptr); 15498913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project 15598913fed6520d8849fb2e246be943e04474aefaThe Android Open Source Project#endif 156