You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
65 lines
3.8 KiB
65 lines
3.8 KiB
/* audio_compressor — адаптивное усиление int16 PCM (моно/стерео) с общей огибающей каналов. |
|
* create → configure → обработка → destroy; объект использует один владелец, блокировок нет. |
|
* Запись: push принимает произвольные порции, flush завершает хвост и lookahead; output принадлежит объекту. |
|
* Поток: process_frame обрабатывает ровно sample_rate*block_duration_ms/1000*channels отсчётов, |
|
* требует нулевого lookahead и пустого входного накопителя; in/out могут совпадать. |
|
* count/output_size — interleaved отсчёты, не байты и не кадры на канал. Выключение даёт исходный PCM. */ |
|
#ifndef AUDIO_COMPRESSOR_H |
|
#define AUDIO_COMPRESSOR_H |
|
|
|
#include <stdint.h> |
|
#include <stddef.h> |
|
|
|
#ifdef __cplusplus |
|
extern "C" { |
|
#endif |
|
|
|
struct audio_compressor; |
|
|
|
typedef struct { |
|
int sample_rate; |
|
int channels; |
|
int block_duration_ms; |
|
int lookback_ms; |
|
int lookahead_ms; |
|
float max_gain_db; |
|
float rise_rate_per_sec; |
|
float release_rate_per_sec; /* скорость плавного снижения gain (0 = авто: rise*5) */ |
|
float target_level; /* Линейная амплитуда огибающей, не дБ; 0 задаёт default 0.25. */ |
|
} audio_compressor_config_t; |
|
|
|
struct audio_compressor* audio_compressor_create(void); |
|
/* Новый пустой compressor с теми же настройками; позволяет передать запись worker без копии PCM. */ |
|
struct audio_compressor* audio_compressor_clone_config(const struct audio_compressor* source); |
|
void audio_compressor_destroy(struct audio_compressor* ac); |
|
|
|
int audio_compressor_configure(struct audio_compressor* ac, const audio_compressor_config_t* cfg); |
|
/* Потоковый кадр без lookahead: результат немедленный, память не выделяется; 0 / -1. */ |
|
int audio_compressor_process_frame(struct audio_compressor* ac, const int16_t* in, int16_t* out, size_t count); |
|
void audio_compressor_reset(struct audio_compressor* ac); |
|
|
|
void audio_compressor_set_enabled(struct audio_compressor* ac, int enabled); |
|
int audio_compressor_is_enabled(const struct audio_compressor* ac); |
|
|
|
/* push копирует вход; push/flush возвращают 0 / -1. Ошибка накопления требует reset перед повтором. */ |
|
int audio_compressor_push(struct audio_compressor* ac, const int16_t* samples, size_t count); |
|
int audio_compressor_flush(struct audio_compressor* ac); |
|
|
|
/* Указатель действителен до изменения/освобождения выходного буфера; вызывающий его не освобождает. */ |
|
const int16_t* audio_compressor_output(const struct audio_compressor* ac); |
|
size_t audio_compressor_output_size(const struct audio_compressor* ac); |
|
|
|
/* Сбросить накопленный выход (output_size=0) после слива — для потокового режима. |
|
* НЕ трогает gain_smoothed (адаптивная громкость сохраняется). */ |
|
void audio_compressor_clear_output(struct audio_compressor* ac); |
|
|
|
/* Число сэмплов, обрезанных по потолку int16 (клиппинг) с момента create/reset. */ |
|
uint32_t audio_compressor_clip_count(const struct audio_compressor* ac); |
|
/* Текущее фактическое усиление в дБ; выключенный compressor возвращает 0. */ |
|
float audio_compressor_gain_db(const struct audio_compressor* ac); |
|
|
|
#ifdef __cplusplus |
|
} |
|
#endif |
|
|
|
#endif
|
|
|