Index: speex/libspeex/nb_celp.h |
=================================================================== |
--- speex/libspeex/nb_celp.h (revision 0) |
+++ speex/libspeex/nb_celp.h (revision 0) |
@@ -0,0 +1,203 @@ |
+/* Copyright (C) 2002-2006 Jean-Marc Valin */ |
+/** |
+ @file nb_celp.h |
+ @brief Narrowband CELP encoder/decoder |
+*/ |
+/* |
+ 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 NB_CELP_H |
+#define NB_CELP_H |
+ |
+#include "modes.h" |
+#include <speex/speex_bits.h> |
+#include <speex/speex_callbacks.h> |
+#include "vbr.h" |
+#include "filters.h" |
+ |
+#ifdef VORBIS_PSYCHO |
+#include "vorbis_psy.h" |
+#endif |
+ |
+/**Structure representing the full state of the narrowband encoder*/ |
+typedef struct EncState { |
+ const SpeexMode *mode; /**< Mode corresponding to the state */ |
+ int first; /**< Is this the first frame? */ |
+ int frameSize; /**< Size of frames */ |
+ int subframeSize; /**< Size of sub-frames */ |
+ int nbSubframes; /**< Number of sub-frames */ |
+ int windowSize; /**< Analysis (LPC) window length */ |
+ int lpcSize; /**< LPC order */ |
+ int min_pitch; /**< Minimum pitch value allowed */ |
+ int max_pitch; /**< Maximum pitch value allowed */ |
+ |
+ spx_word32_t cumul_gain; /**< Product of previously used pitch gains (Q10) */ |
+ int bounded_pitch; /**< Next frame should not rely on previous frames for pitch */ |
+ int ol_pitch; /**< Open-loop pitch */ |
+ int ol_voiced; /**< Open-loop voiced/non-voiced decision */ |
+ int *pitch; |
+ |
+#ifdef VORBIS_PSYCHO |
+ VorbisPsy *psy; |
+ float *psy_window; |
+ float *curve; |
+ float *old_curve; |
+#endif |
+ |
+ spx_word16_t gamma1; /**< Perceptual filter: A(z/gamma1) */ |
+ spx_word16_t gamma2; /**< Perceptual filter: A(z/gamma2) */ |
+ spx_word16_t lpc_floor; /**< Noise floor multiplier for A[0] in LPC analysis*/ |
+ char *stack; /**< Pseudo-stack allocation for temporary memory */ |
+ spx_word16_t *winBuf; /**< Input buffer (original signal) */ |
+ spx_word16_t *excBuf; /**< Excitation buffer */ |
+ spx_word16_t *exc; /**< Start of excitation frame */ |
+ spx_word16_t *swBuf; /**< Weighted signal buffer */ |
+ spx_word16_t *sw; /**< Start of weighted signal frame */ |
+ const spx_word16_t *window; /**< Temporary (Hanning) window */ |
+ const spx_word16_t *lagWindow; /**< Window applied to auto-correlation */ |
+ spx_lsp_t *old_lsp; /**< LSPs for previous frame */ |
+ spx_lsp_t *old_qlsp; /**< Quantized LSPs for previous frame */ |
+ spx_mem_t *mem_sp; /**< Filter memory for signal synthesis */ |
+ spx_mem_t *mem_sw; /**< Filter memory for perceptually-weighted signal */ |
+ spx_mem_t *mem_sw_whole; /**< Filter memory for perceptually-weighted signal (whole frame)*/ |
+ spx_mem_t *mem_exc; /**< Filter memory for excitation (whole frame) */ |
+ spx_mem_t *mem_exc2; /**< Filter memory for excitation (whole frame) */ |
+ spx_mem_t mem_hp[2]; /**< High-pass filter memory */ |
+ spx_word32_t *pi_gain; /**< Gain of LPC filter at theta=pi (fe/2) */ |
+ spx_word16_t *innov_rms_save; /**< If non-NULL, innovation RMS is copied here */ |
+ |
+#ifndef DISABLE_VBR |
+ VBRState *vbr; /**< State of the VBR data */ |
+ float vbr_quality; /**< Quality setting for VBR encoding */ |
+ float relative_quality; /**< Relative quality that will be needed by VBR */ |
+ spx_int32_t vbr_enabled; /**< 1 for enabling VBR, 0 otherwise */ |
+ spx_int32_t vbr_max; /**< Max bit-rate allowed in VBR mode */ |
+ int vad_enabled; /**< 1 for enabling VAD, 0 otherwise */ |
+ int dtx_enabled; /**< 1 for enabling DTX, 0 otherwise */ |
+ int dtx_count; /**< Number of consecutive DTX frames */ |
+ spx_int32_t abr_enabled; /**< ABR setting (in bps), 0 if off */ |
+ float abr_drift; |
+ float abr_drift2; |
+ float abr_count; |
+#endif /* #ifndef DISABLE_VBR */ |
+ |
+ int complexity; /**< Complexity setting (0-10 from least complex to most complex) */ |
+ spx_int32_t sampling_rate; |
+ int plc_tuning; |
+ int encode_submode; |
+ const SpeexSubmode * const *submodes; /**< Sub-mode data */ |
+ int submodeID; /**< Activated sub-mode */ |
+ int submodeSelect; /**< Mode chosen by the user (may differ from submodeID if VAD is on) */ |
+ int isWideband; /**< Is this used as part of the embedded wideband codec */ |
+ int highpass_enabled; /**< Is the input filter enabled */ |
+} EncState; |
+ |
+/**Structure representing the full state of the narrowband decoder*/ |
+typedef struct DecState { |
+ const SpeexMode *mode; /**< Mode corresponding to the state */ |
+ int first; /**< Is this the first frame? */ |
+ int count_lost; /**< Was the last frame lost? */ |
+ int frameSize; /**< Size of frames */ |
+ int subframeSize; /**< Size of sub-frames */ |
+ int nbSubframes; /**< Number of sub-frames */ |
+ int lpcSize; /**< LPC order */ |
+ int min_pitch; /**< Minimum pitch value allowed */ |
+ int max_pitch; /**< Maximum pitch value allowed */ |
+ spx_int32_t sampling_rate; |
+ |
+ spx_word16_t last_ol_gain; /**< Open-loop gain for previous frame */ |
+ |
+ char *stack; /**< Pseudo-stack allocation for temporary memory */ |
+ spx_word16_t *excBuf; /**< Excitation buffer */ |
+ spx_word16_t *exc; /**< Start of excitation frame */ |
+ spx_lsp_t *old_qlsp; /**< Quantized LSPs for previous frame */ |
+ spx_coef_t *interp_qlpc; /**< Interpolated quantized LPCs */ |
+ spx_mem_t *mem_sp; /**< Filter memory for synthesis signal */ |
+ spx_mem_t mem_hp[2]; /**< High-pass filter memory */ |
+ spx_word32_t *pi_gain; /**< Gain of LPC filter at theta=pi (fe/2) */ |
+ spx_word16_t *innov_save; /** If non-NULL, innovation is copied here */ |
+ |
+ spx_word16_t level; |
+ spx_word16_t max_level; |
+ spx_word16_t min_level; |
+ |
+ /* This is used in packet loss concealment */ |
+ int last_pitch; /**< Pitch of last correctly decoded frame */ |
+ spx_word16_t last_pitch_gain; /**< Pitch gain of last correctly decoded frame */ |
+ spx_word16_t pitch_gain_buf[3]; /**< Pitch gain of last decoded frames */ |
+ int pitch_gain_buf_idx; /**< Tail of the buffer */ |
+ spx_int32_t seed; /** Seed used for random number generation */ |
+ |
+ int encode_submode; |
+ const SpeexSubmode * const *submodes; /**< Sub-mode data */ |
+ int submodeID; /**< Activated sub-mode */ |
+ int lpc_enh_enabled; /**< 1 when LPC enhancer is on, 0 otherwise */ |
+ SpeexCallback speex_callbacks[SPEEX_MAX_CALLBACKS]; |
+ |
+ SpeexCallback user_callback; |
+ |
+ /*Vocoder data*/ |
+ spx_word16_t voc_m1; |
+ spx_word32_t voc_m2; |
+ spx_word16_t voc_mean; |
+ int voc_offset; |
+ |
+ int dtx_enabled; |
+ int isWideband; /**< Is this used as part of the embedded wideband codec */ |
+ int highpass_enabled; /**< Is the input filter enabled */ |
+} DecState; |
+ |
+/** Initializes encoder state*/ |
+void *nb_encoder_init(const SpeexMode *m); |
+ |
+/** De-allocates encoder state resources*/ |
+void nb_encoder_destroy(void *state); |
+ |
+/** Encodes one frame*/ |
+int nb_encode(void *state, void *in, SpeexBits *bits); |
+ |
+ |
+/** Initializes decoder state*/ |
+void *nb_decoder_init(const SpeexMode *m); |
+ |
+/** De-allocates decoder state resources*/ |
+void nb_decoder_destroy(void *state); |
+ |
+/** Decodes one frame*/ |
+int nb_decode(void *state, SpeexBits *bits, void *out); |
+ |
+/** ioctl-like function for controlling a narrowband encoder */ |
+int nb_encoder_ctl(void *state, int request, void *ptr); |
+ |
+/** ioctl-like function for controlling a narrowband decoder */ |
+int nb_decoder_ctl(void *state, int request, void *ptr); |
+ |
+ |
+#endif |
Property changes on: speex/libspeex/nb_celp.h |
___________________________________________________________________ |
Name: svn:executable |
+ * |