| /* Copyright (c) 2010 Xiph.Org Foundation |
| Written by Jean-Marc Valin */ |
| /* |
| Redistribution and use in source and binary forms, with or without |
| modification, are permitted provided that the following conditions |
| are met: |
| |
| - Redistributions of source code must retain the above copyright |
| notice, this list of conditions and the following disclaimer. |
| |
| - Redistributions in binary form must reproduce the above copyright |
| notice, this list of conditions and the following disclaimer in the |
| documentation and/or other materials provided with the distribution. |
| |
| THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR |
| CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, |
| EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
| PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR |
| PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF |
| LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING |
| NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS |
| SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| */ |
| |
| #ifndef OPUS_H |
| #define OPUS_H |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| #if defined(__GNUC__) && defined(OPUS_BUILD) |
| #define EXPORT __attribute__ ((visibility ("default"))) |
| #elif defined(WIN32) |
| #define EXPORT __declspec(dllexport) |
| #else |
| #define EXPORT |
| #endif |
| |
| #define __check_int(x) (((void)((x) == (int)0)), (int)(x)) |
| #define __check_int_ptr(ptr) ((ptr) + ((ptr) - (int*)(ptr))) |
| |
| /* Error codes */ |
| /** No error */ |
| #define OPUS_OK 0 |
| /** An (or more) invalid argument (e.g. out of range) */ |
| #define OPUS_BAD_ARG -1 |
| /** The mode struct passed is invalid */ |
| #define OPUS_BUFFER_TOO_SMALL -2 |
| /** An internal error was detected */ |
| #define OPUS_INTERNAL_ERROR -3 |
| /** The data passed (e.g. compressed data to decoder) is corrupted */ |
| #define OPUS_CORRUPTED_DATA -4 |
| /** Invalid/unsupported request number */ |
| #define OPUS_UNIMPLEMENTED -5 |
| /** An encoder or decoder structure is invalid or already freed */ |
| #define OPUS_INVALID_STATE -6 |
| /** Memory allocation has failed */ |
| #define OPUS_ALLOC_FAIL -7 |
| |
| #define OPUS_TEST_RANGE_CODER_STATE 1 |
| |
| #define OPUS_MODE_AUTO 2000 |
| #define OPUS_MODE_VOICE 2001 |
| #define OPUS_MODE_AUDIO 2002 |
| |
| #define MODE_SILK_ONLY 1000 |
| #define MODE_HYBRID 1001 |
| #define MODE_CELT_ONLY 1002 |
| |
| #define BANDWIDTH_AUTO 1100 |
| #define BANDWIDTH_NARROWBAND 1101 |
| #define BANDWIDTH_MEDIUMBAND 1102 |
| #define BANDWIDTH_WIDEBAND 1103 |
| #define BANDWIDTH_SUPERWIDEBAND 1104 |
| #define BANDWIDTH_FULLBAND 1105 |
| |
| |
| |
| #define OPUS_SET_MODE_REQUEST 0 |
| #define OPUS_SET_MODE(x) OPUS_SET_MODE_REQUEST, __check_int(x) |
| #define OPUS_GET_MODE_REQUEST 1 |
| #define OPUS_GET_MODE(x) OPUS_GET_MODE_REQUEST, __check_int_ptr(x) |
| |
| #define OPUS_SET_BITRATE_REQUEST 2 |
| #define OPUS_SET_BITRATE(x) OPUS_SET_BITRATE_REQUEST, __check_int(x) |
| #define OPUS_GET_BITRATE_REQUEST 3 |
| #define OPUS_GET_BITRATE(x) OPUS_GET_BITRATE_REQUEST, __check_int_ptr(x) |
| |
| #define OPUS_SET_VBR_FLAG_REQUEST 6 |
| #define OPUS_SET_VBR_FLAG(x) OPUS_SET_VBR_FLAG_REQUEST, __check_int(x) |
| #define OPUS_GET_VBR_FLAG_REQUEST 7 |
| #define OPUS_GET_VBR_FLAG(x) OPUS_GET_VBR_FLAG_REQUEST, __check_int_ptr(x) |
| |
| #define OPUS_SET_BANDWIDTH_REQUEST 8 |
| #define OPUS_SET_BANDWIDTH(x) OPUS_SET_BANDWIDTH_REQUEST, __check_int(x) |
| #define OPUS_GET_BANDWIDTH_REQUEST 9 |
| #define OPUS_GET_BANDWIDTH(x) OPUS_GET_BANDWIDTH_REQUEST, __check_int_ptr(x) |
| |
| #define OPUS_SET_COMPLEXITY_REQUEST 10 |
| #define OPUS_SET_COMPLEXITY(x) OPUS_SET_COMPLEXITY_REQUEST, __check_int(x) |
| #define OPUS_GET_COMPLEXITY_REQUEST 11 |
| #define OPUS_GET_COMPLEXITY(x) OPUS_GET_COMPLEXITY_REQUEST, __check_int_ptr(x) |
| |
| #define OPUS_SET_INBAND_FEC_FLAG_REQUEST 12 |
| #define OPUS_SET_INBAND_FEC_FLAG(x) OPUS_SET_INBAND_FEC_FLAG_REQUEST, __check_int(x) |
| #define OPUS_GET_INBAND_FEC_FLAG_REQUEST 13 |
| #define OPUS_GET_INBAND_FEC_FLAG(x) OPUS_GET_INBAND_FEC_FLAG_REQUEST, __check_int_ptr(x) |
| |
| #define OPUS_SET_PACKET_LOSS_PERC_REQUEST 14 |
| #define OPUS_SET_PACKET_LOSS_PERC(x) OPUS_SET_PACKET_LOSS_PERC_REQUEST, __check_int(x) |
| #define OPUS_GET_PACKET_LOSS_PERC_REQUEST 15 |
| #define OPUS_GET_PACKET_LOSS_PERC(x) OPUS_GET_PACKET_LOSS_PERC_REQUEST, __check_int_ptr(x) |
| |
| #define OPUS_SET_DTX_FLAG_REQUEST 16 |
| #define OPUS_SET_DTX_FLAG(x) OPUS_SET_DTX_FLAG_REQUEST, __check_int(x) |
| #define OPUS_GET_DTX_FLAG_REQUEST 17 |
| #define OPUS_GET_DTX_FLAG(x) OPUS_GET_DTX_FLAG_REQUEST, __check_int_ptr(x) |
| |
| #define OPUS_SET_VOICE_RATIO_REQUEST 18 |
| #define OPUS_SET_VOICE_RATIO(x) OPUS_SET_VOICE_RATIO_REQUEST, __check_int(x) |
| #define OPUS_GET_VOICE_RATIO_REQUEST 19 |
| #define OPUS_GET_VOICE_RATIO(x) OPUS_GET_VOICE_RATIO_REQUEST, __check_int_ptr(x) |
| |
| #define OPUS_SET_VBR_CONSTRAINT_REQUEST 20 |
| #define OPUS_SET_VBR_CONSTRAINT(x) OPUS_SET_VBR_CONSTRAINT_REQUEST, __check_int(x) |
| #define OPUS_GET_VBR_CONSTRAINT_REQUEST 21 |
| #define OPUS_GET_VBR_CONSTRAINT(x) OPUS_GET_VBR_CONSTRAINT_REQUEST, __check_int_ptr(x) |
| |
| typedef struct OpusEncoder OpusEncoder; |
| typedef struct OpusDecoder OpusDecoder; |
| |
| EXPORT OpusEncoder *opus_encoder_create(int Fs, int channels); |
| |
| /* returns length of data payload (in bytes) */ |
| EXPORT int opus_encode(OpusEncoder *st, const short *pcm, int frame_size, |
| unsigned char *data, int max_data_bytes); |
| |
| EXPORT void opus_encoder_destroy(OpusEncoder *st); |
| |
| EXPORT int opus_encoder_ctl(OpusEncoder *st, int request, ...); |
| |
| EXPORT OpusDecoder *opus_decoder_create(int Fs, int channels); |
| |
| /* returns (CELT) error code */ |
| EXPORT int opus_decode(OpusDecoder *st, const unsigned char *data, int len, |
| short *pcm, int frame_size, int decode_fec); |
| |
| EXPORT int opus_decoder_ctl(OpusDecoder *st, int request, ...); |
| |
| EXPORT void opus_decoder_destroy(OpusDecoder *st); |
| |
| EXPORT int opus_packet_get_bandwidth(const unsigned char *data); |
| EXPORT int opus_packet_get_samples_per_frame(const unsigned char *data, int Fs); |
| EXPORT int opus_packet_get_nb_channels(const unsigned char *data); |
| EXPORT int opus_packet_get_nb_frames(const unsigned char packet[], int len); |
| EXPORT int opus_decoder_get_nb_samples(const OpusDecoder *dec, const unsigned char packet[], int len); |
| |
| |
| #if OPUS_TEST_RANGE_CODER_STATE |
| EXPORT int opus_encoder_get_final_range(OpusEncoder *st); |
| EXPORT int opus_decoder_get_final_range(OpusDecoder *st); |
| #endif |
| |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* OPUS_H */ |