tone.rb 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 843f52bc94240658d10ff26663f3af64ef18b5b41a357a299c40c6e51f5377f8
+  data.tar.gz: c1beef2a831c67e5d51900d8ea3078fe6137fbf886750b979f6c02c6bf940fdb
+SHA512:
+  metadata.gz: 9f148d334a8cbb19f77085c13e2f6c7d990ef07c688b795e1140f09844491fc6cad5205f23a08bcbffede717a073ffabba313d5b9e45747f160535ab8c059209
+  data.tar.gz: 56b17cc4a7129b95c9fc4f35244a0aa2bd6132aab05c828759f49db4584b5e435585802e13ce85c4d5a964a969cc284239fed0a1c72a6c6e043ced205c7379ae

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.5.1
+before_install: gem install bundler -v 1.16.2

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in tone.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,33 @@
+PATH
+  remote: .
+  specs:
+    tone.rb (0.1.0)
+      opal (>= 0.10.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.0)
+    hike (1.2.3)
+    minitest (5.11.3)
+    opal (0.11.0)
+      ast (>= 2.3.0)
+      hike (~> 1.2)
+      parser (= 2.3.3.1)
+      sourcemap (~> 0.1.0)
+    parser (2.3.3.1)
+      ast (~> 2.2)
+    rake (10.5.0)
+    sourcemap (0.1.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  minitest (~> 5.0)
+  rake (~> 10.0)
+  tone.rb!
+
+BUNDLED WITH
+   1.16.2

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Jose Anasco
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,106 @@
+# Tone.rb
+
+Ruby wrapper for [Tone.js](https://github.com/feedjira/feedjira). This is used in the live coding environment of [Negasonic](https://negasonic.herokuapp.com/)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'tone.rb'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install tone
+
+## Usage
+
+Tone.rb targets version 11 of Tone.js. This are the current implemented modules:
+
+### Transport
+
+Handles the global execution of elements in Tone.js
+
+```ruby
+# play after 0.1 seconds
+Tone::Transport.start("+0.1")
+
+# stop now
+Tone::Transport.stop
+```
+
+### Synth
+
+Adds basic functionality for handling it as an input node, playing notes, as well as the ability
+to compare it with other synths
+
+```ruby
+# Volume is measured in decibels
+synth = Tone::Synth::FM.new(volume: 2)
+
+# Play the E2 note at 0 and release at 0.5 seconds
+synth.trigger_attack_release('E2', 0.5, 0)
+
+# Each synths are compared by the volume attribute
+synth == Tone::Synth::FM.new(volume: 2) #=> true
+synth == Tone::Synth::FM.new(volume: 3) #=> false
+synth == Tone::Synth::AM.new(volume: 2) #=> false
+
+# Connect all effects between each other and connect the synth as the input
+synth.chain(array_of_effects)
+```
+
+### Effect
+
+Similar to `Synth`, you can compare between effects, as well as remove
+them trough `Effect#dispose` (good for performance)
+
+```ruby
+# each effect has specific attributes
+vibrato = Tone::Effect::Vibrato.new(frequency: 5, depth: 0.1)
+vibrato == Tone::Effect::Vibrato.new(frequency: 5, depth: 0.2) #=> false
+```
+
+### Event
+
+Events schedules a group of notes in a certain order across the `Transport`
+
+```ruby
+
+# schedules notes in order every 2 seconds
+Tone::Event::Sequence.new([['E2', 'C1'], 'D2'], 'C2'], 2) do |time, note|
+  Tone::Synth::FM.new.trigger_attack_release note, '1', time
+end
+
+# schedules notes in a random order
+pattern = Tone::Event::Pattern.new(['E2', 'C1', 'D2', 'C2'], :random) do |time, note|
+  Tone::Synth::FM.new.trigger_attack_release note, '1', time
+end
+
+# every 2 seconds
+pattern.interval = 2
+
+# run it in loop mode
+pattern.start(0)
+pattern.loop = true
+```
+
+for more info check the [Tone.js Docs](https://tonejs.github.io/docs/)
+
+## TODO
+
+* Basic tests
+* Wrap remaining Tone.js modules
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/merongivian/tone.rb
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,14 @@
+require 'bundler'
+Bundler.require
+Bundler::GemHelper.install_tasks
+
+require 'open-uri'
+
+desc 'update js dependencies'
+task :update_tone_js do
+  js_lib_url = 'https://tonejs.github.io/build/Tone.min.js'
+  js_lib_dest = File.join(File.dirname(__FILE__), './lib/tone/vendor.js')
+  open(js_lib_url) do |f|
+    File.write(js_lib_dest, f.readlines.join)
+  end
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "tone"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/tone.rb

@@ -0,0 +1,11 @@
+if RUBY_ENGINE == 'opal'
+  require 'tone/vendor'
+  require 'tone/transport'
+  require 'tone/event'
+  require 'tone/synth'
+  require 'tone/effect'
+else
+  require 'opal'
+
+  Opal.append_path File.expand_path('../', __FILE__).untaint
+end

data/lib/tone/effect.rb

@@ -0,0 +1,157 @@
+module Tone
+  module Effect
+    class Base
+      include Native
+
+      alias_native :dispose
+      alias_native :connect
+      alias_native :to_master
+
+      def ==(other)
+        self.class == other.class
+      end
+    end
+
+    class Chorus < Base
+      attr_reader :frequency, :delay_time, :depth
+
+      def initialize(frequency: 1.5, delay_time: 3.5, depth: 0.7)
+        @frequency = frequency
+        @delay_time = delay_time
+        @depth = depth
+        super `new Tone.Chorus(frequency, delay_time, depth)`
+      end
+
+      def ==(other)
+        super &&
+          frequency == other.frequency &&
+            delay_time == other.delay_time &&
+              depth == other.depth
+      end
+    end
+
+    class Vibrato < Base
+      attr_reader :frequency, :depth
+
+      def initialize(frequency: 5, depth: 0.1)
+        @frequency = frequency
+        @depth = depth
+        super `new Tone.Vibrato(frequency, depth)`
+      end
+
+      def ==(other)
+        super &&
+          frequency == other.frequency &&
+            depth == other.depth
+      end
+    end
+
+    class Distortion < Base
+      attr_reader :value
+
+      def initialize(value: 0.4)
+        @value = value
+        super `new Tone.Distortion(value)`
+      end
+
+      def ==(other)
+        super && value == other.value
+      end
+    end
+
+    class Tremolo < Base
+      attr_reader :frequency, :depth
+
+      def initialize(frequency: 10, depth: 0.5)
+        @frequency = frequency
+        @depth = depth
+        super `new Tone.Tremolo(frequency, depth)`
+      end
+
+      def ==(other)
+        super &&
+          frequency == other.frequency &&
+            depth == other.depth
+      end
+    end
+
+    class FeedbackDelay < Base
+      attr_reader :delay_time, :feedback
+
+      def initialize(delay_time: 0.25, feedback: 0.5)
+        @delay_time = delay_time
+        @feedback = feedback
+        super `new Tone.FeedbackDelay(delay_time, feedback)`
+      end
+
+      def ==(other)
+        super &&
+          delay_time == other.delay_time &&
+            feedback == other.feedback
+      end
+    end
+
+    class Freeverb < Base
+      attr_reader :room_size, :dampening
+
+      def initialize(room_size: 0.7, dampening: 3000)
+        @room_size = room_size
+        @dampening = dampening
+        super `new Tone.Freeverb(room_size, dampening)`
+      end
+
+      def ==(other)
+        super &&
+          room_size == other.room_size &&
+            dampening == other.dampening
+      end
+    end
+
+    class JCReverb < Base
+      attr_reader :room_size
+
+      def initialize(room_size: 0.5)
+        @room_size = room_size
+        super `new Tone.JCReverb(room_size)`
+      end
+
+      def ==(other)
+        super && room_size == other.room_size
+      end
+    end
+
+    class Phaser < Base
+      attr_reader :frequency, :octaves, :base_frequency
+
+      def initialize(frequency: 0.5, octaves: 3, base_frequency: 350)
+        @frequency = frequency
+        @octaves = octaves
+        @base_frequency = base_frequency
+        super `new Tone.Phaser(frequency, octaves, base_frequency)`
+      end
+
+      def ==(other)
+        super &&
+          frequency == other.frequency &&
+            octaves == other.octaves &&
+              base_frequency == other.base_frequency
+      end
+    end
+
+    class PingPongDelay < Base
+      attr_reader :delay_time, :feedback
+
+      def initialize(delay_time: 0.25, feedback: 1)
+        @delay_time = delay_time
+        @feedback = feedback
+        super `new Tone.PingPongDelay(delay_time, feedback)`
+      end
+
+      def ==(other)
+        super &&
+          delay_time == other.delay_time &&
+              feedback == other.feedback
+      end
+    end
+  end
+end

data/lib/tone/event.rb

@@ -0,0 +1,37 @@
+module Tone
+  module Event
+    class Base
+      include Native
+
+      alias_native :start
+      alias_native :dispose
+      native_writer :loop
+    end
+
+    class Pattern < Base
+      native_writer :interval
+
+      def initialize(notes, type, &block)
+        super `new Tone.Pattern(#{block.to_n}, #{notes.to_n}, type)`
+      end
+    end
+
+    class Part < Base
+      def initialize(definitions, &block)
+        super `new Tone.Part(#{block.to_n}, #{definitions.to_n})`
+      end
+    end
+
+    class Sequence < Base
+      def initialize(segments, duration, &block)
+        super `new Tone.Sequence(#{block.to_n}, #{segments.to_n}, duration)`
+      end
+    end
+
+    class Loop < Base
+      def initialize(interval, &block)
+        super `new Tone.Loop(#{block.to_n}, interval)`
+      end
+    end
+  end
+end

data/lib/tone/synth.rb

@@ -0,0 +1,100 @@
+module Tone
+  module Synth
+    class Base
+      include Native
+
+      alias_native :connect
+      alias_native :dispose
+      alias_native :trigger_attack_release, :triggerAttackRelease
+      alias_native :trigger_attack, :triggerAttack
+      alias_native :trigger_release, :triggerRelease
+
+      def chain(*effects)
+        last_node_connected = self
+
+        effects.each do |effect|
+          last_node_connected.connect(effect.to_n)
+          last_node_connected = effect
+        end
+
+        last_node_connected.connect(`Tone.Master`)
+      end
+
+      def initialize(native, volume: 1)
+        @native = native
+        `#@native.volume.value = volume`
+      end
+
+      def volume
+        `#@native.volume.value`
+      end
+
+      def ==(other)
+        volume == other.volume &&
+          self.class == other.class
+      end
+    end
+
+    class AM < Base
+      def initialize(**opts)
+        super `new Tone.AMSynth().toMaster()`, **opts
+      end
+    end
+
+    class Duo < Base
+      def initialize(**opts)
+        super `new Tone.DuoSynth().toMaster()`, **opts
+      end
+    end
+
+    class FM < Base
+      def initialize(**opts)
+        super `new Tone.FMSynth().toMaster()`, **opts
+      end
+    end
+
+    class Membrane < Base
+      def initialize(**opts)
+        super `new Tone.MembraneSynth().toMaster()`, **opts
+      end
+    end
+
+    # TODO
+    class Metal < Base
+      def initialize(**opts)
+        super `new Tone.MetalSynth().toMaster()`, **opts
+      end
+    end
+
+    class Mono < Base
+      def initialize(**opts)
+        super `new Tone.MonoSynth().toMaster()`, **opts
+      end
+    end
+
+    # TODO
+    class Noise < Base
+      def initialize(**opts)
+        super `new Tone.NoiseSynth().toMaster()`, **opts
+      end
+    end
+
+    class Pluck < Base
+      def initialize(**opts)
+        super `new Tone.PluckSynth().toMaster()`, **opts
+      end
+    end
+
+    class Poly < Base
+      def initialize(**opts)
+        super `new Tone.PolySynth().toMaster()`, **opts
+      end
+    end
+
+    class Simple < Base
+      def initialize(**opts)
+        super `new Tone.Synth().toMaster()`, **opts
+      end
+    end
+  end
+end