| /* Copyright (c) 2012 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 COPYRIGHT OWNER |
| 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_PRIVATE_H |
| #define OPUS_PRIVATE_H |
| |
| #include "arch.h" |
| #include "opus.h" |
| #include "celt.h" |
| |
| #include <stdarg.h> /* va_list */ |
| #include <stddef.h> /* offsetof */ |
| |
| struct OpusRepacketizer { |
| unsigned char toc; |
| int nb_frames; |
| const unsigned char *frames[48]; |
| opus_int16 len[48]; |
| int framesize; |
| }; |
| |
| typedef struct ChannelLayout { |
| int nb_channels; |
| int nb_streams; |
| int nb_coupled_streams; |
| unsigned char mapping[256]; |
| } ChannelLayout; |
| |
| typedef enum { |
| MAPPING_TYPE_NONE, |
| MAPPING_TYPE_SURROUND |
| #ifdef ENABLE_EXPERIMENTAL_AMBISONICS |
| , /* Do not include comma at end of enumerator list */ |
| MAPPING_TYPE_AMBISONICS |
| #endif /* ENABLE_EXPERIMENTAL_AMBISONICS */ |
| } MappingType; |
| |
| struct OpusMSEncoder { |
| ChannelLayout layout; |
| int arch; |
| int lfe_stream; |
| int application; |
| int variable_duration; |
| MappingType mapping_type; |
| opus_int32 bitrate_bps; |
| /* Encoder states go here */ |
| /* then opus_val32 window_mem[channels*120]; */ |
| /* then opus_val32 preemph_mem[channels]; */ |
| }; |
| |
| struct OpusMSDecoder { |
| ChannelLayout layout; |
| /* Decoder states go here */ |
| }; |
| |
| int opus_multistream_encoder_ctl_va_list(struct OpusMSEncoder *st, int request, |
| va_list ap); |
| int opus_multistream_decoder_ctl_va_list(struct OpusMSDecoder *st, int request, |
| va_list ap); |
| |
| int validate_layout(const ChannelLayout *layout); |
| int get_left_channel(const ChannelLayout *layout, int stream_id, int prev); |
| int get_right_channel(const ChannelLayout *layout, int stream_id, int prev); |
| int get_mono_channel(const ChannelLayout *layout, int stream_id, int prev); |
| |
| |
| |
| #define MODE_SILK_ONLY 1000 |
| #define MODE_HYBRID 1001 |
| #define MODE_CELT_ONLY 1002 |
| |
| #define OPUS_SET_VOICE_RATIO_REQUEST 11018 |
| #define OPUS_GET_VOICE_RATIO_REQUEST 11019 |
| |
| /** Configures the encoder's expected percentage of voice |
| * opposed to music or other signals. |
| * |
| * @note This interface is currently more aspiration than actuality. It's |
| * ultimately expected to bias an automatic signal classifier, but it currently |
| * just shifts the static bitrate to mode mapping around a little bit. |
| * |
| * @param[in] x <tt>int</tt>: Voice percentage in the range 0-100, inclusive. |
| * @hideinitializer */ |
| #define OPUS_SET_VOICE_RATIO(x) OPUS_SET_VOICE_RATIO_REQUEST, __opus_check_int(x) |
| /** Gets the encoder's configured voice ratio value, @see OPUS_SET_VOICE_RATIO |
| * |
| * @param[out] x <tt>int*</tt>: Voice percentage in the range 0-100, inclusive. |
| * @hideinitializer */ |
| #define OPUS_GET_VOICE_RATIO(x) OPUS_GET_VOICE_RATIO_REQUEST, __opus_check_int_ptr(x) |
| |
| |
| #define OPUS_SET_FORCE_MODE_REQUEST 11002 |
| #define OPUS_SET_FORCE_MODE(x) OPUS_SET_FORCE_MODE_REQUEST, __opus_check_int(x) |
| |
| typedef void (*downmix_func)(const void *, opus_val32 *, int, int, int, int, int); |
| void downmix_float(const void *_x, opus_val32 *sub, int subframe, int offset, int c1, int c2, int C); |
| void downmix_int(const void *_x, opus_val32 *sub, int subframe, int offset, int c1, int c2, int C); |
| |
| int encode_size(int size, unsigned char *data); |
| |
| opus_int32 frame_size_select(opus_int32 frame_size, int variable_duration, opus_int32 Fs); |
| |
| opus_int32 opus_encode_native(OpusEncoder *st, const opus_val16 *pcm, int frame_size, |
| unsigned char *data, opus_int32 out_data_bytes, int lsb_depth, |
| const void *analysis_pcm, opus_int32 analysis_size, int c1, int c2, |
| int analysis_channels, downmix_func downmix, int float_api); |
| |
| int opus_decode_native(OpusDecoder *st, const unsigned char *data, opus_int32 len, |
| opus_val16 *pcm, int frame_size, int decode_fec, int self_delimited, |
| opus_int32 *packet_offset, int soft_clip); |
| |
| /* Make sure everything is properly aligned. */ |
| static OPUS_INLINE int align(int i) |
| { |
| struct foo {char c; union { void* p; opus_int32 i; opus_val32 v; } u;}; |
| |
| unsigned int alignment = offsetof(struct foo, u); |
| |
| /* Optimizing compilers should optimize div and multiply into and |
| for all sensible alignment values. */ |
| return ((i + alignment - 1) / alignment) * alignment; |
| } |
| |
| int opus_packet_parse_impl(const unsigned char *data, opus_int32 len, |
| int self_delimited, unsigned char *out_toc, |
| const unsigned char *frames[48], opus_int16 size[48], |
| int *payload_offset, opus_int32 *packet_offset); |
| |
| opus_int32 opus_repacketizer_out_range_impl(OpusRepacketizer *rp, int begin, int end, |
| unsigned char *data, opus_int32 maxlen, int self_delimited, int pad); |
| |
| int pad_frame(unsigned char *data, opus_int32 len, opus_int32 new_len); |
| |
| #endif /* OPUS_PRIVATE_H */ |