/*
* HRTF Filter
*
* Copyright (c) 2025 Matt Borgerson
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, see .
*/
#ifndef HW_XBOX_MCPX_HRTF_H
#define HW_XBOX_MCPX_HRTF_H
#include
#include
#include
#include "hw/xbox/mcpx/apu/apu_regs.h"
#define HRTF_SAMPLES_PER_FRAME NUM_SAMPLES_PER_FRAME
#define HRTF_NUM_TAPS 31
#define HRTF_MAX_DELAY_SAMPLES 42
#define HRTF_BUFLEN (HRTF_NUM_TAPS + HRTF_MAX_DELAY_SAMPLES)
#define HRTF_PARAM_SMOOTH_ALPHA 0.01f
typedef struct {
int buf_pos;
struct {
float buf[HRTF_BUFLEN];
float hrir_coeff_cur[HRTF_NUM_TAPS];
float hrir_coeff_tar[HRTF_NUM_TAPS];
} ch[2];
float itd_cur;
float itd_tar;
} HrtfFilter;
static inline void hrtf_filter_init(HrtfFilter *f)
{
memset(f, 0, sizeof(*f));
}
static inline void
hrtf_filter_set_target_params(HrtfFilter *f, float hrir_coeff[2][HRTF_NUM_TAPS],
float itd)
{
f->itd_tar =
fmaxf(-HRTF_MAX_DELAY_SAMPLES, fminf(itd, HRTF_MAX_DELAY_SAMPLES));
for (int ch = 0; ch < 2; ch++) {
float *coeff = f->ch[ch].hrir_coeff_tar;
memcpy(coeff, hrir_coeff[ch], sizeof(f->ch[ch].hrir_coeff_tar));
// Normalize coefficients for unity filter gain
float s = 0.0f;
for (int k = 0; k < HRTF_NUM_TAPS; k++) {
s += fabsf(coeff[k]);
}
if (s == 0.0f || s == 1.0f) {
break;
}
for (int k = 0; k < HRTF_NUM_TAPS; k++) {
coeff[k] /= s;
}
}
}
static inline float hrtf_filter_smooth_param(float cur, float tar)
{
// FIXME: Match hardware parameter transition
return cur + HRTF_PARAM_SMOOTH_ALPHA * (tar - cur);
}
static inline void hrtf_filter_step_parameters(HrtfFilter *f)
{
for (int ch = 0; ch < 2; ch++) {
float *coeff_cur = f->ch[ch].hrir_coeff_cur;
float *coeff_tar = f->ch[ch].hrir_coeff_tar;
for (int k = 0; k < HRTF_NUM_TAPS; k++) {
coeff_cur[k] = hrtf_filter_smooth_param(coeff_cur[k], coeff_tar[k]);
}
}
f->itd_cur = hrtf_filter_smooth_param(f->itd_cur, f->itd_tar);
}
static inline void hrtf_filter_process(HrtfFilter *f,
float in[HRTF_SAMPLES_PER_FRAME][2],
float out[HRTF_SAMPLES_PER_FRAME][2])
{
for (int n = 0; n < HRTF_SAMPLES_PER_FRAME; n++) {
hrtf_filter_step_parameters(f);
for (int ch = 0; ch < 2; ch++) {
float *buf = f->ch[ch].buf;
float *coeff = f->ch[ch].hrir_coeff_cur;
// Push new sample
buf[f->buf_pos] = in[n][ch];
// Interaural time difference (channel delay)
float d = f->itd_cur * (ch == 0 ? +1.0f : -1.0f);
if (d < 0.0f) {
d = 0.0f;
}
int di = d;
float dfrac = d - di;
// HRIR Convolution
float acc = 0.0f;
for (int k = 0; k < HRTF_NUM_TAPS; k++) {
int idx1 = (f->buf_pos - di - k + HRTF_BUFLEN) % HRTF_BUFLEN;
float s = buf[idx1];
// Linear interpolation for fractional part
if (dfrac > 0.0f) {
int idx2 = (idx1 - 1 + HRTF_BUFLEN) % HRTF_BUFLEN;
s = s * (1 - dfrac) + buf[idx2] * dfrac;
}
acc += coeff[k] * s;
}
out[n][ch] = acc;
}
f->buf_pos = (f->buf_pos + 1) % HRTF_BUFLEN;
}
}
#endif