native_audio 0.4.0 → 0.5.1

data/ext/audio/audio.h

@@ -0,0 +1,34 @@
+// ============================================================================
+// audio.h - Shared types, constants, and globals for native_audio
+// ============================================================================
+
+#ifndef NATIVE_AUDIO_H
+#define NATIVE_AUDIO_H
+
+#include "miniaudio.h"
+#include "delay_node.h"
+#include "reverb_node.h"
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+#define MAX_SOUNDS 1024
+#define MAX_CHANNELS 1024
+
+// ============================================================================
+// Globals (defined in audio.c)
+// ============================================================================
+
+extern ma_engine engine;
+extern ma_context context;
+extern ma_sound *sounds[MAX_SOUNDS];
+extern ma_sound *channels[MAX_CHANNELS];
+extern multi_tap_delay_node *delay_nodes[MAX_CHANNELS];
+extern reverb_node *reverb_nodes[MAX_CHANNELS];
+extern int sound_count;
+extern int engine_initialized;
+extern int context_initialized;
+extern int using_null_backend;
+
+#endif // NATIVE_AUDIO_H

data/ext/audio/delay_node.c

@@ -0,0 +1,185 @@
+// ============================================================================
+// delay_node.c - Multi-tap delay node implementation
+// ============================================================================
+
+#include <stdlib.h>
+#include <string.h>
+#include "delay_node.h"
+
+// ============================================================================
+// DSP Callback
+// ============================================================================
+
+static void multi_tap_delay_process(ma_node *pNode, const float **ppFramesIn,
+                                     ma_uint32 *pFrameCountIn, float **ppFramesOut,
+                                     ma_uint32 *pFrameCountOut)
+{
+    multi_tap_delay_node *node = (multi_tap_delay_node *)pNode;
+    const float *pFramesIn = ppFramesIn[0];
+    float *pFramesOut = ppFramesOut[0];
+    ma_uint32 frameCount = *pFrameCountOut;
+    ma_uint32 numChannels = node->channels;
+
+    for (ma_uint32 iFrame = 0; iFrame < frameCount; iFrame++) {
+        for (ma_uint32 iChannel = 0; iChannel < numChannels; iChannel++) {
+            ma_uint32 sampleIndex = iFrame * numChannels + iChannel;
+            float inputSample = pFramesIn[sampleIndex];
+
+            // Write to circular buffer
+            ma_uint32 writeIndex = (node->write_pos * numChannels) + iChannel;
+            node->buffer[writeIndex] = inputSample;
+
+            // Start with dry signal
+            float outputSample = inputSample;
+
+            // Mix in all active taps
+            for (ma_uint32 iTap = 0; iTap < MAX_TAPS_PER_CHANNEL; iTap++) {
+                if (node->taps[iTap].active) {
+                    ma_uint32 delayFrames = node->taps[iTap].delay_frames;
+                    if (delayFrames > 0 && delayFrames <= node->buffer_size) {
+                        ma_uint32 readPos = (node->write_pos + node->buffer_size - delayFrames) % node->buffer_size;
+                        ma_uint32 readIndex = (readPos * numChannels) + iChannel;
+                        outputSample += node->buffer[readIndex] * node->taps[iTap].volume;
+                    }
+                }
+            }
+
+            pFramesOut[sampleIndex] = outputSample;
+        }
+
+        // Advance write position
+        node->write_pos = (node->write_pos + 1) % node->buffer_size;
+    }
+}
+
+static ma_node_vtable g_multi_tap_delay_vtable = {
+    multi_tap_delay_process,
+    NULL,  // onGetRequiredInputFrameCount
+    1,     // inputBusCount
+    1,     // outputBusCount
+    0      // flags
+};
+
+// ============================================================================
+// Lifecycle
+// ============================================================================
+
+ma_result multi_tap_delay_init(multi_tap_delay_node *pNode, ma_node_graph *pNodeGraph,
+                                ma_uint32 sampleRate, ma_uint32 numChannels)
+{
+    if (pNode == NULL) {
+        return MA_INVALID_ARGS;
+    }
+
+    memset(pNode, 0, sizeof(*pNode));
+
+    pNode->sample_rate = sampleRate;
+    pNode->channels = numChannels;
+    pNode->buffer_size = (ma_uint32)(sampleRate * MAX_DELAY_SECONDS);
+    pNode->write_pos = 0;
+    pNode->tap_count = 0;
+
+    // Allocate circular buffer (frames * channels)
+    pNode->buffer = (float *)calloc(pNode->buffer_size * numChannels, sizeof(float));
+    if (pNode->buffer == NULL) {
+        return MA_OUT_OF_MEMORY;
+    }
+
+    // Initialize all taps as inactive
+    for (int i = 0; i < MAX_TAPS_PER_CHANNEL; i++) {
+        pNode->taps[i].active = MA_FALSE;
+        pNode->taps[i].delay_frames = 0;
+        pNode->taps[i].volume = 0.0f;
+    }
+
+    // Set up node configuration
+    ma_uint32 channelsArray[1] = { numChannels };
+    ma_node_config nodeConfig = ma_node_config_init();
+    nodeConfig.vtable = &g_multi_tap_delay_vtable;
+    nodeConfig.pInputChannels = channelsArray;
+    nodeConfig.pOutputChannels = channelsArray;
+
+    return ma_node_init(pNodeGraph, &nodeConfig, NULL, &pNode->base);
+}
+
+void multi_tap_delay_uninit(multi_tap_delay_node *pNode)
+{
+    if (pNode == NULL) {
+        return;
+    }
+
+    ma_node_uninit(&pNode->base, NULL);
+
+    if (pNode->buffer != NULL) {
+        free(pNode->buffer);
+        pNode->buffer = NULL;
+    }
+}
+
+// ============================================================================
+// Tap Management
+// ============================================================================
+
+int multi_tap_delay_add_tap(multi_tap_delay_node *pNode, float time_ms, float volume)
+{
+    if (pNode == NULL) {
+        return -1;
+    }
+
+    // Find first inactive tap slot
+    for (int i = 0; i < MAX_TAPS_PER_CHANNEL; i++) {
+        if (!pNode->taps[i].active) {
+            ma_uint32 delayFrames = (ma_uint32)((time_ms / 1000.0f) * pNode->sample_rate);
+            if (delayFrames > pNode->buffer_size) {
+                delayFrames = pNode->buffer_size;
+            }
+            pNode->taps[i].delay_frames = delayFrames;
+            pNode->taps[i].volume = volume;
+            pNode->taps[i].active = MA_TRUE;
+            pNode->tap_count++;
+            return i;
+        }
+    }
+
+    return -1;  // No slots available
+}
+
+void multi_tap_delay_remove_tap(multi_tap_delay_node *pNode, int tap_id)
+{
+    if (pNode == NULL || tap_id < 0 || tap_id >= MAX_TAPS_PER_CHANNEL) {
+        return;
+    }
+
+    if (pNode->taps[tap_id].active) {
+        pNode->taps[tap_id].active = MA_FALSE;
+        pNode->taps[tap_id].delay_frames = 0;
+        pNode->taps[tap_id].volume = 0.0f;
+        pNode->tap_count--;
+    }
+}
+
+void multi_tap_delay_set_volume(multi_tap_delay_node *pNode, int tap_id, float volume)
+{
+    if (pNode == NULL || tap_id < 0 || tap_id >= MAX_TAPS_PER_CHANNEL) {
+        return;
+    }
+
+    if (pNode->taps[tap_id].active) {
+        pNode->taps[tap_id].volume = volume;
+    }
+}
+
+void multi_tap_delay_set_time(multi_tap_delay_node *pNode, int tap_id, float time_ms)
+{
+    if (pNode == NULL || tap_id < 0 || tap_id >= MAX_TAPS_PER_CHANNEL) {
+        return;
+    }
+
+    if (pNode->taps[tap_id].active) {
+        ma_uint32 delayFrames = (ma_uint32)((time_ms / 1000.0f) * pNode->sample_rate);
+        if (delayFrames > pNode->buffer_size) {
+            delayFrames = pNode->buffer_size;
+        }
+        pNode->taps[tap_id].delay_frames = delayFrames;
+    }
+}

data/ext/audio/delay_node.h

@@ -0,0 +1,51 @@
+// ============================================================================
+// delay_node.h - Multi-tap delay node for native_audio
+// ============================================================================
+
+#ifndef DELAY_NODE_H
+#define DELAY_NODE_H
+
+#include "miniaudio.h"
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+#define MAX_TAPS_PER_CHANNEL 16
+#define MAX_DELAY_SECONDS 2.0f
+
+// ============================================================================
+// Types
+// ============================================================================
+
+typedef struct {
+    ma_uint32 delay_frames;
+    float volume;
+    ma_bool32 active;
+} delay_tap;
+
+typedef struct {
+    ma_node_base base;
+    float *buffer;
+    ma_uint32 buffer_size;      // Size in frames
+    ma_uint32 write_pos;
+    ma_uint32 channels;         // Audio channels (stereo = 2)
+    delay_tap taps[MAX_TAPS_PER_CHANNEL];
+    ma_uint32 tap_count;
+    ma_uint32 sample_rate;
+} multi_tap_delay_node;
+
+// ============================================================================
+// Public API
+// ============================================================================
+
+ma_result multi_tap_delay_init(multi_tap_delay_node *pNode, ma_node_graph *pNodeGraph,
+                                ma_uint32 sampleRate, ma_uint32 numChannels);
+void multi_tap_delay_uninit(multi_tap_delay_node *pNode);
+
+int multi_tap_delay_add_tap(multi_tap_delay_node *pNode, float time_ms, float volume);
+void multi_tap_delay_remove_tap(multi_tap_delay_node *pNode, int tap_id);
+void multi_tap_delay_set_volume(multi_tap_delay_node *pNode, int tap_id, float volume);
+void multi_tap_delay_set_time(multi_tap_delay_node *pNode, int tap_id, float time_ms);
+
+#endif // DELAY_NODE_H

data/ext/audio/reverb_node.c

@@ -0,0 +1,224 @@
+// ============================================================================
+// reverb_node.c - Schroeder reverb node implementation
+// ============================================================================
+
+#include <stdlib.h>
+#include <string.h>
+#include "reverb_node.h"
+
+// ============================================================================
+// Delay Line Helpers
+// ============================================================================
+
+// Base delay times in seconds (Schroeder-style, prime-ish ratios)
+static const float COMB_DELAYS[NUM_COMBS] = { 0.0297f, 0.0371f, 0.0411f, 0.0437f };
+static const float ALLPASS_DELAYS[NUM_ALLPASSES] = { 0.005f, 0.0017f };
+
+static void delay_line_init(delay_line *dl, ma_uint32 size)
+{
+    dl->size = size;
+    dl->pos = 0;
+    dl->buffer = (float *)calloc(size, sizeof(float));
+}
+
+static void delay_line_free(delay_line *dl)
+{
+    if (dl->buffer) {
+        free(dl->buffer);
+        dl->buffer = NULL;
+    }
+}
+
+static inline float delay_line_read(delay_line *dl)
+{
+    return dl->buffer[dl->pos];
+}
+
+static inline void delay_line_write(delay_line *dl, float value)
+{
+    dl->buffer[dl->pos] = value;
+    dl->pos = (dl->pos + 1) % dl->size;
+}
+
+// ============================================================================
+// Filter Processing
+// ============================================================================
+
+// Comb filter: output = buffer[pos], then write input + feedback * output (with damping)
+static inline float comb_process(delay_line *dl, float input, float feedback,
+                                  float damp, float *damp_prev)
+{
+    float output = delay_line_read(dl);
+    // Low-pass filter on feedback for damping (high freq decay faster)
+    *damp_prev = output * (1.0f - damp) + (*damp_prev) * damp;
+    delay_line_write(dl, input + feedback * (*damp_prev));
+    return output;
+}
+
+// Allpass filter: output = -g*input + buffer[pos], write input + g*buffer[pos]
+static inline float allpass_process(delay_line *dl, float input, float feedback)
+{
+    float buffered = delay_line_read(dl);
+    float output = buffered - feedback * input;
+    delay_line_write(dl, input + feedback * buffered);
+    return output;
+}
+
+// ============================================================================
+// DSP Callback
+// ============================================================================
+
+static void reverb_process(ma_node *pNode, const float **ppFramesIn,
+                           ma_uint32 *pFrameCountIn, float **ppFramesOut,
+                           ma_uint32 *pFrameCountOut)
+{
+    reverb_node *node = (reverb_node *)pNode;
+    const float *pFramesIn = ppFramesIn[0];
+    float *pFramesOut = ppFramesOut[0];
+    ma_uint32 frameCount = *pFrameCountOut;
+    ma_uint32 numChannels = node->channels;
+
+    if (!node->enabled) {
+        // Bypass: copy input to output
+        memcpy(pFramesOut, pFramesIn, frameCount * numChannels * sizeof(float));
+        return;
+    }
+
+    for (ma_uint32 iFrame = 0; iFrame < frameCount; iFrame++) {
+        for (ma_uint32 iChannel = 0; iChannel < numChannels && iChannel < 2; iChannel++) {
+            ma_uint32 sampleIndex = iFrame * numChannels + iChannel;
+            float input = pFramesIn[sampleIndex];
+
+            // Sum of parallel comb filters
+            float combSum = 0.0f;
+            for (int c = 0; c < NUM_COMBS; c++) {
+                combSum += comb_process(&node->combs[iChannel][c], input,
+                                        node->comb_feedback, node->comb_damp,
+                                        &node->comb_damp_prev[iChannel][c]);
+            }
+            combSum *= 0.25f;  // Average the 4 combs
+
+            // Series allpass filters
+            float allpassOut = combSum;
+            for (int a = 0; a < NUM_ALLPASSES; a++) {
+                allpassOut = allpass_process(&node->allpasses[iChannel][a],
+                                             allpassOut, node->allpass_feedback);
+            }
+
+            // Mix dry and wet
+            pFramesOut[sampleIndex] = input * node->dry + allpassOut * node->wet;
+        }
+
+        // Handle mono->stereo or more channels by copying
+        for (ma_uint32 iChannel = 2; iChannel < numChannels; iChannel++) {
+            ma_uint32 sampleIndex = iFrame * numChannels + iChannel;
+            pFramesOut[sampleIndex] = pFramesIn[sampleIndex];
+        }
+    }
+}
+
+static ma_node_vtable g_reverb_vtable = {
+    reverb_process,
+    NULL,
+    1,
+    1,
+    0
+};
+
+// ============================================================================
+// Lifecycle
+// ============================================================================
+
+ma_result reverb_init(reverb_node *pNode, ma_node_graph *pNodeGraph,
+                      ma_uint32 sampleRate, ma_uint32 numChannels)
+{
+    if (pNode == NULL) {
+        return MA_INVALID_ARGS;
+    }
+
+    memset(pNode, 0, sizeof(*pNode));
+    pNode->sample_rate = sampleRate;
+    pNode->channels = numChannels;
+    pNode->enabled = MA_FALSE;
+
+    // Default parameters
+    pNode->room_size = 0.5f;
+    pNode->comb_feedback = 0.7f;
+    pNode->comb_damp = 0.3f;
+    pNode->allpass_feedback = 0.5f;
+    pNode->wet = 0.3f;
+    pNode->dry = 1.0f;
+
+    // Initialize delay lines for up to 2 audio channels
+    ma_uint32 chans = numChannels < 2 ? numChannels : 2;
+    for (ma_uint32 ch = 0; ch < chans; ch++) {
+        for (int c = 0; c < NUM_COMBS; c++) {
+            ma_uint32 delaySize = (ma_uint32)(COMB_DELAYS[c] * pNode->room_size * 2.0f * sampleRate);
+            if (delaySize < 1) delaySize = 1;
+            delay_line_init(&pNode->combs[ch][c], delaySize);
+        }
+        for (int a = 0; a < NUM_ALLPASSES; a++) {
+            ma_uint32 delaySize = (ma_uint32)(ALLPASS_DELAYS[a] * sampleRate);
+            if (delaySize < 1) delaySize = 1;
+            delay_line_init(&pNode->allpasses[ch][a], delaySize);
+        }
+    }
+
+    // Set up node
+    ma_uint32 channelsArray[1] = { numChannels };
+    ma_node_config nodeConfig = ma_node_config_init();
+    nodeConfig.vtable = &g_reverb_vtable;
+    nodeConfig.pInputChannels = channelsArray;
+    nodeConfig.pOutputChannels = channelsArray;
+
+    return ma_node_init(pNodeGraph, &nodeConfig, NULL, &pNode->base);
+}
+
+void reverb_uninit(reverb_node *pNode)
+{
+    if (pNode == NULL) return;
+
+    ma_node_uninit(&pNode->base, NULL);
+
+    for (int ch = 0; ch < 2; ch++) {
+        for (int c = 0; c < NUM_COMBS; c++) {
+            delay_line_free(&pNode->combs[ch][c]);
+        }
+        for (int a = 0; a < NUM_ALLPASSES; a++) {
+            delay_line_free(&pNode->allpasses[ch][a]);
+        }
+    }
+}
+
+// ============================================================================
+// Parameter Control
+// ============================================================================
+
+void reverb_set_enabled(reverb_node *pNode, ma_bool32 enabled)
+{
+    if (pNode) pNode->enabled = enabled;
+}
+
+void reverb_set_room_size(reverb_node *pNode, float size)
+{
+    if (pNode == NULL) return;
+    pNode->room_size = size;
+    // Note: changing room_size after init would require reallocating buffers
+    // For now, this affects feedback calculation
+    pNode->comb_feedback = 0.6f + size * 0.35f;  // 0.6 to 0.95
+}
+
+void reverb_set_damping(reverb_node *pNode, float damp)
+{
+    if (pNode) pNode->comb_damp = damp;
+}
+
+void reverb_set_wet(reverb_node *pNode, float wet)
+{
+    if (pNode) pNode->wet = wet;
+}
+
+void reverb_set_dry(reverb_node *pNode, float dry)
+{
+    if (pNode) pNode->dry = dry;
+}

data/ext/audio/reverb_node.h

@@ -0,0 +1,63 @@
+// ============================================================================
+// reverb_node.h - Schroeder reverb node for native_audio
+// ============================================================================
+
+#ifndef REVERB_NODE_H
+#define REVERB_NODE_H
+
+#include "miniaudio.h"
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+#define NUM_COMBS 4
+#define NUM_ALLPASSES 2
+
+// ============================================================================
+// Types
+// ============================================================================
+
+typedef struct {
+    float *buffer;
+    ma_uint32 size;
+    ma_uint32 pos;
+} delay_line;
+
+typedef struct {
+    ma_node_base base;
+    ma_uint32 channels;
+    ma_uint32 sample_rate;
+
+    // 4 parallel comb filters per audio channel
+    delay_line combs[2][NUM_COMBS];  // [audio_channel][comb_index]
+    float comb_feedback;
+    float comb_damp;
+    float comb_damp_prev[2][NUM_COMBS];
+
+    // 2 series allpass filters per audio channel
+    delay_line allpasses[2][NUM_ALLPASSES];
+    float allpass_feedback;
+
+    // Mix control
+    float wet;
+    float dry;
+    float room_size;
+    ma_bool32 enabled;
+} reverb_node;
+
+// ============================================================================
+// Public API
+// ============================================================================
+
+ma_result reverb_init(reverb_node *pNode, ma_node_graph *pNodeGraph,
+                      ma_uint32 sampleRate, ma_uint32 numChannels);
+void reverb_uninit(reverb_node *pNode);
+
+void reverb_set_enabled(reverb_node *pNode, ma_bool32 enabled);
+void reverb_set_room_size(reverb_node *pNode, float size);
+void reverb_set_damping(reverb_node *pNode, float damp);
+void reverb_set_wet(reverb_node *pNode, float wet);
+void reverb_set_dry(reverb_node *pNode, float dry);
+
+#endif // REVERB_NODE_H

data/lib/dummy_audio.rb

@@ -4,6 +4,7 @@
 # Has the same interface as the Audio C extension but does nothing.
 module DummyAudio
   @sound_count = 0
+  @tap_counts = {}
 
   def self.init
     nil
@@ -20,6 +21,7 @@ module DummyAudio
   end
 
   def self.play(channel, clip)
+    @tap_counts[channel] = 0
     channel
   end
 
@@ -46,4 +48,47 @@ module DummyAudio
   def self.set_pos(channel, angle, distance)
     nil
   end
+
+  def self.set_looping(channel, looping)
+    nil
+  end
+
+  def self.add_delay_tap(channel, time_ms, volume)
+    @tap_counts[channel] ||= 0
+    tap_id = @tap_counts[channel]
+    @tap_counts[channel] += 1
+    tap_id
+  end
+
+  def self.remove_delay_tap(channel, tap_id)
+    nil
+  end
+
+  def self.set_delay_tap_volume(channel, tap_id, volume)
+    nil
+  end
+
+  def self.set_delay_tap_time(channel, tap_id, time_ms)
+    nil
+  end
+
+  def self.enable_reverb(channel, enabled)
+    nil
+  end
+
+  def self.set_reverb_room_size(channel, size)
+    nil
+  end
+
+  def self.set_reverb_damping(channel, damp)
+    nil
+  end
+
+  def self.set_reverb_wet(channel, wet)
+    nil
+  end
+
+  def self.set_reverb_dry(channel, dry)
+    nil
+  end
 end