beeps 0.3.11 → 0.3.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 447c9cdd326022c8ae82bb29c71e2b19feba8034ff75540a275a13897396632e
-  data.tar.gz: f13e11cf3e2f0690c9cc87434b474bb717c58a2a737abbdad5377a7470fc2e86
+  metadata.gz: be0112d74491238712ca27ab7da557b8dbffac3075e2ac1eb13efa7ca91b4f18
+  data.tar.gz: 935312ec040f4dc78ab97135d8ff5035ee5f8712a5e1019bb720aead83e7bb90
 SHA512:
-  metadata.gz: 1112849bbec8c92505651120c14aaf8bdefc4e4a97602f718fe3557e540789d7f63719357c73ab093b98e5d15c90320ce8bad5811a258c6c76bdfbe1345462cb
-  data.tar.gz: 9e81ccd1d756546134ab2e4ba5ca11525924c7d29100a3735aeafb807af7bd99bb6c649fe3eced021306a7e48a06158f67182defbbcb5d2929d62d535f66dac4
+  metadata.gz: c83043583de20a32cd345f29cf01c3e56cebbbfc6dc960d9a2032e1b2d179c8fcf5013f67f0a775807e5084b00c8e7d8674f464da2e8383ce4bf5e46e8d9c804
+  data.tar.gz: aabb022c116a6c942b2b4c253e0caed24ed7f62320190b768dfd76d331da2acb6d28fb2f4ddd939db577b4bfce625af968baadba095de66a2a1fd2ba9667cc58

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
@@ -33,23 +36,9 @@ jobs:
           echo path=$(ruby -e 'print Dir.glob("*.gem").first') >> $GITHUB_OUTPUT
 
       - name: create github release
-        id: release
-        uses: actions/create-release@v1
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          tag_name: ${{ github.ref }}
-          release_name: ${{ github.ref }}
-
-      - name: upload to github release
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ steps.release.outputs.upload_url }}
-          asset_path: ./${{ steps.gem.outputs.path }}
-          asset_name:   ${{ steps.gem.outputs.path }}
-          asset_content_type: application/zip
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: ruby -I.github/workflows -rutils -e 'release(*ARGV)' ./${{ steps.gem.outputs.path }}
 
       - name: upload to rubygems
         env:

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,26 @@
 # beeps ChangeLog
 
 
+## [v0.3.13] - 2026-05-17
+
+- Rewrite README.md
+- CI: Migrate release-gem.yml from actions/create-release to gh release create
+
+
+## [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/README.md

@@ -1,4 +1,4 @@
-# Beeps - Plays beep sound
+# Beeps - Audio synthesis and playback library
 
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/xord/beeps)
 ![License](https://img.shields.io/github/license/xord/beeps)
@@ -21,18 +21,37 @@ Thanks for your support! 🙌
 
 ## 🚀 About
 
-**Beeps** is a simple utility that plays a beep sound.
+**Beeps** is an audio library for Ruby. You build a processor graph — oscillators, file / mic input, filters, envelopes, effects — by wiring nodes together with the `>>` operator, then render the result to a `Sound` and play it back.
 
-It is designed to be lightweight and easy to use, making it perfect for adding audible notifications to your scripts or applications.
+It is part of the `xord/*` family and underlies the audio support in [Reflex](https://github.com/xord/reflex), [Processing](https://github.com/xord/processing), [RubySketch](https://github.com/xord/rubysketch), and [Reight](https://github.com/xord/reight). Like the rest of the family, it is primarily developed for our own use, but it works as a standalone audio synthesis gem.
+
+## 📋 Requirements
+
+- Ruby **3.0.0** or later
+- A C++ compiler with C++20 support
+- [Xot](https://rubygems.org/gems/xot) and [Rucy](https://rubygems.org/gems/rucy) (declared as runtime dependencies)
+- Platform audio backend:
+  - **macOS** — OpenAL and AVFoundation (bundled with the OS)
+  - **Windows** — OpenAL (`MINGW_PACKAGE_PREFIX-openal`) and Media Foundation
+  - **Linux** — `libopenal-dev`
+
+The following third-party DSP libraries are cloned from GitHub and statically linked while the native extension is being built, so you do not need to install them separately:
+
+| Library                                                                       | Role                                |
+| ----------------------------------------------------------------------------- | ----------------------------------- |
+| [STK](https://github.com/thestk/stk)                                          | Core synthesis primitives           |
+| [AudioFile](https://github.com/adamstark/AudioFile)                           | WAV / AIFF file I/O                 |
+| [r8brain-free-src](https://github.com/avaneev/r8brain-free-src)               | High-quality sample-rate conversion |
+| [signalsmith-stretch](https://github.com/Signalsmith-Audio/signalsmith-stretch) | Time stretching and pitch shifting  |
 
 ## 📦 Installation
 
 Add this line to your Gemfile:
 ```ruby
-$ gem 'beeps'
+gem 'beeps'
 ```
 
-Then, install gem:
+Then install:
 ```bash
 $ bundle install
 ```
@@ -42,7 +61,131 @@ Or install it directly:
 $ gem install beeps
 ```
 
+`require 'beeps'` automatically calls `Beeps.init!` and registers `Beeps.fin!` at exit. Set `$BEEPS_NOAUTOINIT = true` before requiring if you want to manage the lifetime yourself.
+
+## 📚 What's Included
+
+### Generators (signal sources)
+
+| Class                | Purpose                                                                  |
+| -------------------- | ------------------------------------------------------------------------ |
+| `Beeps::Oscillator`  | Sine / triangle / square / sawtooth / noise / sample-playback oscillator |
+| `Beeps::Value`       | Constant or linearly-interpolated control value over time                |
+| `Beeps::Sequencer`   | Schedule processors at given offsets and durations                       |
+| `Beeps::FileIn`      | Stream audio from a WAV / AIFF / other supported file                    |
+| `Beeps::MicIn`       | Capture audio from a microphone                                          |
+| `Beeps::TextIn`      | Synthesize speech from text                                              |
+
+### Filters (processors that take an input)
+
+| Class                | Purpose                                                                 |
+| -------------------- | ----------------------------------------------------------------------- |
+| `Beeps::Gain`        | Multiply the signal by a gain coefficient                               |
+| `Beeps::Mixer`       | Sum multiple inputs                                                     |
+| `Beeps::Envelope`    | Attack / Decay / Sustain / Release envelope with `note_on` / `note_off` |
+| `Beeps::LowPass`     | Low-pass filter with cutoff frequency                                   |
+| `Beeps::HighPass`    | High-pass filter with cutoff frequency                                  |
+| `Beeps::Reverb`      | Reverb with `mix`, `room_size`, `damping` controls                      |
+| `Beeps::TimeStretch` | Change duration without affecting pitch                                 |
+| `Beeps::PitchShift`  | Change pitch without affecting duration                                 |
+| `Beeps::Analyser`    | FFT analyser — exposes time-domain and spectrum readings                |
+
+### Playback
+
+| Class                | Purpose                                                                     |
+| -------------------- | --------------------------------------------------------------------------- |
+| `Beeps::Sound`       | A finite, renderable audio asset (created from a processor or `load_sound`) |
+| `Beeps::SoundPlayer` | Returned by `Sound#play`; supports `pause`, `stop`, `position`, `loop`, ... |
+
+## 💡 Usage
+
+### Play a 440 Hz sine tone for one second
+
+```ruby
+require 'beeps'
+
+osc    = Beeps::Oscillator.new(:sine, frequency: 440)
+sound  = Beeps::Sound.new(osc, 1)
+player = sound.play
+
+sleep 1   # keep the script alive while the sound plays
+```
+
+### Build a processor chain with `>>`
+
+```ruby
+require 'beeps'
+
+# oscillator -> half-volume -> low-pass at 800 Hz -> reverb
+chain =
+  Beeps::Oscillator.new(:sawtooth, frequency: 220) >>
+  Beeps::Gain.new(0.5) >>
+  Beeps::LowPass.new(cutoff: 800) >>
+  Beeps::Reverb.new(mix: 0.3, room_size: 0.7)
+
+Beeps::Sound.new(chain, 2).play
+sleep 2
+```
+
+`a >> b` calls `b.add_input(a)` and returns `b`, so the right-most node is the head of the chain you pass to `Sound.new`.
+
+### ADSR envelope
+
+```ruby
+require 'beeps'
+
+osc = Beeps::Oscillator.new(:sine, frequency: 440)
+env = Beeps::Envelope.new(0.05, 0.1, 0.7, 0.3, input: osc)
+env.note_on
+env.note_off 0.5    # release after 0.5 s
+
+Beeps::Sound.new(env, 1).play
+sleep 1
+```
+
+### Play and save a wave file
+
+```ruby
+require 'beeps'
+
+# play an existing file
+player = Beeps.load_sound('drum.wav').play
+
+# render a chain and save it to disk
+sound = Beeps::Sound.new(Beeps::Oscillator.new(:square, frequency: 880), 0.5)
+sound.save 'square.wav'
+```
+
+### Capture from the microphone and analyse
+
+```ruby
+require 'beeps'
+
+mic      = Beeps::MicIn.new(1)            # 1 channel
+analyser = Beeps::Analyser.new(1024, mic) # 1024-point FFT
+mic.start
+
+loop do
+  sleep 0.1
+  puts analyser.spectrum.first(8).map {|v| v.round 3 }.inspect
+end
+```
+
+## 🛠️ Development
+
+```bash
+$ rake lib    # build the native C++ library (libbeeps)
+$ rake ext    # build the Ruby C extension
+$ rake test   # run the test suite
+$ rake doc    # generate RDoc from C++ sources
+$ rake       # default: builds the extension
+```
+
+In the [`xord/all`](https://github.com/xord/all) monorepo you can scope by module, e.g. `rake beeps test`.
+
 ## 📜 License
 
 **Beeps** is licensed under the MIT License.
 See the [LICENSE](./LICENSE) file for details.
+
+The third-party DSP libraries listed above retain their own licenses.

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.13

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.13'
+  s.add_dependency 'rucy', '~> 0.3.13'
 
   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;