ruby-audio 1.5.0-x86-mingw32

data/lib/ruby-audio/sound_info.rb

@@ -0,0 +1,66 @@
+module RubyAudio
+  # Class <code>SoundInfo</code>  provides information about open sound files'
+  # format, length, samplerate, channels, and other things.
+  #
+  # Example:
+  #   snd = RubyAudio::Sound.open("snd.wav")
+  #   puts snd.info.channels                  #=> 2
+  #   puts snd.info.samplerate                #=> 48000
+  #   snd.close
+  #
+  # In addition it can be used to specify the format of new sound files:
+  #
+  #   info = RubyAudio::SoundInfo.new :channels => 1, :samplerate => 48000, :format => RubyAudio::FORMAT_WAV|RubyAudio::FORMAT_PCM_16
+  #   snd = RubyAudio::Sound.open("new.wav", 'w', info)
+  class SoundInfo < CSoundInfo
+    # Creates a new SoundInfo object and populates it using the given data
+    #
+    # Example:
+    #    info = RubyAudio::SoundInfo.new :channels => 1, :samplerate => 48000, :format => RubyAudio::FORMAT_WAV|RubyAudio::FORMAT_PCM_16
+    def initialize options={}
+      # Populate from options if given
+      unless options.empty?
+        options.each {|key,value| send("#{key}=", value)}
+      end
+    end
+
+    # Returns a new <code>SoundInfo</code> object that is has the same channel
+    # count, sample rate, and format. This is useful in creating a new sound with
+    # the same format as an already existing sound.
+    #
+    # Example:
+    #   snd1 = RubyAudio::Sound.open("snd.wav")
+    #   snd2 = RubyAudio::Sound.open("snd2.wav", 'w', snd1.info.clone)
+    def clone
+      SoundInfo.new(:channels => channels, :samplerate => samplerate, :format => format)
+    end
+
+    alias_method :seekable?, :seekable
+
+    def main_format
+      calculate_format if @main_format.nil?
+      @main_format
+    end
+
+    def sub_format
+      calculate_format if @sub_format.nil?
+      @sub_format
+    end
+
+    private
+    def calculate_format
+      RubyAudio.constants.grep(/FORMAT_/).map(&:to_s).each do |f|
+        next if f.include?('MASK') # Skip mask constants
+
+        val = RubyAudio.const_get(f)
+        if val > RubyAudio::FORMAT_SUBMASK
+          # Main format
+          @main_format = f if format & RubyAudio::FORMAT_TYPEMASK == val
+        else
+          # Sub format
+          @sub_format = f if format & RubyAudio::FORMAT_SUBMASK == val
+        end
+      end
+    end
+  end
+end

data/ruby-audio.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name        = 'ruby-audio'
+  s.version     = '1.5.0'
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Stephen Augenstein']
+  s.email       = ['perl.programmer@gmail.com']
+  s.homepage    = 'http://github.com/warhammerkid/ruby-audio'
+  s.summary     = 'libsndfile wrapper for ruby'
+  s.description = 'ruby-audio wraps around libsndfile to provide simplified sound reading and writing support to ruby programs'
+
+  s.files         = Dir['ruby-audio.gemspec', 'README.rdoc', 'LICENSE', 'Rakefile', 'lib/**/*.rb', 'spec/**/*.{rb,opts,wav,mp3}', 'ext/**/*.{c,h,rb}']
+  s.test_files    = Dir['spec/**/*_spec.rb']
+  s.extensions    = Dir["ext/**/extconf.rb"]
+
+  s.requirements << 'libsndfile (http://www.mega-nerd.com/libsndfile/)'
+
+  s.has_rdoc         = true
+  s.extra_rdoc_files = Dir['README.rdoc', 'ext/**/*.c']
+  s.rdoc_options     = ['--line-numbers', '--main', 'README.rdoc']
+end

data/spec/buffer_spec.rb

@@ -0,0 +1,88 @@
+require "spec_helper.rb"
+
+describe RubyAudio::Buffer do
+  it "should initialize properly" do
+    buf = RubyAudio::Buffer.new('float', 100, 2)
+    buf.channels.should == 2
+    buf.size.should == 100
+    buf.real_size.should == 0
+    buf.type.should == :float
+  end
+
+  it "should support pretty typed constructors" do
+    lambda {
+      [:short, :int, :float, :double].each do |type|
+        buf = RubyAudio::Buffer.send(type, 100)
+      end
+    }.should_not raise_error
+  end
+
+  it "should allow [] access on single channel buffers" do
+    buf = RubyAudio::Buffer.int(100, 1)
+    buf[0] = 1.3
+    buf[0].should == 1
+  end
+
+  it "should allow [] access on multi-channel buffers" do
+    buf = RubyAudio::Buffer.double(100, 2)
+    buf[0] = [0.5, 0.3]
+    buf[0].should == [0.5, 0.3]
+  end
+
+  it "should raise exception if channel count of set frame does not match buffer's" do
+    lambda {
+      buf = RubyAudio::Buffer.double(100, 2)
+      buf[0] = [0.4, 0.8, 0.8]
+    }.should raise_error(RubyAudio::Error, "array length must match channel count")
+  end
+
+  it "should return nil on out-of-bounds [] access" do
+    buf = RubyAudio::Buffer.float(100)
+    buf[101].should == nil
+    buf[-1].should == nil
+  end
+
+  it "should truncate invalid real size" do
+    buf = RubyAudio::Buffer.float(100)
+    buf.real_size = 101
+    buf.real_size.should == 100
+  end
+
+  it "should support cloning/duping" do
+    buf = RubyAudio::Buffer.int(100)
+    buf[4] = 100
+
+    buf2 = buf.dup
+    buf2.size.should == buf.size
+    buf2[4].should == 100
+
+    buf[4] = 140
+    buf2[4].should == 100
+  end
+
+  context ".each" do
+    before(:each) do
+      @buf = RubyAudio::Buffer.int(10, 2)
+      10.times do |i|
+        @buf[i] = [i, i]
+      end
+    end
+
+    it "should yield the elements in order" do
+      i = 0
+      @buf.each do |left, right|
+        left.should == i
+        right.should == i
+        i += 1
+      end
+    end
+
+    it "shouldn't do anything on an empty buffer" do
+      buf = RubyAudio::Buffer.int(0, 2)
+
+      buf.each do
+        fail "This shouldn't be executed"
+      end
+    end
+  end
+end

data/spec/sound_info_spec.rb

@@ -0,0 +1,49 @@
+require "spec_helper.rb"
+
+describe RubyAudio::SoundInfo do
+  it "should initialize with default properties" do
+    info = RubyAudio::SoundInfo.new
+    info.channels.should == 0
+    info.samplerate.should == 0
+    info.format.should == 0
+  end
+
+  it "should allow setting properties on initialize" do
+    info = RubyAudio::SoundInfo.new(:channels => 1, :samplerate => 48000, :format => RubyAudio::FORMAT_WAV|RubyAudio::FORMAT_PCM_16)
+    info.channels.should == 1
+    info.samplerate.should == 48000
+    info.format.should == RubyAudio::FORMAT_WAV|RubyAudio::FORMAT_PCM_16
+  end
+
+  it "should allow setting properties after initialize" do
+    info = RubyAudio::SoundInfo.new
+    info.channels = 3
+    info.channels.should == 3
+  end
+
+  it "should not be valid if properties invalid" do
+    info = RubyAudio::SoundInfo.new(:channels => 1, :samplerate => 48000, :format => RubyAudio::FORMAT_WAV)
+    info.valid?.should == false
+    info.format = RubyAudio::FORMAT_WAV|RubyAudio::FORMAT_PCM_16
+    info.valid?.should == true
+  end
+
+  it "should allow cloning" do
+    info = RubyAudio::SoundInfo.new(:channels => 1, :samplerate => 48000, :format => RubyAudio::FORMAT_WAV|RubyAudio::FORMAT_PCM_16)
+    info2 = info.clone
+    info.object_id.should_not == info2.object_id
+    info.channels.should == info2.channels
+    info.samplerate.should == info2.samplerate
+    info.format.should == info2.format
+  end
+
+  it "should calculate main and sub format from format" do
+    info = RubyAudio::SoundInfo.new(:format => RubyAudio::FORMAT_WAV|RubyAudio::FORMAT_PCM_16)
+    info.main_format.should == "FORMAT_WAV"
+    info.sub_format.should == "FORMAT_PCM_16"
+
+    info = RubyAudio::SoundInfo.new(:format => RubyAudio::FORMAT_WAVEX|RubyAudio::FORMAT_MS_ADPCM)
+    info.main_format.should == "FORMAT_WAVEX"
+    info.sub_format.should == "FORMAT_MS_ADPCM"
+  end
+end

data/spec/sound_spec.rb

@@ -0,0 +1,182 @@
+require "spec_helper.rb"
+
+describe RubyAudio::Sound do
+  MONO_TEST_WAV = File.dirname(__FILE__)+'/data/what.wav'
+  STEREO_TEST_WAV = File.dirname(__FILE__)+'/data/what2.wav'
+  TEST_MP3 = File.dirname(__FILE__)+'/data/what.mp3'
+  OUT_WAV = File.dirname(__FILE__)+'/data/temp.wav'
+
+  after :each do
+    File.delete(OUT_WAV) if File.exists?(OUT_WAV)
+  end
+
+  it "should open a standard wav without issues" do
+    lambda {
+      RubyAudio::Sound.open(MONO_TEST_WAV)
+    }.should_not raise_error
+  end
+
+  it "should raise an exception if the mode is invalid" do
+    lambda {
+      RubyAudio::Sound.open(MONO_TEST_WAV, 'q')
+    }.should raise_error(ArgumentError, 'invalid access mode q')
+  end
+
+  it "should close the sound on block exit" do
+    s = nil
+    RubyAudio::Sound.open(MONO_TEST_WAV) do |snd|
+      snd.closed?.should be_false
+      s = snd
+    end
+    s.closed?.should be_true
+  end
+
+  it "should raise an exception for an unsupported file" do
+    lambda {
+      RubyAudio::Sound.open(TEST_MP3)
+    }.should raise_error(RubyAudio::Error, "File contains data in an unknown format.")
+  end
+
+  it "should raise an exception if file does not exist" do
+    lambda {
+      RubyAudio::Sound.open(TEST_MP3+'.not')
+    }.should raise_error(RubyAudio::Error, "System error : No such file or directory.")
+  end
+
+  it "should have the proper sound info" do
+    RubyAudio::Sound.open(MONO_TEST_WAV) do |snd|
+      snd.info.channels.should == 1
+      snd.info.samplerate.should == 16000
+      snd.info.format.should == RubyAudio::FORMAT_WAV|RubyAudio::FORMAT_PCM_16
+    end
+  end
+
+  it "should allow seeking" do
+    lambda {
+      RubyAudio::Sound.open(MONO_TEST_WAV) do |snd|
+        snd.seek(100)
+        buf = snd.read(:float, 100)
+        buf[0].should > 0
+      end
+    }.should_not raise_error
+  end
+
+  it "should raise exceptions for invalid seeks" do
+    lambda {
+      RubyAudio::Sound.open(MONO_TEST_WAV) {|snd| snd.seek(-1)}
+    }.should raise_error(RubyAudio::Error, "invalid seek")
+    lambda {
+      RubyAudio::Sound.open(MONO_TEST_WAV) {|snd| snd.seek(1000000)}
+    }.should raise_error(RubyAudio::Error, "invalid seek")
+  end
+
+  it "should allow reading samples from the sound" do
+    RubyAudio::Sound.open(STEREO_TEST_WAV) do |snd|
+      buf = snd.read(:float, 1000)
+      buf.size.should == 1000
+      buf.real_size.should == 1000
+      buf[999].length.should == 2
+    end
+  end
+
+  it "should allow reading into an existing buffer" do
+    buf = RubyAudio::Buffer.float(1000)
+    buf.real_size.should == 0
+    RubyAudio::Sound.open(MONO_TEST_WAV) do |snd|
+      snd.read(buf)
+    end
+    buf.real_size.should == 1000
+    buf[99].should > 0
+  end
+
+  it "should allow reading into an existing buffer partially" do
+    buf = RubyAudio::Buffer.float(1000)
+    buf.real_size.should == 0
+    RubyAudio::Sound.open(MONO_TEST_WAV) do |snd|
+      snd.read(buf, 100)
+    end
+    buf.real_size.should == 100
+    buf[99].should > 0
+    buf[100].should == nil
+  end
+
+  it "should allow downmixing to mono on read" do
+    buf = RubyAudio::Buffer.int(100, 1)
+    buf2 = RubyAudio::Buffer.int(100, 2)
+    RubyAudio::Sound.open(STEREO_TEST_WAV, 'r') do |snd|
+      snd.read(buf)
+      snd.seek(0)
+      snd.read(buf2)
+
+      f = buf2[99]
+      buf[99].should == (f[0] + f[1]) / 2
+    end
+  end
+
+  it "should allow upmixing from mono on read" do
+    buf = RubyAudio::Buffer.int(100, 1)
+    buf2 = RubyAudio::Buffer.int(100, 2)
+    RubyAudio::Sound.open(STEREO_TEST_WAV, 'r') do |snd|
+      snd.read(buf2)
+      snd.seek(0)
+      snd.read(buf)
+
+      buf2[99].should == [buf[99], buf[99]]
+    end
+  end
+
+  it "should fail read on unsupported up/downmixing" do
+    buf = RubyAudio::Buffer.float(100, 5)
+    lambda {
+      RubyAudio::Sound.open(STEREO_TEST_WAV) do |snd|
+        snd.read(buf)
+      end
+    }.should raise_error(RubyAudio::Error, "unsupported mix from 5 to 2")
+  end
+
+  it "should allow writing to a new sound" do
+    in_buf = RubyAudio::Buffer.float(100)
+    out_buf = RubyAudio::Buffer.float(100)
+    out_info = nil
+    RubyAudio::Sound.open(MONO_TEST_WAV) do |snd|
+      snd.read(in_buf)
+      out_info = snd.info.clone
+    end
+
+    RubyAudio::Sound.open(OUT_WAV, 'rw', out_info) do |snd|
+      snd.write(in_buf)
+      snd.seek(0)
+      snd.read(out_buf)
+    end
+
+    out_buf[50].should == in_buf[50]
+  end
+
+  it "should allow writing to a new sound using <<" do
+    in_buf = RubyAudio::Buffer.float(100)
+    out_buf = RubyAudio::Buffer.float(100)
+    out_info = nil
+    RubyAudio::Sound.open(MONO_TEST_WAV) do |snd|
+      snd.read(in_buf)
+      out_info = snd.info.clone
+    end
+
+    RubyAudio::Sound.open(OUT_WAV, 'rw', out_info) do |snd|
+      snd << in_buf
+      snd.seek(0)
+      snd.read(out_buf)
+    end
+
+    out_buf[50].should == in_buf[50]
+  end
+
+  it "should fail write on channel mismatch" do
+    buf = RubyAudio::Buffer.float(100, 5)
+    info = RubyAudio::SoundInfo.new :channels => 2, :samplerate => 48000, :format => RubyAudio::FORMAT_WAV|RubyAudio::FORMAT_PCM_16
+    lambda {
+      RubyAudio::Sound.open(OUT_WAV, 'w', info) do |snd|
+        snd.write(buf)
+      end
+    }.should raise_error(RubyAudio::Error, "channel count mismatch: 5 vs 2")
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,2 @@
+--colour
+-f nested

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  gem 'rspec'
+  require 'spec'
+end
+require 'spec/autorun'
+
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'ruby-audio'

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification 
+name: ruby-audio
+version: !ruby/object:Gem::Version 
+  hash: 3
+  prerelease: false
+  segments: 
+  - 1
+  - 5
+  - 0
+  version: 1.5.0
+platform: x86-mingw32
+authors: 
+- Stephen Augenstein
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-06 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: ruby-audio wraps around libsndfile to provide simplified sound reading and writing support to ruby programs
+email: 
+- perl.programmer@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- ext/rubyaudio_ext/ra_buffer.c
+- ext/rubyaudio_ext/ra_sound.c
+- ext/rubyaudio_ext/ra_soundinfo.c
+- ext/rubyaudio_ext/rubyaudio_ext.c
+files: 
+- ruby-audio.gemspec
+- README.rdoc
+- LICENSE
+- Rakefile
+- lib/ruby-audio/buffer.rb
+- lib/ruby-audio/sound.rb
+- lib/ruby-audio/sound_info.rb
+- lib/ruby-audio.rb
+- spec/buffer_spec.rb
+- spec/sound_info_spec.rb
+- spec/sound_spec.rb
+- spec/spec_helper.rb
+- spec/spec.opts
+- spec/data/what.wav
+- spec/data/what2.wav
+- spec/data/what.mp3
+- ext/rubyaudio_ext/ra_buffer.c
+- ext/rubyaudio_ext/ra_sound.c
+- ext/rubyaudio_ext/ra_soundinfo.c
+- ext/rubyaudio_ext/rubyaudio_ext.c
+- ext/rubyaudio_ext/ra_buffer.h
+- ext/rubyaudio_ext/ra_sound.h
+- ext/rubyaudio_ext/ra_soundinfo.h
+- ext/rubyaudio_ext/extconf.rb
+- lib/1.8/rubyaudio_ext.so
+- lib/1.9/rubyaudio_ext.so
+has_rdoc: true
+homepage: http://github.com/warhammerkid/ruby-audio
+licenses: []
+
+post_install_message: You installed the binary version of this gem!
+rdoc_options: 
+- --line-numbers
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: 
+- libsndfile (http://www.mega-nerd.com/libsndfile/)
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: libsndfile wrapper for ruby
+test_files: 
+- spec/buffer_spec.rb
+- spec/sound_info_spec.rb
+- spec/sound_spec.rb