Alexandre Lision | 744f742 | 2013-09-25 11:39:37 -0400 | [diff] [blame] | 1 | /*********************************************************************** |
| 2 | Copyright (c) 2006-2011, Skype Limited. All rights reserved. |
| 3 | Redistribution and use in source and binary forms, with or without |
| 4 | modification, are permitted provided that the following conditions |
| 5 | are met: |
| 6 | - Redistributions of source code must retain the above copyright notice, |
| 7 | this list of conditions and the following disclaimer. |
| 8 | - Redistributions in binary form must reproduce the above copyright |
| 9 | notice, this list of conditions and the following disclaimer in the |
| 10 | documentation and/or other materials provided with the distribution. |
| 11 | - Neither the name of Internet Society, IETF or IETF Trust, nor the |
| 12 | names of specific contributors, may be used to endorse or promote |
| 13 | products derived from this software without specific prior written |
| 14 | permission. |
| 15 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” |
| 16 | AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| 17 | IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
| 18 | ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE |
| 19 | LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
| 20 | CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
| 21 | SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
| 22 | INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
| 23 | CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
| 24 | ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
| 25 | POSSIBILITY OF SUCH DAMAGE. |
| 26 | ***********************************************************************/ |
| 27 | |
| 28 | #ifndef SILK_API_H |
| 29 | #define SILK_API_H |
| 30 | |
| 31 | #include "control.h" |
| 32 | #include "typedef.h" |
| 33 | #include "errors.h" |
| 34 | #include "entenc.h" |
| 35 | #include "entdec.h" |
| 36 | |
| 37 | #ifdef __cplusplus |
| 38 | extern "C" |
| 39 | { |
| 40 | #endif |
| 41 | |
| 42 | #define SILK_MAX_FRAMES_PER_PACKET 3 |
| 43 | |
| 44 | /* Struct for TOC (Table of Contents) */ |
| 45 | typedef struct { |
| 46 | opus_int VADFlag; /* Voice activity for packet */ |
| 47 | opus_int VADFlags[ SILK_MAX_FRAMES_PER_PACKET ]; /* Voice activity for each frame in packet */ |
| 48 | opus_int inbandFECFlag; /* Flag indicating if packet contains in-band FEC */ |
| 49 | } silk_TOC_struct; |
| 50 | |
| 51 | /****************************************/ |
| 52 | /* Encoder functions */ |
| 53 | /****************************************/ |
| 54 | |
| 55 | /***********************************************/ |
| 56 | /* Get size in bytes of the Silk encoder state */ |
| 57 | /***********************************************/ |
| 58 | opus_int silk_Get_Encoder_Size( /* O Returns error code */ |
| 59 | opus_int *encSizeBytes /* O Number of bytes in SILK encoder state */ |
| 60 | ); |
| 61 | |
| 62 | /*************************/ |
| 63 | /* Init or reset encoder */ |
| 64 | /*************************/ |
| 65 | opus_int silk_InitEncoder( /* O Returns error code */ |
| 66 | void *encState, /* I/O State */ |
| 67 | silk_EncControlStruct *encStatus /* O Encoder Status */ |
| 68 | ); |
| 69 | |
| 70 | /**************************/ |
| 71 | /* Encode frame with Silk */ |
| 72 | /**************************/ |
| 73 | /* Note: if prefillFlag is set, the input must contain 10 ms of audio, irrespective of what */ |
| 74 | /* encControl->payloadSize_ms is set to */ |
| 75 | opus_int silk_Encode( /* O Returns error code */ |
| 76 | void *encState, /* I/O State */ |
| 77 | silk_EncControlStruct *encControl, /* I Control status */ |
| 78 | const opus_int16 *samplesIn, /* I Speech sample input vector */ |
| 79 | opus_int nSamplesIn, /* I Number of samples in input vector */ |
| 80 | ec_enc *psRangeEnc, /* I/O Compressor data structure */ |
| 81 | opus_int32 *nBytesOut, /* I/O Number of bytes in payload (input: Max bytes) */ |
| 82 | const opus_int prefillFlag /* I Flag to indicate prefilling buffers no coding */ |
| 83 | ); |
| 84 | |
| 85 | /****************************************/ |
| 86 | /* Decoder functions */ |
| 87 | /****************************************/ |
| 88 | |
| 89 | /***********************************************/ |
| 90 | /* Get size in bytes of the Silk decoder state */ |
| 91 | /***********************************************/ |
| 92 | opus_int silk_Get_Decoder_Size( /* O Returns error code */ |
| 93 | opus_int *decSizeBytes /* O Number of bytes in SILK decoder state */ |
| 94 | ); |
| 95 | |
| 96 | /*************************/ |
| 97 | /* Init or Reset decoder */ |
| 98 | /*************************/ |
| 99 | opus_int silk_InitDecoder( /* O Returns error code */ |
| 100 | void *decState /* I/O State */ |
| 101 | ); |
| 102 | |
| 103 | /******************/ |
| 104 | /* Decode a frame */ |
| 105 | /******************/ |
| 106 | opus_int silk_Decode( /* O Returns error code */ |
| 107 | void* decState, /* I/O State */ |
| 108 | silk_DecControlStruct* decControl, /* I/O Control Structure */ |
| 109 | opus_int lostFlag, /* I 0: no loss, 1 loss, 2 decode fec */ |
| 110 | opus_int newPacketFlag, /* I Indicates first decoder call for this packet */ |
| 111 | ec_dec *psRangeDec, /* I/O Compressor data structure */ |
| 112 | opus_int16 *samplesOut, /* O Decoded output speech vector */ |
| 113 | opus_int32 *nSamplesOut /* O Number of samples decoded */ |
| 114 | ); |
| 115 | |
| 116 | #if 0 |
| 117 | /**************************************/ |
| 118 | /* Get table of contents for a packet */ |
| 119 | /**************************************/ |
| 120 | opus_int silk_get_TOC( |
| 121 | const opus_uint8 *payload, /* I Payload data */ |
| 122 | const opus_int nBytesIn, /* I Number of input bytes */ |
| 123 | const opus_int nFramesPerPayload, /* I Number of SILK frames per payload */ |
| 124 | silk_TOC_struct *Silk_TOC /* O Type of content */ |
| 125 | ); |
| 126 | #endif |
| 127 | |
| 128 | #ifdef __cplusplus |
| 129 | } |
| 130 | #endif |
| 131 | |
| 132 | #endif |