FreeCalypso > hg > gsm-codec-lib
view libgsmefr/gsm_efr.h @ 183:452c1d5a6268
libgsmefr BFI w/o data: emit zero output after decoder reset
In real-life usage, each EFR decoder session will most likely begin
with lots of BFI frames before the first real frame arrives. However,
because the spec-defined home state of the decoder is speech rather
than CN, our regular logic for BFI w/o data would have to feed
pseudorandom noise to the decoder (in the "fixed codebook excitation
pulses" part), which is silly to do at the beginning of the decoder
session right out of reset. Therefore, let's check reset_flag_old,
and if we are still in the reset state, simply emit zero output.
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Tue, 03 Jan 2023 00:12:18 +0000 |
parents | 88468d5b3590 |
children | 9499d12d315b |
line wrap: on
line source
/* * This header file is the external public interface to libgsmefr; * it should be installed in the same system include directory * as <gsm.h> and <gsm_fr_preproc.h> for the older FR codec. */ #ifndef __GSM_EFR_H #define __GSM_EFR_H #include <stdint.h> #define EFR_RTP_FRAME_LEN 31 #define EFR_NUM_PARAMS 57 struct EFR_encoder_state; /* opaque to external users */ struct EFR_decoder_state; /* ditto */ extern struct EFR_encoder_state *EFR_encoder_create(int dtx); extern struct EFR_decoder_state *EFR_decoder_create(void); /* use standard free() call to free both afterward */ /* reset state to initial */ extern void EFR_encoder_reset(struct EFR_encoder_state *st, int dtx); extern void EFR_decoder_reset(struct EFR_decoder_state *st); /* encoder public functions */ extern void EFR_encode_params(struct EFR_encoder_state *st, const int16_t *pcm, int16_t *params, int *sp, int *vad); extern void EFR_encode_frame(struct EFR_encoder_state *st, const int16_t *pcm, uint8_t *frame, int *sp, int *vad); /* decoder public functions */ extern void EFR_decode_params(struct EFR_decoder_state *st, const int16_t *params, int bfi, int sid, int taf, int16_t *pcm); extern void EFR_decode_frame(struct EFR_decoder_state *st, const uint8_t *frame, int bfi, int taf, int16_t *pcm); extern void EFR_decode_bfi_nodata(struct EFR_decoder_state *st, int taf, int16_t *pcm); /* stateless utility functions */ extern int EFR_sid_classify(const uint8_t *frame); extern void EFR_frame2params(const uint8_t *frame, int16_t *params); extern void EFR_params2frame(const int16_t *params, uint8_t *frame); extern void EFR_insert_sid_codeword(uint8_t *frame); #endif /* include guard */