ruck-ugen 0.2.0

data/lib/ruck/ugen/wav.rb

@@ -0,0 +1,187 @@
+
+require File.join(File.dirname(__FILE__), "..", "misc", "riff")
+
+module Ruck
+  module UGen
+    module Generators
+    
+      # saves all incoming samples in memory to export to disk later
+      # outputs 0.0 samples
+      class WavOut
+        include UGenBase
+        include Source
+        include MultiChannelTarget
+
+        attr_reader :filename
+
+        def initialize(attrs = {})
+          require_attrs attrs, [:filename]
+          @filename = attrs.delete(:filename)
+          @num_channels = attrs.delete(:num_channels) || 1
+          @bits_per_sample = attrs.delete(:bits_per_sample) || 16
+          parse_attrs attrs
+
+          @in_channels = (1..@num_channels).map { InChannel.new }
+
+          @sample_rate = SAMPLE_RATE
+          @samples = (1..@num_channels).map { [] }
+          @ins = []
+          @last = 0.0
+
+          # TODO: this is necessary, but if UGen graph were explicitly
+          # destructed, that would be nice.
+          at_exit { save }
+        end
+
+        def next(now)
+          return @last if @now == now
+          @now = now
+          @samples << @in_channels.map { |chan| chan.next now }
+          @last
+        end
+
+        def save
+          LOG.info "Saving WAV to #{@filename}..."
+          File.open(@filename, "wb") { |f| f.write encode }
+        end
+
+        def attr_names
+          [:filename]
+        end
+
+        private
+
+          def encode
+            chunk("RIFF") do |riff|
+              riff << ascii("WAVE")
+              riff << chunk("fmt ") do |fmt|
+                fmt << short(1) # format = 1: PCM (no compression)
+                fmt << short(@num_channels)
+                fmt << int(@sample_rate)
+                fmt << int((@sample_rate * @num_channels * (@bits_per_sample / 8))) # byte-rate
+                fmt << short((@num_channels * @bits_per_sample/8)) # block align
+                fmt << short(@bits_per_sample) # bits/sample
+              end
+              riff << chunk("data") do |data|
+                range = 2 ** (@bits_per_sample - 1)
+                @samples.each do |sample_list|
+                  sample_list.each { |sample| data << [sample * range].pack("s1") }
+                end
+              end
+            end
+          end
+
+          def int(i)
+            [i].pack("i1")
+          end
+
+          def short(s)
+            [s].pack("s1")
+          end
+
+          def ascii(str)
+            str.split("").pack("A1" * str.length)
+          end
+
+          def chunk(type, &block)
+            buf = ""
+            block.call(buf)
+            ascii(type) + int(buf.length) + buf
+          end
+
+      end
+
+      # plays sound stored in a RIFF WAV file
+      class WavIn
+        include UGenBase
+        include MultiChannelSource
+
+        linkable_attr :rate
+        linkable_attr :gain
+        attr_reader :filename
+
+        def initialize(attrs = {})
+          require_attrs attrs, [:filename]
+          @rate = 1.0
+          @gain = 1.0
+          @filename = attrs.delete(:filename)
+          parse_attrs attrs
+
+          @loaded = false
+          @playing = true
+
+          init_wav
+        end
+
+        def init_wav
+          riff = Riff::RiffReader.new(@filename).chunks.first
+          unless riff.type == "RIFF"
+            LOG.error "#{@filename}: Not RIFF!"
+            return
+          end
+          unless riff[0..3] == "WAVE"
+            LOG.error "#{@filename}: Not WAVE!"
+            return
+          end
+
+          riff.data_skip = 4 # skip "WAVE"
+          fmt = riff.chunks.first
+          @wav = riff.chunks.find { |c| c.type == "data" }
+          unless fmt[0..1].unpack("s1").first == 1
+            LOG.error "#{@filename}: Not PCM!"
+            return
+          end
+
+          @num_channels, @sample_rate, @byte_rate,
+            @block_align, @bits_per_sample =
+            fmt[2..15].unpack("s1i1i1s1s1")
+          @range = (2 ** (@bits_per_sample - 1)).to_f
+
+          @out_channels = (0..@num_channels-1).map { |chan| OutChannel.new self, chan }
+          @sample = [0.0] * @num_channels
+          @last = [0.0] * @num_channels
+          @now = [nil] * @num_channels
+          @rate_adjust = @sample_rate / SAMPLE_RATE
+
+          @loaded = true
+        end
+
+        def duration
+          @loaded ? @wav.size / @block_align / @rate_adjust : 0
+        end
+
+        def attr_names
+          [:filename, :rate]
+        end
+
+        def next(now, chan = 0)
+          return @last[chan] if @now[chan] == now
+          @now[chan] = now
+
+          return @last[chan] unless @loaded && @playing
+
+          offset = @sample[chan].to_i * @block_align
+          chan_offset = (chan * @bits_per_sample) / 8
+
+          if offset + @block_align > @wav.size
+            @playing = false
+            return @last[chan]
+          end
+
+          @last[chan] = @wav[offset + chan_offset, @bits_per_sample].unpack("s1").first / @range * gain
+          @sample[chan] += rate * @rate_adjust
+          @last[chan]
+        end
+
+        def play; @playing = true; end
+        def stop; @playing = false; end
+
+        def reset
+          @offset = 0
+        end
+
+      end
+    
+    end
+  end
+end

data/lib/ruck/ugen.rb

@@ -0,0 +1,7 @@
+
+require File.join(File.dirname(__FILE__), "misc", "linkage")
+require File.join(File.dirname(__FILE__), "ugen", "ugen")
+require File.join(File.dirname(__FILE__), "ugen", "basic")
+require File.join(File.dirname(__FILE__), "ugen", "time_helpers")
+require File.join(File.dirname(__FILE__), "ugen", "oscillators")
+require File.join(File.dirname(__FILE__), "ugen", "wav")

data/ruck-ugen.gemspec

@@ -0,0 +1,85 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{ruck-ugen}
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Tom Lieber"]
+  s.date = %q{2010-07-10}
+  s.default_executable = %q{ruck_ugen}
+  s.description = %q{      A ruck shreduler and mini audio unit generator framework inspired by ChucK.
+      Includes library for reading and writing multi-channel WAV files, and some
+      basic audio filters.
+}
+  s.email = %q{tom@alltom.com}
+  s.executables = ["ruck_ugen"]
+  s.extra_rdoc_files = [
+    "README"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "README",
+     "Rakefile",
+     "VERSION",
+     "bin/ruck_ugen",
+     "examples/ex01.rb",
+     "examples/ex02.rb",
+     "examples/ex03.rb",
+     "examples/ex04.rb",
+     "examples/ex05.rb",
+     "examples/ex06.rb",
+     "examples/ex07.rb",
+     "examples/ex08.rb",
+     "examples/ex09.rb",
+     "examples/ex10.rb",
+     "examples/ex11.rb",
+     "lib/ruck/misc/linkage.rb",
+     "lib/ruck/misc/riff.rb",
+     "lib/ruck/ugen.rb",
+     "lib/ruck/ugen/basic.rb",
+     "lib/ruck/ugen/oscillators.rb",
+     "lib/ruck/ugen/time_helpers.rb",
+     "lib/ruck/ugen/ugen.rb",
+     "lib/ruck/ugen/wav.rb",
+     "ruck-ugen.gemspec",
+     "test/bench.rb"
+  ]
+  s.homepage = %q{http://github.com/alltom/ruck-ugen}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{ruck shreduler + mini audio unit generator framework inspired by ChucK}
+  s.test_files = [
+    "test/bench.rb",
+     "examples/ex01.rb",
+     "examples/ex02.rb",
+     "examples/ex03.rb",
+     "examples/ex04.rb",
+     "examples/ex05.rb",
+     "examples/ex06.rb",
+     "examples/ex07.rb",
+     "examples/ex08.rb",
+     "examples/ex09.rb",
+     "examples/ex10.rb",
+     "examples/ex11.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<ruck>, [">= 0"])
+    else
+      s.add_dependency(%q<ruck>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<ruck>, [">= 0"])
+  end
+end
+

data/test/bench.rb

@@ -0,0 +1,57 @@
+
+puts "Testing how many Step ugens it takes to synthesize slower than real-time"
+
+seconds = 4
+
+# were we invoked as a ruck_ugen script, or stand-alone?
+if __FILE__ == $0
+  # we were invoked like "ruby bench.rb"
+  # benchmark UGens without shreduling
+  
+  puts "... without shreduling"
+
+  require "ruck"
+  require "ruck/ugen"
+  
+  SAMPLE_RATE = 22050
+  TIME = SAMPLE_RATE * seconds
+  dac = Ruck::InChannel.new
+  count = 0
+  @now = 0
+  puts "Simulating #{TIME / SAMPLE_RATE} seconds at #{SAMPLE_RATE} sample rate"
+  loop do
+    Ruck::Generators::Step.new >> dac
+    count += 1
+
+    start = Time.now
+    TIME.to_i.times do
+      dac.next(@now)
+      @now += 1
+    end
+    
+    time = Time.now - start
+    puts "#{count} ugens took #{time} sec to synthesize #{TIME / 1.seconds} sec"
+
+    break if time > (TIME / SAMPLE_RATE)
+  end
+else
+  # we were invoked by ruck_ugen
+  # benchmark UGens with shreduling
+  
+  puts "... with shreduling"
+
+  TIME = seconds.seconds
+  count = 0
+  puts "Simulating #{TIME / 1.second} seconds at #{SAMPLE_RATE} sample rate"
+  loop do
+    Step.new >> blackhole
+    count += 1
+
+    start = Time.now
+    play TIME
+    time = Time.now - start
+    puts "#{count} ugens took #{time} sec to synthesize #{TIME / 1.seconds} sec"
+
+    break if time > (TIME / 1.second)
+  end
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification 
+name: ruck-ugen
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
+platform: ruby
+authors: 
+- Tom Lieber
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-10 00:00:00 -07:00
+default_executable: ruck_ugen
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ruck
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: "      A ruck shreduler and mini audio unit generator framework inspired by ChucK.\n      Includes library for reading and writing multi-channel WAV files, and some\n      basic audio filters.\n"
+email: tom@alltom.com
+executables: 
+- ruck_ugen
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- .document
+- .gitignore
+- README
+- Rakefile
+- VERSION
+- bin/ruck_ugen
+- examples/ex01.rb
+- examples/ex02.rb
+- examples/ex03.rb
+- examples/ex04.rb
+- examples/ex05.rb
+- examples/ex06.rb
+- examples/ex07.rb
+- examples/ex08.rb
+- examples/ex09.rb
+- examples/ex10.rb
+- examples/ex11.rb
+- lib/ruck/misc/linkage.rb
+- lib/ruck/misc/riff.rb
+- lib/ruck/ugen.rb
+- lib/ruck/ugen/basic.rb
+- lib/ruck/ugen/oscillators.rb
+- lib/ruck/ugen/time_helpers.rb
+- lib/ruck/ugen/ugen.rb
+- lib/ruck/ugen/wav.rb
+- ruck-ugen.gemspec
+- test/bench.rb
+has_rdoc: true
+homepage: http://github.com/alltom/ruck-ugen
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: ruck shreduler + mini audio unit generator framework inspired by ChucK
+test_files: 
+- test/bench.rb
+- examples/ex01.rb
+- examples/ex02.rb
+- examples/ex03.rb
+- examples/ex04.rb
+- examples/ex05.rb
+- examples/ex06.rb
+- examples/ex07.rb
+- examples/ex08.rb
+- examples/ex09.rb
+- examples/ex10.rb
+- examples/ex11.rb