xref: /aosp_15_r20/external/liblc3/src/plc.h (revision 49fe348c0058011ee60b6957cdd9d52742df84bc)
1*49fe348cSAndroid Build Coastguard Worker /******************************************************************************
2*49fe348cSAndroid Build Coastguard Worker  *
3*49fe348cSAndroid Build Coastguard Worker  *  Copyright 2022 Google LLC
4*49fe348cSAndroid Build Coastguard Worker  *
5*49fe348cSAndroid Build Coastguard Worker  *  Licensed under the Apache License, Version 2.0 (the "License");
6*49fe348cSAndroid Build Coastguard Worker  *  you may not use this file except in compliance with the License.
7*49fe348cSAndroid Build Coastguard Worker  *  You may obtain a copy of the License at:
8*49fe348cSAndroid Build Coastguard Worker  *
9*49fe348cSAndroid Build Coastguard Worker  *  http://www.apache.org/licenses/LICENSE-2.0
10*49fe348cSAndroid Build Coastguard Worker  *
11*49fe348cSAndroid Build Coastguard Worker  *  Unless required by applicable law or agreed to in writing, software
12*49fe348cSAndroid Build Coastguard Worker  *  distributed under the License is distributed on an "AS IS" BASIS,
13*49fe348cSAndroid Build Coastguard Worker  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14*49fe348cSAndroid Build Coastguard Worker  *  See the License for the specific language governing permissions and
15*49fe348cSAndroid Build Coastguard Worker  *  limitations under the License.
16*49fe348cSAndroid Build Coastguard Worker  *
17*49fe348cSAndroid Build Coastguard Worker  ******************************************************************************/
18*49fe348cSAndroid Build Coastguard Worker 
19*49fe348cSAndroid Build Coastguard Worker #ifndef __LC3_PLC_H
20*49fe348cSAndroid Build Coastguard Worker #define __LC3_PLC_H
21*49fe348cSAndroid Build Coastguard Worker 
22*49fe348cSAndroid Build Coastguard Worker #include "common.h"
23*49fe348cSAndroid Build Coastguard Worker 
24*49fe348cSAndroid Build Coastguard Worker 
25*49fe348cSAndroid Build Coastguard Worker /**
26*49fe348cSAndroid Build Coastguard Worker  * Reset PLC state
27*49fe348cSAndroid Build Coastguard Worker  * plc             PLC State to reset
28*49fe348cSAndroid Build Coastguard Worker  */
29*49fe348cSAndroid Build Coastguard Worker void lc3_plc_reset(lc3_plc_state_t *plc);
30*49fe348cSAndroid Build Coastguard Worker 
31*49fe348cSAndroid Build Coastguard Worker /**
32*49fe348cSAndroid Build Coastguard Worker  * Suspend PLC synthesis (Error-free frame decoded)
33*49fe348cSAndroid Build Coastguard Worker  * plc             PLC State
34*49fe348cSAndroid Build Coastguard Worker  */
35*49fe348cSAndroid Build Coastguard Worker void lc3_plc_suspend(lc3_plc_state_t *plc);
36*49fe348cSAndroid Build Coastguard Worker 
37*49fe348cSAndroid Build Coastguard Worker /**
38*49fe348cSAndroid Build Coastguard Worker  * Synthesis of a PLC frame
39*49fe348cSAndroid Build Coastguard Worker  * dt, sr          Duration and samplerate of the frame
40*49fe348cSAndroid Build Coastguard Worker  * plc             PLC State
41*49fe348cSAndroid Build Coastguard Worker  * x               Last good spectral coefficients
42*49fe348cSAndroid Build Coastguard Worker  * y               Return emulated ones
43*49fe348cSAndroid Build Coastguard Worker  *
44*49fe348cSAndroid Build Coastguard Worker  * `x` and `y` can be the same buffer
45*49fe348cSAndroid Build Coastguard Worker  */
46*49fe348cSAndroid Build Coastguard Worker void lc3_plc_synthesize(enum lc3_dt dt, enum lc3_srate sr,
47*49fe348cSAndroid Build Coastguard Worker     lc3_plc_state_t *plc, const float *x, float *y);
48*49fe348cSAndroid Build Coastguard Worker 
49*49fe348cSAndroid Build Coastguard Worker 
50*49fe348cSAndroid Build Coastguard Worker #endif /* __LC3_PLC_H */
51