cannam@154: /*********************************************************************** cannam@154: Copyright (c) 2006-2011, Skype Limited. All rights reserved. cannam@154: Redistribution and use in source and binary forms, with or without cannam@154: modification, are permitted provided that the following conditions cannam@154: are met: cannam@154: - Redistributions of source code must retain the above copyright notice, cannam@154: this list of conditions and the following disclaimer. cannam@154: - Redistributions in binary form must reproduce the above copyright cannam@154: notice, this list of conditions and the following disclaimer in the cannam@154: documentation and/or other materials provided with the distribution. cannam@154: - Neither the name of Internet Society, IETF or IETF Trust, nor the cannam@154: names of specific contributors, may be used to endorse or promote cannam@154: products derived from this software without specific prior written cannam@154: permission. cannam@154: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" cannam@154: AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE cannam@154: IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE cannam@154: ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE cannam@154: LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR cannam@154: CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF cannam@154: SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS cannam@154: INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN cannam@154: CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) cannam@154: ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE cannam@154: POSSIBILITY OF SUCH DAMAGE. cannam@154: ***********************************************************************/ cannam@154: cannam@154: #ifndef SILK_DEFINE_H cannam@154: #define SILK_DEFINE_H cannam@154: cannam@154: #include "errors.h" cannam@154: #include "typedef.h" cannam@154: cannam@154: #ifdef __cplusplus cannam@154: extern "C" cannam@154: { cannam@154: #endif cannam@154: cannam@154: /* Max number of encoder channels (1/2) */ cannam@154: #define ENCODER_NUM_CHANNELS 2 cannam@154: /* Number of decoder channels (1/2) */ cannam@154: #define DECODER_NUM_CHANNELS 2 cannam@154: cannam@154: #define MAX_FRAMES_PER_PACKET 3 cannam@154: cannam@154: /* Limits on bitrate */ cannam@154: #define MIN_TARGET_RATE_BPS 5000 cannam@154: #define MAX_TARGET_RATE_BPS 80000 cannam@154: cannam@154: /* LBRR thresholds */ cannam@154: #define LBRR_NB_MIN_RATE_BPS 12000 cannam@154: #define LBRR_MB_MIN_RATE_BPS 14000 cannam@154: #define LBRR_WB_MIN_RATE_BPS 16000 cannam@154: cannam@154: /* DTX settings */ cannam@154: #define NB_SPEECH_FRAMES_BEFORE_DTX 10 /* eq 200 ms */ cannam@154: #define MAX_CONSECUTIVE_DTX 20 /* eq 400 ms */ cannam@154: #define DTX_ACTIVITY_THRESHOLD 0.1f cannam@154: cannam@154: /* VAD decision */ cannam@154: #define VAD_NO_DECISION -1 cannam@154: #define VAD_NO_ACTIVITY 0 cannam@154: #define VAD_ACTIVITY 1 cannam@154: cannam@154: /* Maximum sampling frequency */ cannam@154: #define MAX_FS_KHZ 16 cannam@154: #define MAX_API_FS_KHZ 48 cannam@154: cannam@154: /* Signal types */ cannam@154: #define TYPE_NO_VOICE_ACTIVITY 0 cannam@154: #define TYPE_UNVOICED 1 cannam@154: #define TYPE_VOICED 2 cannam@154: cannam@154: /* Conditional coding types */ cannam@154: #define CODE_INDEPENDENTLY 0 cannam@154: #define CODE_INDEPENDENTLY_NO_LTP_SCALING 1 cannam@154: #define CODE_CONDITIONALLY 2 cannam@154: cannam@154: /* Settings for stereo processing */ cannam@154: #define STEREO_QUANT_TAB_SIZE 16 cannam@154: #define STEREO_QUANT_SUB_STEPS 5 cannam@154: #define STEREO_INTERP_LEN_MS 8 /* must be even */ cannam@154: #define STEREO_RATIO_SMOOTH_COEF 0.01 /* smoothing coef for signal norms and stereo width */ cannam@154: cannam@154: /* Range of pitch lag estimates */ cannam@154: #define PITCH_EST_MIN_LAG_MS 2 /* 2 ms -> 500 Hz */ cannam@154: #define PITCH_EST_MAX_LAG_MS 18 /* 18 ms -> 56 Hz */ cannam@154: cannam@154: /* Maximum number of subframes */ cannam@154: #define MAX_NB_SUBFR 4 cannam@154: cannam@154: /* Number of samples per frame */ cannam@154: #define LTP_MEM_LENGTH_MS 20 cannam@154: #define SUB_FRAME_LENGTH_MS 5 cannam@154: #define MAX_SUB_FRAME_LENGTH ( SUB_FRAME_LENGTH_MS * MAX_FS_KHZ ) cannam@154: #define MAX_FRAME_LENGTH_MS ( SUB_FRAME_LENGTH_MS * MAX_NB_SUBFR ) cannam@154: #define MAX_FRAME_LENGTH ( MAX_FRAME_LENGTH_MS * MAX_FS_KHZ ) cannam@154: cannam@154: /* Milliseconds of lookahead for pitch analysis */ cannam@154: #define LA_PITCH_MS 2 cannam@154: #define LA_PITCH_MAX ( LA_PITCH_MS * MAX_FS_KHZ ) cannam@154: cannam@154: /* Order of LPC used in find pitch */ cannam@154: #define MAX_FIND_PITCH_LPC_ORDER 16 cannam@154: cannam@154: /* Length of LPC window used in find pitch */ cannam@154: #define FIND_PITCH_LPC_WIN_MS ( 20 + (LA_PITCH_MS << 1) ) cannam@154: #define FIND_PITCH_LPC_WIN_MS_2_SF ( 10 + (LA_PITCH_MS << 1) ) cannam@154: #define FIND_PITCH_LPC_WIN_MAX ( FIND_PITCH_LPC_WIN_MS * MAX_FS_KHZ ) cannam@154: cannam@154: /* Milliseconds of lookahead for noise shape analysis */ cannam@154: #define LA_SHAPE_MS 5 cannam@154: #define LA_SHAPE_MAX ( LA_SHAPE_MS * MAX_FS_KHZ ) cannam@154: cannam@154: /* Maximum length of LPC window used in noise shape analysis */ cannam@154: #define SHAPE_LPC_WIN_MAX ( 15 * MAX_FS_KHZ ) cannam@154: cannam@154: /* dB level of lowest gain quantization level */ cannam@154: #define MIN_QGAIN_DB 2 cannam@154: /* dB level of highest gain quantization level */ cannam@154: #define MAX_QGAIN_DB 88 cannam@154: /* Number of gain quantization levels */ cannam@154: #define N_LEVELS_QGAIN 64 cannam@154: /* Max increase in gain quantization index */ cannam@154: #define MAX_DELTA_GAIN_QUANT 36 cannam@154: /* Max decrease in gain quantization index */ cannam@154: #define MIN_DELTA_GAIN_QUANT -4 cannam@154: cannam@154: /* Quantization offsets (multiples of 4) */ cannam@154: #define OFFSET_VL_Q10 32 cannam@154: #define OFFSET_VH_Q10 100 cannam@154: #define OFFSET_UVL_Q10 100 cannam@154: #define OFFSET_UVH_Q10 240 cannam@154: cannam@154: #define QUANT_LEVEL_ADJUST_Q10 80 cannam@154: cannam@154: /* Maximum numbers of iterations used to stabilize an LPC vector */ cannam@154: #define MAX_LPC_STABILIZE_ITERATIONS 16 cannam@154: #define MAX_PREDICTION_POWER_GAIN 1e4f cannam@154: #define MAX_PREDICTION_POWER_GAIN_AFTER_RESET 1e2f cannam@154: cannam@154: #define MAX_LPC_ORDER 16 cannam@154: #define MIN_LPC_ORDER 10 cannam@154: cannam@154: /* Find Pred Coef defines */ cannam@154: #define LTP_ORDER 5 cannam@154: cannam@154: /* LTP quantization settings */ cannam@154: #define NB_LTP_CBKS 3 cannam@154: cannam@154: /* Flag to use harmonic noise shaping */ cannam@154: #define USE_HARM_SHAPING 1 cannam@154: cannam@154: /* Max LPC order of noise shaping filters */ cannam@154: #define MAX_SHAPE_LPC_ORDER 24 cannam@154: cannam@154: #define HARM_SHAPE_FIR_TAPS 3 cannam@154: cannam@154: /* Maximum number of delayed decision states */ cannam@154: #define MAX_DEL_DEC_STATES 4 cannam@154: cannam@154: #define LTP_BUF_LENGTH 512 cannam@154: #define LTP_MASK ( LTP_BUF_LENGTH - 1 ) cannam@154: cannam@154: #define DECISION_DELAY 40 cannam@154: cannam@154: /* Number of subframes for excitation entropy coding */ cannam@154: #define SHELL_CODEC_FRAME_LENGTH 16 cannam@154: #define LOG2_SHELL_CODEC_FRAME_LENGTH 4 cannam@154: #define MAX_NB_SHELL_BLOCKS ( MAX_FRAME_LENGTH / SHELL_CODEC_FRAME_LENGTH ) cannam@154: cannam@154: /* Number of rate levels, for entropy coding of excitation */ cannam@154: #define N_RATE_LEVELS 10 cannam@154: cannam@154: /* Maximum sum of pulses per shell coding frame */ cannam@154: #define SILK_MAX_PULSES 16 cannam@154: cannam@154: #define MAX_MATRIX_SIZE MAX_LPC_ORDER /* Max of LPC Order and LTP order */ cannam@154: cannam@154: # define NSQ_LPC_BUF_LENGTH MAX_LPC_ORDER cannam@154: cannam@154: /***************************/ cannam@154: /* Voice activity detector */ cannam@154: /***************************/ cannam@154: #define VAD_N_BANDS 4 cannam@154: cannam@154: #define VAD_INTERNAL_SUBFRAMES_LOG2 2 cannam@154: #define VAD_INTERNAL_SUBFRAMES ( 1 << VAD_INTERNAL_SUBFRAMES_LOG2 ) cannam@154: cannam@154: #define VAD_NOISE_LEVEL_SMOOTH_COEF_Q16 1024 /* Must be < 4096 */ cannam@154: #define VAD_NOISE_LEVELS_BIAS 50 cannam@154: cannam@154: /* Sigmoid settings */ cannam@154: #define VAD_NEGATIVE_OFFSET_Q5 128 /* sigmoid is 0 at -128 */ cannam@154: #define VAD_SNR_FACTOR_Q16 45000 cannam@154: cannam@154: /* smoothing for SNR measurement */ cannam@154: #define VAD_SNR_SMOOTH_COEF_Q18 4096 cannam@154: cannam@154: /* Size of the piecewise linear cosine approximation table for the LSFs */ cannam@154: #define LSF_COS_TAB_SZ_FIX 128 cannam@154: cannam@154: /******************/ cannam@154: /* NLSF quantizer */ cannam@154: /******************/ cannam@154: #define NLSF_W_Q 2 cannam@154: #define NLSF_VQ_MAX_VECTORS 32 cannam@154: #define NLSF_QUANT_MAX_AMPLITUDE 4 cannam@154: #define NLSF_QUANT_MAX_AMPLITUDE_EXT 10 cannam@154: #define NLSF_QUANT_LEVEL_ADJ 0.1 cannam@154: #define NLSF_QUANT_DEL_DEC_STATES_LOG2 2 cannam@154: #define NLSF_QUANT_DEL_DEC_STATES ( 1 << NLSF_QUANT_DEL_DEC_STATES_LOG2 ) cannam@154: cannam@154: /* Transition filtering for mode switching */ cannam@154: #define TRANSITION_TIME_MS 5120 /* 5120 = 64 * FRAME_LENGTH_MS * ( TRANSITION_INT_NUM - 1 ) = 64*(20*4)*/ cannam@154: #define TRANSITION_NB 3 /* Hardcoded in tables */ cannam@154: #define TRANSITION_NA 2 /* Hardcoded in tables */ cannam@154: #define TRANSITION_INT_NUM 5 /* Hardcoded in tables */ cannam@154: #define TRANSITION_FRAMES ( TRANSITION_TIME_MS / MAX_FRAME_LENGTH_MS ) cannam@154: #define TRANSITION_INT_STEPS ( TRANSITION_FRAMES / ( TRANSITION_INT_NUM - 1 ) ) cannam@154: cannam@154: /* BWE factors to apply after packet loss */ cannam@154: #define BWE_AFTER_LOSS_Q16 63570 cannam@154: cannam@154: /* Defines for CN generation */ cannam@154: #define CNG_BUF_MASK_MAX 255 /* 2^floor(log2(MAX_FRAME_LENGTH))-1 */ cannam@154: #define CNG_GAIN_SMTH_Q16 4634 /* 0.25^(1/4) */ cannam@154: #define CNG_NLSF_SMTH_Q16 16348 /* 0.25 */ cannam@154: cannam@154: #ifdef __cplusplus cannam@154: } cannam@154: #endif cannam@154: cannam@154: #endif