/* * melisma - extensible and scriptable audio engine * Copyright (C) 2026 Ludvig Gunne Lindström * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program 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 General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #include #include #include #include #include "melisma.h" #include "mutil.h" #define LOWPASS_TYPENAME "biquad LPF" #define LOWPASS_DEFAULT_CUTOFF 4000 #define LOWPASS_DEFAULT_RESONANCE 0.5 struct biquad; typedef void (*recomp_fn)(struct biquad*); struct biquad { ml_channel *out; recomp_fn recomp; double x_1,x_2,y_1,y_2; double xc_0,xc_1,xc_2; double yc_1,yc_2; double Fs; double f0; double Q; }; static inline void lowpass_recomp(struct biquad *bq) { double w0,cosw0,sinw0,alpha,b0,b1,b2,a0,a1,a2; w0 = 2*M_PI*bq->f0/bq->Fs; cosw0 = cos(w0); sinw0 = sin(w0); alpha = sinw0/(2*bq->Q); b0 = (1 - cosw0)/2; b1 = 1 - cosw0; b2 = (1 - cosw0)/2; a0 = 1 + alpha; a1 = -2*cosw0; a2 = 1 - alpha; bq->xc_0 = b0/a0; bq->xc_1 = b1/a0; bq->xc_2 = b2/a0; bq->yc_1 = a1/a0; bq->yc_2 = a2/a0; } static void proc(const ml_proc_args *args) { struct biquad bq = *(struct biquad*) args->userp; float *x = args->in[0]; float *y = args->out[0]; for (size_t i = 0; i < args->nframes; i++) { y[i] = bq.xc_0*x[i] + bq.xc_1*bq.x_1 + bq.xc_2*bq.x_2 - bq.yc_1*bq.y_1 - bq.yc_2*bq.y_2; bq.x_2 = bq.x_1; bq.x_1 = x[i]; bq.y_2 = bq.y_1; bq.y_1 = y[i]; } *(struct biquad*) args->userp = bq; } static int l_lowpass_init(lua_State *s) { ml_channel *src = mutil_get_channel(s,1); struct biquad *bq = calloc(1,sizeof(*bq)); bq->recomp = lowpass_recomp; bq->Fs = ml_sample_rate(); bq->f0 = LOWPASS_DEFAULT_CUTOFF; bq->Q = LOWPASS_DEFAULT_RESONANCE; bq->recomp(bq); ml_node *node = ml_create_node(proc,bq); ml_label_node(node,"lowpass"); ml_channel *dst = ml_add_input(node); ml_connect(src,dst); bq->out = ml_add_output(node); *(void**) lua_newuserdata(s,sizeof(void*)) = bq; luaL_setmetatable(s,LOWPASS_TYPENAME); return 1; } static int l_lowpass_resonance(lua_State *s) { struct biquad *bq = *(void**) luaL_checkudata(s,1,LOWPASS_TYPENAME); bq->Q = luaL_checknumber(s,2); bq->recomp(bq); *(void**) lua_newuserdata(s,sizeof(void*)) = bq; luaL_setmetatable(s,LOWPASS_TYPENAME); return 1; } static int l_lowpass_cutoff(lua_State *s) { struct biquad *bq = *(void**) luaL_checkudata(s,1,LOWPASS_TYPENAME); bq->f0 = luaL_checknumber(s,2); bq->recomp(bq); *(void**) lua_newuserdata(s,sizeof(void*)) = bq; luaL_setmetatable(s,LOWPASS_TYPENAME); return 1; } static int l_lowpass_out(lua_State *s) { struct biquad *bq = *(void**) luaL_checkudata(s,1,LOWPASS_TYPENAME); *(void**) lua_newuserdata(s,sizeof(void*)) = bq->out; luaL_setmetatable(s,MELISMA_OUTPUT_CHANNEL_TYPENAME); return 1; } int luaopen_melisma_biquad(lua_State *s) { /*** Digital biquad filters. @module biquad */ lua_newtable(s); int tbl = lua_gettop(s); /*** Lowpass filter. @type biquad.lowpass @usage local mbiquad = require 'melisma.biquad' local input = ... local lowpass = mbiquad.lowpass.init(node, 2000, 0.6) lowpass:resonance(1000) lowpass:cutoff(0.25) */ lua_newtable(s); int lowpass_tbl = lua_gettop(s); /*** Create a lowpass filter. @static @function init @tparam channel input Input signal. @treturn biquad.lowpass The newly created lowpass filter. */ lua_pushcfunction(s,l_lowpass_init); lua_setfield(s,lowpass_tbl,"init"); /*** Set filter resonance. @function lowpass:resonance @tparam number res Resonance. */ lua_pushcfunction(s,l_lowpass_resonance); lua_setfield(s,lowpass_tbl,"resonance"); /*** Set filter cutoff frequency. @function lowpass:cutoff @tparam number cut Cutoff frequency. */ lua_pushcfunction(s,l_lowpass_cutoff); lua_setfield(s,lowpass_tbl,"cutoff"); lua_pushcfunction(s,l_lowpass_out); lua_setfield(s,lowpass_tbl,MUTIL_OUTPUT_CHANNEL_FUNCTION); luaL_newmetatable(s,LOWPASS_TYPENAME); int lowpass_mt = lua_gettop(s); lua_pushvalue(s,lowpass_tbl); lua_setfield(s,lowpass_mt,"__index"); lua_pushvalue(s,lowpass_tbl); lua_setfield(s,tbl,"lowpass"); lua_settop(s,tbl); return 1; }