wavefile 0.3.0 → 0.4.0

metadata

@@ -1,58 +1,97 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: wavefile
-version: !ruby/object:Gem::Version 
-  version: 0.3.0
+version: !ruby/object:Gem::Version
+  version: 0.4.0
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Joel Strait
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2010-01-12 00:00:00 -05:00
-default_executable: 
+date: 2012-01-01 00:00:00.000000000 Z
 dependencies: []
-
 description: 
-email: joel.strait at gmail.com
+email: joel dot strait at Google's popular web mail service
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - LICENSE
 - README.markdown
+- Rakefile
+- lib/wavefile/buffer.rb
+- lib/wavefile/format.rb
+- lib/wavefile/info.rb
+- lib/wavefile/reader.rb
+- lib/wavefile/writer.rb
 - lib/wavefile.rb
-- test/wavefile_test.rb
-has_rdoc: true
+- test/buffer_test.rb
+- test/fixtures/actual_output/valid_mono_8_44100_with_padding_byte.wav
+- test/fixtures/expected_output/no_samples.wav
+- test/fixtures/expected_output/valid_mono_16_44100.wav
+- test/fixtures/expected_output/valid_mono_32_44100.wav
+- test/fixtures/expected_output/valid_mono_8_44100.wav
+- test/fixtures/expected_output/valid_mono_8_44100_with_padding_byte.wav
+- test/fixtures/expected_output/valid_stereo_16_44100.wav
+- test/fixtures/expected_output/valid_stereo_32_44100.wav
+- test/fixtures/expected_output/valid_stereo_8_44100.wav
+- test/fixtures/expected_output/valid_tri_16_44100.wav
+- test/fixtures/expected_output/valid_tri_32_44100.wav
+- test/fixtures/expected_output/valid_tri_8_44100.wav
+- test/fixtures/invalid/bad_riff_header.wav
+- test/fixtures/invalid/bad_wavefile_format.wav
+- test/fixtures/invalid/empty.wav
+- test/fixtures/invalid/empty_format_chunk.wav
+- test/fixtures/invalid/incomplete_riff_header.wav
+- test/fixtures/invalid/insufficient_format_chunk.wav
+- test/fixtures/invalid/no_data_chunk.wav
+- test/fixtures/invalid/no_format_chunk.wav
+- test/fixtures/invalid/README.markdown
+- test/fixtures/unsupported/bad_audio_format.wav
+- test/fixtures/unsupported/bad_channel_count.wav
+- test/fixtures/unsupported/bad_sample_rate.wav
+- test/fixtures/unsupported/README.markdown
+- test/fixtures/unsupported/unsupported_audio_format.wav
+- test/fixtures/unsupported/unsupported_bits_per_sample.wav
+- test/fixtures/valid/README.markdown
+- test/fixtures/valid/valid_mono_16_44100.wav
+- test/fixtures/valid/valid_mono_32_44100.wav
+- test/fixtures/valid/valid_mono_8_44100.wav
+- test/fixtures/valid/valid_mono_8_44100_with_padding_byte.wav
+- test/fixtures/valid/valid_stereo_16_44100.wav
+- test/fixtures/valid/valid_stereo_32_44100.wav
+- test/fixtures/valid/valid_stereo_8_44100.wav
+- test/fixtures/valid/valid_tri_16_44100.wav
+- test/fixtures/valid/valid_tri_32_44100.wav
+- test/fixtures/valid/valid_tri_8_44100.wav
+- test/format_test.rb
+- test/info_test.rb
+- test/reader_test.rb
+- test/wavefile_io_test_helper.rb
+- test/writer_test.rb
 homepage: http://www.joelstrait.com/
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.3.5
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
 summary: A class for reading and writing Wave sound files (*.wav)
 test_files: []
-

data/test/wavefile_test.rb

@@ -1,339 +0,0 @@
-$:.unshift File.join(File.dirname(__FILE__),'..','lib')
-
-require 'test/unit'
-require 'wavefile'
-
-class WaveFileTest < Test::Unit::TestCase
-  def test_initialize
-
-  end
-  
-  def test_read_empty_file
-    assert_raise(StandardError) { w = WaveFile.open("examples/invalid/empty.wav") }
-  end
-  
-  def test_read_nonexistent_file
-    assert_raise(Errno::ENOENT) { w = WaveFile.open("examples/invalid/nonexistent.wav") }
-  end
-
-  def test_read_valid_file
-    # Mono file
-    w = WaveFile.open("examples/valid/sine-mono-8bit.wav")
-    assert_equal(w.num_channels, 1)
-    assert_equal(w.mono?, true)
-    assert_equal(w.stereo?, false)
-    assert_equal(w.sample_rate, 44100)
-    assert_equal(w.bits_per_sample, 8)
-    assert_equal(w.byte_rate, 44100)
-    assert_equal(w.block_align, 1)
-    assert_equal(w.sample_data.length, 44100)
-    # Test that sample array is in format [sample, sample ... sample]
-    valid = true
-    w.sample_data.each{|sample| valid &&= (sample.class == Fixnum)}
-    assert_equal(valid, true)
-    
-    # Stereo file
-    w = WaveFile.open("examples/valid/sine-stereo-8bit.wav")
-    assert_equal(w.num_channels, 2)
-    assert_equal(w.mono?, false)
-    assert_equal(w.stereo?, true)
-    assert_equal(w.sample_rate, 44100)
-    assert_equal(w.bits_per_sample, 8)
-    assert_equal(w.byte_rate, 88200)
-    assert_equal(w.block_align, 2)
-    assert_equal(w.sample_data.length, 44100)
-    # Test that sample array is in format [[left, right], [left, right] ... [left,right]]
-    valid = true
-    w.sample_data.each{|sample| valid &&= (sample.class == Array) && (sample.length == 2)}
-    assert_equal(valid, true)
-  end
-  
-  def test_new_file
-    # Mono
-    w = WaveFile.new(1, 44100, 8)
-    assert_equal(w.num_channels, 1)
-    assert_equal(w.sample_rate, 44100)
-    assert_equal(w.bits_per_sample, 8)
-    assert_equal(w.byte_rate, 44100)
-    assert_equal(w.block_align, 1)
-    
-    # Mono
-    w = WaveFile.new(:mono, 44100, 8)
-    assert_equal(w.num_channels, 1)
-    assert_equal(w.sample_rate, 44100)
-    assert_equal(w.bits_per_sample, 8)
-    assert_equal(w.byte_rate, 44100)
-    assert_equal(w.block_align, 1)
-    
-    # Stereo
-    w = WaveFile.new(2, 44100, 16)
-    assert_equal(w.num_channels, 2)
-    assert_equal(w.sample_rate, 44100)
-    assert_equal(w.bits_per_sample, 16)
-    assert_equal(w.byte_rate, 176400)
-    assert_equal(w.block_align, 4)
-    
-    # Stereo
-    w = WaveFile.new(:stereo, 44100, 16)
-    assert_equal(w.num_channels, 2)
-    assert_equal(w.sample_rate, 44100)
-    assert_equal(w.bits_per_sample, 16)
-    assert_equal(w.byte_rate, 176400)
-    assert_equal(w.block_align, 4)
-    
-    # Quad
-    w = WaveFile.new(4, 44100, 16)
-    assert_equal(w.num_channels, 4)
-    assert_equal(w.sample_rate, 44100)
-    assert_equal(w.bits_per_sample, 16)
-    assert_equal(w.byte_rate, 352800)
-    assert_equal(w.block_align, 8)
-  end
-  
-  def test_normalized_sample_data
-    # Mono 8-bit
-    w = WaveFile.new(:mono, 44100, 8)
-    w.sample_data = [0, 32, 64, 96, 128, 160, 192, 223, 255]
-    assert_equal(w.normalized_sample_data, [-1.0, -0.75, -0.5, -0.25, 0.0,
-                                            (32.0 / 127.0), (64.0 / 127.0), (95.0 / 127.0), 1.0])
-    
-    # Mono 16-bit
-    w = WaveFile.new(:mono, 44100, 16)
-    w.sample_data = [-32768, -24576, -16384, -8192, 0, 8192, 16383, 24575, 32767]
-    assert_equal(w.normalized_sample_data, [-1.0, -0.75, -0.5, -0.25, 0.0,
-                                            (8192.0 / 32767.0), (16383.0 / 32767.0), (24575.0 / 32767.0), 1.0])
-    
-    # Stereo 8-bit
-    w = WaveFile.new(:stereo, 44100, 8)
-    w.sample_data = [[0, 255], [32, 223], [64, 192], [96, 160], [128, 128], [160, 96], [192, 64], [223, 32], [255, 0]]
-    assert_equal(w.normalized_sample_data, [[-1.0, 1.0],
-                                            [-0.75, (95.0 / 127.0)],
-                                            [-0.5, (64.0 / 127.0)],
-                                            [-0.25, (32.0 / 127.0)],
-                                            [0.0, 0.0],
-                                            [(32.0 / 127.0), -0.25],
-                                            [(64.0 / 127.0), -0.5],
-                                            [(95.0 / 127.0), -0.75],
-                                            [1.0, -1.0]])
-                                           
-    # Stereo 16-bit
-    w = WaveFile.new(:stereo, 44100, 16)
-    w.sample_data = [[-32768, 32767], [-24576, 24575], [-16384, 16384], [-8192, 8192], [0, 0], [8192, -8192], [16384, -16384], [24575, -24576], [32767, -32768]]
-    assert_equal(w.normalized_sample_data, [[-1.0, 1.0],
-                                            [-0.75, (24575.0 / 32767.0)],
-                                            [-0.5, (16384.0 / 32767.0)],
-                                            [-0.25, (8192.0 / 32767.0)],
-                                            [0.0, 0.0],
-                                            [(8192.0 / 32767.0), -0.25],
-                                            [(16384.0 / 32767.0), -0.5],
-                                            [(24575.0 / 32767.0), -0.75],
-                                            [1.0, -1.0]])
-  end
-  
-  def test_sample_data=
-    # Mono 8-bit
-    w = WaveFile.new(:mono, 44100, 8)
-    w.sample_data = [-1.0, -0.75, -0.5, -0.25, 0.0, 0.25, 0.5, 0.75, 1.0]
-    assert_equal(w.sample_data, [0, 32, 64, 96, 128, 160, 192, 223, 255])
-    
-    # Mono 16-bit
-    w = WaveFile.new(:mono, 44100, 16)
-    w.sample_data = [-1.0, -0.75, -0.5, -0.25, 0.0, 0.25, 0.5, 0.75, 1.0]
-    assert_equal(w.sample_data, [-32768, -24576, -16384, -8192, 0, 8192, 16384, 24575, 32767])
-    
-    # Stereo 8-bit
-    w = WaveFile.new(:stereo, 44100, 8)
-    w.sample_data = [[-1.0, 1.0], [-0.75, 0.75], [-0.5, 0.5], [-0.25, 0.25], [0.0, 0.0],
-                     [0.25, -0.25], [0.5, -0.5], [0.75, -0.75], [1.0, -1.0]]
-    assert_equal(w.sample_data, [[0, 255], [32, 223], [64, 192], [96, 160], [128, 128],
-                                 [160, 96], [192, 64], [223, 32], [255, 0]])
-    
-    # Stereo 16-bit
-    w = WaveFile.new(:stereo, 44100, 16)
-    w.sample_data = [[-1.0, 1.0], [-0.75, 0.75], [-0.5, 0.5], [-0.25, 0.25], [0.0, 0.0],
-                     [0.25, -0.25], [0.5, -0.5], [0.75, -0.75], [1.0, -1.0]]
-    assert_equal(w.sample_data, [[-32768, 32767], [-24576, 24575], [-16384, 16384], [-8192, 8192], [0, 0],
-                                 [8192, -8192], [16384, -16384], [24575, -24576], [32767, -32768]])
-  end
-  
-  def test_mono?
-    w = WaveFile.new(1, 44100, 16)
-    assert_equal(w.mono?, true)
-    
-    w = WaveFile.open("examples/valid/sine-mono-8bit.wav")
-    assert_equal(w.mono?, true)
-    
-    w = WaveFile.new(2, 44100, 16)
-    assert_equal(w.mono?, false)
-    
-    w = WaveFile.new(4, 44100, 16)
-    assert_equal(w.mono?, false)
-  end
-  
-  def test_stereo?
-    w = WaveFile.new(1, 44100, 16)
-    assert_equal(w.stereo?, false)
-    
-    w = WaveFile.open("examples/valid/sine-mono-8bit.wav")
-    assert_equal(w.stereo?, false)
-    
-    w = WaveFile.new(2, 44100, 16)
-    assert_equal(w.stereo?, true)
-    
-    w = WaveFile.new(4, 44100, 16)
-    assert_equal(w.stereo?, false)
-  end
-  
-  def test_reverse
-    # Mono
-    w = WaveFile.new(:mono, 44100, 16)
-    w.sample_data = [1, 2, 3, 4, 5]
-    w.reverse
-    assert_equal(w.sample_data, [5, 4, 3, 2, 1])
-  
-    # Stereo
-    w = WaveFile.new(:stereo, 44100, 16)
-    w.sample_data = [[1, 9], [2, 8], [3, 7], [4, 6], [5, 5]]
-    w.reverse
-    assert_equal(w.sample_data, [[5, 5], [4, 6], [3, 7], [2, 8], [1, 9]])
-  end
-  
-  def test_duration()
-    sample_rate = 44100
-    
-    [30001, 22050, 44100].each {|bits_per_sample|
-      [8, 16].each {|bits_per_sample|
-        [:mono, :stereo].each {|num_channels|
-          w = WaveFile.new(num_channels, sample_rate, bits_per_sample)
-          
-          w.sample_data = []
-          assert_equal(w.duration, {:hours => 0, :minutes => 0, :seconds => 0, :milliseconds => 0})
-          w.sample_data = get_duration_test_samples(num_channels, (sample_rate.to_f / 1000.0).floor)
-          assert_equal(w.duration, {:hours => 0, :minutes => 0, :seconds => 0, :milliseconds => 0})
-          w.sample_data = get_duration_test_samples(num_channels, (sample_rate.to_f / 1000.0).ceil)
-          assert_equal(w.duration, {:hours => 0, :minutes => 0, :seconds => 0, :milliseconds => 1})
-          w.sample_data = get_duration_test_samples(num_channels, sample_rate / 2)
-          assert_equal(w.duration, {:hours => 0, :minutes => 0, :seconds => 0, :milliseconds => 500})
-          w.sample_data = get_duration_test_samples(num_channels, sample_rate - 1)
-          assert_equal(w.duration, {:hours => 0, :minutes => 0, :seconds => 0, :milliseconds => 999})
-          w.sample_data = get_duration_test_samples(num_channels, sample_rate)
-          assert_equal(w.duration, {:hours => 0, :minutes => 0, :seconds => 1, :milliseconds => 0})
-          w.sample_data = get_duration_test_samples(num_channels, sample_rate * 2)
-          assert_equal(w.duration, {:hours => 0, :minutes => 0, :seconds => 2, :milliseconds => 0})
-          w.sample_data = get_duration_test_samples(num_channels, (sample_rate / 2) * 3)
-          assert_equal(w.duration, {:hours => 0, :minutes => 0, :seconds => 1, :milliseconds => 500})
-          
-          # These tests currently take too long to run...
-          #w.sample_data = [].fill(0.0, 0, sample_rate * 60)
-          #assert_equal(w.duration, {:hours => 0, :minutes => 1, :seconds => 0, :milliseconds => 0})
-          #w.sample_data = [].fill(0.0, 0, sample_rate * 60 * 60)
-          #assert_equal(w.duration, {:hours => 1, :minutes => 0, :seconds => 0, :milliseconds => 0})
-        }
-      }
-    }
-  end
-  
-  def get_duration_test_samples(num_channels, num_samples)
-    if num_channels == :mono || num_channels == 1
-      return [].fill(0.0, 0, num_samples)
-    elsif num_channels == :stereo || num_channels == 2
-      return [].fill([0.0, 0.0], 0, num_samples)
-    else
-      return "error"
-    end
-  end
-  
-  def test_bits_per_sample=()
-    # Set bits_per_sample to invalid value (non-8 or non-16)
-    w = WaveFile.open("examples/valid/sine-mono-8bit.wav")
-    assert_raise(StandardError) { w.bits_per_sample = 20 }
-    w = WaveFile.new(:mono, 44100, 16)
-    assert_raise(StandardError) { w.bits_per_sample = 4 }
-    
-    w_before = WaveFile.open("examples/valid/sine-mono-8bit.wav")
-    w_after = WaveFile.open("examples/valid/sine-mono-8bit.wav")
-    w_after.bits_per_sample = 8
-    assert_equal(w_before.sample_data, w_after.sample_data)
-    
-    w_before = WaveFile.open("examples/valid/sine-stereo-8bit.wav")
-    w_after = WaveFile.open("examples/valid/sine-stereo-8bit.wav")
-    w_after.bits_per_sample = 8
-    assert_equal(w_before.sample_data, w_after.sample_data)
-    
-    # Open mono 16 bit file, change to 16 bit, still the same
-    # Open stereo 16 bit file, change to 16 bit, still the same
-    
-    # Open mono 8 bit file, convert to 16 bit
-    w = WaveFile.new(:mono, 44100, 8)
-    w.sample_data = [0, 32, 64, 96, 128, 160, 192, 223, 255]
-    w.bits_per_sample = 16
-    assert_equal(w.sample_data, [-32768, -24576, -16384, -8192, 0, 8256, 16513, 24511, 32767])
-    
-    # Open stereo 8 bit file, convert to 16 bit
-    w = WaveFile.new(:stereo, 44100, 8)
-    w.sample_data = [[0, 255], [32, 223], [64, 192], [96, 160], [128, 128],
-                    [160, 96], [192, 64], [223, 32], [255, 0]]
-    w.bits_per_sample = 16
-    assert_equal(w.sample_data, [[-32768, 32767], [-24576, 24511], [-16384, 16513], [-8192, 8256], [0, 0],
-                                 [8256, -8192], [16513, -16384], [24511, -24576], [32767, -32768]])
-    
-    # Open mono 16 bit file, convert to 8 bit
-    w = WaveFile.new(:mono, 44100, 16)
-    w.sample_data = [-32768, -24576, -16384, -8192, 0, 8256, 16513, 24511, 32767]
-    w.bits_per_sample = 8
-    assert_equal(w.sample_data, [0, 32, 64, 96, 128, 160, 192, 223, 255])
-    
-    # Open stereo 16 bit file, convert to 8 bit, conversion successful
-    w = WaveFile.new(:stereo, 44100, 16)
-    w.sample_data = [[-32768, 32767], [-24576, 24511], [-16384, 16513], [-8192, 8256], [0, 0],
-                     [8256, -8192], [16513, -16384], [24511, -24576], [32767, -32768]]
-    w.bits_per_sample = 8
-    assert_equal(w.sample_data, [[0, 255], [32, 223], [64, 192], [96, 160], [128, 128],
-                                 [160, 96], [192, 64], [223, 32], [255, 0]])
-    
-    # Open 8 bit mono, convert to 16 bit, back to 8 bit.
-    w_before = WaveFile.open("examples/valid/sine-mono-8bit.wav")
-    w_after = WaveFile.open("examples/valid/sine-mono-8bit.wav")
-    w_after.bits_per_sample = 16
-    assert_not_equal(w_before.sample_data, w_after.sample_data)
-    w_after.bits_per_sample = 8
-    assert_equal(w_before.sample_data, w_after.sample_data)
-    
-    # Open 8 bit stereo, convert to 16 bit, back to 8 bit.
-    w_before = WaveFile.open("examples/valid/sine-stereo-8bit.wav")
-    w_after = WaveFile.open("examples/valid/sine-stereo-8bit.wav")
-    w_after.bits_per_sample = 16
-    assert_not_equal(w_before.sample_data, w_after.sample_data)
-    w_after.bits_per_sample = 8
-    assert_equal(w_before.sample_data, w_after.sample_data)
-    
-    # Open 16 bit mono, convert to 8 bit, back to 16 bit.
-    # Open 16 bit stereo, convert to 8 bit, back to 16 bit.
-  end
-  
-  def test_num_channels=()
-    w = WaveFile.new(:mono, 44100, 16)
-    w.sample_data = [-32768, -24576, -16384, -8192, 0, 8256, 16513, 24511, 32767]
-    w.num_channels = 2
-    assert_equal(w.sample_data, [[-32768, -32768], [-24576, -24576], [-16384, -16384], [-8192, -8192], [0, 0],
-                                 [8256, 8256], [16513, 16513], [24511, 24511], [32767, 32767]])
-                                 
-    w = WaveFile.new(:mono, 44100, 16)
-    w.sample_data = [-32768, -24576, -16384, -8192, 0, 8256, 16513, 24511, 32767]
-    w.num_channels = 3
-    assert_equal(w.sample_data, [[-32768, -32768, -32768], [-24576, -24576, -24576], [-16384, -16384, -16384], [-8192, -8192, -8192], [0, 0, 0],
-                                [8256, 8256, 8256], [16513, 16513, 16513], [24511, 24511, 24511], [32767, 32767, 32767]])
-                                
-    w = WaveFile.new(:stereo, 44100, 16)
-    w.sample_data = [[-32768, -32768], [-24576, -24576], [-16384, -16384], [-8192, -8192], [0, 0],
-                     [8256, 8256], [16513, 16513], [24511, 24511], [32767, 32767]]
-    w.num_channels = 1
-    assert_equal(w.sample_data, [-32768, -24576, -16384, -8192, 0, 8256, 16513, 24511, 32767])
-    
-    w = WaveFile.new(3, 44100, 16)
-    w.sample_data = [[-32768, -32768, -32768], [-24576, -24576, -24576], [-16384, -16384, -16384], [-8192, -8192, -8192], [0, 0, 0],
-                     [8256, 8256, 8256], [16513, 16513, 16513], [24511, 24511, 24511], [32767, 32767, 32767]]
-    w.num_channels = 1
-    assert_equal(w.sample_data, [-32768, -24576, -16384, -8192, 0, 8256, 16513, 24511, 32767])
-  end
-end