beeps 0.3.9 → 0.3.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8f411f90d8d0ed9b8672d08b5039799ac6f9178835dac7dc24acccd8c93cc0e
-  data.tar.gz: e7ba8574e7962d3b9de62238f4f42cb897dd0edbecce3d298928acc07f2fe161
+  metadata.gz: 83c3fb3d71043da5eaa1f4f6c9832442f68d9fb9ee765c1d19891306df2ca3da
+  data.tar.gz: 6f80df9fa3ada9ecf150708c9efaf090800044b38c3e694108bfcb2b766ef577
 SHA512:
-  metadata.gz: 4874e8fba3a4e1962853b9ce05454c703065b89c77fa89a286aebbf76bc775c43fb9f6e47c326b9725d005d8f2c680a13ee6981d686836a50e19900ab4c9436e
-  data.tar.gz: f84446b0b666cc6852fc95845e303668c844012208210b647bc71611539972d0d24339113ade1b1903d0df5f2cbc9264ff2d339dfdcf4bccb9ee6e501f6eb163
+  metadata.gz: a94142e5430d65b5d9539b2f9b9d5d92bf13b893cf77c9aa00a3bbe52ec5e3cdca78db410fe4400ee465f3c9d6124201046414059fbc32635540a024c10c0e8d
+  data.tar.gz: 9b1a87a0c216b7cee8afe2bfd2decabb7035c5723449c3f02876336e33cf5c2c36dff5c0f2e0c4e757e4278c3b89f93d51e8489b571893460b665a34dd37b792

data/.doc/ext/beeps/analyser.cpp

@@ -72,8 +72,8 @@ VALUE each_signal(VALUE self, VALUE nsamples_)
 			Value args(2, values);
 			for (uint i = start; i < nsamples; i += 2)
 			{
-				args[0] = value(samples[i + 0]);
-				args[1] = value(samples[i + 1]);
+				args.set(0, value(samples[i + 0]));
+				args.set(1, value(samples[i + 1]));
 				rb_yield(args);
 			}
 			break;

data/.doc/ext/beeps/native.cpp

@@ -9,6 +9,7 @@ void Init_beeps_sound ();
 void Init_beeps_sound_player ();
 void Init_beeps_processor ();
 
+void Init_beeps_value ();
 void Init_beeps_oscillator ();
 void Init_beeps_sequencer ();
 void Init_beeps_file_in ();
@@ -27,11 +28,7 @@ void Init_beeps_analyser ();
 
 
 extern "C" void
-#ifdef COCOAPODS
-	Init_beeps_native ()
-#else
-	Init_native ()
-#endif
+Init_beeps_ext ()
 {
 	RUCY_TRY
 
@@ -45,6 +42,7 @@ extern "C" void
 	Init_beeps_sound_player();
 	Init_beeps_processor();
 
+	Init_beeps_value();
 	Init_beeps_oscillator();
 	Init_beeps_sequencer();
 	Init_beeps_file_in();

data/.doc/ext/beeps/oscillator.cpp

@@ -40,8 +40,8 @@ VALUE set_samples(VALUE self, VALUE samples)
 {
 	CHECK;
 
-	Value* array = samples.as_array();
-	size_t size  = samples.size();
+	const Value* array = samples.as_array();
+	size_t size        = samples.size();
 
 	std::vector<Beeps::Sample> data;
 	data.reserve(size);

data/.doc/ext/beeps/sequencer.cpp

@@ -56,6 +56,22 @@ VALUE get_time_scale(VALUE self)
 	return value(THIS->time_scale());
 }
 
+static
+VALUE each_note(VALUE self)
+{
+	CHECK;
+
+	Value ret;
+	for (auto it = THIS->begin(), end = THIS->end(); it != end; ++it)
+	{
+		ret = rb_yield_values(3,
+			value(it->processor.get()),
+			value(it->offset),
+			value(it->duration));
+	}
+	return ret;
+}
+
 
 static Class cSequencer;
 
@@ -70,6 +86,7 @@ Init_beeps_sequencer ()
 	rb_define_method(cSequencer, "remove", RUBY_METHOD_FUNC(remove), 2);
 	//rb_define_method(cSequencer, "time_scale=", RUBY_METHOD_FUNC(set_time_scale), 1);
 	//rb_define_method(cSequencer, "time_scale", RUBY_METHOD_FUNC(get_time_scale), 0);
+	cSequencer.define_method("each_note!", each_note);
 }
 
 

data/.doc/ext/beeps/value.cpp

@@ -0,0 +1,107 @@
+#include "beeps/ruby/generator.h"
+
+
+#include "beeps/ruby/processor.h"
+#include "defs.h"
+
+
+RUCY_DEFINE_WRAPPER_VALUE_FROM_TO(BEEPS_EXPORT, Beeps::Value)
+
+#define THIS  to<Beeps::Value*>(self)
+
+#define CHECK RUCY_CHECK_OBJ(Beeps::Value, self)
+
+
+static
+VALUE alloc(VALUE klass)
+{
+	return value(new Beeps::RubyProcessor<Beeps::Value>, klass);
+}
+
+static
+VALUE set_type(VALUE self, VALUE type)
+{
+	CHECK;
+
+	THIS->set_type((Beeps::Value::Type) to<uint>(type));
+	return type;
+}
+
+static
+VALUE get_type(VALUE self)
+{
+	CHECK;
+
+	return value(THIS->type());
+}
+
+static
+VALUE set_value(VALUE self, VALUE value)
+{
+	CHECK;
+
+	THIS->set_value(to<float>(value));
+	return value;
+}
+
+static
+VALUE insert(VALUE self, VALUE value, VALUE time)
+{
+	CHECK;
+
+	THIS->insert(to<float>(value), to<float>(time));
+}
+
+static
+VALUE clear(VALUE self)
+{
+	CHECK;
+
+	THIS->clear();
+}
+
+static
+VALUE each_value(VALUE self)
+{
+	CHECK;
+
+	Value ret;
+	for (auto it = THIS->begin(), end = THIS->end(); it != end; ++it)
+		ret = rb_yield_values(2, value(it->value), value(it->time));
+	return ret;
+}
+
+
+static Class cValue;
+
+void
+Init_beeps_value ()
+{
+	Module mBeeps = rb_define_module("Beeps");
+
+	cValue = mBeeps.define_class("Value", Beeps::processor_class());
+	rb_define_alloc_func(cValue, alloc);
+	rb_define_method(cValue, "type=", RUBY_METHOD_FUNC(set_type), 1);
+	rb_define_method(cValue, "type", RUBY_METHOD_FUNC(get_type), 0);
+	rb_define_method(cValue, "value=", RUBY_METHOD_FUNC(set_value), 1);
+	rb_define_method(cValue, "insert", RUBY_METHOD_FUNC(insert), 2);
+	rb_define_method(cValue, "clear", RUBY_METHOD_FUNC(clear), 0);
+	cValue.define_method("each_value!", each_value);
+
+	cValue.define_const("TYPE_NONE", Beeps::Value::TYPE_NONE);
+	cValue.define_const("LINEAR",    Beeps::Value::LINEAR);
+}
+
+
+namespace Beeps
+{
+
+
+	Class
+	value_class ()
+	{
+		return cValue;
+	}
+
+
+}// Beeps

data/CLAUDE.md

@@ -0,0 +1,24 @@
+# Beeps
+
+Audio synthesis and playback library. Provides an audio processing chain with oscillators, filters, envelopes, and effects.
+
+## Processor Chain
+
+Connect processors with the `>>` operator:
+```ruby
+Beeps::Oscillator.new >> Beeps::Gain.new(gain: 0.5)
+```
+
+## External Libraries
+
+Automatically fetched and statically linked at build time:
+- STK 5.0.1 — DSP toolkit
+- AudioFile 1.1.1 — Audio file I/O
+- r8brain-free-src 6.2 — Sample rate conversion
+- signalsmith-stretch — Time stretching
+
+## Platform Dependencies
+
+- macOS: OpenAL, AVFoundation
+- Windows: OpenAL, Media Foundation
+- Linux: libopenal-dev

data/ChangeLog.md

@@ -1,6 +1,15 @@
 # beeps ChangeLog
 
 
+## [v0.3.10] - 2026-04-09
+
+- Add Sequencer#each_note
+- Add 'apt' for install_packages()
+- Add Value processor for time-varying value generation
+- Change C-Extension name from 'native.so' to 'beeps_ext.so'
+- Update dependencies
+
+
 ## [v0.3.9] - 2025-07-06
 
 - Add TextIn class

data/Rakefile

@@ -14,7 +14,9 @@ require 'beeps/extension'
 EXTENSIONS  = [Xot, Rucy, Beeps]
 TESTS_ALONE = ['test/test_beeps_init.rb']
 
-install_packages win32: %w[MINGW_PACKAGE_PREFIX-openal]
+install_packages(
+  mingw: %w[MINGW_PACKAGE_PREFIX-openal],
+  apt:   %w[libopenal-dev])
 
 use_external_library 'https://github.com/thestk/stk',
   tag:      '5.0.1',

data/VERSION

@@ -1 +1 @@
-0.3.9
+0.3.10

data/beeps.gemspec

@@ -25,8 +25,8 @@ Gem::Specification.new do |s|
   s.platform              = Gem::Platform::RUBY
   s.required_ruby_version = '>= 3.0.0'
 
-  s.add_dependency 'xot',  '~> 0.3.9', '>= 0.3.9'
-  s.add_dependency 'rucy', '~> 0.3.9', '>= 0.3.9'
+  s.add_dependency 'xot',  '~> 0.3.10'
+  s.add_dependency 'rucy', '~> 0.3.10'
 
   s.files            = `git ls-files`.split $/
   s.executables      = s.files.grep(%r{^bin/}) {|f| File.basename f}

data/ext/beeps/analyser.cpp

@@ -76,8 +76,8 @@ RUCY_DEF1(each_signal, nsamples_)
 			Value args(2, values);
 			for (uint i = start; i < nsamples; i += 2)
 			{
-				args[0] = value(samples[i + 0]);
-				args[1] = value(samples[i + 1]);
+				args.set(0, value(samples[i + 0]));
+				args.set(1, value(samples[i + 1]));
 				rb_yield(args);
 			}
 			break;

data/ext/beeps/extconf.rb

@@ -13,16 +13,20 @@ Xot::ExtConf.new Xot, Rucy, Beeps do
   setup do
     headers << 'ruby.h'
 
-    if win32?
-      headers    << 'AL/al.h'     << 'AL/alc.h'
-      libs       << 'openal' << 'ole32' << 'mf' << 'mfplat' << 'mfreadwrite' << 'mfuuid'
-    elsif osx?
+    case
+    when osx?
       headers    << 'OpenAL/al.h' << 'OpenAL/alc.h'
       frameworks << 'OpenAL'      << 'AVFoundation'
+    when win32?
+      headers    << 'AL/al.h'     << 'AL/alc.h'
+      libs       << 'openal' << 'ole32' << 'mf' << 'mfplat' << 'mfreadwrite' << 'mfuuid'
+    when linux?
+      headers    << 'AL/al.h'     << 'AL/alc.h'
+      libs       << 'openal'
     end
 
-    $LDFLAGS << ' -Wl,--out-implib=native.dll.a' if mingw? || cygwin?
+    $LDFLAGS << ' -Wl,--out-implib=beeps_ext.dll.a' if mingw? || cygwin?
   end
 
-  create_makefile 'beeps/native'
+  create_makefile 'beeps_ext'
 end

data/ext/beeps/native.cpp

@@ -9,6 +9,7 @@ void Init_beeps_sound ();
 void Init_beeps_sound_player ();
 void Init_beeps_processor ();
 
+void Init_beeps_value ();
 void Init_beeps_oscillator ();
 void Init_beeps_sequencer ();
 void Init_beeps_file_in ();
@@ -27,11 +28,7 @@ void Init_beeps_analyser ();
 
 
 extern "C" void
-#ifdef COCOAPODS
-	Init_beeps_native ()
-#else
-	Init_native ()
-#endif
+Init_beeps_ext ()
 {
 	RUCY_TRY
 
@@ -45,6 +42,7 @@ extern "C" void
 	Init_beeps_sound_player();
 	Init_beeps_processor();
 
+	Init_beeps_value();
 	Init_beeps_oscillator();
 	Init_beeps_sequencer();
 	Init_beeps_file_in();

data/ext/beeps/oscillator.cpp

@@ -43,8 +43,8 @@ RUCY_DEF1(set_samples, samples)
 {
 	CHECK;
 
-	Value* array = samples.as_array();
-	size_t size  = samples.size();
+	const Value* array = samples.as_array();
+	size_t size        = samples.size();
 
 	std::vector<Beeps::Sample> data;
 	data.reserve(size);

data/ext/beeps/sequencer.cpp

@@ -61,6 +61,23 @@ RUCY_DEF0(get_time_scale)
 }
 RUCY_END
 
+static
+RUCY_DEF0(each_note)
+{
+	CHECK;
+
+	Value ret;
+	for (auto it = THIS->begin(), end = THIS->end(); it != end; ++it)
+	{
+		ret = rb_yield_values(3,
+			value(it->processor.get()),
+			value(it->offset),
+			value(it->duration));
+	}
+	return ret;
+}
+RUCY_END
+
 
 static Class cSequencer;
 
@@ -75,6 +92,7 @@ Init_beeps_sequencer ()
 	cSequencer.define_method("remove", remove);
 	//cSequencer.define_method("time_scale=", set_time_scale);
 	//cSequencer.define_method("time_scale",  get_time_scale);
+	cSequencer.define_method("each_note!", each_note);
 }
 
 

data/ext/beeps/value.cpp

@@ -0,0 +1,114 @@
+#include "beeps/ruby/generator.h"
+
+
+#include "beeps/ruby/processor.h"
+#include "defs.h"
+
+
+RUCY_DEFINE_WRAPPER_VALUE_FROM_TO(BEEPS_EXPORT, Beeps::Value)
+
+#define THIS  to<Beeps::Value*>(self)
+
+#define CHECK RUCY_CHECK_OBJ(Beeps::Value, self)
+
+
+static
+RUCY_DEF_ALLOC(alloc, klass)
+{
+	return value(new Beeps::RubyProcessor<Beeps::Value>, klass);
+}
+RUCY_END
+
+static
+RUCY_DEF1(set_type, type)
+{
+	CHECK;
+
+	THIS->set_type((Beeps::Value::Type) to<uint>(type));
+	return type;
+}
+RUCY_END
+
+static
+RUCY_DEF0(get_type)
+{
+	CHECK;
+
+	return value(THIS->type());
+}
+RUCY_END
+
+static
+RUCY_DEF1(set_value, value)
+{
+	CHECK;
+
+	THIS->set_value(to<float>(value));
+	return value;
+}
+RUCY_END
+
+static
+RUCY_DEF2(insert, value, time)
+{
+	CHECK;
+
+	THIS->insert(to<float>(value), to<float>(time));
+}
+RUCY_END
+
+static
+RUCY_DEF0(clear)
+{
+	CHECK;
+
+	THIS->clear();
+}
+RUCY_END
+
+static
+RUCY_DEF0(each_value)
+{
+	CHECK;
+
+	Value ret;
+	for (auto it = THIS->begin(), end = THIS->end(); it != end; ++it)
+		ret = rb_yield_values(2, value(it->value), value(it->time));
+	return ret;
+}
+RUCY_END
+
+
+static Class cValue;
+
+void
+Init_beeps_value ()
+{
+	Module mBeeps = define_module("Beeps");
+
+	cValue = mBeeps.define_class("Value", Beeps::processor_class());
+	cValue.define_alloc_func(alloc);
+	cValue.define_method("type=",  set_type);
+	cValue.define_method("type",   get_type);
+	cValue.define_method("value=", set_value);
+	cValue.define_method("insert", insert);
+	cValue.define_method("clear",  clear);
+	cValue.define_method("each_value!", each_value);
+
+	cValue.define_const("TYPE_NONE", Beeps::Value::TYPE_NONE);
+	cValue.define_const("LINEAR",    Beeps::Value::LINEAR);
+}
+
+
+namespace Beeps
+{
+
+
+	Class
+	value_class ()
+	{
+		return cValue;
+	}
+
+
+}// Beeps

data/include/beeps/generator.h

@@ -4,6 +4,7 @@
 #define __BEEPS_GENERATOR_H__
 
 
+#include <list>
 #include <beeps/processor.h>
 
 
@@ -11,6 +12,72 @@ namespace Beeps
 {
 
 
+	class Value : public Generator
+	{
+
+		typedef Generator Super;
+
+		public:
+
+			enum Type
+			{
+				TYPE_NONE = 0, LINEAR
+			};
+
+			struct Point
+			{
+
+				float value;
+
+				float time;
+
+				Point (float value, float time);
+
+			};// Point
+
+			typedef std::vector<Point> PointList;
+
+			typedef PointList::      iterator       iterator;
+
+			typedef PointList::const_iterator const_iterator;
+
+			Value (float value = 0, Type type = LINEAR);
+
+			virtual ~Value ();
+
+			virtual void set_type (Type type);
+
+			virtual Type     type () const;
+
+			virtual void set_value (float value);
+
+			virtual void insert    (float value, float time);
+
+			virtual void clear ();
+
+			virtual       iterator begin ();
+
+			virtual const_iterator begin () const;
+
+			virtual       iterator end ();
+
+			virtual const_iterator end () const;
+
+			struct Data;
+
+			Xot::PImpl<Data> self;
+
+		private:
+
+			virtual void generate (
+				Context* context, Signals* signals, uint* offset) override;
+
+			virtual int max_segment_size_for_process (
+				double sample_rate, uint nsamples) const override;
+
+	};// Value
+
+
 	class Oscillator : public Generator
 	{
 
@@ -95,6 +162,23 @@ namespace Beeps
 
 		public:
 
+			struct Note
+			{
+
+				Processor::Ref processor;
+
+				float offset, duration;
+
+				Note (Processor* processor, float offset, float duration);
+
+			};// Note
+
+			typedef std::list<Note> NoteList;
+
+			typedef NoteList::      iterator       iterator;
+
+			typedef NoteList::const_iterator const_iterator;
+
 			Sequencer ();
 
 			virtual ~Sequencer ();
@@ -107,6 +191,14 @@ namespace Beeps
 
 			virtual float    time_scale () const;
 
+			virtual       iterator begin ();
+
+			virtual const_iterator begin () const;
+
+			virtual       iterator end ();
+
+			virtual const_iterator end () const;
+
 			virtual operator bool () const override;
 
 			struct Data;

data/include/beeps/ruby/generator.h

@@ -9,6 +9,8 @@
 #include <beeps/generator.h>
 
 
+RUCY_DECLARE_WRAPPER_VALUE_FROM_TO(BEEPS_EXPORT, Beeps::Value)
+
 RUCY_DECLARE_WRAPPER_VALUE_FROM_TO(BEEPS_EXPORT, Beeps::Oscillator)
 
 RUCY_DECLARE_WRAPPER_VALUE_FROM_TO(BEEPS_EXPORT, Beeps::Sequencer)
@@ -24,6 +26,9 @@ namespace Beeps
 {
 
 
+	BEEPS_EXPORT Rucy::Class value_class ();
+	// class Beeps::Value
+
 	BEEPS_EXPORT Rucy::Class oscillator_class ();
 	// class Beeps::Oscillator
 
@@ -47,6 +52,12 @@ namespace Rucy
 {
 
 
+	template <> inline Class
+	get_ruby_class<Beeps::Value> ()
+	{
+		return Beeps::value_class();
+	}
+
 	template <> inline Class
 	get_ruby_class<Beeps::Oscillator> ()
 	{

data/lib/beeps/ext.rb

@@ -1 +1 @@
-require 'beeps/native'
+require 'beeps_ext'

data/lib/beeps/processor.rb

@@ -45,6 +45,32 @@ module Beeps
   end# Processor
 
 
+  class Value
+
+    include Enumerable
+
+    const_symbol_accessor :type, **{
+      none:   TYPE_NONE,
+      linear: LINEAR
+    }
+
+    def initialize(value, type = :linear, **kwargs, &block)
+      super(**kwargs, &block)
+      self.value, self.type = value, type
+    end
+
+    universal_accessor :type
+
+    def each_value(&block)
+      return enum_for :each_value unless block
+      each_value!(&block)
+    end
+
+    alias each each_value
+
+  end# Value
+
+
   class Oscillator
 
     include Enumerable
@@ -74,14 +100,33 @@ module Beeps
     alias freq  frequency
 
     def each_sample(&block)
-      block ? each_sample!(&block) : enum_for(:each_sample!)
+      return enum_for :each_sample unless block
+      each_sample!(&block)
     end
 
     alias each each_sample
 
+    def samples()
+      to_a
+    end
+
   end# Oscillator
 
 
+  class Sequencer
+
+    include Enumerable
+
+    def each_note(&block)
+      return enum_for :each_note unless block
+      each_note!(&block)
+    end
+
+    alias each each_note
+
+  end# Sequencer
+
+
   class FileIn
 
     def initialize(path = nil, **kwargs, &block)

data/src/sdl/beeps.cpp

@@ -0,0 +1,19 @@
+#include "../beeps.h"
+
+
+namespace Beeps
+{
+
+
+	void
+	Beeps_init ()
+	{
+	}
+
+	void
+	Beeps_fin ()
+	{
+	}
+
+
+}// Beeps

data/src/sdl/signals.cpp

@@ -0,0 +1,18 @@
+#include "../signals.h"
+
+
+#include "beeps/exception.h"
+
+
+namespace Beeps
+{
+
+
+	Signals
+	Signals_load (const char* path)
+	{
+		not_implemented_error(__FILE__, __LINE__);
+	}
+
+
+}// Beeps

data/src/sdl/text_in.cpp

@@ -0,0 +1,61 @@
+#include "beeps/generator.h"
+
+
+#include "beeps/exception.h"
+#include "../signals.h"
+
+
+namespace Beeps
+{
+
+
+	struct TextIn::Data
+	{
+
+		double sample_rate = 0;
+
+	};// TextIn::Data
+
+
+	TextIn::TextIn (const char* text, double sample_rate)
+	{
+		if (sample_rate == 0)
+			sample_rate = Beeps::sample_rate();
+		if (sample_rate <= 0)
+			argument_error(__FILE__, __LINE__);
+
+		self->sample_rate = sample_rate;
+
+		if (text) synthesize(text);
+	}
+
+	TextIn::~TextIn ()
+	{
+	}
+
+	void
+	TextIn::synthesize (const char* text)
+	{
+		not_implemented_error(__FILE__, __LINE__);
+	}
+
+	double
+	TextIn::sample_rate () const
+	{
+		return self->sample_rate;
+	}
+
+	TextIn::operator bool () const
+	{
+		if (!Super::operator bool()) return false;
+		return self->sample_rate > 0;
+	}
+
+	void
+	TextIn::generate (Context* context, Signals* signals, uint* offset)
+	{
+		Super::generate(context, signals, offset);
+	}
+
+
+}// Beeps

data/src/sequencer.cpp

@@ -1,7 +1,6 @@
 #include "beeps/generator.h"
 
 
-#include <list>
 #include <algorithm>
 #include "beeps/exception.h"
 #include "beeps/debug.h"
@@ -16,21 +15,7 @@ namespace Beeps
 	struct Sequencer::Data
 	{
 
-		struct Note
-		{
-
-			Processor::Ref processor;
-
-			float offset, duration;
-
-			Note (Processor* processor, float offset, float duration)
-			:	processor(processor), offset(offset), duration(duration)
-			{
-			}
-
-		};// Note
-
-		std::list<Note> notes;
+		NoteList notes;
 
 		float time_scale = 1;
 
@@ -42,6 +27,12 @@ namespace Beeps
 	};// Sequencer::Data
 
 
+	Sequencer::Note::Note (Processor* processor, float offset, float duration)
+	:	processor(processor), offset(offset), duration(duration)
+	{
+	}
+
+
 	Sequencer::Sequencer ()
 	{
 	}
@@ -99,6 +90,30 @@ namespace Beeps
 		return self->time_scale;
 	}
 
+	Sequencer::iterator
+	Sequencer::begin ()
+	{
+		return self->notes.begin();
+	}
+
+	Sequencer::const_iterator
+	Sequencer::begin () const
+	{
+		return self->notes.begin();
+	}
+
+	Sequencer::iterator
+	Sequencer::end ()
+	{
+		return self->notes.end();
+	}
+
+	Sequencer::const_iterator
+	Sequencer::end () const
+	{
+		return self->notes.end();
+	}
+
 	Sequencer::operator bool () const
 	{
 		if (!Super::operator bool()) return false;

data/src/value.cpp

@@ -0,0 +1,181 @@
+#include "beeps/generator.h"
+
+
+#include <algorithm>
+#include "beeps/exception.h"
+#include "processor.h"
+#include "signals.h"
+
+
+namespace Beeps
+{
+
+
+	struct Value::Data
+	{
+
+		Type type = TYPE_NONE;
+
+		PointList points;
+
+	};// Value::Data
+
+
+	Value::Point::Point (float value, float time)
+	:	value(value), time(time)
+	{
+	}
+
+
+	Value::Value (float value, Type type)
+	{
+		self->type = type;
+		set_value(value);
+	}
+
+	Value::~Value ()
+	{
+	}
+
+	void
+	Value::set_type (Type type)
+	{
+		self->type = type;
+
+		set_updated();
+	}
+
+	Value::Type
+	Value::type () const
+	{
+		return self->type;
+	}
+
+	void
+	Value::set_value (float value)
+	{
+		self->points.clear();
+		self->points.push_back(Point(value, 0));
+
+		set_updated();
+	}
+
+	void
+	Value::insert (float value, float time)
+	{
+		if (time < 0)
+			argument_error(__FILE__, __LINE__, "time must be >= 0");
+
+		auto& points = self->points;
+		auto it      = std::find_if(
+			points.begin(), points.end(),
+			[&](const auto& p) {return time <= p.time;});
+		if (it != points.end() && it->time == time)
+		{
+			if (it->value == value) return;
+			it->value = value;
+		}
+		else
+			points.emplace(it, value, time);
+
+		set_updated();
+	}
+
+	void
+	Value::clear ()
+	{
+		self->points.clear();
+
+		set_updated();
+	}
+
+	Value::iterator
+	Value::begin ()
+	{
+		return self->points.begin();
+	}
+
+	Value::const_iterator
+	Value::begin () const
+	{
+		return self->points.begin();
+	}
+
+	Value::iterator
+	Value::end ()
+	{
+		return self->points.end();
+	}
+
+	Value::const_iterator
+	Value::end () const
+	{
+		return self->points.end();
+	}
+
+	static float
+	interpolate_linear (const Value::PointList& points, float time)
+	{
+		if (points.empty())         return 0;
+		if (time <= points[0].time) return points[0].value;
+
+		for (size_t i = 0; i + 1 < points.size(); ++i)
+		{
+			const auto& p0 = points[i];
+			const auto& p1 = points[i + 1];
+			if (time < p1.time)
+			{
+				float t = (time - p0.time) / (p1.time - p0.time);
+				return p0.value + (p1.value - p0.value) * t;
+			}
+		}
+		return points.back().value;
+	}
+
+	static decltype(&interpolate_linear)
+	get_interpolate_func (Value::Type type)
+	{
+		switch (type)
+		{
+			case Value::LINEAR: return interpolate_linear;
+			default:            return NULL;
+		}
+	}
+
+	void
+	Value::generate (Context* context, Signals* signals, uint* offset)
+	{
+		Super::generate(context, signals, offset);
+
+		auto& points  = self->points;
+		uint nsamples = signals->capacity();
+
+		if (points.size() == 1)
+			Signals_fill(signals, nsamples, points[0].value);
+		else
+		{
+			auto interpolate = get_interpolate_func(self->type);
+			if (!interpolate)
+				invalid_state_error(__FILE__, __LINE__);
+
+			double sample_rate = signals->sample_rate();
+			Sample* p          = Signals_at(signals, 0);
+			for (uint i = 0; i < nsamples; ++i)
+				p[i] = interpolate(points, (*offset + i) / sample_rate);
+			Signals_set_nsamples(signals, nsamples);
+		}
+
+		*offset += signals->nsamples();
+	}
+
+	int
+	Value::max_segment_size_for_process (
+		double sample_rate, uint nsamples) const
+	{
+		if (self->points.size() == 1)
+			return Super::max_segment_size_for_process(sample_rate, nsamples);
+		return sample_rate / 256;
+	}
+
+
+}// Beeps

data/test/test_oscillator.rb

@@ -23,12 +23,12 @@ class TestOscillator < Test::Unit::TestCase
   def test_offset()
     assert_in_delta  0, get_samples(10000, osc(offset:  0)).sum / 10000
     assert_in_delta  3, get_samples(10000, osc(offset:  3)).sum / 10000
-    assert_in_delta -3, get_samples(10000, osc(offset: -3)).sum / 10000
+    assert_in_delta(-3, get_samples(10000, osc(offset: -3)).sum / 10000)
   end
 
   def test_gain()
     assert_in_delta  3, get_samples(100, osc(gain: 3)).max
-    assert_in_delta -3, get_samples(100, osc(gain: 3)).min
+    assert_in_delta(-3, get_samples(100, osc(gain: 3)).min)
   end
 
   def test_offset_and_gain()

data/test/test_sequencer.rb

@@ -0,0 +1,25 @@
+require_relative 'helper'
+
+
+class TestSequencer < Test::Unit::TestCase
+
+  B = Beeps
+
+  def seq(&b)
+    B::Sequencer.new.tap {b.call _1}
+  end
+
+  def osc(type = :sine, samples: nil, freq: 1, **kwargs)
+    B::Oscillator.new(type, samples: samples, freq: freq, **kwargs)
+  end
+
+  def test_each_note()
+    assert_equal(
+      [[B::Oscillator,  0, 1]],
+      seq {_1.add osc, 0, 1}.map {|p, *args| [p.class, *args]})
+
+    assert_equal [0],    seq {_1.add osc, 0, 1}                  .map {_2}
+    assert_equal [0, 2], seq {_1.add osc, 0, 1; _1.add osc, 2, 3}.map {_2}
+  end
+
+end# TestSequencer

data/test/test_value.rb

@@ -0,0 +1,47 @@
+require_relative 'helper'
+
+
+class TestValue < Test::Unit::TestCase
+
+  B = Beeps
+
+  def val(...) = B::Value.new(...)
+
+  def test_constant()
+    assert_each_in_delta [5] * 3, get_samples(2, val(5))
+  end
+
+  def test_linear_interpolation()
+    v = val 0
+    v.insert 2, 1
+    v.insert 1, 2
+    assert_each_in_delta [0, 1, 2, 1.5, 1], get_samples(2, v, seconds: 2)
+  end
+
+  def test_insert()
+    v = val 0
+    v.insert 1, 1
+    assert_equal [[0, 0], [1, 1]], v.to_a
+
+    v.insert 2, 1
+    assert_equal [[0, 0], [2, 1]], v.to_a
+
+    assert_raise(ArgumentError) {v.insert 1, -1}
+  end
+
+  def test_clear()
+    v = val 0
+    assert_equal 1, v.to_a.size
+
+    v.clear
+    assert_equal 0, v.to_a.size
+  end
+
+  def test_each()
+    v = val 0
+    v.insert 1, 1
+    v.insert 2, 2
+    assert_equal [[0, 0], [1, 1], [2, 2]], v.to_a
+  end
+
+end# TestValue

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: beeps
 version: !ruby/object:Gem::Version
-  version: 0.3.9
+  version: 0.3.10
 platform: ruby
 authors:
 - xordog
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-05 00:00:00.000000000 Z
+date: 2026-04-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: xot
@@ -16,40 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.9
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 0.3.10
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.9
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 0.3.10
 - !ruby/object:Gem::Dependency
   name: rucy
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.9
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 0.3.10
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.9
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 0.3.10
 description: Synthesize and play beep sounds.
 email: xordog@gmail.com
 executables: []
@@ -77,6 +65,7 @@ extra_rdoc_files:
 - ".doc/ext/beeps/sound_player.cpp"
 - ".doc/ext/beeps/text_in.cpp"
 - ".doc/ext/beeps/time_stretch.cpp"
+- ".doc/ext/beeps/value.cpp"
 files:
 - ".doc/ext/beeps/analyser.cpp"
 - ".doc/ext/beeps/beeps.cpp"
@@ -99,11 +88,13 @@ files:
 - ".doc/ext/beeps/sound_player.cpp"
 - ".doc/ext/beeps/text_in.cpp"
 - ".doc/ext/beeps/time_stretch.cpp"
+- ".doc/ext/beeps/value.cpp"
 - ".github/PULL_REQUEST_TEMPLATE.md"
 - ".github/workflows/release-gem.yml"
 - ".github/workflows/tag.yml"
 - ".github/workflows/test.yml"
 - ".github/workflows/utils.rb"
+- CLAUDE.md
 - CONTRIBUTING.md
 - ChangeLog.md
 - Gemfile
@@ -136,6 +127,7 @@ files:
 - ext/beeps/sound_player.cpp
 - ext/beeps/text_in.cpp
 - ext/beeps/time_stretch.cpp
+- ext/beeps/value.cpp
 - include/beeps.h
 - include/beeps/beeps.h
 - include/beeps/debug.h
@@ -186,12 +178,16 @@ files:
 - src/processor.cpp
 - src/processor.h
 - src/reverb.cpp
+- src/sdl/beeps.cpp
+- src/sdl/signals.cpp
+- src/sdl/text_in.cpp
 - src/sequencer.cpp
 - src/signals.cpp
 - src/signals.h
 - src/sound.cpp
 - src/sound.h
 - src/time_stretch.cpp
+- src/value.cpp
 - src/win32/beeps.cpp
 - src/win32/exception.cpp
 - src/win32/exception.h
@@ -211,10 +207,12 @@ files:
 - test/test_oscillator.rb
 - test/test_pitch_shift.rb
 - test/test_processor.rb
+- test/test_sequencer.rb
 - test/test_signals.rb
 - test/test_sound.rb
 - test/test_sound_player.rb
 - test/test_time_stretch.rb
+- test/test_value.rb
 homepage: https://github.com/xord/beeps
 licenses:
 - MIT
@@ -253,7 +251,9 @@ test_files:
 - test/test_oscillator.rb
 - test/test_pitch_shift.rb
 - test/test_processor.rb
+- test/test_sequencer.rb
 - test/test_signals.rb
 - test/test_sound.rb
 - test/test_sound_player.rb
 - test/test_time_stretch.rb
+- test/test_value.rb