| /* |
| * 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> |
| |
| /* |
| * Define the fixpoint numeric formats |
| */ |
| |
| #include "typedefs.h" // NOLINT(build/include) |
| |
| /* |
| * 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_ |
