252 lines
8.2 KiB
C
252 lines
8.2 KiB
C
|
/*
|
||
|
|
* Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
|
||
|
|
*
|
||
|
|
* Use of this source code is governed by a BSD-style license
|
||
|
|
* that can be found in the LICENSE file in the root of the source
|
||
|
|
* tree. An additional intellectual property rights grant can be found
|
||
|
|
* in the file PATENTS. All contributing project authors may
|
||
|
|
* be found in the AUTHORS file in the root of the source tree.
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
* ilbc.h
|
||
|
|
*
|
||
|
|
* This header file contains all of the API's for iLBC.
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef MODULES_AUDIO_CODING_CODECS_ILBC_ILBC_H_
|
||
|
|
#define MODULES_AUDIO_CODING_CODECS_ILBC_ILBC_H_
|
||
|
|
|
||
|
|
#include <stddef.h>
|
||
|
|
#include <stdint.h>
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Solution to support multiple instances
|
||
|
|
* Customer has to cast instance to proper type
|
||
|
|
*/
|
||
|
|
|
||
|
|
typedef struct iLBC_encinst_t_ IlbcEncoderInstance;
|
||
|
|
|
||
|
|
typedef struct iLBC_decinst_t_ IlbcDecoderInstance;
|
||
|
|
|
||
|
|
/*
|
||
|
|
* Comfort noise constants
|
||
|
|
*/
|
||
|
|
|
||
|
|
#define ILBC_SPEECH 1
|
||
|
|
#define ILBC_CNG 2
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/****************************************************************************
|
||
|
|
* WebRtcIlbcfix_XxxAssign(...)
|
||
|
|
*
|
||
|
|
* These functions assigns the encoder/decoder instance to the specified
|
||
|
|
* memory location
|
||
|
|
*
|
||
|
|
* Input:
|
||
|
|
* - XXX_xxxinst : Pointer to created instance that should be
|
||
|
|
* assigned
|
||
|
|
* - ILBCXXX_inst_Addr : Pointer to the desired memory space
|
||
|
|
* - size : The size that this structure occupies (in Word16)
|
||
|
|
*
|
||
|
|
* Return value : 0 - Ok
|
||
|
|
* -1 - Error
|
||
|
|
*/
|
||
|
|
|
||
|
|
int16_t WebRtcIlbcfix_EncoderAssign(IlbcEncoderInstance** iLBC_encinst,
|
||
|
|
int16_t* ILBCENC_inst_Addr,
|
||
|
|
int16_t* size);
|
||
|
|
int16_t WebRtcIlbcfix_DecoderAssign(IlbcDecoderInstance** iLBC_decinst,
|
||
|
|
int16_t* ILBCDEC_inst_Addr,
|
||
|
|
int16_t* size);
|
||
|
|
|
||
|
|
/****************************************************************************
|
||
|
|
* WebRtcIlbcfix_XxxAssign(...)
|
||
|
|
*
|
||
|
|
* These functions create a instance to the specified structure
|
||
|
|
*
|
||
|
|
* Input:
|
||
|
|
* - XXX_inst : Pointer to created instance that should be created
|
||
|
|
*
|
||
|
|
* Return value : 0 - Ok
|
||
|
|
* -1 - Error
|
||
|
|
*/
|
||
|
|
|
||
|
|
int16_t WebRtcIlbcfix_EncoderCreate(IlbcEncoderInstance** iLBC_encinst);
|
||
|
|
int16_t WebRtcIlbcfix_DecoderCreate(IlbcDecoderInstance** iLBC_decinst);
|
||
|
|
|
||
|
|
/****************************************************************************
|
||
|
|
* WebRtcIlbcfix_XxxFree(...)
|
||
|
|
*
|
||
|
|
* These functions frees the dynamic memory of a specified instance
|
||
|
|
*
|
||
|
|
* Input:
|
||
|
|
* - XXX_inst : Pointer to created instance that should be freed
|
||
|
|
*
|
||
|
|
* Return value : 0 - Ok
|
||
|
|
* -1 - Error
|
||
|
|
*/
|
||
|
|
|
||
|
|
int16_t WebRtcIlbcfix_EncoderFree(IlbcEncoderInstance* iLBC_encinst);
|
||
|
|
int16_t WebRtcIlbcfix_DecoderFree(IlbcDecoderInstance* iLBC_decinst);
|
||
|
|
|
||
|
|
/****************************************************************************
|
||
|
|
* WebRtcIlbcfix_EncoderInit(...)
|
||
|
|
*
|
||
|
|
* This function initializes a iLBC instance
|
||
|
|
*
|
||
|
|
* Input:
|
||
|
|
* - iLBCenc_inst : iLBC instance, i.e. the user that should receive
|
||
|
|
* be initialized
|
||
|
|
* - frameLen : The frame length of the codec 20/30 (ms)
|
||
|
|
*
|
||
|
|
* Return value : 0 - Ok
|
||
|
|
* -1 - Error
|
||
|
|
*/
|
||
|
|
|
||
|
|
int16_t WebRtcIlbcfix_EncoderInit(IlbcEncoderInstance* iLBCenc_inst,
|
||
|
|
int16_t frameLen);
|
||
|
|
|
||
|
|
/****************************************************************************
|
||
|
|
* WebRtcIlbcfix_Encode(...)
|
||
|
|
*
|
||
|
|
* This function encodes one iLBC frame. Input speech length has be a
|
||
|
|
* multiple of the frame length.
|
||
|
|
*
|
||
|
|
* Input:
|
||
|
|
* - iLBCenc_inst : iLBC instance, i.e. the user that should encode
|
||
|
|
* a package
|
||
|
|
* - speechIn : Input speech vector
|
||
|
|
* - len : Samples in speechIn (160, 240, 320 or 480)
|
||
|
|
*
|
||
|
|
* Output:
|
||
|
|
* - encoded : The encoded data vector
|
||
|
|
*
|
||
|
|
* Return value : >0 - Length (in bytes) of coded data
|
||
|
|
* -1 - Error
|
||
|
|
*/
|
||
|
|
|
||
|
|
int WebRtcIlbcfix_Encode(IlbcEncoderInstance* iLBCenc_inst,
|
||
|
|
const int16_t* speechIn,
|
||
|
|
size_t len,
|
||
|
|
uint8_t* encoded);
|
||
|
|
|
||
|
|
/****************************************************************************
|
||
|
|
* WebRtcIlbcfix_DecoderInit(...)
|
||
|
|
*
|
||
|
|
* This function initializes a iLBC instance with either 20 or 30 ms frames
|
||
|
|
* Alternatively the WebRtcIlbcfix_DecoderInit_XXms can be used. Then it's
|
||
|
|
* not needed to specify the frame length with a variable.
|
||
|
|
*
|
||
|
|
* Input:
|
||
|
|
* - IlbcDecoderInstance : iLBC decoder instance
|
||
|
|
* - frameLen : The frame length of the codec 20/30 (ms)
|
||
|
|
*
|
||
|
|
* Return value : 0 - Ok
|
||
|
|
* -1 - Error
|
||
|
|
*/
|
||
|
|
|
||
|
|
int16_t WebRtcIlbcfix_DecoderInit(IlbcDecoderInstance* iLBCdec_inst,
|
||
|
|
int16_t frameLen);
|
||
|
|
void WebRtcIlbcfix_DecoderInit20Ms(IlbcDecoderInstance* iLBCdec_inst);
|
||
|
|
void WebRtcIlbcfix_Decoderinit30Ms(IlbcDecoderInstance* iLBCdec_inst);
|
||
|
|
|
||
|
|
/****************************************************************************
|
||
|
|
* WebRtcIlbcfix_Decode(...)
|
||
|
|
*
|
||
|
|
* This function decodes a packet with iLBC frame(s). Output speech length
|
||
|
|
* will be a multiple of 160 or 240 samples ((160 or 240)*frames/packet).
|
||
|
|
*
|
||
|
|
* Input:
|
||
|
|
* - iLBCdec_inst : iLBC instance, i.e. the user that should decode
|
||
|
|
* a packet
|
||
|
|
* - encoded : Encoded iLBC frame(s)
|
||
|
|
* - len : Bytes in encoded vector
|
||
|
|
*
|
||
|
|
* Output:
|
||
|
|
* - decoded : The decoded vector
|
||
|
|
* - speechType : 1 normal, 2 CNG
|
||
|
|
*
|
||
|
|
* Return value : >0 - Samples in decoded vector
|
||
|
|
* -1 - Error
|
||
|
|
*/
|
||
|
|
|
||
|
|
int WebRtcIlbcfix_Decode(IlbcDecoderInstance* iLBCdec_inst,
|
||
|
|
const uint8_t* encoded,
|
||
|
|
size_t len,
|
||
|
|
int16_t* decoded,
|
||
|
|
int16_t* speechType);
|
||
|
|
int WebRtcIlbcfix_Decode20Ms(IlbcDecoderInstance* iLBCdec_inst,
|
||
|
|
const uint8_t* encoded,
|
||
|
|
size_t len,
|
||
|
|
int16_t* decoded,
|
||
|
|
int16_t* speechType);
|
||
|
|
int WebRtcIlbcfix_Decode30Ms(IlbcDecoderInstance* iLBCdec_inst,
|
||
|
|
const uint8_t* encoded,
|
||
|
|
size_t len,
|
||
|
|
int16_t* decoded,
|
||
|
|
int16_t* speechType);
|
||
|
|
|
||
|
|
/****************************************************************************
|
||
|
|
* WebRtcIlbcfix_DecodePlc(...)
|
||
|
|
*
|
||
|
|
* This function conducts PLC for iLBC frame(s). Output speech length
|
||
|
|
* will be a multiple of 160 or 240 samples.
|
||
|
|
*
|
||
|
|
* Input:
|
||
|
|
* - iLBCdec_inst : iLBC instance, i.e. the user that should perform
|
||
|
|
* a PLC
|
||
|
|
* - noOfLostFrames : Number of PLC frames to produce
|
||
|
|
*
|
||
|
|
* Output:
|
||
|
|
* - decoded : The "decoded" vector
|
||
|
|
*
|
||
|
|
* Return value : Samples in decoded PLC vector
|
||
|
|
*/
|
||
|
|
|
||
|
|
size_t WebRtcIlbcfix_DecodePlc(IlbcDecoderInstance* iLBCdec_inst,
|
||
|
|
int16_t* decoded,
|
||
|
|
size_t noOfLostFrames);
|
||
|
|
|
||
|
|
/****************************************************************************
|
||
|
|
* WebRtcIlbcfix_NetEqPlc(...)
|
||
|
|
*
|
||
|
|
* This function updates the decoder when a packet loss has occured, but it
|
||
|
|
* does not produce any PLC data. Function can be used if another PLC method
|
||
|
|
* is used (i.e NetEq).
|
||
|
|
*
|
||
|
|
* Input:
|
||
|
|
* - iLBCdec_inst : iLBC instance that should be updated
|
||
|
|
* - noOfLostFrames : Number of lost frames
|
||
|
|
*
|
||
|
|
* Output:
|
||
|
|
* - decoded : The "decoded" vector (nothing in this case)
|
||
|
|
*
|
||
|
|
* Return value : Samples in decoded PLC vector
|
||
|
|
*/
|
||
|
|
|
||
|
|
size_t WebRtcIlbcfix_NetEqPlc(IlbcDecoderInstance* iLBCdec_inst,
|
||
|
|
int16_t* decoded,
|
||
|
|
size_t noOfLostFrames);
|
||
|
|
|
||
|
|
/****************************************************************************
|
||
|
|
* WebRtcIlbcfix_version(...)
|
||
|
|
*
|
||
|
|
* This function returns the version number of iLBC
|
||
|
|
*
|
||
|
|
* Output:
|
||
|
|
* - version : Version number of iLBC (maximum 20 char)
|
||
|
|
*/
|
||
|
|
|
||
|
|
void WebRtcIlbcfix_version(char* version);
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif // MODULES_AUDIO_CODING_CODECS_ILBC_ILBC_H_
|