main_FLP.h 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286
  1. /***********************************************************************
  2. Copyright (c) 2006-2011, Skype Limited. All rights reserved.
  3. Redistribution and use in source and binary forms, with or without
  4. modification, are permitted provided that the following conditions
  5. are met:
  6. - Redistributions of source code must retain the above copyright notice,
  7. this list of conditions and the following disclaimer.
  8. - Redistributions in binary form must reproduce the above copyright
  9. notice, this list of conditions and the following disclaimer in the
  10. documentation and/or other materials provided with the distribution.
  11. - Neither the name of Internet Society, IETF or IETF Trust, nor the
  12. names of specific contributors, may be used to endorse or promote
  13. products derived from this software without specific prior written
  14. permission.
  15. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  16. AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  17. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  18. ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  19. LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  20. CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  21. SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  22. INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  23. CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  24. ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  25. POSSIBILITY OF SUCH DAMAGE.
  26. ***********************************************************************/
  27. #ifndef SILK_MAIN_FLP_H
  28. #define SILK_MAIN_FLP_H
  29. #include "SigProc_FLP.h"
  30. #include "SigProc_FIX.h"
  31. #include "structs_FLP.h"
  32. #include "main.h"
  33. #include "define.h"
  34. #include "debug.h"
  35. #include "entenc.h"
  36. #ifdef __cplusplus
  37. extern "C"
  38. {
  39. #endif
  40. #define silk_encoder_state_Fxx silk_encoder_state_FLP
  41. #define silk_encode_do_VAD_Fxx silk_encode_do_VAD_FLP
  42. #define silk_encode_frame_Fxx silk_encode_frame_FLP
  43. /*********************/
  44. /* Encoder Functions */
  45. /*********************/
  46. /* High-pass filter with cutoff frequency adaptation based on pitch lag statistics */
  47. void silk_HP_variable_cutoff(
  48. silk_encoder_state_Fxx state_Fxx[] /* I/O Encoder states */
  49. );
  50. /* Encoder main function */
  51. void silk_encode_do_VAD_FLP(
  52. silk_encoder_state_FLP *psEnc, /* I/O Encoder state FLP */
  53. opus_int activity /* I Decision of Opus voice activity detector */
  54. );
  55. /* Encoder main function */
  56. opus_int silk_encode_frame_FLP(
  57. silk_encoder_state_FLP *psEnc, /* I/O Encoder state FLP */
  58. opus_int32 *pnBytesOut, /* O Number of payload bytes; */
  59. ec_enc *psRangeEnc, /* I/O compressor data structure */
  60. opus_int condCoding, /* I The type of conditional coding to use */
  61. opus_int maxBits, /* I If > 0: maximum number of output bits */
  62. opus_int useCBR /* I Flag to force constant-bitrate operation */
  63. );
  64. /* Initializes the Silk encoder state */
  65. opus_int silk_init_encoder(
  66. silk_encoder_state_FLP *psEnc, /* I/O Encoder state FLP */
  67. int arch /* I Run-tim architecture */
  68. );
  69. /* Control the Silk encoder */
  70. opus_int silk_control_encoder(
  71. silk_encoder_state_FLP *psEnc, /* I/O Pointer to Silk encoder state FLP */
  72. silk_EncControlStruct *encControl, /* I Control structure */
  73. const opus_int allow_bw_switch, /* I Flag to allow switching audio bandwidth */
  74. const opus_int channelNb, /* I Channel number */
  75. const opus_int force_fs_kHz
  76. );
  77. /**************************/
  78. /* Noise shaping analysis */
  79. /**************************/
  80. /* Compute noise shaping coefficients and initial gain values */
  81. void silk_noise_shape_analysis_FLP(
  82. silk_encoder_state_FLP *psEnc, /* I/O Encoder state FLP */
  83. silk_encoder_control_FLP *psEncCtrl, /* I/O Encoder control FLP */
  84. const silk_float *pitch_res, /* I LPC residual from pitch analysis */
  85. const silk_float *x /* I Input signal [frame_length + la_shape] */
  86. );
  87. /* Autocorrelations for a warped frequency axis */
  88. void silk_warped_autocorrelation_FLP(
  89. silk_float *corr, /* O Result [order + 1] */
  90. const silk_float *input, /* I Input data to correlate */
  91. const silk_float warping, /* I Warping coefficient */
  92. const opus_int length, /* I Length of input */
  93. const opus_int order /* I Correlation order (even) */
  94. );
  95. /* Calculation of LTP state scaling */
  96. void silk_LTP_scale_ctrl_FLP(
  97. silk_encoder_state_FLP *psEnc, /* I/O Encoder state FLP */
  98. silk_encoder_control_FLP *psEncCtrl, /* I/O Encoder control FLP */
  99. opus_int condCoding /* I The type of conditional coding to use */
  100. );
  101. /**********************************************/
  102. /* Prediction Analysis */
  103. /**********************************************/
  104. /* Find pitch lags */
  105. void silk_find_pitch_lags_FLP(
  106. silk_encoder_state_FLP *psEnc, /* I/O Encoder state FLP */
  107. silk_encoder_control_FLP *psEncCtrl, /* I/O Encoder control FLP */
  108. silk_float res[], /* O Residual */
  109. const silk_float x[], /* I Speech signal */
  110. int arch /* I Run-time architecture */
  111. );
  112. /* Find LPC and LTP coefficients */
  113. void silk_find_pred_coefs_FLP(
  114. silk_encoder_state_FLP *psEnc, /* I/O Encoder state FLP */
  115. silk_encoder_control_FLP *psEncCtrl, /* I/O Encoder control FLP */
  116. const silk_float res_pitch[], /* I Residual from pitch analysis */
  117. const silk_float x[], /* I Speech signal */
  118. opus_int condCoding /* I The type of conditional coding to use */
  119. );
  120. /* LPC analysis */
  121. void silk_find_LPC_FLP(
  122. silk_encoder_state *psEncC, /* I/O Encoder state */
  123. opus_int16 NLSF_Q15[], /* O NLSFs */
  124. const silk_float x[], /* I Input signal */
  125. const silk_float minInvGain /* I Prediction gain from LTP (dB) */
  126. );
  127. /* LTP analysis */
  128. void silk_find_LTP_FLP(
  129. silk_float XX[ MAX_NB_SUBFR * LTP_ORDER * LTP_ORDER ], /* O Weight for LTP quantization */
  130. silk_float xX[ MAX_NB_SUBFR * LTP_ORDER ], /* O Weight for LTP quantization */
  131. const silk_float r_ptr[], /* I LPC residual */
  132. const opus_int lag[ MAX_NB_SUBFR ], /* I LTP lags */
  133. const opus_int subfr_length, /* I Subframe length */
  134. const opus_int nb_subfr /* I number of subframes */
  135. );
  136. void silk_LTP_analysis_filter_FLP(
  137. silk_float *LTP_res, /* O LTP res MAX_NB_SUBFR*(pre_lgth+subfr_lngth) */
  138. const silk_float *x, /* I Input signal, with preceding samples */
  139. const silk_float B[ LTP_ORDER * MAX_NB_SUBFR ], /* I LTP coefficients for each subframe */
  140. const opus_int pitchL[ MAX_NB_SUBFR ], /* I Pitch lags */
  141. const silk_float invGains[ MAX_NB_SUBFR ], /* I Inverse quantization gains */
  142. const opus_int subfr_length, /* I Length of each subframe */
  143. const opus_int nb_subfr, /* I number of subframes */
  144. const opus_int pre_length /* I Preceding samples for each subframe */
  145. );
  146. /* Calculates residual energies of input subframes where all subframes have LPC_order */
  147. /* of preceding samples */
  148. void silk_residual_energy_FLP(
  149. silk_float nrgs[ MAX_NB_SUBFR ], /* O Residual energy per subframe */
  150. const silk_float x[], /* I Input signal */
  151. silk_float a[ 2 ][ MAX_LPC_ORDER ], /* I AR coefs for each frame half */
  152. const silk_float gains[], /* I Quantization gains */
  153. const opus_int subfr_length, /* I Subframe length */
  154. const opus_int nb_subfr, /* I number of subframes */
  155. const opus_int LPC_order /* I LPC order */
  156. );
  157. /* 16th order LPC analysis filter */
  158. void silk_LPC_analysis_filter_FLP(
  159. silk_float r_LPC[], /* O LPC residual signal */
  160. const silk_float PredCoef[], /* I LPC coefficients */
  161. const silk_float s[], /* I Input signal */
  162. const opus_int length, /* I Length of input signal */
  163. const opus_int Order /* I LPC order */
  164. );
  165. /* LTP tap quantizer */
  166. void silk_quant_LTP_gains_FLP(
  167. silk_float B[ MAX_NB_SUBFR * LTP_ORDER ], /* O Quantized LTP gains */
  168. opus_int8 cbk_index[ MAX_NB_SUBFR ], /* O Codebook index */
  169. opus_int8 *periodicity_index, /* O Periodicity index */
  170. opus_int32 *sum_log_gain_Q7, /* I/O Cumulative max prediction gain */
  171. silk_float *pred_gain_dB, /* O LTP prediction gain */
  172. const silk_float XX[ MAX_NB_SUBFR * LTP_ORDER * LTP_ORDER ], /* I Correlation matrix */
  173. const silk_float xX[ MAX_NB_SUBFR * LTP_ORDER ], /* I Correlation vector */
  174. const opus_int subfr_len, /* I Number of samples per subframe */
  175. const opus_int nb_subfr, /* I Number of subframes */
  176. int arch /* I Run-time architecture */
  177. );
  178. /* Residual energy: nrg = wxx - 2 * wXx * c + c' * wXX * c */
  179. silk_float silk_residual_energy_covar_FLP( /* O Weighted residual energy */
  180. const silk_float *c, /* I Filter coefficients */
  181. silk_float *wXX, /* I/O Weighted correlation matrix, reg. out */
  182. const silk_float *wXx, /* I Weighted correlation vector */
  183. const silk_float wxx, /* I Weighted correlation value */
  184. const opus_int D /* I Dimension */
  185. );
  186. /* Processing of gains */
  187. void silk_process_gains_FLP(
  188. silk_encoder_state_FLP *psEnc, /* I/O Encoder state FLP */
  189. silk_encoder_control_FLP *psEncCtrl, /* I/O Encoder control FLP */
  190. opus_int condCoding /* I The type of conditional coding to use */
  191. );
  192. /******************/
  193. /* Linear Algebra */
  194. /******************/
  195. /* Calculates correlation matrix X'*X */
  196. void silk_corrMatrix_FLP(
  197. const silk_float *x, /* I x vector [ L+order-1 ] used to create X */
  198. const opus_int L, /* I Length of vectors */
  199. const opus_int Order, /* I Max lag for correlation */
  200. silk_float *XX /* O X'*X correlation matrix [order x order] */
  201. );
  202. /* Calculates correlation vector X'*t */
  203. void silk_corrVector_FLP(
  204. const silk_float *x, /* I x vector [L+order-1] used to create X */
  205. const silk_float *t, /* I Target vector [L] */
  206. const opus_int L, /* I Length of vecors */
  207. const opus_int Order, /* I Max lag for correlation */
  208. silk_float *Xt /* O X'*t correlation vector [order] */
  209. );
  210. /* Apply sine window to signal vector. */
  211. /* Window types: */
  212. /* 1 -> sine window from 0 to pi/2 */
  213. /* 2 -> sine window from pi/2 to pi */
  214. void silk_apply_sine_window_FLP(
  215. silk_float px_win[], /* O Pointer to windowed signal */
  216. const silk_float px[], /* I Pointer to input signal */
  217. const opus_int win_type, /* I Selects a window type */
  218. const opus_int length /* I Window length, multiple of 4 */
  219. );
  220. /* Wrapper functions. Call flp / fix code */
  221. /* Convert AR filter coefficients to NLSF parameters */
  222. void silk_A2NLSF_FLP(
  223. opus_int16 *NLSF_Q15, /* O NLSF vector [ LPC_order ] */
  224. const silk_float *pAR, /* I LPC coefficients [ LPC_order ] */
  225. const opus_int LPC_order /* I LPC order */
  226. );
  227. /* Convert NLSF parameters to AR prediction filter coefficients */
  228. void silk_NLSF2A_FLP(
  229. silk_float *pAR, /* O LPC coefficients [ LPC_order ] */
  230. const opus_int16 *NLSF_Q15, /* I NLSF vector [ LPC_order ] */
  231. const opus_int LPC_order, /* I LPC order */
  232. int arch /* I Run-time architecture */
  233. );
  234. /* Limit, stabilize, and quantize NLSFs */
  235. void silk_process_NLSFs_FLP(
  236. silk_encoder_state *psEncC, /* I/O Encoder state */
  237. silk_float PredCoef[ 2 ][ MAX_LPC_ORDER ], /* O Prediction coefficients */
  238. opus_int16 NLSF_Q15[ MAX_LPC_ORDER ], /* I/O Normalized LSFs (quant out) (0 - (2^15-1)) */
  239. const opus_int16 prev_NLSF_Q15[ MAX_LPC_ORDER ] /* I Previous Normalized LSFs (0 - (2^15-1)) */
  240. );
  241. /* Floating-point Silk NSQ wrapper */
  242. void silk_NSQ_wrapper_FLP(
  243. silk_encoder_state_FLP *psEnc, /* I/O Encoder state FLP */
  244. silk_encoder_control_FLP *psEncCtrl, /* I/O Encoder control FLP */
  245. SideInfoIndices *psIndices, /* I/O Quantization indices */
  246. silk_nsq_state *psNSQ, /* I/O Noise Shaping Quantzation state */
  247. opus_int8 pulses[], /* O Quantized pulse signal */
  248. const silk_float x[] /* I Prefiltered input signal */
  249. );
  250. #ifdef __cplusplus
  251. }
  252. #endif
  253. #endif