Imported Debian version 2.4.3~trusty1
[deb_ffmpeg.git] / ffmpeg / libavcodec / g729postfilter.h
CommitLineData
2ba45a60
DM
1/*
2 * G.729, G729 Annex D postfilter
3 * Copyright (c) 2008 Vladimir Voroshilov
4 *
5 * This file is part of FFmpeg.
6 *
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
11 *
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
21#ifndef FFMPEG_G729POSTFILTER_H
22#define FFMPEG_G729POSTFILTER_H
23
24#include <stdint.h>
25#include "audiodsp.h"
26
27/**
28 * tilt compensation factor (G.729, k1>0)
29 * 0.2 in Q15
30 */
31#define G729_TILT_FACTOR_PLUS 6554
32
33/**
34 * tilt compensation factor (G.729, k1<0)
35 * 0.9 in Q15
36 */
37#define G729_TILT_FACTOR_MINUS 29491
38
39/* 4.2.2 */
40#define FORMANT_PP_FACTOR_NUM 18022 //0.55 in Q15
41#define FORMANT_PP_FACTOR_DEN 22938 //0.70 in Q15
42
43/**
44 * gain adjustment factor (G.729, 4.2.4)
45 * 0.9875 in Q15
46 */
47#define G729_AGC_FACTOR 32358
48#define G729_AGC_FAC1 (32768-G729_AGC_FACTOR)
49
50/**
51 * 1.0 / (1.0 + 0.5) in Q15
52 * where 0.5 is the minimum value of
53 * weight factor, controlling amount of long-term postfiltering
54 */
55#define MIN_LT_FILT_FACTOR_A 21845
56
57/**
58 * Short interpolation filter length
59 */
60#define SHORT_INT_FILT_LEN 2
61
62/**
63 * Long interpolation filter length
64 */
65#define LONG_INT_FILT_LEN 8
66
67/**
68 * Number of analyzed fractional pitch delays in second stage of long-term
69 * postfilter
70 */
71#define ANALYZED_FRAC_DELAYS 7
72
73/**
74 * Amount of past residual signal data stored in buffer
75 */
76#define RES_PREV_DATA_SIZE (PITCH_DELAY_MAX + LONG_INT_FILT_LEN + 1)
77
78/**
79 * \brief Signal postfiltering (4.2)
80 * \param dsp initialized DSP context
81 * \param ht_prev_data [in/out] (Q12) pointer to variable receiving tilt
82 * compensation filter data from previous subframe
83 * \param voicing [in/out] (Q0) pointer to variable receiving voicing decision
84 * \param lp_filter_coeffs (Q12) LP filter coefficients
85 * \param pitch_delay_int integer part of the pitch delay
86 * \param residual [in/out] (Q0) residual signal buffer (used in long-term postfilter)
87 * \param res_filter_data [in/out] (Q0) speech data of previous subframe
88 * \param pos_filter_data [in/out] (Q0) previous speech data for short-term postfilter
89 * \param speech [in/out] (Q0) signal buffer
90 * \param subframe_size size of subframe
91 *
92 * Filtering has the following stages:
93 * Long-term postfilter (4.2.1)
94 * Short-term postfilter (4.2.2).
95 * Tilt-compensation (4.2.3)
96 */
97void ff_g729_postfilter(AudioDSPContext *adsp, int16_t* ht_prev_data, int* voicing,
98 const int16_t *lp_filter_coeffs, int pitch_delay_int,
99 int16_t* residual, int16_t* res_filter_data,
100 int16_t* pos_filter_data, int16_t *speech,
101 int subframe_size);
102
103/**
104 * \brief Adaptive gain control (4.2.4)
105 * \param gain_before (Q0) gain of speech before applying postfilters
106 * \param gain_after (Q0) gain of speech after applying postfilters
107 * \param speech [in/out] (Q0) signal buffer
108 * \param subframe_size length of subframe
109 * \param gain_prev (Q12) previous value of gain coefficient
110 *
111 * \return (Q12) last value of gain coefficient
112 */
113int16_t ff_g729_adaptive_gain_control(int gain_before, int gain_after, int16_t *speech,
114 int subframe_size, int16_t gain_prev);
115
116#endif // FFMPEG_G729POSTFILTER_H