rubysketch 0.9.4 → 0.10.0

data/pod.rake

@@ -3,7 +3,7 @@
 
 github  = 'https://github.com/xord'
 renames = {reflexion: 'reflex'}
-regexp  = /add\w+dependency.*['"](\w+)['"].*['"]\s*~>\s*([\d\.]+)\s*['"]/
+regexp  = /add\w+dependency.*['"]([\w\-]+)['"].*['"]\s*~>\s*([\d\.]+)\s*['"]/
 repos   = File.readlines('rubysketch.gemspec', chomp: true)
   .map {|s| regexp.match(s)&.values_at 1, 2}
   .compact

data/rubysketch.gemspec

@@ -25,14 +25,16 @@ Gem::Specification.new do |s|
   s.platform              = Gem::Platform::RUBY
   s.required_ruby_version = '>= 3.0.0'
 
-  s.add_dependency 'xot',        '~> 0.3.15'
-  s.add_dependency 'rucy',       '~> 0.3.15'
-  s.add_dependency 'beeps',      '~> 0.3.16'
-  s.add_dependency 'rays',       '~> 0.3.16'
-  s.add_dependency 'reflexion',  '~> 0.5.3'
-  s.add_dependency 'processing', '~> 1.3.4'
+  s.add_dependency 'xot',             '~> 0.4.0'
+  s.add_dependency 'rucy',            '~> 0.4.0'
+  s.add_dependency 'beeps',           '~> 0.4.0'
+  s.add_dependency 'rays',            '~> 0.4.0'
+  s.add_dependency 'reflexion',       '~> 0.6.0'
+  s.add_dependency 'reflex-packager', '~> 0.2.0'
+  s.add_dependency 'processing',      '~> 1.4.0'
 
   s.files            = `git ls-files`.split $/
+  s.executables      = s.files.grep(%r{^bin/}) {|f| File.basename f}
   s.test_files       = s.files.grep %r{^(test|spec|features)/}
   s.extra_rdoc_files = rdocs.to_a
 end

data/test/helper.rb

@@ -8,3 +8,26 @@ require 'rubysketch/all'
 require 'test/unit'
 
 include Xot::Test
+
+
+module HasContext
+
+  def new_context()
+    RubySketch::Window.new.context
+  end
+
+  def setup()
+    $processing_context__ = new_context
+    super
+  end
+
+  def teardown()
+    super
+    $processing_context__ = nil
+  end
+
+  def context()
+    $processing_context__
+  end
+
+end# HasContext

data/test/test_constraint.rb

@@ -0,0 +1,230 @@
+require_relative 'helper'
+
+
+class TestConstraint < Test::Unit::TestCase
+
+  include HasContext
+
+  RS = RubySketch
+  PI = Math::PI
+
+  def sprite(*args, **kwargs)
+    RS::Sprite.new(*args, **kwargs)
+  end
+
+  def vec(*args, **kwargs)
+    RS::Vector.new(*args, **kwargs)
+  end
+
+  def sprites()
+    [sprite(100, 100, 50, 50), sprite(200, 100, 50, 50)]
+  end
+
+  def test_create()
+    s1, s2 = sprites
+
+    assert_instance_of RS::SnapConstraint,  s1.snap( s2)
+    assert_instance_of RS::LinkConstraint,  s1.link( s2)
+    assert_instance_of RS::WheelConstraint, s1.wheel(s2)
+    assert_instance_of RS::ChaseConstraint, s1.chase(s2)
+  end
+
+  def test_create_by_pin()
+    s1, s2 = sprites
+
+    assert_instance_of RS::Pin, s1.pin(10, 20)
+    assert_equal s1,            s1.pin(10, 20).sprite
+    assert_equal vec(10, 20),   s1.pin(10, 20).pos
+    assert_nil                  s1.pin        .pos
+
+    assert_instance_of RS::SnapConstraint, s1.pin(10, 20).snap(s2.pin(30, 40))
+    assert_equal [s1, s2],                 s1.pin(10, 20).snap(s2.pin(30, 40)).sprites
+  end
+
+  def test_sprites()
+    s1, s2 = sprites
+
+    assert_equal [s1, s2],  s1.snap(s2)        .sprites
+    assert_equal [s1, nil], s1.link([100, 200]).sprites
+  end
+
+  def test_spring_damping_collide()
+    s1, s2 = sprites
+
+    assert_in_delta 0,   s1.link(s2,            damping: 0.5, collide: true).spring
+    assert_in_delta 4,   s1.link(s2, spring: 4, damping: 0.5, collide: true).spring
+    assert_in_delta 0.5, s1.link(s2, spring: 4, damping: 0.5, collide: true).damping
+    assert_in_delta 0.5, s1.link(s2, spring: 4, damping: 0.5, collide: true).damping
+    assert_false         s1.link(s2, spring: 4, damping: 0.5)               .collide?
+    assert_true          s1.link(s2, spring: 4, damping: 0.5, collide: true).collide?
+
+    c = s1.link s2, spring: 4
+    c.spring = nil; assert_nil         c.spring
+    c.spring = 8;   assert_in_delta 8, c.spring
+  end
+
+  def test_force()
+    s1, s2 = sprites
+
+    assert_nil           s1.snap(s2)            .force
+    assert_in_delta 500, s1.snap(s2, force: 500).force
+
+    c = s1.chase s2, force: 500
+    assert_in_delta 500, c.force
+
+    c.force = nil
+    assert_nil c.force
+  end
+
+  def test_snap_angle_follows_angle_mode()
+    s1, s2 = sprites
+
+    c        = s1.snap s2, angle: -PI / 3..PI / 3, motor: PI # RADIANS by default
+    internal = c.getInternal__
+    assert_in_delta(-60,     internal.angle.begin)
+    assert_in_delta( 60,     internal.angle.end)
+    assert_in_delta( 180,    internal.motor)
+    assert_in_delta(-PI / 3, c.angle.begin)
+    assert_in_delta( PI / 3, c.angle.end)
+    assert_in_delta( PI,     c.motor)
+
+    c.motor = PI / 2
+    assert_in_delta 90, internal.motor
+
+    context.angleMode Processing::GraphicsContext::DEGREES
+    c        = s1.snap s2, angle: -60..60, motor: 90
+    internal = c.getInternal__
+    assert_in_delta(-60, internal.angle.begin)
+    assert_in_delta( 60, internal.angle.end)
+    assert_in_delta( 90, internal.motor)
+    assert_in_delta( 90, c.motor)
+  end
+
+  def test_snap_angle_none_or_fixed()
+    s1, s2 = sprites
+
+    assert_nil s1.snap(s2).angle
+
+    c = s1.snap s2, angle: 0
+    assert_in_delta 0, c.angle.begin
+    assert_in_delta 0, c.angle.end
+  end
+
+  def test_link_distance_range()
+    s1, s2 = sprites
+
+    c = s1.link s2, distance: 80, range: 60..100
+    assert_in_delta 80,  c.distance
+    assert_in_delta 80,  c.dist
+    assert_in_delta 60,  c.range.begin
+    assert_in_delta 100, c.range.end
+  end
+
+  def test_link_axis()
+    s1, s2 = sprites
+
+    assert_nil s1.link(s2).axis # a radial link has no axis
+
+    c = s1.link s2, axis: [0, 1], range: -50..50, motor: 100
+    assert_equal    vec(0, 1), c.axis
+    assert_in_delta(-50, c.range.begin)
+    assert_in_delta( 50, c.range.end)
+    assert_in_delta 100, c.getInternal__.motor # linear: not affected by angleMode
+    assert_in_delta 100, c.motor
+
+    assert_equal vec(1, 0), s1.link(s2, axis: vec(1, 0)).axis
+  end
+
+  def test_wheel()
+    s1, s2 = sprites
+
+    c = s1.wheel s2, axis: [0, 1], spring: 6, motor: PI
+    assert_equal    vec(0, 1), c.axis
+    assert_in_delta 6,   c.spring
+    assert_in_delta 180, c.getInternal__.motor # spin motor follows angleMode
+    assert_in_delta PI,  c.motor
+
+    assert_equal vec(0, 1), s1.wheel(s2).axis # vertical suspension by default
+  end
+
+  def test_chase_target()
+    s1, s2 = sprites
+
+    c = s1.chase s2
+    assert_equal s2, c.target.sprite
+
+    c.target = [10, 20]
+    assert_nil   c.target.sprite
+    assert_equal vec(10, 20), c.target.pos
+
+    c.target = vec(30, 40)
+    assert_equal vec(30, 40), c.target.pos
+
+    s3       = sprite 300, 100, 50, 50
+    c.target = s3
+    assert_equal s3, c.target.sprite
+
+    c.target = nil # nil chases nothing: an empty pin with no sprite and no point
+    assert_nil c.target.sprite
+    assert_nil c.target.pos
+  end
+
+  def test_link_current_distance()
+    s1, s2 = sprites
+
+    c = s1.link s2
+    assert_equal 0, c.currentDistance # 0 while not active in a world
+
+    context.addSprite s1
+    context.addSprite s2
+    s1.dynamic = true
+    assert_in_delta 100, c.currentDistance # sprite centers are 100 px apart
+  end
+
+  def test_block()
+    s1, s2 = sprites
+
+    c = s1.link s2 do
+      distance 80
+      spring   4
+    end
+    assert_in_delta 80, c.distance
+    assert_in_delta 4,  c.spring
+
+    c = s1.snap s2 do
+      motor PI # block form goes through the angleMode conversion too
+    end
+    assert_in_delta 180, c.getInternal__.motor
+  end
+
+  def test_constraints()
+    s1, s2 = sprites
+
+    c1 = s1.link s2
+    c2 = s1.snap s2
+    assert_equal [c1, c2], s1.constraints
+    assert_equal [c1, c2], s2.constraints
+  end
+
+  def test_remove()
+    s1, s2 = sprites
+
+    c = s1.snap s2
+    assert_false c.active? # sprites are not in a world yet
+    assert_false c.removed?
+
+    c.remove
+    assert_true      c.removed?
+    assert_equal [], s1.constraints
+    assert_equal [], s2.constraints
+  end
+
+  def test_constrain_to_itself_error()
+    s, = sprites
+
+    assert_raise(ArgumentError) {s.snap  s}
+    assert_raise(ArgumentError) {s.chase s}
+    assert_equal [], s.constraints
+  end
+
+end# TestConstraint

data/test/test_context.rb

@@ -3,40 +3,77 @@ require_relative 'helper'
 
 class TestContext < Test::Unit::TestCase
 
+  include HasContext
+
   RS = RubySketch
 
-  def sprite(*args, **kwargs)
-    RS::Sprite.new(*args, **kwargs)
+  def world(*args, **kwargs)
+    RS::SpriteWorld.new(*args, **kwargs)
   end
 
-  def context()
-    RS::Context.current__
+  def sprite(*args, **kwargs)
+    RS::Sprite.new(*args, **kwargs)
   end
 
-  def setup()
-    RS::Context.setCurrent__ RS::Window.new.context
+  def test_addWorld()
+    world.tap do |w|
+      assert_equal w,                  context.addWorld(w)
+      assert_equal context, w.getContext__
+      assert_raise(ArgumentError)     {context.addWorld w}
+      assert_raise(ArgumentError) {new_context.addWorld w}
+    end
   end
 
-  def teardown()
-    RS::Context.setCurrent__ nil
+  def test_removeWorld()
+    world.tap do |w|
+      assert_raise(ArgumentError) {context.removeWorld w}
+      context.addWorld w
+      assert_equal w,              context.removeWorld(w)
+      assert_nil w.getContext__
+    end
   end
 
   def test_addSprite()
-    sp = sprite
-    assert_equal sp, context.addSprite(sp)
+    sprite.tap do |sp|
+      assert_equal sp,             context.addSprite(sp)
+      assert_not_nil sp.getWorld__
+      assert_raise(ArgumentError) {context.addSprite sp}
+    end
+
+    sprite.tap do |sp|
+      ary = []
+      assert_equal sp,             context.addSprite(sp, to: ary)
+      assert_equal [sp], ary
+    end
 
-    ary = []
-    assert_equal sp, context.addSprite(ary, sp)
-    assert_equal [sp], ary
+    sprite.tap do |sp| # deprecated form
+      ary = []
+      assert_equal sp,             context.addSprite(ary, sp)
+      assert_equal [sp], ary
+    end
   end
 
   def test_removeSprite()
-    sp = sprite
-    assert_equal sp, context.removeSprite(sp)
+    sprite.tap do |sp|
+      assert_raise(ArgumentError) {context.removeSprite sp}
+      context.addSprite sp
+      assert_equal sp,             context.removeSprite(sp)
+      assert_nil sp.getWorld__
+    end
+
+    sprite.tap do |sp|
+      ary = []
+      context.addSprite sp, to: ary
+      assert_equal sp,             context.removeSprite(sp, from: ary)
+      assert_equal [], ary
+    end
 
-    ary = [sp]
-    assert_equal sp, context.removeSprite(ary, sp)
-    assert_equal [], ary
+    sprite.tap do |sp| # deprecated form
+      ary = []
+      context.addSprite ary, sp
+      assert_equal sp,             context.removeSprite(ary, sp)
+      assert_equal [], ary
+    end
   end
 
 end# TestContext

data/test/test_sprite.rb

@@ -3,6 +3,8 @@ require_relative 'helper'
 
 class TestSprite < Test::Unit::TestCase
 
+  include HasContext
+
   RS = RubySketch
 
   def sprite(*args, **kwargs)
@@ -17,14 +19,6 @@ class TestSprite < Test::Unit::TestCase
     RS::Image.new Rays::Image.new(w, h)
   end
 
-  def setup()
-    RS::Context.setCurrent__ RS::Window.new.context
-  end
-
-  def teardown()
-    RS::Context.setCurrent__ nil
-  end
-
   def test_initialize()
     assert_equal vec(0, 0), sprite            .pos
     assert_equal vec(1, 2), sprite(1, 2)      .pos

data/test/test_sprite_world.rb

@@ -0,0 +1,66 @@
+require_relative 'helper'
+
+
+class TestSpriteWorld < Test::Unit::TestCase
+
+  include HasContext
+
+  RS = RubySketch
+
+  def world(*args, **kwargs)
+    RS::SpriteWorld.new(*args, **kwargs)
+  end
+
+  def sprite(*args, **kwargs)
+    RS::Sprite.new(*args, **kwargs)
+  end
+
+  def test_addSprite()
+    sprite.tap do |sp|
+      w = world
+      assert_equal sp,             w    .addSprite(sp)
+      assert_not_nil sp.getWorld__
+      assert_raise(ArgumentError) {w    .addSprite sp}
+      assert_raise(ArgumentError) {world.addSprite sp}
+    end
+
+    sprite.tap do |sp|
+      w, ary = world, []
+      assert_equal sp,             w.addSprite(sp, to: ary)
+      assert_equal [sp], ary
+    end
+
+    sprite.tap do |sp| # deprecated form
+      w, ary = world, []
+      assert_equal sp,             w.addSprite(ary, sp)
+      assert_equal [sp], ary
+    end
+  end
+
+  def test_removeSprite()
+    sprite.tap do |sp|
+      w = world
+      assert_raise(ArgumentError) {w.removeSprite sp}
+      w.addSprite sp
+      assert_equal sp,             w.removeSprite(sp)
+      assert_nil sp.getWorld__
+    end
+
+    sprite.tap do |sp|
+      w, ary = world, []
+      w.addSprite sp, to: ary
+      assert_equal [sp], ary
+      assert_equal sp,             w.removeSprite(sp, from: ary)
+      assert_equal [],   ary
+    end
+
+    sprite.tap do |sp| # deprecated form
+      w, ary = world, []
+      w.addSprite ary, sp
+      assert_equal [sp], ary
+      assert_equal sp,             w.removeSprite(ary, sp)
+      assert_equal [],   ary
+    end
+  end
+
+end# TestSpriteWorld

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rubysketch
 version: !ruby/object:Gem::Version
-  version: 0.9.4
+  version: 0.10.0
 platform: ruby
 authors:
 - xordog
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-23 00:00:00.000000000 Z
+date: 2026-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: xot
@@ -16,87 +16,102 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.15
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.15
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: rucy
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.15
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.15
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: beeps
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.16
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.16
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: rays
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.16
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.16
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: reflexion
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.3
+        version: 0.6.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.3
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: reflex-packager
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: processing
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.4
+        version: 1.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.4
+        version: 1.4.0
 description: A game engine based on the Processing API.
 email: xordog@gmail.com
-executables: []
+executables:
+- rubysketch
 extensions: []
 extra_rdoc_files: []
 files:
@@ -116,6 +131,8 @@ files:
 - Rakefile
 - RubySketch.podspec
 - VERSION
+- bin/rubysketch
+- examples/constraint.rb
 - examples/hello.rb
 - examples/mml.rb
 - examples/physics.rb
@@ -123,12 +140,14 @@ files:
 - examples/toon.rb
 - lib/rubysketch.rb
 - lib/rubysketch/all.rb
+- lib/rubysketch/constraint.rb
 - lib/rubysketch/context.rb
 - lib/rubysketch/easings.rb
 - lib/rubysketch/extension.rb
 - lib/rubysketch/graphics_context.rb
 - lib/rubysketch/helper.rb
 - lib/rubysketch/mml.rb
+- lib/rubysketch/pin.rb
 - lib/rubysketch/shape.rb
 - lib/rubysketch/sound.rb
 - lib/rubysketch/sprite.rb
@@ -138,10 +157,12 @@ files:
 - src/RubySketch.h
 - src/RubySketch.mm
 - test/helper.rb
+- test/test_constraint.rb
 - test/test_context.rb
 - test/test_mml.rb
 - test/test_sound.rb
 - test/test_sprite.rb
+- test/test_sprite_world.rb
 homepage: https://github.com/xord/rubysketch
 licenses:
 - MIT
@@ -167,7 +188,9 @@ specification_version: 4
 summary: A game engine based on the Processing API.
 test_files:
 - test/helper.rb
+- test/test_constraint.rb
 - test/test_context.rb
 - test/test_mml.rb
 - test/test_sound.rb
 - test/test_sprite.rb
+- test/test_sprite_world.rb