opus.h

Go to the documentation of this file.

 
#pragma once
 
#include <stddef.h>
#include <stdint.h>
#include "../common.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* ============================================================================
 * Forward Declarations
 * ============================================================================ */
 
typedef struct OpusEncoder OpusEncoder;
typedef struct OpusDecoder OpusDecoder;

asciichat_error_t audio_opus_configure_encoder(OpusEncoder *encoder, int bitrate);
 
/* ============================================================================
 * Opus Application Modes
 * ============================================================================ */

typedef enum {
  OPUS_APPLICATION_VOIP = 2048,               
  OPUS_APPLICATION_AUDIO = 2049,              
  OPUS_APPLICATION_RESTRICTED_LOWDELAY = 2051 
} opus_application_t;
 
/* ============================================================================
 * Codec Context Structure
 * ============================================================================ */

typedef struct {
  OpusEncoder *encoder; 
  OpusDecoder *decoder; 
  int sample_rate;      
  int channels;         
  int bitrate;          
  uint8_t *tmp_buffer;  
} opus_codec_t;
 
/* ============================================================================
 * Encoder Functions
 * ============================================================================ */

opus_codec_t *opus_codec_create_encoder(opus_application_t application, int sample_rate, int bitrate);
opus_codec_t *opus_codec_create_encoder_channels(opus_application_t application, int sample_rate, int bitrate,
                                                 int channels);

opus_codec_t *opus_codec_create_decoder(int sample_rate);
opus_codec_t *opus_codec_create_decoder_channels(int sample_rate, int channels);

size_t opus_codec_encode(opus_codec_t *codec, const float *samples, int num_samples, uint8_t *out_data,
                         size_t out_size);
 
/* ============================================================================
 * Decoder Functions
 * ============================================================================ */

int opus_codec_decode(opus_codec_t *codec, const uint8_t *data, size_t data_len, float *out_samples,
                      int out_num_samples);
 
/* ============================================================================
 * Configuration Functions
 * ============================================================================ */

asciichat_error_t opus_codec_set_bitrate(opus_codec_t *codec, int bitrate);

int opus_codec_get_bitrate(opus_codec_t *codec);

asciichat_error_t opus_codec_set_dtx(opus_codec_t *codec, int enable);
 
/* ============================================================================
 * Lifecycle Functions
 * ============================================================================ */

void opus_codec_destroy(opus_codec_t *codec);
 
#ifdef __cplusplus
}
#endif