native_audio 0.3.0 → 0.5.0

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

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+# Dummy audio backend for CI/testing environments without audio hardware.
+# Has the same interface as the Audio C extension but does nothing.
+module DummyAudio
+  @sound_count = 0
+  @tap_counts = {}
+
+  def self.init
+    nil
+  end
+
+  def self.load(path)
+    id = @sound_count
+    @sound_count += 1
+    id
+  end
+
+  def self.duration(clip)
+    5.0
+  end
+
+  def self.play(channel, clip)
+    @tap_counts[channel] = 0
+    channel
+  end
+
+  def self.stop(channel)
+    nil
+  end
+
+  def self.pause(channel)
+    nil
+  end
+
+  def self.resume(channel)
+    nil
+  end
+
+  def self.set_volume(channel, volume)
+    nil
+  end
+
+  def self.set_pitch(channel, pitch)
+    nil
+  end
+
+  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

data/lib/native_audio.rb

@@ -1,46 +1,117 @@
 # frozen_string_literal: true
 
 require_relative './audio'
+require_relative './dummy_audio'
+
+Audio.init unless ENV['DUMMY_AUDIO_BACKEND'] == 'true'
 
 module NativeAudio
+  def self.audio_driver
+    ENV['DUMMY_AUDIO_BACKEND'] == 'true' ? DummyAudio : Audio
+  end
+
   class Clip
     attr_reader :clip
 
     def initialize(path)
       @path = path
-      @clip = Audio.load(path)
+      @clip = NativeAudio.audio_driver.load(path)
+    end
+
+    def duration
+      NativeAudio.audio_driver.duration(@clip)
+    end
+  end
+
+  class DelayTap
+    attr_reader :id, :audio_source, :time_ms, :volume
+
+    def initialize(audio_source, id, time_ms, volume)
+      @audio_source = audio_source
+      @id = id
+      @time_ms = time_ms
+      @volume = volume
+    end
+
+    def volume=(val)
+      NativeAudio.audio_driver.set_delay_tap_volume(@audio_source.channel, @id, val)
+      @volume = val
+    end
+
+    def time_ms=(val)
+      NativeAudio.audio_driver.set_delay_tap_time(@audio_source.channel, @id, val)
+      @time_ms = val
+    end
+
+    def remove
+      NativeAudio.audio_driver.remove_delay_tap(@audio_source.channel, @id)
+      @audio_source.delay_taps.delete(self)
     end
   end
 
   class AudioSource
+    attr_reader :channel
+
     def initialize(clip)
       @clip = clip
       @channel = AudioSource.channels.count
+      @delay_taps = []
       AudioSource.channels << self
     end
 
     def play
-      Audio.play(@channel, @clip.clip)
+      NativeAudio.audio_driver.play(@channel, @clip.clip)
     end
 
     def stop
-      Audio.stop(@channel)
+      NativeAudio.audio_driver.stop(@channel)
     end
 
     def pause
-      Audio.pause(@channel)
+      NativeAudio.audio_driver.pause(@channel)
     end
 
     def resume
-      Audio.resume(@channel)
+      NativeAudio.audio_driver.resume(@channel)
     end
 
     def set_pos(angle, distance)
-      Audio.set_pos(@channel, angle, distance)
+      NativeAudio.audio_driver.set_pos(@channel, angle, distance)
     end
 
     def set_volume(volume)
-      Audio.set_volume(@channel, volume)
+      NativeAudio.audio_driver.set_volume(@channel, volume)
+    end
+
+    def set_pitch(pitch)
+      NativeAudio.audio_driver.set_pitch(@channel, pitch)
+    end
+
+    def set_looping(looping)
+      NativeAudio.audio_driver.set_looping(@channel, looping)
+    end
+
+    def add_delay_tap(time_ms:, volume:)
+      tap_id = NativeAudio.audio_driver.add_delay_tap(@channel, time_ms, volume)
+      tap = DelayTap.new(self, tap_id, time_ms, volume)
+      @delay_taps << tap
+      tap
+    end
+
+    def enable_reverb(enabled = true)
+      NativeAudio.audio_driver.enable_reverb(@channel, enabled)
+    end
+
+    def set_reverb(room_size: 0.5, damping: 0.3, wet: 0.3, dry: 1.0)
+      NativeAudio.audio_driver.enable_reverb(@channel, true)
+      NativeAudio.audio_driver.set_reverb_room_size(@channel, room_size)
+      NativeAudio.audio_driver.set_reverb_damping(@channel, damping)
+      NativeAudio.audio_driver.set_reverb_wet(@channel, wet)
+      NativeAudio.audio_driver.set_reverb_dry(@channel, dry)
+    end
+
+    def delay_taps
+      @delay_taps
     end
 
     def self.channels

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: native_audio
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Max Hatfull
 bindir: bin
 cert_chain: []
-date: 2026-01-26 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: A simple audio library for Ruby
 email:
@@ -17,137 +17,17 @@ extensions:
 - ext/audio/extconf.rb
 extra_rdoc_files: []
 files:
-- assets/include/SDL2/SDL.h
-- assets/include/SDL2/SDL_assert.h
-- assets/include/SDL2/SDL_atomic.h
-- assets/include/SDL2/SDL_audio.h
-- assets/include/SDL2/SDL_bits.h
-- assets/include/SDL2/SDL_blendmode.h
-- assets/include/SDL2/SDL_clipboard.h
-- assets/include/SDL2/SDL_config.h
-- assets/include/SDL2/SDL_config_android.h
-- assets/include/SDL2/SDL_config_emscripten.h
-- assets/include/SDL2/SDL_config_iphoneos.h
-- assets/include/SDL2/SDL_config_macosx.h
-- assets/include/SDL2/SDL_config_minimal.h
-- assets/include/SDL2/SDL_config_ngage.h
-- assets/include/SDL2/SDL_config_os2.h
-- assets/include/SDL2/SDL_config_pandora.h
-- assets/include/SDL2/SDL_config_windows.h
-- assets/include/SDL2/SDL_config_wingdk.h
-- assets/include/SDL2/SDL_config_winrt.h
-- assets/include/SDL2/SDL_config_xbox.h
-- assets/include/SDL2/SDL_copying.h
-- assets/include/SDL2/SDL_cpuinfo.h
-- assets/include/SDL2/SDL_egl.h
-- assets/include/SDL2/SDL_endian.h
-- assets/include/SDL2/SDL_error.h
-- assets/include/SDL2/SDL_events.h
-- assets/include/SDL2/SDL_filesystem.h
-- assets/include/SDL2/SDL_gamecontroller.h
-- assets/include/SDL2/SDL_gesture.h
-- assets/include/SDL2/SDL_guid.h
-- assets/include/SDL2/SDL_haptic.h
-- assets/include/SDL2/SDL_hidapi.h
-- assets/include/SDL2/SDL_hints.h
-- assets/include/SDL2/SDL_image.h
-- assets/include/SDL2/SDL_joystick.h
-- assets/include/SDL2/SDL_keyboard.h
-- assets/include/SDL2/SDL_keycode.h
-- assets/include/SDL2/SDL_loadso.h
-- assets/include/SDL2/SDL_locale.h
-- assets/include/SDL2/SDL_log.h
-- assets/include/SDL2/SDL_main.h
-- assets/include/SDL2/SDL_messagebox.h
-- assets/include/SDL2/SDL_metal.h
-- assets/include/SDL2/SDL_misc.h
-- assets/include/SDL2/SDL_mixer.h
-- assets/include/SDL2/SDL_mouse.h
-- assets/include/SDL2/SDL_mutex.h
-- assets/include/SDL2/SDL_name.h
-- assets/include/SDL2/SDL_opengl.h
-- assets/include/SDL2/SDL_opengl_glext.h
-- assets/include/SDL2/SDL_opengles.h
-- assets/include/SDL2/SDL_opengles2.h
-- assets/include/SDL2/SDL_opengles2_gl2.h
-- assets/include/SDL2/SDL_opengles2_gl2ext.h
-- assets/include/SDL2/SDL_opengles2_gl2platform.h
-- assets/include/SDL2/SDL_opengles2_khrplatform.h
-- assets/include/SDL2/SDL_pixels.h
-- assets/include/SDL2/SDL_platform.h
-- assets/include/SDL2/SDL_power.h
-- assets/include/SDL2/SDL_quit.h
-- assets/include/SDL2/SDL_rect.h
-- assets/include/SDL2/SDL_render.h
-- assets/include/SDL2/SDL_revision.h
-- assets/include/SDL2/SDL_rwops.h
-- assets/include/SDL2/SDL_scancode.h
-- assets/include/SDL2/SDL_sensor.h
-- assets/include/SDL2/SDL_shape.h
-- assets/include/SDL2/SDL_stdinc.h
-- assets/include/SDL2/SDL_surface.h
-- assets/include/SDL2/SDL_system.h
-- assets/include/SDL2/SDL_syswm.h
-- assets/include/SDL2/SDL_test.h
-- assets/include/SDL2/SDL_test_assert.h
-- assets/include/SDL2/SDL_test_common.h
-- assets/include/SDL2/SDL_test_compare.h
-- assets/include/SDL2/SDL_test_crc32.h
-- assets/include/SDL2/SDL_test_font.h
-- assets/include/SDL2/SDL_test_fuzzer.h
-- assets/include/SDL2/SDL_test_harness.h
-- assets/include/SDL2/SDL_test_images.h
-- assets/include/SDL2/SDL_test_log.h
-- assets/include/SDL2/SDL_test_md5.h
-- assets/include/SDL2/SDL_test_memory.h
-- assets/include/SDL2/SDL_test_random.h
-- assets/include/SDL2/SDL_thread.h
-- assets/include/SDL2/SDL_timer.h
-- assets/include/SDL2/SDL_touch.h
-- assets/include/SDL2/SDL_ttf.h
-- assets/include/SDL2/SDL_types.h
-- assets/include/SDL2/SDL_version.h
-- assets/include/SDL2/SDL_video.h
-- assets/include/SDL2/SDL_vulkan.h
-- assets/include/SDL2/begin_code.h
-- assets/include/SDL2/close_code.h
-- assets/macos/universal/lib/libFLAC.a
-- assets/macos/universal/lib/libSDL2.a
-- assets/macos/universal/lib/libSDL2_mixer.a
-- assets/macos/universal/lib/libmodplug.a
-- assets/macos/universal/lib/libmpg123.a
-- assets/macos/universal/lib/libogg.a
-- assets/macos/universal/lib/libvorbis.a
-- assets/macos/universal/lib/libvorbisfile.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libFLAC.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libSDL2.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libSDL2_mixer.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libmodplug.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libmpg123.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libogg.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libopus.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libopusfile.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libsndfile.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libstdc++.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libvorbis.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libvorbisfile.a
-- assets/windows/mingw-w64-ucrt-x86_64/lib/libz.a
-- assets/windows/mingw-w64-x86_64/lib/libFLAC.a
-- assets/windows/mingw-w64-x86_64/lib/libSDL2.a
-- assets/windows/mingw-w64-x86_64/lib/libSDL2_mixer.a
-- assets/windows/mingw-w64-x86_64/lib/libmodplug.a
-- assets/windows/mingw-w64-x86_64/lib/libmpg123.a
-- assets/windows/mingw-w64-x86_64/lib/libogg.a
-- assets/windows/mingw-w64-x86_64/lib/libopus.a
-- assets/windows/mingw-w64-x86_64/lib/libopusfile.a
-- assets/windows/mingw-w64-x86_64/lib/libsndfile.a
-- assets/windows/mingw-w64-x86_64/lib/libstdc++.a
-- assets/windows/mingw-w64-x86_64/lib/libvorbis.a
-- assets/windows/mingw-w64-x86_64/lib/libvorbisfile.a
-- assets/windows/mingw-w64-x86_64/lib/libz.a
+- LICENSE
+- README.md
 - ext/audio/audio.c
-- ext/audio/extconf.h
+- ext/audio/audio.h
+- ext/audio/delay_node.c
+- ext/audio/delay_node.h
 - ext/audio/extconf.rb
+- ext/audio/miniaudio.h
+- ext/audio/reverb_node.c
+- ext/audio/reverb_node.h
+- lib/dummy_audio.rb
 - lib/native_audio.rb
 homepage: https://github.com/rubyrpg/native_audio
 licenses:
@@ -167,7 +47,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.3
 specification_version: 4
 summary: A simple audio library for Ruby
 test_files: []