Add minim examples

Author: monkstone

contributed/recursive_pentagon.rb

@@ -30,7 +30,7 @@ def settings
 
 RecursivePentagons.new
 
-# Here we include Processing::Proxy to mimic vanilla processing inner class
+# Here we include Propane::Proxy to mimic vanilla processing inner class
 # access.
 class PentagonFractal
   include Propane::Proxy

external_library/java/minim/Rakefile

@@ -0,0 +1,18 @@
+# Simple demo Rakefile to autorun samples in current directory
+
+desc 'run demo'
+task default: [:demo]
+
+desc 'demo'
+task :demo do
+  samples_list.shuffle.each { |sample| run_sample sample }
+end
+
+def samples_list
+  Dir.glob('*.rb').map { |file| File.join(__dir__, file) }
+end
+
+def run_sample(sample_name)
+  puts "Running #{sample_name}...quit to run next sample"
+  system "jruby --dev #{sample_name}"
+end

external_library/java/minim/adsr_example.rb

@@ -0,0 +1,68 @@
+#!/usr/bin/env jruby
+# frozen_string_literal: true
+
+require 'propane'
+
+# ADSRExample is an example of using the ADSR envelope within an instrument.
+# For more information about Minim and additional features,
+# visit http://code.compartmental.net/minim/
+# author: Anderson Mills<br/>
+# Anderson Mills's work was supported by numediart (www.numediart.org)
+class ADSRExample < Propane::App
+  load_libraries :minim, :tone_instrument
+  java_import 'ddf.minim.Minim'
+
+  attr_reader :out
+
+  def setup
+    sketch_title 'ADSR Example'
+    minim = Minim.new(self)
+    @out = minim.get_line_out(Minim::MONO, 2048)
+    # pause time when adding a bunch of notes at once
+    out.pause_notes
+    # make four repetitions of the same pattern
+    4.times do |i|
+      # add some low notes
+      out.play_note(1.25 + i * 2.0, 0.3, ToneInstrument.new(out, 75, 0.49))
+      out.play_note(2.50 + i * 2.0, 0.3, ToneInstrument.new(out, 75, 0.49))
+
+      # add some middle notes
+      out.play_note(1.75 + i * 2.0, 0.3, ToneInstrument.new(out, 175, 0.4))
+      out.play_note(2.75 + i * 2.0, 0.3, ToneInstrument.new(out, 175, 0.4))
+
+      # add some high notes
+      out.play_note(1.25 + i * 2.0, 0.3, ToneInstrument.new(out, 3750, 0.07))
+      out.play_note(1.5 + i * 2.0, 0.3, ToneInstrument.new(out, 1750, 0.02))
+      out.play_note(1.75 + i * 2.0, 0.3, ToneInstrument.new(out, 3750, 0.07))
+      out.play_note(2.0 + i * 2.0, 0.3, ToneInstrument.new(out, 1750, 0.02))
+      out.play_note(2.25 + i * 2.0, 0.3, ToneInstrument.new(out, 3750, 0.07))
+      out.play_note(2.5 + i * 2.0, 0.3, ToneInstrument.new(out, 5550, 0.09))
+      out.play_note(2.75 + i * 2.0, 0.3, ToneInstrument.new(out, 3750, 0.07))
+    end
+    # resume time after a bunch of notes are added at once
+    out.resumeNotes
+  end
+
+  # draw is run many times
+  def draw
+    # erase the window to black
+    background(0)
+    # draw using a white stroke
+    stroke(255)
+    # draw the waveforms
+    (0...(out.bufferSize - 1)).each do |i|
+      # find the x position of each buffer value
+      x1  =  map1d(i, 0..out.bufferSize, 0..width)
+      x2  =  map1d(i + 1, 0..out.bufferSize, 0..width)
+      # draw a line from one buffer position to the next for both channels
+      line(x1, 50 + out.left.get(i) * 50, x2, 50 + out.left.get(i + 1) * 50)
+      line(x1, 150 + out.right.get(i) * 50, x2, 150 + out.right.get(i + 1) * 50)
+    end
+  end
+
+  def settings
+    size(512, 200, P2D)
+  end
+end
+
+ADSRExample.new

external_library/java/minim/create_instrument.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/env jruby
+# frozen_string_literal: true
+
+require 'propane'
+# This sketch demonstrates how to create synthesized sound with Minim
+# using an AudioOutput and an Instrument we define. By using the
+# playNote method you can schedule notes to played at some point in the
+# future, essentially allowing to you create musical scores with code.
+# Because they are constructed with code, they can be either
+# deterministic or different every time. This sketch creates a
+# deterministic score, meaning it is the same every time you run the
+# sketch. For more complex examples of using playNote check out
+# algorithmicCompExample and compositionExample. For more information
+# about Minim and additional features, visit
+# http://code.compartmental.net/minim/
+class CreateInstrument < Propane::App
+  load_libraries :minim, :sine_instrument
+  java_import 'ddf.minim.Minim'
+
+  attr_reader :out
+
+  def settings
+    size(512, 200, P2D)
+  end
+
+  def setup
+    sketch_title 'Create Instrument'
+    minim = Minim.new(self)
+    @out = minim.getLineOut
+    # when providing an Instrument, we always specify start time and duration
+    out.playNote(0.0, 0.9, SineInstrument.new(out, 97.99))
+    out.playNote(1.0, 0.9, SineInstrument.new(out, 123.47))
+    # we can use the Frequency class to create frequencies from pitch names
+    out.playNote(2.0, 2.9, SineInstrument.new(out, Frequency.ofPitch('C3').asHz))
+    out.playNote(3.0, 1.9, SineInstrument.new(out, Frequency.ofPitch('E3').asHz))
+    out.playNote(4.0, 0.9, SineInstrument.new(out, Frequency.ofPitch('G3').asHz))
+  end
+
+  def draw
+    background(0)
+    stroke(255)
+    # draw the waveforms
+    (out.bufferSize - 1).times do |i|
+      line(i, 50 + out.left.get(i) * 50, i + 1, 50 + out.left.get(i + 1) * 50)
+      line(i, 150 + out.right.get(i) * 50, i + 1, 150 + out.right.get(i + 1) * 50)
+    end
+  end
+end
+
+CreateInstrument.new