beeps 0.3.11 → 0.3.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 447c9cdd326022c8ae82bb29c71e2b19feba8034ff75540a275a13897396632e
-  data.tar.gz: f13e11cf3e2f0690c9cc87434b474bb717c58a2a737abbdad5377a7470fc2e86
+  metadata.gz: 8a848993e9610dd9598a6685f4ef669083aea313d68b533fb6d222b723348cd9
+  data.tar.gz: ea8610eb20594ac731580377a1d7966fac499afb36074973149d2449deaab14e
 SHA512:
-  metadata.gz: 1112849bbec8c92505651120c14aaf8bdefc4e4a97602f718fe3557e540789d7f63719357c73ab093b98e5d15c90320ce8bad5811a258c6c76bdfbe1345462cb
-  data.tar.gz: 9e81ccd1d756546134ab2e4ba5ca11525924c7d29100a3735aeafb807af7bd99bb6c649fe3eced021306a7e48a06158f67182defbbcb5d2929d62d535f66dac4
+  metadata.gz: 7942136dd8a5cedc43842ff907211d73e38864b80b7aa4a79287d95d2e9bc5531d551afd8a08acf6ca294c9f73e66feb37c2a02be996d8484e9347e94c663b6f
+  data.tar.gz: 6ea818cccb69bbc0967700687dc23ef699802d5c915770be1153fc175a9150f0ae5a0bd845831c17ae86c8239c42915bd596718f1a5ca1b98662ea73f09b88d7

data/.doc/ext/beeps/sound_player.cpp

@@ -61,6 +61,57 @@ VALUE get_state(VALUE self)
 	return value(THIS->state());
 }
 
+static
+VALUE set_position(VALUE self, VALUE position)
+{
+	CHECK;
+
+	THIS->set_position(to<uint>(position));
+	return position;
+}
+
+static
+VALUE get_position(VALUE self)
+{
+	CHECK;
+
+	return value(THIS->position());
+}
+
+static
+VALUE set_time(VALUE self, VALUE time)
+{
+	CHECK;
+
+	THIS->set_time(to<float>(time));
+	return time;
+}
+
+static
+VALUE get_time(VALUE self)
+{
+	CHECK;
+
+	return value(THIS->time());
+}
+
+static
+VALUE set_time_scale(VALUE self, VALUE scale)
+{
+	CHECK;
+
+	THIS->set_time_scale(to<float>(scale));
+	return scale;
+}
+
+static
+VALUE get_time_scale(VALUE self)
+{
+	CHECK;
+
+	return value(THIS->time_scale());
+}
+
 static
 VALUE set_gain(VALUE self, VALUE gain)
 {
@@ -116,6 +167,12 @@ Init_beeps_sound_player ()
 	rb_define_method(cSoundPlayer, "rewind", RUBY_METHOD_FUNC(rewind), 0);
 	rb_define_method(cSoundPlayer, "stop", RUBY_METHOD_FUNC(stop), 0);
 	rb_define_method(cSoundPlayer, "state", RUBY_METHOD_FUNC(get_state), 0);
+	rb_define_method(cSoundPlayer, "position=", RUBY_METHOD_FUNC(set_position), 1);
+	rb_define_method(cSoundPlayer, "position", RUBY_METHOD_FUNC(get_position), 0);
+	rb_define_method(cSoundPlayer, "time=", RUBY_METHOD_FUNC(set_time), 1);
+	rb_define_method(cSoundPlayer, "time", RUBY_METHOD_FUNC(get_time), 0);
+	rb_define_method(cSoundPlayer, "time_scale=", RUBY_METHOD_FUNC(set_time_scale), 1);
+	rb_define_method(cSoundPlayer, "time_scale", RUBY_METHOD_FUNC(get_time_scale), 0);
 	rb_define_method(cSoundPlayer, "gain=", RUBY_METHOD_FUNC(set_gain), 1);
 	rb_define_method(cSoundPlayer, "gain", RUBY_METHOD_FUNC(get_gain), 0);
 	rb_define_method(cSoundPlayer, "loop=", RUBY_METHOD_FUNC(set_loop), 1);

data/.github/workflows/release-gem.yml

@@ -4,6 +4,9 @@ on:
   push:
     tags: ['v[0-9]*']
 
+permissions:
+  contents: write
+
 jobs:
   release:
     runs-on: macos-latest

data/.github/workflows/utils.rb

@@ -1,3 +1,9 @@
+require 'shellwords'
+
+ALL_REPO        = 'xord/all'
+ALL_DIR         = '../all'
+ALL_FETCH_DEPTH = 100
+
 RENAMES = {reflex: 'reflexion'}
 
 def sh(cmd)
@@ -5,7 +11,7 @@ def sh(cmd)
   system cmd
 end
 
-def setup_dependencies(build: true, only: nil)
+def setup_dependencies(only: nil)
   gemspec_path = `git ls-files`.lines(chomp: true).find {|l| l =~ /\.gemspec$/}
   return unless gemspec_path
 
@@ -13,44 +19,109 @@ def setup_dependencies(build: true, only: nil)
   name    = File.basename gemspec_path, '.gemspec'
 
   exts = File.readlines('Rakefile')
-    .map {|l| l[%r|^\s*require\W+(\w+)/extension\W+$|, 1]}
+    .map {|l| l[%r|^\s*require\W+([\w\-\_]+)/extension\W+$|, 1]}
     .compact
     .reject {|ext| ext == name}
   exts = exts & [only].flatten.map(&:to_s) if only
+  return if exts.empty?
+
+  unless setup_dependencies_via_monorepo(exts)
+    setup_dependencies_via_each_repo_by_version(gemspec, exts)
+  end
+
+  exts.each {|ext| sh %( cd ../#{ext} && rake ext )}
+end
+
+def setup_dependencies_via_monorepo(exts)
+  return false unless checkout_monorepo
+  exts.each {|ext| sh %( ln -snf all/#{ext} ../#{ext} )}
+  true
+end
+
+def checkout_monorepo()
+  uuid = `git log -1 --format=%B`[/^\[\[([0-9a-fA-F-]+)\]\]$/, 1]
+  return false unless uuid
+
+  commit = setup_monorepo uuid
+  return false unless commit
+
+  Dir.chdir(ALL_DIR) {sh %( git checkout -q #{commit} )}
+  true
+end
+
+def setup_monorepo(uuid)
+  unless File.directory? ALL_DIR
+    url = "https://github.com/#{ALL_REPO}.git"
+    sh %( git clone --no-tags --depth #{ALL_FETCH_DEPTH} #{url} #{ALL_DIR} )
+  end
+  loop do
+    commit = find_monorepo_commit uuid
+    return commit if commit
+
+    deepened = Dir.chdir ALL_DIR do
+      before = `git rev-list --count HEAD`.to_i
+      sh %( git fetch --deepen #{ALL_FETCH_DEPTH} )
+      `git rev-list --count HEAD`.to_i > before
+    end
+    return nil unless deepened
+  end
+end
+
+def find_monorepo_commit(uuid)
+  Dir.chdir ALL_DIR do
+    out = `git log origin/HEAD -F --grep="[[#{uuid}]]" --format=%H -1`.strip
+    out.empty? ? nil : out
+  end
+end
 
+def setup_dependencies_via_each_repo_by_version(gemspec, exts)
   exts.each do |ext|
     gem   = RENAMES[ext.to_sym].then {|s| s || ext}
-    ver   = gemspec[/add_dependency.*['"]#{gem}['"].*['"]\s*>=\s*([\d\.]+)\s*['"]/, 1]
+    ver   = gemspec[/add_dependency.*['"]#{gem}['"].*['"]\s*~>\s*([\d\.]+)\s*['"]/, 1]
     opts  = '-c advice.detachedHead=false --depth 1'
     clone = "git clone #{opts} https://github.com/xord/#{ext}.git ../#{ext}"
 
     # 'rake subtree:push' pushes all subrepos, so cloning by new tag
     # often fails before tagging each new tag
     sh %( #{clone} --branch v#{ver} || #{clone} )
-    sh %( cd ../#{ext} && rake ext )
   end
 end
 
 def tag_versions()
-  tags = `git tag`.lines chomp: true
-  vers = `git log --oneline ./VERSION`
+  changes = changelogs
+  tags    = `git tag`.lines chomp: true
+  vers    = `git log --oneline ./VERSION`
     .lines(chomp: true)
     .map {|line| line.split.first[/^\w+$/]}
-    .map {|hash| [`git cat-file -p #{hash}:./VERSION 2>/dev/null`[/[\d\.]+/], hash]}
-    .select {|ver, hash| ver && hash}
+    .map {|sha| [`git cat-file -p #{sha}:./VERSION 2>/dev/null`[/[\d\.]+/], sha]}
+    .select {|ver, sha| ver && sha}
     .reverse
     .to_h
 
-  changes = File.read('ChangeLog.md')
-    .split(/^\s*##\s*\[\s*v([\d\.]+)\s*\].*$/)
-    .slice(1..-1)
-    .each_slice(2)
-    .to_h
-    .transform_values(&:strip!)
-
-  vers.to_a.reverse.each do |ver, hash|
+  vers.to_a.reverse.each do |ver, sha|
     tag = "v#{ver}"
     break if tags.include?(tag)
-    sh %( git tag -a -m \"#{changes[ver]&.gsub '"', '\\"'}\" #{tag} #{hash} )
+    sh %( git tag -a -m \"#{changes[tag]&.gsub '"', '\\"'}\" #{tag} #{sha} )
   end
 end
+
+def release(*paths)
+  tag   = ENV['GITHUB_REF']&.sub(%r|^refs/tags/|, '') || raise('GITHUB_REF tag not set')
+  notes = (changelogs[tag] || '').shellescape
+  paths = paths.flatten.join ' '
+
+  sh(%( gh release create #{tag} #{paths} --notes #{notes} )) ||
+    sh(%( gh release upload #{tag} #{paths} --clobber )) ||
+    raise('failed to upload to releases')
+end
+
+def changelogs()
+  File.read('ChangeLog.md')
+    .split(/^\s*##\s*\[\s*(v[\d\.]+)\s*\].*$/)
+    .slice(1..)
+    .each_slice(2)
+    .to_h
+    .transform_values(&:strip!)
+rescue Errno::ENOENT
+  raise 'failed to get changelogs'
+end

data/ChangeLog.md

@@ -1,6 +1,20 @@
 # beeps ChangeLog
 
 
+## [v0.3.12] - 2026-05-10
+
+- Support WebAssembly
+- Add adaptive stream buffering to prevent audio underruns
+- Add position(), time(), time_scale() to SoundPlayer and seekable() to Processor
+- Add constructors, clear(), and append() to Signals as public API
+- Move set_buffering_seconds() from Filter to Processor
+- Rename max_segment_size_for_process() to get_max_segment_size_for_process()
+- Bump AudioFile from 1.1.1 to 1.1.4 to fix Windows CI
+- Remove deprecated has_rdoc= from gemspecs
+
+- Fix SignalSamples copying channel 0 data to all channels
+
+
 ## [v0.3.11] - 2026-04-17
 
 - Update dependencies

data/Rakefile

@@ -25,7 +25,7 @@ use_external_library 'https://github.com/thestk/stk',
   excludes: %w[stk/src/include Tcp Udp Socket Thread Mutex InetWv /Rt]
 
 use_external_library 'https://github.com/adamstark/AudioFile',
-  tag:      '1.1.1',
+  tag:      '1.1.4',
   srcdirs:  'NOSRC',
   excludes: %w[examples/ tests/]
 

data/VERSION

@@ -1 +1 @@
-0.3.11
+0.3.12

data/beeps.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |s|
   end
 
   ext   = Beeps::Extension
-  name  = ext.name.downcase
+  name  = ext.name true
   rdocs = glob.call *%w[README .doc/ext/**/*.cpp]
 
   s.name        = name
@@ -25,14 +25,13 @@ Gem::Specification.new do |s|
   s.platform              = Gem::Platform::RUBY
   s.required_ruby_version = '>= 3.0.0'
 
-  s.add_dependency 'xot',  '~> 0.3.11'
-  s.add_dependency 'rucy', '~> 0.3.11'
+  s.add_dependency 'xot',  '~> 0.3.12'
+  s.add_dependency 'rucy', '~> 0.3.12'
 
   s.files            = `git ls-files`.split $/
   s.executables      = s.files.grep(%r{^bin/}) {|f| File.basename f}
   s.test_files       = s.files.grep %r{^(test|spec|features)/}
   s.extra_rdoc_files = rdocs.to_a
-  s.has_rdoc         = true
 
   s.metadata['msys2_mingw_dependencies'] = 'openal'
 

data/ext/beeps/extconf.rb

@@ -25,7 +25,7 @@ Xot::ExtConf.new Xot, Rucy, Beeps do
       libs       << 'openal'
     end
 
-    $LDFLAGS << ' -Wl,--out-implib=beeps_ext.dll.a' if mingw? || cygwin?
+    $LDFLAGS << ' -Wl,--out-implib=libbeeps.dll.a' if mingw? || cygwin?
   end
 
   create_makefile 'beeps_ext'

data/ext/beeps/sound_player.cpp

@@ -67,6 +67,63 @@ RUCY_DEF0(get_state)
 }
 RUCY_END
 
+static
+RUCY_DEF1(set_position, position)
+{
+	CHECK;
+
+	THIS->set_position(to<uint>(position));
+	return position;
+}
+RUCY_END
+
+static
+RUCY_DEF0(get_position)
+{
+	CHECK;
+
+	return value(THIS->position());
+}
+RUCY_END
+
+static
+RUCY_DEF1(set_time, time)
+{
+	CHECK;
+
+	THIS->set_time(to<float>(time));
+	return time;
+}
+RUCY_END
+
+static
+RUCY_DEF0(get_time)
+{
+	CHECK;
+
+	return value(THIS->time());
+}
+RUCY_END
+
+static
+RUCY_DEF1(set_time_scale, scale)
+{
+	CHECK;
+
+	THIS->set_time_scale(to<float>(scale));
+	return scale;
+}
+RUCY_END
+
+static
+RUCY_DEF0(get_time_scale)
+{
+	CHECK;
+
+	return value(THIS->time_scale());
+}
+RUCY_END
+
 static
 RUCY_DEF1(set_gain, gain)
 {
@@ -126,7 +183,13 @@ Init_beeps_sound_player ()
 	cSoundPlayer.define_method("pause",  pause);
 	cSoundPlayer.define_method("rewind", rewind);
 	cSoundPlayer.define_method("stop",   stop);
-	cSoundPlayer.define_method("state",    get_state);
+	cSoundPlayer.define_method("state", get_state);
+	cSoundPlayer.define_method("position=",   set_position);
+	cSoundPlayer.define_method("position",    get_position);
+	cSoundPlayer.define_method("time=",       set_time);
+	cSoundPlayer.define_method("time",        get_time);
+	cSoundPlayer.define_method("time_scale=", set_time_scale);
+	cSoundPlayer.define_method("time_scale",  get_time_scale);
 	cSoundPlayer.define_method("gain=", set_gain);
 	cSoundPlayer.define_method("gain",  get_gain);
 	cSoundPlayer.define_method("loop=", set_loop);

data/include/beeps/defs.h

@@ -23,6 +23,8 @@ namespace Beeps
 
 	using Xot::String;
 
+	using Xot::StringList;
+
 
 	typedef double Sample;
 

data/include/beeps/filter.h

@@ -27,6 +27,8 @@ namespace Beeps
 
 			virtual float    gain () const;
 
+			bool seekable () const override;
+
 			struct Data;
 
 			Xot::PImpl<Data> self;
@@ -70,6 +72,8 @@ namespace Beeps
 
 			virtual operator bool () const override;
 
+			bool seekable () const override;
+
 			struct Data;
 
 			Xot::PImpl<Data> self;
@@ -303,6 +307,8 @@ namespace Beeps
 
 			virtual operator bool () const override;
 
+			bool seekable () const override;
+
 			struct Data;
 
 			Xot::PImpl<Data> self;

data/include/beeps/generator.h

@@ -63,6 +63,8 @@ namespace Beeps
 
 			virtual const_iterator end () const;
 
+			bool seekable () const override;
+
 			struct Data;
 
 			Xot::PImpl<Data> self;
@@ -72,7 +74,7 @@ namespace Beeps
 			virtual void generate (
 				Context* context, Signals* signals, uint* offset) override;
 
-			virtual int max_segment_size_for_process (
+			virtual int get_max_segment_size_for_process (
 				double sample_rate, uint nsamples) const override;
 
 	};// Value
@@ -140,6 +142,8 @@ namespace Beeps
 
 			virtual operator bool () const override;
 
+			bool seekable () const override;
+
 			struct Data;
 
 			Xot::PImpl<Data> self;
@@ -149,7 +153,7 @@ namespace Beeps
 			virtual void generate (
 				Context* context, Signals* signals, uint* offset) override;
 
-			virtual int max_segment_size_for_process (
+			virtual int get_max_segment_size_for_process (
 				double sample_rate, uint nsamples) const override;
 
 	};// Oscillator
@@ -240,6 +244,8 @@ namespace Beeps
 
 			virtual operator bool () const override;
 
+			bool seekable () const override;
+
 			struct Data;
 
 			Xot::PImpl<Data> self;

data/include/beeps/processor.h

@@ -24,7 +24,7 @@ namespace Beeps
 
 			class Context {};
 
-			typedef Xot::Ref<This>     Ref;
+			typedef Xot::Ref<This>      Ref;
 
 			typedef std::map<uint, Ref> Map;
 
@@ -38,6 +38,8 @@ namespace Beeps
 
 			virtual const Processor* input () const;
 
+			virtual bool seekable () const;
+
 			virtual void on_start ();
 
 			virtual operator bool () const;
@@ -58,17 +60,19 @@ namespace Beeps
 
 			virtual void filter   (Context* context, Signals* signals, uint* offset);
 
-			virtual int  max_segment_size_for_process (
-				double sample_rate, uint nsamples) const;
-
-			virtual uint get_segment_size (double sample_rate, uint nsamples) const;
-
 			virtual void   set_sub_input (uint index, Processor* input);
 
 			virtual Processor* sub_input (uint index) const;
 
 			virtual void clear_sub_input_unless_processing (uint index);
 
+			virtual uint get_segment_size (double sample_rate, uint nsamples) const;
+
+			virtual int get_max_segment_size_for_process (
+				double sample_rate, uint nsamples) const;
+
+			void set_buffering_seconds (float seconds);
+
 			virtual void set_updated ();
 
 			friend class ProcessorContext;
@@ -102,8 +106,6 @@ namespace Beeps
 
 			Filter (Processor* input = NULL);
 
-			void set_buffering_seconds (float seconds);
-
 		private:
 
 			void generate (

data/include/beeps/ruby.h

@@ -1,7 +1,7 @@
 // -*- c++ -*-
 #pragma once
-#ifndef __BEEPS_RUBY_H__
-#define __BEEPS_RUBY_H__
+#ifndef __BEEPS_RUBY_ALL_H__
+#define __BEEPS_RUBY_ALL_H__
 
 
 #include <beeps/ruby/defs.h>

data/include/beeps/signals.h

@@ -19,10 +19,24 @@ namespace Beeps
 
 			Signals ();
 
+			Signals (uint capacity, uint nchannels = 1, double sample_rate = 0);
+
+			Signals (
+				const float* const* channels, uint nsamples, uint nchannels,
+				double sample_rate = 0, uint capacity = 0);
+
 			~Signals ();
 
 			Signals dup () const;
 
+			void clear (uint capacity = 0);
+
+			uint append (
+				const float* const* channels, uint nsamples, uint nchannels,
+				double sample_rate = 0);
+
+			uint append (const Signals& source, uint source_offset = 0);
+
 			double sample_rate () const;
 
 			uint nchannels () const;

data/include/beeps/sound.h

@@ -47,6 +47,18 @@ namespace Beeps
 
 			State state () const;
 
+			void set_position (uint position);
+
+			uint     position () const;
+
+			void set_time (float time);
+
+			float    time () const;
+
+			void set_time_scale (float scale);
+
+			float    time_scale () const;
+
 			void set_gain (float gain);
 
 			float    gain () const;

data/include/beeps.h

@@ -1,7 +1,7 @@
 // -*- c++ -*-
 #pragma once
-#ifndef __BEEPS_H__
-#define __BEEPS_H__
+#ifndef __BEEPS_ALL_H__
+#define __BEEPS_ALL_H__
 
 
 #include <beeps/defs.h>

data/lib/beeps/extension.rb

@@ -5,8 +5,10 @@ module Beeps
 
     module_function
 
-    def name()
-      super.split('::')[-2]
+    def name(downcase = false)
+      super().split('::')[-2].then {|s|
+        downcase ? s.gsub(/([a-z])([A-Z])/) {"#{$1}-#{$2}"}.downcase : s
+      }
     end
 
     def version()
@@ -29,6 +31,10 @@ module Beeps
       root_dir 'ext'
     end
 
+    def lib_name()
+      "#{name true}.dll" if /mswin|ming|cygwin/.match? RUBY_PLATFORM
+    end
+
   end# Extension
 
 

data/lib/beeps/sound.rb

@@ -55,7 +55,7 @@ module Beeps
       state == :stopped
     end
 
-    universal_accessor :gain, :loop
+    universal_accessor :position, :time, :time_scale, :gain, :loop
 
   end# SoundPlayer
 

data/src/analyser.cpp

@@ -55,7 +55,7 @@ namespace Beeps
 
 			clear();
 
-			signals   = Signals_create(std::min(size, (uint) Beeps::sample_rate()));
+			signals   = Signals(std::min(size, (uint) Beeps::sample_rate()));
 			pffft     .reset(pffft_new_setup(size, PFFFT_REAL));
 			fft_buffer.reset((float*) pffft_aligned_malloc(sizeof(float) * size));
 			fft_size  = size;
@@ -192,6 +192,13 @@ namespace Beeps
 		return self->is_valid();
 	}
 
+	bool
+	Analyser::seekable () const
+	{
+		const Processor* in = input();
+		return !in || in->seekable();
+	}
+
 	static void
 	shift (Signals* signals, uint nsamples)
 	{
@@ -199,7 +206,7 @@ namespace Beeps
 			return;
 
 		if (nsamples > signals->nsamples())
-			return Signals_clear(signals);
+			return signals->clear();
 
 		Sample* from         = Signals_at(signals, nsamples);
 		Sample* to           = Signals_at(signals, 0);
@@ -237,7 +244,7 @@ namespace Beeps
 		auto& my = self->signals;
 
 		if (my.nchannels() != in.nchannels() || my.sample_rate() != in.sample_rate())
-			my = Signals_create(my.capacity(), in.nchannels(), in.sample_rate());
+			my = Signals(my.capacity(), in.nchannels(), in.sample_rate());
 
 		uint total_nsamples = my.nsamples() + in.nsamples();
 		if (total_nsamples > my.capacity())

data/src/envelope.cpp

@@ -261,12 +261,9 @@ namespace Beeps
 		Super::filter(context, signals, offset);
 
 		if (!self->adsr_signals)
-		{
-			self->adsr_signals =
-				Signals_create(signals->nsamples(), 1, signals->sample_rate());
-		}
+			self->adsr_signals = Signals(signals->nsamples(), 1, signals->sample_rate());
 		else
-			Signals_clear(&self->adsr_signals, signals->nsamples());
+			self->adsr_signals.clear(signals->nsamples());
 
 		process_envelope_signals(this, &self->adsr_signals);
 		if (self->adsr_signals.nsamples() < signals->nsamples())