sndfile 0.1.0

data/.gitignore

@@ -0,0 +1,43 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+spec/outputs/*
+
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+#.DS_Store
+#
+# For TextMate
+#*.tmproj
+#tmtags
+#
+# For emacs:
+#*~
+#\#*
+#.\#*
+#
+# For vim:
+#*.swp
+

data/Gemfile

@@ -0,0 +1,3 @@
+source 'http://rubygems.org'
+
+gemspec

data/README.md

@@ -0,0 +1,45 @@
+Libsndfile for Ruby
+-------------
+
+*sndfile* provides a fast and easy way to read, process, and write audio
+file data.  It wraps the [libsndfile](http://www.mega-nerd.com/libsndfile/)
+C library via [FFI](http://github.com/ffi/ffi), reading & writing the
+sample data as a [GSLng](https://github.com/v01d/ruby-gsl-ng) matrix.
+
+The author has (so far) fleshed out only the parts needed for his own projects.  Please do fork this project and contribute to it.
+
+Libsndfile?
+===========
+"Libsndfile is a C library for reading and writing files containing sampled sound (such as MS Windows WAV and the Apple/SGI AIFF format) through one standard library interface. It is released in source code format under the Gnu Lesser General Public License."
+
+
+Installation
+============
+
+To use this Ruby library, you must have [libsndfile](http://www.mega-nerd.com/libsndfile/) and [GSL](http://www.gnu.org/software/gsl/) on your machine. You can install
+them via apt-get (linux) or homebrew (OS X) or download them directly from their websites.
+
+That being said:
+
+  gem install sndfile
+
+or, in a Gemfile
+
+  gem "sndfile-ruby", :require => "sndfile"
+
+Usage
+=====
+Here's a simple example, that reads an arbitrary source file and produces a WAV file at half the volume:
+
+    fin = Sndfile::File.new(inpath)
+    Sndfile::File.open(outpath, :mode => :WRITE, :format => :WAV, :encoding => :PCM_16, :channels => fin.channels, :samplerate => fin.samplerate) do |fout|
+      while data = fin.read(10000)
+        fout.write(data * 0.5)
+      end
+    end
+
+See the [RDOC](http://rubydoc.info/gems/sndfile) for more info.
+
+
+History
+=======

data/Rakefile

@@ -0,0 +1,17 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.main = 'README.rdoc'
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "sndfile #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.rspec_opts = '-Ispec'
+end

data/lib/gsl-ng/matrix.rb

@@ -0,0 +1,38 @@
+# GSLng::Matrix is extended with two aliases:
+#
+# GSLng::Matrix#frames, which is an alias for GSLng::Matrix#m and GSLng::Matrix#height
+#
+# GSLng::Matrix#channels, which is an alias for GSLng::Matrix#n and GSLng::Matrix#width
+#
+class GSLng::Matrix
+
+ 
+  # @method frames
+  # frames is an alias for GSLng::Matrix#m and GSLng::Matrix#height
+  #
+  alias :frames :m
+  
+  
+  # @method channels
+  # channels is an alias for GSLng::Matrix#n and GSLng::Matrix#width
+  #
+  alias :channels :n
+
+  unless instance_methods.include? :data_ptr
+
+    class GSL_matrix < FFI::Struct # :nodoc:
+      layout :size1, :size_t,
+        :size2, :size_t,
+        :tda, :size_t,
+        :data, :pointer,
+        :block, :pointer,
+        :owner, :int
+    end
+
+    def data_ptr # :nodoc:
+      GSL_matrix.new(ptr)[:data]
+    end
+
+  end
+
+end

data/lib/sndfile.rb

@@ -0,0 +1,9 @@
+require 'ffi'
+require 'gslng'
+require 'hash_keyword_args'
+
+require 'gsl-ng/matrix'
+require 'sndfile/enums'
+require 'sndfile/error'
+require 'sndfile/sndfile_api'
+require 'sndfile/file'

data/lib/sndfile/enums.rb

@@ -0,0 +1,181 @@
+module Sndfile # :nodoc: all
+  module Enums
+    extend FFI::Library
+
+    # Error Codes
+    ErrorCode = enum(
+      :SF_ERR_NO_ERROR,             0,
+      :SF_ERR_UNRECOGNISED_FORMAT,  1,
+      :SF_ERR_SYSTEM,               2,
+      :SF_ERR_MALFORMED_FILE,       3,
+      :SF_ERR_UNSUPPORTED_ENCODING, 4,
+    )
+      
+
+    # Modes for opening files.
+    FileMode = enum(
+      :READ,  0x10,
+      :WRITE,  0x20,
+      :RDWR,  0x30,
+    )
+
+    # Major formats.
+    FORMAT_MASK =  0x0FFF0000
+    Format = enum(
+      :WAV,           0x010000,     # Microsoft WAV format (little endian).
+      :AIFF,          0x020000,     # Apple/SGI AIFF format (big endian).
+      :AU,            0x030000,     # Sun/NeXT AU format (big endian).
+      :RAW,           0x040000,     # RAW PCM data.
+      :PAF,           0x050000,     # Ensoniq PARIS file format.
+      :SVX,           0x060000,     # Amiga IFF / SVX8 / SV16 format.
+      :NIST,          0x070000,     # Sphere NIST format.
+      :VOC,           0x080000,     # VOC files.
+      :IRCAM,         0x0A0000,     # Berkeley/IRCAM/CARL
+      :W64,           0x0B0000,     # Sonic Foundry's 64 bit RIFF/WAV
+      :MAT4,          0x0C0000,     # Matlab (tm) V4.2 / GNU Octave 2.0
+      :MAT5,          0x0D0000,     # Matlab (tm) V5.0 / GNU Octave 2.1
+      :PVF,           0x0E0000,     # Portable Voice Format
+      :XI,            0x0F0000,     # Fasttracker 2 Extended Instrument
+      :HTK,           0x100000,     # HMM Tool Kit format
+      :SDS,           0x110000,     # Midi Sample Dump Standard
+      :AVR,           0x120000,     # Audio Visual Research
+      :WAVEX,         0x130000,     # MS WAVE with WAVEFORMATEX
+      :SD2,           0x160000,     # Sound Designer 2
+      :FLAC,          0x170000,     # FLAC lossless file format
+      :CAF,           0x180000,     # Core Audio File format
+      :WVE,           0x190000,     # Psion WVE format
+      :OGG,           0x200000,     # Xiph OGG container
+      :MPC2K,         0x210000,     # Akai MPC 2000 sampler
+      :RF64,          0x220000,     # RF64 WAV file
+    )
+
+    # Subtypes from here on.
+    ENCODING_MASK =  0x0000FFFF
+    Encoding = enum(
+      :PCM_S8,        0x0001,       # Signed 8 bit data
+      :PCM_16,        0x0002,       # Signed 16 bit data
+      :PCM_24,        0x0003,       # Signed 24 bit data
+      :PCM_32,        0x0004,       # Signed 32 bit data
+
+      :PCM_U8,        0x0005,       # Unsigned 8 bit data (WAV and RAW only)
+
+      :FLOAT,         0x0006,       # 32 bit float data
+      :DOUBLE,        0x0007,       # 64 bit float data
+
+      :ULAW,          0x0010,       # U-Law encoded.
+      :ALAW,          0x0011,       # A-Law encoded.
+      :IMA_ADPCM,     0x0012,       # IMA ADPCM.
+      :MS_ADPCM,      0x0013,       # Microsoft ADPCM.
+
+      :GSM610,        0x0020,       # GSM 6.10 encoding.
+      :VOX_ADPCM,     0x0021,       # Oki Dialogic ADPCM encoding.
+
+      :G721_32,       0x0030,       # 32kbs G721 ADPCM encoding.
+      :G723_24,       0x0031,       # 24kbs G723 ADPCM encoding.
+      :G723_40,       0x0032,       # 40kbs G723 ADPCM encoding.
+
+      :DWVW_12,       0x0040,       # 12 bit Delta Width Variable Word encoding.
+      :DWVW_16,       0x0041,       # 16 bit Delta Width Variable Word encoding.
+      :DWVW_24,       0x0042,       # 24 bit Delta Width Variable Word encoding.
+      :DWVW_N,        0x0043,       # N bit Delta Width Variable Word encoding.
+
+      :DPCM_8,        0x0050,       # 8 bit differential PCM (XI only)
+      :DPCM_16,       0x0051,       # 16 bit differential PCM (XI only)
+
+      :VORBIS,        0x0060,       # Xiph Vorbis encoding.
+    )
+
+    # Endian-ness options.
+    ENDIAN_MASK =     0x30000000
+    Endian = enum(
+      :FILE,          0x00000000,   # Default file endian-ness.
+      :LITTLE,        0x10000000,   # Force little endian-ness.
+      :BIG,           0x20000000,   # Force big endian-ness.
+      :CPU,           0x30000000,   # Force CPU endian-ness.
+    )
+
+    # Command numbers for sf_command
+    Command = enum(
+	:SFC_GET_LIB_VERSION,				 0x1000,
+	:SFC_GET_LOG_INFO,				 0x1001,
+	:SFC_GET_CURRENT_SF_INFO,			 0x1002,
+
+
+	:SFC_GET_NORM_DOUBLE,				 0x1010,
+	:SFC_GET_NORM_FLOAT,				 0x1011,
+	:SFC_SET_NORM_DOUBLE,				 0x1012,
+	:SFC_SET_NORM_FLOAT,				 0x1013,
+	:SFC_SET_SCALE_FLOAT_INT_READ,	 0x1014,
+	:SFC_SET_SCALE_INT_FLOAT_WRITE,	 0x1015,
+
+	:SFC_GET_SIMPLE_FORMAT_COUNT,		 0x1020,
+	:SFC_GET_SIMPLE_FORMAT,			 0x1021,
+
+	:SFC_GET_FORMAT_INFO,				 0x1028,
+
+	:SFC_GET_FORMAT_MAJOR_COUNT,		 0x1030,
+	:SFC_GET_FORMAT_MAJOR,			 0x1031,
+	:SFC_GET_FORMAT_SUBTYPE_COUNT,	 0x1032,
+	:SFC_GET_FORMAT_SUBTYPE,			 0x1033,
+
+	:SFC_CALC_SIGNAL_MAX,				 0x1040,
+	:SFC_CALC_NORM_SIGNAL_MAX,		 0x1041,
+	:SFC_CALC_MAX_ALL_CHANNELS,		 0x1042,
+	:SFC_CALC_NORM_MAX_ALL_CHANNELS,	 0x1043,
+	:SFC_GET_SIGNAL_MAX,				 0x1044,
+	:SFC_GET_MAX_ALL_CHANNELS,		 0x1045,
+
+	:SFC_SET_ADD_PEAK_CHUNK,			 0x1050,
+	:SFC_SET_ADD_HEADER_PAD_CHUNK,	 0x1051,
+
+	:SFC_UPDATE_HEADER_NOW,			 0x1060,
+	:SFC_SET_UPDATE_HEADER_AUTO,		 0x1061,
+
+	:SFC_FILE_TRUNCATE,				 0x1080,
+
+	:SFC_SET_RAW_START_OFFSET,		 0x1090,
+
+	:SFC_SET_DITHER_ON_WRITE,			 0x10A0,
+	:SFC_SET_DITHER_ON_READ,			 0x10A1,
+
+	:SFC_GET_DITHER_INFO_COUNT,		 0x10A2,
+	:SFC_GET_DITHER_INFO,				 0x10A3,
+
+	:SFC_GET_EMBED_FILE_INFO,			 0x10B0,
+
+	:SFC_SET_CLIPPING,				 0x10C0,
+	:SFC_GET_CLIPPING,				 0x10C1,
+
+	:SFC_GET_INSTRUMENT,				 0x10D0,
+	:SFC_SET_INSTRUMENT,				 0x10D1,
+
+	:SFC_GET_LOOP_INFO,				 0x10E0,
+
+	:SFC_GET_BROADCAST_INFO,			 0x10F0,
+	:SFC_SET_BROADCAST_INFO,			 0x10F1,
+
+	:SFC_GET_CHANNEL_MAP_INFO,		 0x1100,
+	:SFC_SET_CHANNEL_MAP_INFO,		 0x1101,
+
+	:SFC_RAW_DATA_NEEDS_ENDSWAP,		 0x1110,
+
+	# Support for Wavex Ambisonics Format
+	:SFC_WAVEX_SET_AMBISONIC,			 0x1200,
+	:SFC_WAVEX_GET_AMBISONIC,			 0x1201,
+
+	:SFC_SET_VBR_ENCODING_QUALITY,	 0x1300,
+
+	# Following commands for testing only.
+	:SFC_TEST_IEEE_FLOAT_REPLACE,		 0x6001,
+
+	##
+	## :SFC_SET_ADD_* values are deprecated and will disappear at some
+	## time in the future. They are guaranteed to be here up to and
+	## including version 1.0.8 to avoid breakage of existng software.
+	## They currently do nothing and will continue to do nothing.
+	##
+	:SFC_SET_ADD_DITHER_ON_WRITE,		 0x1070,
+	:SFC_SET_ADD_DITHER_ON_READ,		 0x1071
+    )
+  end
+end

data/lib/sndfile/error.rb

@@ -0,0 +1,8 @@
+module Sndfile
+  #
+  # Exception raised in case of errors from libsndfile.  The message
+  # contains the libsndfile error message.
+  #
+  class Error < RuntimeError
+  end
+end

data/lib/sndfile/file.rb

@@ -0,0 +1,202 @@
+module Sndfile
+
+  class File
+    include SndfileApi
+
+    #
+    # Without a block, this is the same as File.new(path, opts).
+    # With a block, yields the File object to the block and ensures that
+    # File#close is then called .
+    #
+    def self.open(path, opts={})
+      file = new(path, opts)
+      if block_given?
+        begin
+          yield file
+        ensure
+          file.close
+        end
+      else
+        file
+      end
+    end
+
+    #
+    # Create a File instance.  Options are:
+    #
+    #  :mode => :READ (default), :WRITE, or :RDWR
+    #  :format => see list at File#format  (default is :WAV)
+    #  :encoding => see list at File#encoding (default is :PCM_16)
+    #  :endian => see list at File#endian (default is :FILE)
+    #  :samplerate => default is 44100
+    #  :channles => default is 2
+    #
+    # When mode is :READ, then :format, :channels, and :samplerate are
+    # ignored -- unless the format is :RAW
+    #
+    # May raise Sndfile::Error on various error conditions
+    #
+    def initialize(path,opts={})
+      opts = opts.keyword_args(:mode => { :valid => Enums::FileMode.symbols, :default => :READ },
+                               :format => { :valid => Enums::Format.symbols, :default => :WAV },
+                               :encoding => { :valid => Enums::Encoding.symbols, :default => :PCM_16 },
+                               :endian => { :valid => Enums::Endian.symbols, :default => :FILE },
+                               :samplerate => 44100,
+                               :channels => 2,
+                              )
+
+      @path = path
+      @sfinfo = SfInfo.new
+      if opts.mode == :WRITE or opts.format == :RAW
+        @sfinfo[:format] = Enums::Format[opts.format]|Enums::Encoding[opts.encoding]|Enums::Endian[opts.endian]
+        @sfinfo[:channels] = opts.channels
+        @sfinfo[:samplerate] = opts.samplerate
+      end
+      @sfpointer = sf_open(path.to_s, opts.mode, @sfinfo)
+      check_error
+      sf_command @sfpointer, :SFC_SET_CLIPPING, nil, 1
+      check_error
+    end
+
+    # Closes the File instance.
+    #
+    # May raise Sndfile::Error for various error conditions
+    def close
+      check_error sf_close(@sfpointer)
+    end
+
+    # Returns the format of the file, which is one of
+    #
+    #  :WAV           - Microsoft WAV format (little endian).
+    #  :AIFF          - Apple/SGI AIFF format (big endian).
+    #  :AU            - Sun/NeXT AU format (big endian).
+    #  :RAW           - RAW PCM data.
+    #  :PAF           - Ensoniq PARIS file format.
+    #  :SVX           - Amiga IFF / SVX8 / SV16 format.
+    #  :NIST          - Sphere NIST format.
+    #  :VOC           - VOC files.
+    #  :IRCAM         - Berkeley/IRCAM/CARL
+    #  :W64           - Sonic Foundry's 64 bit RIFF/WAV
+    #  :MAT4          - Matlab (tm) V4.2 / GNU Octave 2.0
+    #  :MAT5          - Matlab (tm) V5.0 / GNU Octave 2.1
+    #  :PVF           - Portable Voice Format
+    #  :XI            - Fasttracker 2 Extended Instrument
+    #  :HTK           - HMM Tool Kit format
+    #  :SDS           - Midi Sample Dump Standard
+    #  :AVR           - Audio Visual Research
+    #  :WAVEX         - MS WAVE with WAVEFORMATEX
+    #  :SD2           - Sound Designer 2
+    #  :FLAC          - FLAC lossless file format
+    #  :CAF           - Core Audio File format
+    #  :WVE           - Psion WVE format
+    #  :OGG           - Xiph OGG container
+    #  :MPC2K         - Akai MPC 2000 sampler
+    #  :RF64          - RF64 WAV file
+    def format
+      Format[@sfinfo[:format] & FORMAT_MASK]
+    end
+
+    # Returns the encoding of the file data, which is one of:
+    #
+    #  :PCM_S8        - Signed 8 bit data
+    #  :PCM_16        - Signed 16 bit data
+    #  :PCM_24        - Signed 24 bit data
+    #  :PCM_32        - Signed 32 bit data
+    #  :PCM_U8        - Unsigned 8 bit data (WAV and RAW only)
+    #  :FLOAT         - 32 bit float data
+    #  :DOUBLE        - 64 bit float data
+    #  :ULAW          - U-Law encoded.
+    #  :ALAW          - A-Law encoded.
+    #  :IMA_ADPCM     - IMA ADPCM.
+    #  :MS_ADPCM      - Microsoft ADPCM.
+    #  :GSM610        - GSM 6.10 encoding.
+    #  :VOX_ADPCM     - Oki Dialogic ADPCM encoding.
+    #  :G721_32       - 32kbs G721 ADPCM encoding.
+    #  :G723_24       - 24kbs G723 ADPCM encoding.
+    #  :G723_40       - 40kbs G723 ADPCM encoding.
+    #  :DWVW_12       - 12 bit Delta Width Variable Word encoding.
+    #  :DWVW_16       - 16 bit Delta Width Variable Word encoding.
+    #  :DWVW_24       - 24 bit Delta Width Variable Word encoding.
+    #  :DWVW_N        - N bit Delta Width Variable Word encoding.
+    #  :DPCM_8        - 8 bit differential PCM (XI only)
+    #  :DPCM_16       - 16 bit differential PCM (XI only)
+    #  :VORBIS        - Xiph Vorbis encoding.
+    def encoding
+      Encoding[@sfinfo[:format] & ENCODING_MASK]
+    end
+
+    # Returns the endian-ness of the data, one of:
+    #
+    #  :FILE          - Default file endian-ness.
+    #  :LITTLE        - Force little endian-ness.
+    #  :BIG           - Force big endian-ness.
+    #  :CPU           - Force CPU endian-ness.
+    def endian
+      Endian[@sfinfo[:format] & ENDIAN_MASK]
+    end
+
+    # Returns the number of frames (samples) in the file
+    def frames
+      @sfinfo[:frames]
+    end
+
+    # Returns the sample rate, frames per second
+    def samplerate
+      @sfinfo[:samplerate]
+    end
+
+    # Returns the number of channels of data
+    def channels
+      @sfinfo[:channels]
+    end
+
+    # Reads frames from the file, returning the data in a GSLng::Matrix of
+    # dimensions frames x channels.  (For convenience, the height and width
+    # methods of GSLng::Matrix are aliased as GSLng::Matrix#frames and
+    # GSLng::Matrix#channels)
+    #
+    # Normally the requested number of frames is read, unless end of file is
+    # reached.  If no frames are read (i.e. already at end of file),
+    # returns nil instead of a GSLng::Matrix.
+    #
+    # May raise Sndfile::Error in case of error.
+    def read(nframes)
+
+      buf = GSLng::Matrix.new(nframes, channels)
+
+      count = sf_readf_double @sfpointer, buf.data_ptr, nframes
+      check_error
+      case count
+      when 0 then nil
+      when nframes then buf
+      else buf.view(0, 0, count, channels)
+      end
+    end
+
+    # Writes frames to the file.  The data must be (quack like) a GSLng::Matrix
+    # with dimensions frames x channels.  The matrix can contain any number of
+    # frames.
+    #
+    # When writing to a file with integer encoding, values are clipped to
+    # [-1, 1].
+    #
+    # May raise Sndfile::Error in case of error.
+    def write(buf)
+      sf_writef_double @sfpointer, buf.data_ptr, buf.frames
+      check_error
+    end
+
+    private
+
+    def check_error(code = nil)
+      code ||= sf_error(@sfpointer.null? ? nil : @sfpointer)
+      if code != 0
+        msg = sf_strerror(@sfpointer.null? ? nil : @sfpointer)
+        msg += " (#{ErrorCode[code]})" if ErrorCode[code]
+        msg += " [#{@path}]"
+        raise Sndfile::Error, msg
+      end
+    end
+
+  end
+end

data/lib/sndfile/sndfile_api.rb

@@ -0,0 +1,98 @@
+module Sndfile # :nodoc: all
+  module SndfileApi
+    extend FFI::Library
+    include Enums
+
+    ffi_lib 'libsndfile'
+
+    typedef :int64, :sf_count_t
+
+    class SfInfo < FFI::Struct
+      layout :frames, :sf_count_t,
+        :samplerate, :int,
+        :channels, :int,
+        :format, :int,
+        :sections, :int,
+        :seekable, :int
+    end
+
+    # SNDFILE*    sf_open          (const char *path, int mode, SF_INFO *sfinfo) ;
+    # SNDFILE*    sf_open_fd       (int fd, int mode, SF_INFO *sfinfo, int close_desc) ;
+    # SNDFILE* 	sf_open_virtual  (SF_VIRTUAL_IO *sfvirtual, int mode, SF_INFO *sfinfo, void *user_data) ;
+    # int         sf_format_check  (const SF_INFO *info) ;
+    attach_function :sf_open,          [:string, FileMode, :pointer], :pointer
+    attach_function :sf_open_fd,       [:int, :int, :pointer, :int], :pointer
+    attach_function :sf_open_virtual,  [:pointer, :int, :pointer, :pointer], :pointer
+    attach_function :sf_format_check,  [:pointer], :int         
+
+    # sf_count_t  sf_seek          (SNDFILE *sndfile, sf_count_t frames, int whence) ;
+    attach_function :sf_seek,          [:pointer, :sf_count_t, :int], :sf_count_t  
+
+    # int         sf_command       (SNDFILE *sndfile, int cmd, void *data, int datasize) ;
+    attach_function :sf_command,       [:pointer, Command, :pointer, :int], :int
+
+    # int         sf_error         (SNDFILE *sndfile) ;
+    # const char* sf_strerror      (SNDFILE *sndfile) ;
+    # const char* sf_error_number  (int errnum) ;
+    attach_function :sf_error,         [:pointer], :int         
+    attach_function :sf_strerror,      [:pointer], :string
+    attach_function :sf_error_number,  [:int], :string
+
+    # int         sf_perror        (SNDFILE *sndfile) ;
+    # int         sf_error_str     (SNDFILE *sndfile, char* str, size_t len) ;
+    attach_function :sf_perror,        [:pointer], :int         
+    attach_function :sf_error_str,     [:pointer, :pointer, :int], :int         
+
+    # int         sf_close         (SNDFILE *sndfile) ;
+    # void        sf_write_sync    (SNDFILE *sndfile) ;
+    attach_function :sf_close,         [:pointer], :int         
+    attach_function :sf_write_sync,    [:pointer], :void
+
+
+    # sf_count_t  sf_read_short    (SNDFILE *sndfile, short *ptr, sf_count_t items) ;
+    # sf_count_t  sf_read_int      (SNDFILE *sndfile, int *ptr, sf_count_t items) ;
+    # sf_count_t  sf_read_float    (SNDFILE *sndfile, float *ptr, sf_count_t items) ;
+    # sf_count_t  sf_read_double   (SNDFILE *sndfile, double *ptr, sf_count_t items) ;
+    attach_function :sf_read_short,    [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_read_int,      [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_read_float,    [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_read_double,   [:pointer, :pointer, :sf_count_t], :sf_count_t  
+
+    # sf_count_t  sf_readf_short   (SNDFILE *sndfile, short *ptr, sf_count_t frames) ;
+    # sf_count_t  sf_readf_int     (SNDFILE *sndfile, int *ptr, sf_count_t frames) ;
+    # sf_count_t  sf_readf_float   (SNDFILE *sndfile, float *ptr, sf_count_t frames) ;
+    # sf_count_t  sf_readf_double  (SNDFILE *sndfile, double *ptr, sf_count_t frames) ;
+    attach_function :sf_readf_short,   [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_readf_int,     [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_readf_float,   [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_readf_double,  [:pointer, :pointer, :sf_count_t], :sf_count_t  
+
+    # sf_count_t  sf_write_short   (SNDFILE *sndfile, short *ptr, sf_count_t items) ;
+    # sf_count_t  sf_write_int     (SNDFILE *sndfile, int *ptr, sf_count_t items) ;
+    # sf_count_t  sf_write_float   (SNDFILE *sndfile, float *ptr, sf_count_t items) ;
+    # sf_count_t  sf_write_double  (SNDFILE *sndfile, double *ptr, sf_count_t items) ;
+    attach_function :sf_write_short,   [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_write_int,     [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_write_float,   [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_write_double,  [:pointer, :pointer, :sf_count_t], :sf_count_t  
+
+    # sf_count_t  sf_writef_short  (SNDFILE *sndfile, short *ptr, sf_count_t frames) ;
+    # sf_count_t  sf_writef_int    (SNDFILE *sndfile, int *ptr, sf_count_t frames) ;
+    # sf_count_t  sf_writef_float  (SNDFILE *sndfile, float *ptr, sf_count_t frames) ;
+    # sf_count_t  sf_writef_double (SNDFILE *sndfile, double *ptr, sf_count_t frames) ;
+    attach_function :sf_writef_short,  [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_writef_int,    [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_writef_float,  [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_writef_double, [:pointer, :pointer, :sf_count_t], :sf_count_t  
+
+    # sf_count_t  sf_read_raw      (SNDFILE *sndfile, void *ptr, sf_count_t bytes) ;
+    # sf_count_t  sf_write_raw     (SNDFILE *sndfile, void *ptr, sf_count_t bytes) ;
+    attach_function :sf_read_raw,      [:pointer, :pointer, :sf_count_t], :sf_count_t  
+    attach_function :sf_write_raw,     [:pointer, :pointer,  :sf_count_t], :sf_count_t  
+
+    # const char* sf_get_string    (SNDFILE *sndfile, int str_type) ;
+    # int         sf_set_string    (SNDFILE *sndfile, int str_type, const char* str) ;
+    attach_function :sf_get_string,    [:pointer, :int], :string
+    attach_function :sf_set_string,    [:pointer, :int, :string], :int         
+  end
+end

data/lib/sndfile/version.rb

@@ -0,0 +1,3 @@
+module Sndfile
+  VERSION = "0.1.0"
+end

data/sndfile.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/sndfile/version', __FILE__)
+
+Gem::Specification.new do |gem|
+    gem.authors       = ["ronen barzel"]
+    gem.email         = ["ronen@barzel.org"]
+    gem.description   = %q{Ruby wrapper for libsndfile.  Reads/writes data as GSL matrices, to allow fast processing.}
+    gem.summary       = %q{Ruby wrapper for libsndfile.  Reads/writes data as GSL matrices, to allow fast processing.}
+    gem.homepage      = "https://github.com/ronen/sndfile"
+
+    gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+    gem.files         = `git ls-files`.split("\n")
+    gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+    gem.name          = "sndfile"
+    gem.require_paths = ["lib"]
+    gem.version       = Sndfile::VERSION
+
+    gem.add_dependency("ffi")
+    gem.add_dependency("ruby-gsl-ng")
+    gem.add_dependency("hash_keyword_args")
+
+    gem.add_development_dependency 'rake'
+    gem.add_development_dependency 'rspec'
+    gem.add_development_dependency 'simplecov'
+    gem.add_development_dependency 'simplecov-gem-adapter'
+end

data/spec/file_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+describe Sndfile do
+
+  it "should return correct file info" do
+    Sndfile::File.open(INPUTS_DIR + "ComputerMagic.wav") do |f|
+      f.format.should == :WAV
+      f.encoding.should == :PCM_16
+      f.endian.should == :FILE
+      f.frames.should == 223451
+      f.samplerate.should == 44100
+      f.channels.should == 2
+    end
+  end
+
+  it "should raise an error when it can't open the file" do
+    expect { Sndfile::File.open("/no/such/file") }.should raise_error Sndfile::Error
+  end
+
+end

data/spec/integration_spec.rb

@@ -0,0 +1,73 @@
+require 'spec_helper'
+require 'tmpdir'
+require 'narray'
+
+describe "Integration" do
+
+  it "should copy a file" do
+    inpath = in_path("ComputerMagic.wav")
+    outpath, refpath = out_ref_paths("copy.wav")
+
+    fin = Sndfile::File.open(inpath)
+    Sndfile::File.open(outpath, :mode => :WRITE, :format => :WAV, :encoding => :PCM_16, :channels => 2, :samplerate => fin.samplerate) do |fout|
+      while data = fin.read(12345)
+        fout.write(data)
+      end
+      system("cmp #{outpath} #{refpath}").should be_true
+    end
+  end
+
+  it "should mix two files to and write the result" do
+    inpath1 = in_path("ComputerMagic.wav")
+    inpath2 = in_path("Flute3.wav")
+    outpath, refpath = out_ref_paths("mix.wav")
+
+    fin1 = Sndfile::File.open(inpath1)
+    fin1.channels.should == 2
+
+    fin2 = Sndfile::File.open(inpath2)
+    fin2.channels.should == 1
+    fin1.samplerate.should == fin2.samplerate
+
+    Sndfile::File.open(outpath, :mode => :WRITE, :format => :WAV, :encoding => :PCM_16, :channels => 2, :samplerate => fin1.samplerate) do |fout|
+      while true
+        a = fin1.read(10000)
+        b = fin2.read(10000)
+        b = b * GSLng::Matrix.from_array([[1,0]]) if b
+        case
+        when a.nil? && b.nil?
+          break
+        when a.nil?
+          r = b
+        when b.nil?
+          r = a
+        when a.frames > b.frames
+          r = a
+          r.view(0, 0, b.frames, 2).add! b
+        when b.frames > a.frames
+          r = b
+          r.view(0, 0, a.frames, 2).add! a
+        else
+          r = a
+          r.add! b
+        end
+        fout.write(r)
+      end
+      system("cmp #{outpath} #{refpath}").should be_true
+    end
+  end
+
+  it "should multiply data by a scalar" do
+    inpath = in_path("ComputerMagic.wav")
+    outpath, refpath = out_ref_paths("half.wav")
+
+    fin = Sndfile::File.open(inpath)
+    Sndfile::File.open(outpath, :mode => :WRITE, :format => :WAV, :encoding => :PCM_16, :channels => 2, :samplerate => fin.samplerate) do |fout|
+      while data = fin.read(10000)
+        fout.write(data * 0.5)
+      end
+      system("cmp #{outpath} #{refpath}").should be_true
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,33 @@
+if RUBY_VERSION > "1.9"
+  require 'simplecov'
+  require 'simplecov-gem-adapter'
+  SimpleCov.start 'gem'
+end
+
+require 'rspec'
+require 'sndfile'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end
+
+INPUTS_DIR = Pathname.new(__FILE__) + "../inputs"
+REFS_DIR = Pathname.new(__FILE__) + "../refs"
+OUTPUTS_DIR = Pathname.new(__FILE__) + "../outputs"
+Dir.mkdir(OUTPUTS_DIR) unless Dir.exist? OUTPUTS_DIR
+
+def in_path(name)
+  INPUTS_DIR + name
+end
+
+def out_ref_paths(name)
+  [
+    OUTPUTS_DIR + "out-#{name}",
+    REFS_DIR + "ref-#{name}",
+  ]
+end
+

metadata

@@ -0,0 +1,153 @@
+--- !ruby/object:Gem::Specification
+name: sndfile
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- ronen barzel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: &70255236835440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70255236835440
+- !ruby/object:Gem::Dependency
+  name: ruby-gsl-ng
+  requirement: &70255236834820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70255236834820
+- !ruby/object:Gem::Dependency
+  name: hash_keyword_args
+  requirement: &70255236850680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70255236850680
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70255236850240 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70255236850240
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70255236849800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70255236849800
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &70255236849360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70255236849360
+- !ruby/object:Gem::Dependency
+  name: simplecov-gem-adapter
+  requirement: &70255236848880 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70255236848880
+description: Ruby wrapper for libsndfile.  Reads/writes data as GSL matrices, to allow
+  fast processing.
+email:
+- ronen@barzel.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- lib/gsl-ng/matrix.rb
+- lib/sndfile.rb
+- lib/sndfile/enums.rb
+- lib/sndfile/error.rb
+- lib/sndfile/file.rb
+- lib/sndfile/sndfile_api.rb
+- lib/sndfile/version.rb
+- sndfile.gemspec
+- spec/file_spec.rb
+- spec/inputs/ComputerMagic.wav
+- spec/inputs/Flute3.wav
+- spec/integration_spec.rb
+- spec/refs/ref-copy.wav
+- spec/refs/ref-half.wav
+- spec/refs/ref-mix.wav
+- spec/spec_helper.rb
+homepage: https://github.com/ronen/sndfile
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+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.8.12
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper for libsndfile.  Reads/writes data as GSL matrices, to allow
+  fast processing.
+test_files:
+- spec/file_spec.rb
+- spec/inputs/ComputerMagic.wav
+- spec/inputs/Flute3.wav
+- spec/integration_spec.rb
+- spec/refs/ref-copy.wav
+- spec/refs/ref-half.wav
+- spec/refs/ref-mix.wav
+- spec/spec_helper.rb
+has_rdoc: