celt-ruby 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rvmrc

@@ -0,0 +1 @@
+rvm use --create ruby-1.9.3-p0@celt_ruby_gem

data/Gemfile

@@ -0,0 +1,4 @@
+source 'http://rubygems.org'
+
+# Specify your gem's dependencies in celt-ruby.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,45 @@
+celt-ruby
+    http://www.github.com/perrym5/celt-ruby
+
+== DESCRIPTION:
+
+CELT-Ruby is a Ruby Gem for working with the CELT Audio Codec.
+CELT-Ruby uses the Ruby-FFI extension to wrap the native CELT library code.
+This means that you must have CELT installed in order for this gem to work.
+
+== FEATURES:
+
+This gem was designed to fill a specific role in another one of my projects.
+As a result, the feature set is relatively small compared to the native libraries.
+However, I will accept any pull requests with additional functionality should someone need it.
+
+What this library can do:
+* Encode raw audio to CELT
+
+== REQUIREMENTS:
+
+* Ruby >= 1.9.2
+* CELT 0.7 Library
+
+== INSTALL:
+
+    [sudo] gem install celt-ruby
+
+== USAGE:
+
+    # Create new encoder with a sample rate of 48 kHz, a frame size of 480 bytes and 1 channel
+    encoder = Celt::Encoder.new 48000, 480, 1
+    # Set the prediction request to 0
+    encoder.prediction_request = 0
+    # Set the VBR rate to 60,000
+    encoder.vbr_rate = 60000
+
+    # Return the bitstream version for this version of CELT
+    encoder.bitstream_version
+
+    # Encode some raw audio
+    compressed_size = [@encoder.vbr_rate / 800, 127].min
+    encoded = encoder.encode(raw_audio, compressed_size)
+
+    # Safely destroy encoder
+    encoder.destroy

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/celt-ruby.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/celt-ruby/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Matthew Perry"]
+  gem.email         = ["perrym5@rpi.edu"]
+  gem.description   = %q{Ruby FFI Gem for the CELT Audio Codec}
+  gem.summary       = %q{Ruby FFI wrapper for the CELT Audio Codec C library for low latency audio encoding}
+  gem.homepage      = ""
+
+  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          = "celt-ruby"
+  gem.require_paths = ["lib"]
+  gem.version       = Celt::VERSION
+
+  gem.add_dependency "ffi"
+end

data/lib/celt-ruby.rb

@@ -0,0 +1,47 @@
+require 'ffi'
+require 'celt-ruby/version'
+require 'celt-ruby/encoder'
+
+module Celt
+  extend FFI::Library
+
+  ffi_lib 'celt0'
+
+  module Constants
+    CELT_OK                         = 0
+    CELT_BAD_ARG                    = -1
+    CELT_INVALID_MODE               = -2
+    CELT_INTERNAL_ERROR             = -3
+    CELT_CORRUPTED_DATA             = -4
+    CELT_UNIMPLEMENTED              = -5
+    CELT_INVALID_STATE              = -6
+    CELT_ALLOC_FAIL                 = -7
+    CELT_GET_MODE_REQUEST           = 1
+    CELT_SET_COMPLEXITY_REQUEST     = 2
+    CELT_SET_PREDICTION_REQUEST     = 4
+    CELT_SET_VBR_RATE_REQUEST       = 6
+    CELT_RESET_STATE_REQUEST        = 8
+    CELT_GET_FRAME_SIZE             = 1000
+    CELT_GET_LOOKAHEAD              = 1001
+    CELT_GET_SAMPLE_RATE            = 1003
+    CELT_GET_BITSTREAM_VERSION      = 2000
+  end
+
+  attach_function :celt_mode_create, [:int32, :int, :pointer], :pointer
+  attach_function :celt_mode_destroy, [:pointer], :void
+  attach_function :celt_mode_info, [:pointer, :int, :pointer], :int
+
+  attach_function :celt_encoder_create, [:pointer, :int, :pointer], :pointer
+  attach_function :celt_encoder_destroy, [:pointer], :void
+  attach_function :celt_encode_float, [:pointer, :pointer, :pointer, :pointer, :int], :int
+  attach_function :celt_encode, [:pointer, :pointer, :pointer, :pointer, :int], :int
+  attach_function :celt_encoder_ctl, [:pointer, :int, :varargs], :int
+
+  attach_function :celt_decoder_create, [:pointer, :int, :pointer], :pointer
+  attach_function :celt_decoder_destroy, [:pointer], :void
+  attach_function :celt_decode_float, [:pointer, :pointer, :int, :pointer], :int
+  attach_function :celt_decode, [:pointer, :pointer, :int, :pointer], :int
+  attach_function :celt_decoder_ctl, [:pointer, :int, :varargs], :int
+
+  attach_function :celt_strerror, [:int], :pointer
+end

data/lib/celt-ruby/encoder.rb

@@ -0,0 +1,48 @@
+module Celt
+  class Encoder
+    attr_reader :sample_rate, :frame_size, :channels,
+                :prediction_request, :vbr_rate
+
+    def initialize(sample_rate, frame_size, channels)
+      @sample_rate = sample_rate
+      @frame_size = frame_size
+      @channels = channels
+
+      @mode = Celt.celt_mode_create sample_rate, frame_size, nil
+      @encoder = Celt.celt_encoder_create @mode, channels, nil
+    end
+
+    def destroy
+      Celt.celt_encoder_destroy @encoder
+      Celt.celt_mode_destroy @mode
+    end
+
+    def bitstream_version
+      bv = FFI::MemoryPointer.new :int32
+      Celt.celt_mode_info @mode, Celt::Constants::CELT_GET_BITSTREAM_VERSION, bv
+      bv.read_int32
+    end
+
+    def prediction_request=(value)
+      @prediction_request = value
+      v_ptr = FFI::MemoryPointer.new :int
+      v_ptr.put_int 0, value
+      Celt.celt_encoder_ctl @encoder, Celt::Constants::CELT_SET_PREDICTION_REQUEST, :pointer, v_ptr
+    end
+
+    def vbr_rate=(value)
+      @vbr_rate = value
+      v_ptr = FFI::MemoryPointer.new :int
+      v_ptr.put_int 0, value
+      Celt.celt_encoder_ctl @encoder, Celt::Constants::CELT_SET_VBR_RATE_REQUEST, :pointer, v_ptr
+    end
+
+    def encode(data, size)
+      out = FFI::MemoryPointer.new :char, data.size + 1
+      buf = FFI::MemoryPointer.new :char, data.size + 1
+      buf.put_string 0, data
+      len = Celt.celt_encode @encoder, buf, nil, out, size
+      out.read_string_length len
+    end
+  end
+end

data/lib/celt-ruby/version.rb

@@ -0,0 +1,3 @@
+module Celt
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: celt-ruby
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Matthew Perry
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: &15396360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *15396360
+description: Ruby FFI Gem for the CELT Audio Codec
+email:
+- perrym5@rpi.edu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rvmrc
+- Gemfile
+- README.rdoc
+- Rakefile
+- celt-ruby.gemspec
+- lib/celt-ruby.rb
+- lib/celt-ruby/encoder.rb
+- lib/celt-ruby/version.rb
+homepage: ''
+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.10
+signing_key: 
+specification_version: 3
+summary: Ruby FFI wrapper for the CELT Audio Codec C library for low latency audio
+  encoding
+test_files: []