cannam@154: /*********************************************************************** cannam@154: Copyright (c) 2006-2011, Skype Limited. All rights reserved. cannam@154: Redistribution and use in source and binary forms, with or without cannam@154: modification, are permitted provided that the following conditions cannam@154: are met: cannam@154: - Redistributions of source code must retain the above copyright notice, cannam@154: this list of conditions and the following disclaimer. cannam@154: - Redistributions in binary form must reproduce the above copyright cannam@154: notice, this list of conditions and the following disclaimer in the cannam@154: documentation and/or other materials provided with the distribution. cannam@154: - Neither the name of Internet Society, IETF or IETF Trust, nor the cannam@154: names of specific contributors, may be used to endorse or promote cannam@154: products derived from this software without specific prior written cannam@154: permission. cannam@154: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" cannam@154: AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE cannam@154: IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE cannam@154: ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE cannam@154: LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR cannam@154: CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF cannam@154: SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS cannam@154: INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN cannam@154: CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) cannam@154: ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE cannam@154: POSSIBILITY OF SUCH DAMAGE. cannam@154: ***********************************************************************/ cannam@154: cannam@154: #ifndef SILK_API_H cannam@154: #define SILK_API_H cannam@154: cannam@154: #include "control.h" cannam@154: #include "typedef.h" cannam@154: #include "errors.h" cannam@154: #include "entenc.h" cannam@154: #include "entdec.h" cannam@154: cannam@154: #ifdef __cplusplus cannam@154: extern "C" cannam@154: { cannam@154: #endif cannam@154: cannam@154: #define SILK_MAX_FRAMES_PER_PACKET 3 cannam@154: cannam@154: /* Struct for TOC (Table of Contents) */ cannam@154: typedef struct { cannam@154: opus_int VADFlag; /* Voice activity for packet */ cannam@154: opus_int VADFlags[ SILK_MAX_FRAMES_PER_PACKET ]; /* Voice activity for each frame in packet */ cannam@154: opus_int inbandFECFlag; /* Flag indicating if packet contains in-band FEC */ cannam@154: } silk_TOC_struct; cannam@154: cannam@154: /****************************************/ cannam@154: /* Encoder functions */ cannam@154: /****************************************/ cannam@154: cannam@154: /***********************************************/ cannam@154: /* Get size in bytes of the Silk encoder state */ cannam@154: /***********************************************/ cannam@154: opus_int silk_Get_Encoder_Size( /* O Returns error code */ cannam@154: opus_int *encSizeBytes /* O Number of bytes in SILK encoder state */ cannam@154: ); cannam@154: cannam@154: /*************************/ cannam@154: /* Init or reset encoder */ cannam@154: /*************************/ cannam@154: opus_int silk_InitEncoder( /* O Returns error code */ cannam@154: void *encState, /* I/O State */ cannam@154: int arch, /* I Run-time architecture */ cannam@154: silk_EncControlStruct *encStatus /* O Encoder Status */ cannam@154: ); cannam@154: cannam@154: /**************************/ cannam@154: /* Encode frame with Silk */ cannam@154: /**************************/ cannam@154: /* Note: if prefillFlag is set, the input must contain 10 ms of audio, irrespective of what */ cannam@154: /* encControl->payloadSize_ms is set to */ cannam@154: opus_int silk_Encode( /* O Returns error code */ cannam@154: void *encState, /* I/O State */ cannam@154: silk_EncControlStruct *encControl, /* I Control status */ cannam@154: const opus_int16 *samplesIn, /* I Speech sample input vector */ cannam@154: opus_int nSamplesIn, /* I Number of samples in input vector */ cannam@154: ec_enc *psRangeEnc, /* I/O Compressor data structure */ cannam@154: opus_int32 *nBytesOut, /* I/O Number of bytes in payload (input: Max bytes) */ cannam@154: const opus_int prefillFlag, /* I Flag to indicate prefilling buffers no coding */ cannam@154: int activity /* I Decision of Opus voice activity detector */ cannam@154: ); cannam@154: cannam@154: /****************************************/ cannam@154: /* Decoder functions */ cannam@154: /****************************************/ cannam@154: cannam@154: /***********************************************/ cannam@154: /* Get size in bytes of the Silk decoder state */ cannam@154: /***********************************************/ cannam@154: opus_int silk_Get_Decoder_Size( /* O Returns error code */ cannam@154: opus_int *decSizeBytes /* O Number of bytes in SILK decoder state */ cannam@154: ); cannam@154: cannam@154: /*************************/ cannam@154: /* Init or Reset decoder */ cannam@154: /*************************/ cannam@154: opus_int silk_InitDecoder( /* O Returns error code */ cannam@154: void *decState /* I/O State */ cannam@154: ); cannam@154: cannam@154: /******************/ cannam@154: /* Decode a frame */ cannam@154: /******************/ cannam@154: opus_int silk_Decode( /* O Returns error code */ cannam@154: void* decState, /* I/O State */ cannam@154: silk_DecControlStruct* decControl, /* I/O Control Structure */ cannam@154: opus_int lostFlag, /* I 0: no loss, 1 loss, 2 decode fec */ cannam@154: opus_int newPacketFlag, /* I Indicates first decoder call for this packet */ cannam@154: ec_dec *psRangeDec, /* I/O Compressor data structure */ cannam@154: opus_int16 *samplesOut, /* O Decoded output speech vector */ cannam@154: opus_int32 *nSamplesOut, /* O Number of samples decoded */ cannam@154: int arch /* I Run-time architecture */ cannam@154: ); cannam@154: cannam@154: #if 0 cannam@154: /**************************************/ cannam@154: /* Get table of contents for a packet */ cannam@154: /**************************************/ cannam@154: opus_int silk_get_TOC( cannam@154: const opus_uint8 *payload, /* I Payload data */ cannam@154: const opus_int nBytesIn, /* I Number of input bytes */ cannam@154: const opus_int nFramesPerPayload, /* I Number of SILK frames per payload */ cannam@154: silk_TOC_struct *Silk_TOC /* O Type of content */ cannam@154: ); cannam@154: #endif cannam@154: cannam@154: #ifdef __cplusplus cannam@154: } cannam@154: #endif cannam@154: cannam@154: #endif