add readme

Author: monkstone

external_library/gem/skatolo/README.md

@@ -0,0 +1,20 @@
+# skatolo
+
+### Skatolo is a GUI library for Processing, forked from [ControlP5](https://github.com/sojamo/controlp5)
+See repo on [github](https://github.com/Rea-lity-Tech/Skatolo) to run these examples you require gem version 1.1.4+ (if only 1.1.3 version is available from rubygems then clone repo to build)
+
+### About
+
+The skatolo java library was developed for an [advanced use of ControlP5](https://github.com/poqudrof/PapARt), it is not as convenient to use. It is a part of a research and development project involving multi-touch, augmented reality and Ruby. However it has also been adapted to work easily with JRubyArt (and hence propane). The skatolo library is developed by [Jeremy Laviole](http://jeremy.laviole.name/).
+
+#### Sliders
+
+If you name slider 'fred' then you will be able access the value as `fred_value`
+
+#### Buttons
+
+If you name the button 'my_method' you will be able create a method `:my_method` that gets called when button is pressed.
+
+### Usage
+
+Sketches need to `require 'skatolo'`, and `include EventMethod`, otherwise usage is similar to ControlP5 except `Skatolo.new(self)` instead of `ControlP5.new(self)`

external_library/gem/skatolo/Rakefile

@@ -0,0 +1,29 @@
+# Simple demo Rakefile to autorun samples in current directory
+
+SAMPLES_DIR = './'
+
+desc 'run demo'
+task default: [:demo]
+
+desc 'demo'
+task :demo do
+  samples_list.shuffle.each { |sample| run_sample sample }
+end
+
+def samples_list
+  files = []
+  Dir.chdir(SAMPLES_DIR)
+  Dir.glob('*.rb').each do |file|
+    files << File.join(SAMPLES_DIR, file)
+  end
+  return files
+end
+
+def run_sample(sample_name)
+  puts "Running #{sample_name}...quit to run next sample"
+  open("|jruby #{sample_name}", 'r') do |io|
+    while l = io.gets
+      puts(l.chop)
+    end
+  end
+end

external_library/gem/skatolo/button_group.rb

@@ -2,11 +2,14 @@
 require 'propane'
 require 'skatolo'
 # In this simple sketch we attach three buttons to skatolo in the regular way,
-# named buttons 'press_me' and 'reset' thanks to some fancy metaprogramming
-# we can create methods :red_color, :green_color and :blue_color for the buttons
-class SkatoloButtonGroup < Propane::App
-
+# and group them, then add the group to the accordion widget
+# named buttons 'red_color' ... thanks to some fancy metaprogramming
+# we can create methods :red_color, :green_color and :blue_color buttons
+class ButtonGroup < Propane::App
   include EventMethod
+
+  COLOR = %w[Red Green Blue].freeze
+
   attr_reader :skatolo, :back_color
 
   def settings
@@ -39,26 +42,18 @@ def blue_color
   def create_gui
     @skatolo = Skatolo.new(self)
     color_group = skatolo.add_group('colors')
-    skatolo.add_button('red_color')
-           .set_group(color_group)
-           .set_position(0, 10)
-           .set_size(50, 20)
-           .set_label('Red')
-    skatolo.add_button('green_color')
-           .set_group(color_group)
-           .set_position(0, 30)
-           .set_size(50, 20)
-           .set_label('Green')
-    skatolo.add_button('blue_color')
-           .set_group(color_group)
-           .set_position(0, 50)
-           .set_size(50, 20)
-           .set_label('Blue')
+    %w[red_color green_color blue_color].freeze.each_with_index do |col, index|
+      skatolo.add_button(col)
+             .set_group(color_group)
+             .set_position(0, 10 + index * 20)
+             .set_size(50, 20)
+             .set_label(COLOR[index])
+    end
     skatolo.add_accordion('acc')
            .set_position(20, 10)
            .set_size(50, 20)
            .add_item(color_group)
   end
 end
 
-SkatoloButtonGroup.new
+ButtonGroup.new

external_library/gem/skatolo/buttons.rb

@@ -4,27 +4,21 @@
 # In this simple sketch we attach two buttons to skatolo in the regular way,
 # named buttons 'press_me' and 'reset' thanks to some fancy metaprogramming
 # we can create methods :press_me and :reset for the buttons
-class SkatoloButtons < Propane::App
+
+class ButtonDemo < Propane::App
   include EventMethod
+
   attr_reader :skatolo, :back_color
 
   def settings
     size(400, 300)
   end
 
   def setup
-    sketch_title 'Skatolo Buttons on Propane'
-    @skatolo = Skatolo.new(self)
-    skatolo.add_button('press_me')
-  	       .set_position(10, 10)
-           .set_size(50, 20)
-  	       .set_label('Press Me!')
-    skatolo.add_button('reset')
-         	 .set_position(10, 40)
-           .set_size(50, 20)
-         	 .set_label('Reset!')
-     skatolo.update # this step is important
-     @back_color = color(200, 0, 200)
+    sketch_title 'Skatolo Buttons'
+    create_gui
+    skatolo.update # this step is important
+    @back_color = color(200, 0, 200)
   end
 
   def draw
@@ -38,6 +32,18 @@ def reset
   def press_me
     @back_color = color(200, 0, 0)
   end
+
+  def create_gui
+    @skatolo = Skatolo.new(self)
+    skatolo.add_button('press_me')
+           .set_position(10, 10)
+           .set_size(50, 20)
+           .set_label('Press Me!')
+    skatolo.add_button('reset')
+           .set_position(10, 40)
+           .set_size(50, 20)
+           .set_label('Reset!')
+  end
 end
 
-SkatoloButtons.new
+ButtonDemo.new

external_library/gem/skatolo/jwishy.rb

@@ -82,9 +82,9 @@ def draw_shape(args)
     when 'triangle'
       draw_triangle(args)
     when 'square'
-      rect(args[1], args[2], args[3], args[4])
+      rect(*args.slice(1, 4))
     else
-      oval(args[1], args[2], args[3], args[4]) # ellipse alias
+      oval(*args.slice(1, 4)) # ellipse alias
     end
   end
 
@@ -117,30 +117,20 @@ def create_gui
            .set_color_background(color(100))
     px = 10
     py = 15
-    skatolo.add_slider('bluish')
-           .set_size(sx, sy)
-           .set_position(px, py += oy)
-           .set_range(0, 1.0)
-           .set_value(0.5)
-           .set_group(control)
-    skatolo.add_slider('alpha')
-           .set_size(sx, sy)
-           .set_position(px, py += oy)
-           .set_range(0, 1.0)
-           .set_value(0.5)
-           .set_group(control)
-    skatolo.add_button('toggle_big')
-           .set_size(sx, 15)
-           .set_position(px, py += oy)
-           .set_group(control)
-    skatolo.add_button('reset!')
-           .set_size(sx, 15)
-           .set_position(px, py += oy)
-           .set_group(control)
-    skatolo.add_button('random_shape')
-           .set_size(sx, 15)
-           .set_position(px, py += oy)
-           .set_group(control)
+    %w[bluish alpha].freeze.each do |slider|
+      skatolo.add_slider(slider)
+             .set_size(sx, sy)
+             .set_position(px, py += oy)
+             .set_range(0, 1.0)
+             .set_value(0.5)
+             .set_group(control)
+    end
+    %w[toggle_big reset! random_shape].freeze.each do |button|
+      skatolo.add_button(button)
+             .set_size(sx, 15)
+             .set_position(px, py += oy)
+             .set_group(control)
+    end
   end
 end
 

external_library/gem/skatolo/slider.rb

@@ -3,8 +3,8 @@
 require 'skatolo'
 # In this simple sketch we attach a slider to skatolo in the regular way, with
 # a named slider 'background_color' and thanks to some fancy metaprogramming
-# we can read the result from background_color_value
-class SkatoloSlider < Propane::App
+# we can read the result from background_color_value in the sketch
+class SliderDemo < Propane::App
   include EventMethod
   attr_reader :skatolo
 
@@ -14,19 +14,23 @@ def settings
 
   def setup
     sketch_title 'Skatolo Slider'
-    @skatolo = Skatolo.new(self)
-    skatolo.add_slider('background_color')
-  	       .set_position(10, 10)
-  	       .set_size(150, 20)
-  	       .set_range(80, 255)
-           .set_value(180)
-  	       .set_label('Background color')
-     skatolo.update # this step is important
+    create_gui
+    skatolo.update # this step is important
   end
 
   def draw
     background(background_color_value)
   end
+
+  def create_gui
+    @skatolo = Skatolo.new(self)
+    skatolo.add_slider('background_color')
+           .set_position(10, 10)
+           .set_size(150, 20)
+           .set_range(80, 255)
+           .set_value(180)
+           .set_label('Background color')
+  end
 end
 
-SkatoloSlider.new
+SliderDemo.new

external_library/gem/skatolo/slider_group.rb

@@ -1,11 +1,10 @@
 #!/usr/bin/env jruby
 require 'propane'
 require 'skatolo'
-# In this simple sketch we attach three buttons to skatolo in the regular way,
-# named buttons 'press_me' and 'reset' thanks to some fancy metaprogramming
-# we can create methods :red_color, :green_color and :blue_color for the buttons
-class SkatoloSliderGroup < Propane::App
-
+# In this simple sketch we attach three sliders to skatolo in the regular way,
+# then group them and attach to an accordion widget, the slider values are sent
+# (auto-magically) to the sketch as red_value, green_value and blue_value
+class SliderGroupDemo < Propane::App
   include EventMethod
   attr_reader :skatolo, :back_color
 
@@ -27,29 +26,19 @@ def draw
   def create_gui
     @skatolo = Skatolo.new(self)
     color_group = skatolo.add_group('colors')
-    skatolo.add_slider('red')
-           .set_group(color_group)
-           .set_size(100, 15)
-           .set_position(0, 10)
-           .set_range(0, 255)
-           .set_value(50)
-    skatolo.add_slider('green')
-           .set_group(color_group)
-           .set_size(100, 15)
-           .set_position(0, 30)
-           .set_range(0, 255)
-           .set_value(50)
-    skatolo.add_slider('blue')
-           .set_group(color_group)
-           .set_size(100, 15)
-           .set_position(0, 50)
-           .set_range(0, 255)
-           .set_value(50)
+    %w[red green blue].freeze.each_with_index do |slider, index|
+      skatolo.add_slider(slider)
+             .set_group(color_group)
+             .set_size(100, 15)
+             .set_position(0, 10 + 20 * index)
+             .set_range(0, 255)
+             .set_value(50)
+    end
     skatolo.add_accordion('acc')
            .set_position(10, 10)
            .set_size(120, 20)
            .add_item(color_group)
   end
 end
 
-SkatoloSliderGroup.new
+SliderGroupDemo.new

external_library/gem/skatolo/text_box.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/env jruby
+require 'propane'
+require 'skatolo'
+# In this simple sketch we attach a button to skatolo in the regular way,
+# and textfield widget. We can create a method :press_me and print the value of
+# the textfield, ps: make sure you do return on texfield entry
+class TextBoxDemo < Propane::App
+  include EventMethod
+  attr_reader :skatolo, :back_color, :font, :name
+
+  def settings
+    size(400, 300)
+  end
+
+  def setup
+    sketch_title 'Skatolo Text Box'
+    create_gui
+    skatolo.update # this step is important
+    @back_color = color(200, 0, 200)
+    text_font(create_font('monospace', 30))
+    @name = ''
+  end
+
+  def press_me
+    text("Hello #{name}", 10,120)
+    @name = ''
+  end
+
+  def draw
+    background(back_color)
+    @name = input_name_value if name.length.zero?
+  end
+
+  def create_gui
+    @skatolo = Skatolo.new(self)
+    skatolo.add_button('press_me')
+           .set_position(10, 10)
+           .set_size(50, 20)
+           .set_label('Press Me!')
+    @input = skatolo.add_textfield('input_name')
+           .set_position(10, 50)
+           .set_size(100, 20)
+           .set_auto_clear(true)
+  end
+end
+
+TextBoxDemo.new