processing 0.5.33 → 1.0.1

data/lib/processing/svg.rb

@@ -0,0 +1,248 @@
+module Processing
+
+
+  # @private
+  class SVGLoader
+
+    def initialize(context)
+      @c, @cc = context, context.class
+    end
+
+    def load(filename)
+      parse File.read(filename)
+    end
+
+    def parse(xml)
+      addGroup nil, REXML::Document.new(xml).elements.first
+    end
+
+    def addGroup(parent, e, **attribs)
+      group   = @c.createShape @cc::GROUP
+      attribs = getAttribs e, attribs
+      e.elements.each do |child|
+        case child.name.to_sym
+        when :g, :a    then addGroup    group, child,       **attribs
+        when :line     then addLine     group, child,       **attribs
+        when :rect     then addRect     group, child,       **attribs
+        when :circle   then addCircle   group, child,       **attribs
+        when :ellipse  then addEllipse  group, child,       **attribs
+        when :polyline then addPolyline group, child,       **attribs
+        when :polygon  then addPolyline group, child, true, **attribs
+        when :path     then addPath     group, child,       **attribs
+        end
+      end
+      parent.addChild group if parent
+      group
+    end
+
+    def addLine(parent, e, **attribs)
+      x1, y1 = float(e, :x1), float(e, :y1)
+      x2, y2 = float(e, :x2), float(e, :y2)
+      s = @c.createLineShape__ x1, y1, x2, y2
+      applyAttribs s, e, attribs
+      parent.addChild s
+    end
+
+    def addRect(parent, e, **attribs)
+      x,  y  = float(e, :x),     float(e, :y)
+      w,  h  = float(e, :width), float(e, :height)
+      rx, ry = float(e, :rx),    float(e, :ry)
+      s = @c.createRectShape__ x, y, w, h, (rx || ry), mode: @cc::CORNER
+      applyAttribs s, e, attribs
+      parent.addChild s
+    end
+
+    def addCircle(parent, e, **attribs)
+      cx, cy = float(e, :cx), float(e, :cy)
+      r      = float(e, :r)
+      s = @c.createEllipseShape__ cx, cy, r * 2, r * 2, mode: @cc::CENTER
+      applyAttribs s, e, attribs
+      parent.addChild s
+    end
+
+    def addEllipse(parent, e, **attribs)
+      cx, cy = float(e, :cx), float(e, :cy)
+      rx, ry = float(e, :rx), float(e, :ry)
+      s = @c.createEllipseShape__ cx, cy, rx * 2, ry * 2, mode: @cc::CENTER
+      applyAttribs s, e, attribs
+      parent.addChild s
+    end
+
+    def addPolyline(parent, e, close = false, **attribs)
+      points  = e[:points] or raise Error, "missing 'points'"
+      scanner = StringScanner.new points
+      child   = @c.createShape
+      child.beginShape
+
+      skipSpaces scanner
+      until scanner.eos?
+        child.vertex(*nextPos(scanner))
+        skipSpaces scanner
+      end
+
+      child.endShape close ? @cc::CLOSE : @cc::OPEN
+      applyAttribs child, e, attribs
+      parent.addChild child
+    end
+
+    def applyAttribs(shape, e, attribs)
+      a = getAttribs e, attribs
+      shape.setFill         a[:fill]         || :black
+      shape.setStroke       a[:stroke]       || :none
+      shape.setStrokeWeight a[:strokeWeight] || 1
+      shape.setStrokeCap    a[:strokeCap]    || @cc::SQUARE
+      shape.setStrokeJoin   a[:strokeJoin]   || @cc::MITER
+    end
+
+    def getAttribs(e, attribs)
+      @caps ||= {
+        'butt'   => @cc::SQUARE,
+        'round'  => @cc::ROUND,
+        'square' => @cc::PROJECT
+      }
+      @joins ||= {
+        'miter'      => @cc::MITER,
+        'miter-clip' => @cc::MITER,
+        'round'      => @cc::ROUND,
+        'bevel'      => @cc::BEVEL,
+        'arcs'       => @cc::MITER
+      }
+      attribs.merge({
+        fill:                e[:fill],
+        stroke:              e[:stroke],
+        strokeWeight:        e[:'stroke-width'],
+        strokeCap:    @caps[ e[:'stroke-linecap']],
+        strokeJoin:   @joins[e[:'stroke-linejoin']]
+      }.compact)
+    end
+
+    def int(e, key, defval = 0)
+      e[key]&.to_i || defval
+    end
+
+    def float(e, key, defval = 0)
+      e[key]&.to_f || defval
+    end
+
+    def addPath(parent, e, **attribs)
+      data    = e[:d] or raise Error, "missing 'd'"
+      scanner = StringScanner.new data
+      skipSpaces scanner
+
+      child      = nil
+      close      = false
+      beginChild = -> {
+        close = false
+        child = @c.createShape
+        child.beginShape
+      }
+      endChild   = -> {
+        if child# && child.getVertexCount >= 2
+          child.endShape close ? @cc::CLOSE : @cc::OPEN
+          applyAttribs child, e, attribs
+          parent.addChild child
+        end
+      }
+
+      lastCommand    = nil
+      lastX,  lastY  = 0, 0
+      lastCX, lastCY = 0, 0
+      until scanner.eos?
+        command = nextCommand scanner
+        if command =~ /^[Mm]$/
+          endChild.call
+          beginChild.call
+        end
+        raise Error, "no leading 'M' or 'm'" unless child
+
+        command ||= lastCommand
+        case command
+        when 'M', 'm'
+          lastX, lastY = nextPos scanner, lastX, lastY, command == 'm'
+          child.vertex lastX, lastY
+        when 'L', 'l'
+          lastX, lastY = nextPos scanner, lastX, lastY, command == 'l'
+          child.vertex lastX, lastY
+        when 'H', 'h'
+          lastX = nextNum scanner, lastX, command == 'h'
+          child.vertex lastX, lastY
+        when 'V', 'v'
+          lastY = nextNum scanner, lastY, command == 'v'
+          child.vertex lastX, lastY
+        when 'Q', 'q'
+          relative       = command == 'q'
+          lastCX, lastCY = nextPos scanner, lastX, lastY, relative
+          lastX,  lastY  = nextPos scanner, lastX, lastY, relative
+          child.quadraticVertex lastCX, lastCY, lastX, lastY
+        when 'T', 't'
+          lastCX, lastCY =
+            if lastCommand =~ /[QqTt]/
+              [lastX + (lastX - lastCX), lastY + (lastY - lastCY)]
+            else
+              [lastX, lastY]
+            end
+          lastX, lastY = nextPos scanner, lastX, lastY, command == 't'
+          child.quadraticVertex lastCX, lastCY, lastX, lastY
+        when 'C', 'c'
+          relative       = command == 'c'
+              cx,     cy = nextPos scanner, lastX, lastY, relative
+          lastCX, lastCY = nextPos scanner, lastX, lastY, relative
+          lastX,  lastY  = nextPos scanner, lastX, lastY, relative
+          child.bezierVertex cx, cy, lastCX, lastCY, lastX, lastY
+        when 'S', 's'
+          cx, cy =
+            if lastCommand =~ /[CcSs]/
+              [lastX + (lastX - lastCX), lastY + (lastY - lastCY)]
+            else
+              [lastX, lastY]
+            end
+          relative       = command == 's'
+          lastCX, lastCY = nextPos scanner, lastX, lastY, relative
+          lastX,  lastY  = nextPos scanner, lastX, lastY, relative
+          child.bezierVertex cx, cy, lastCX, lastCY, lastX, lastY
+        when 'A', 'a'
+          rx, ry       = nextPos scanner
+          a, b, c      = nextNum(scanner), nextNum(scanner), nextNum(scanner)
+          lastX, lastY = nextPos scanner, lastX, lastY, command == 'a'
+          child.vertex lastX, lastY
+        when 'Z', 'z'
+          v0           = child.getVertex 0
+          lastX, lastY = v0 ? [v0.x, v0.y] : [0, 0]
+          close = true
+        end
+        lastCommand = command
+      end
+      endChild.call
+    end
+
+    def nextCommand(scanner)
+      w = scanner.scan(/[[:alpha:]]/)
+      skipSpaces scanner
+      w
+    end
+
+    def nextNum(scanner, base = 0, relative = true)
+      n = scanner.scan(/(?:[\+\-]\s*)?\d*(?:\.\d+)?/)&.strip&.to_f
+      raise Error, 'invalid path' unless n
+      skipSpaces scanner
+      n + (relative ? base : 0)
+    end
+
+    def nextPos(scanner, baseX = 0, baseY = 0, relative = true)
+      [nextNum(scanner, baseX, relative), nextNum(scanner, baseY, relative)]
+    end
+
+    def skipSpaces(scanner)
+      scanner.scan(/\s*,?\s*/)
+    end
+
+    class Error < StandardError
+      def initialize(message = "error")
+        super "SVG: #{message}"
+      end
+    end# Error
+
+  end# SVG
+
+
+end# Processing

data/lib/processing/vector.rb

@@ -3,6 +3,9 @@ module Processing
 
   # Vector class.
   #
+  # @see https://processing.org/reference/PVector.html
+  # @see https://p5js.org/reference/#/p5.Vector
+  #
   class Vector
 
     include Comparable
@@ -22,6 +25,9 @@ module Processing
     # @param v [Vector]  vector object to copy
     # @param a [Array]   array like [x, y, z]
     #
+    # @see https://processing.org/reference/PVector.html
+    # @see https://p5js.org/reference/#/p5.Vector
+    #
     def initialize(x = 0, y = 0, z = 0, context: nil)
       @point = case x
         when Rays::Point then x.dup
@@ -42,6 +48,9 @@ module Processing
     #
     # @return [Vector] duplicated vector object
     #
+    # @see https://processing.org/reference/PVector_copy_.html
+    # @see https://p5js.org/reference/#/p5.Vector/copy
+    #
     alias copy dup
 
     # Sets x, y and z.
@@ -60,6 +69,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/PVector_set_.html
+    # @see https://p5js.org/reference/#/p5.Vector/set
+    #
     def set(*args)
       initialize(*args)
       self
@@ -69,6 +81,9 @@ module Processing
     #
     # @return [Numeric] x value of vector
     #
+    # @see https://processing.org/reference/PVector_x.html
+    # @see https://p5js.org/reference/#/p5.Vector/x
+    #
     def x()
       @point.x
     end
@@ -77,6 +92,9 @@ module Processing
     #
     # @return [Numeric] y value of vector
     #
+    # @see https://processing.org/reference/PVector_y.html
+    # @see https://p5js.org/reference/#/p5.Vector/y
+    #
     def y()
       @point.y
     end
@@ -85,6 +103,9 @@ module Processing
     #
     # @return [Numeric] z value of vector
     #
+    # @see https://processing.org/reference/PVector_z.html
+    # @see https://p5js.org/reference/#/p5.Vector/z
+    #
     def z()
       @point.z
     end
@@ -93,6 +114,9 @@ module Processing
     #
     # @return [Numeric] x value of vector
     #
+    # @see https://processing.org/reference/PVector_x.html
+    # @see https://p5js.org/reference/#/p5.Vector/x
+    #
     def x=(x)
       @point.x = x
     end
@@ -101,6 +125,9 @@ module Processing
     #
     # @return [Numeric] y value of vector
     #
+    # @see https://processing.org/reference/PVector_y.html
+    # @see https://p5js.org/reference/#/p5.Vector/y
+    #
     def y=(y)
       @point.y = y
     end
@@ -109,6 +136,9 @@ module Processing
     #
     # @return [Numeric] z value of vector
     #
+    # @see https://processing.org/reference/PVector_z.html
+    # @see https://p5js.org/reference/#/p5.Vector/z
+    #
     def z=(z)
       @point.z = z
     end
@@ -127,6 +157,9 @@ module Processing
     #
     # @return [Vector] interporated vector
     #
+    # @see https://processing.org/reference/PVector_lerp_.html
+    # @see https://p5js.org/reference/#/p5.Vector/lerp
+    #
     def lerp(*args, amount)
       v      = toVector__(*args)
       self.x = x + (v.x - x) * amount
@@ -143,6 +176,9 @@ module Processing
     #
     # @return [Vector] interporated vector
     #
+    # @see https://processing.org/reference/PVector_lerp_.html
+    # @see https://p5js.org/reference/#/p5.Vector/lerp
+    #
     def self.lerp(v1, v2, amount)
       v1.dup.lerp v2, amount
     end
@@ -153,6 +189,9 @@ module Processing
     #
     # @return [Array] array of x, y, z
     #
+    # @see https://processing.org/reference/PVector_array_.html
+    # @see https://p5js.org/reference/#/p5.Vector/array
+    #
     def array(n = 3)
       @point.to_a n
     end
@@ -172,6 +211,9 @@ module Processing
     #
     # @return [Vector] added vector
     #
+    # @see https://processing.org/reference/PVector_add_.html
+    # @see https://p5js.org/reference/#/p5.Vector/add
+    #
     def add(*args)
       @point += toVector__(*args).getInternal__
       self
@@ -190,6 +232,9 @@ module Processing
     #
     # @return [Vector] subtracted vector
     #
+    # @see https://processing.org/reference/PVector_sub_.html
+    # @see https://p5js.org/reference/#/p5.Vector/sub
+    #
     def sub(*args)
       @point -= toVector__(*args).getInternal__
       self
@@ -201,6 +246,9 @@ module Processing
     #
     # @return [Vector] multiplied vector
     #
+    # @see https://processing.org/reference/PVector_mult_.html
+    # @see https://p5js.org/reference/#/p5.Vector/mult
+    #
     def mult(num)
       @point *= num
       self
@@ -212,6 +260,9 @@ module Processing
     #
     # @return [Vector] divided vector
     #
+    # @see https://processing.org/reference/PVector_div_.html
+    # @see https://p5js.org/reference/#/p5.Vector/div
+    #
     def div(num)
       @point /= num
       self
@@ -223,6 +274,9 @@ module Processing
     #
     # @return [Vector] added vector
     #
+    # @see https://processing.org/reference/PVector_add_.html
+    # @see https://p5js.org/reference/#/p5.Vector/add
+    #
     def +(v)
       dup.add v
     end
@@ -233,6 +287,9 @@ module Processing
     #
     # @return [Vector] subtracted vector
     #
+    # @see https://processing.org/reference/PVector_sub_.html
+    # @see https://p5js.org/reference/#/p5.Vector/sub
+    #
     def -(v)
       dup.sub v
     end
@@ -243,6 +300,9 @@ module Processing
     #
     # @return [Vector] multiplied vector
     #
+    # @see https://processing.org/reference/PVector_mult_.html
+    # @see https://p5js.org/reference/#/p5.Vector/mult
+    #
     def *(num)
       dup.mult num
     end
@@ -253,6 +313,9 @@ module Processing
     #
     # @return [Vector] divided vector
     #
+    # @see https://processing.org/reference/PVector_div_.html
+    # @see https://p5js.org/reference/#/p5.Vector/div
+    #
     def /(num)
       dup.div num
     end
@@ -268,6 +331,9 @@ module Processing
     #
     # @return [Vector] added vector
     #
+    # @see https://processing.org/reference/PVector_add_.html
+    # @see https://p5js.org/reference/#/p5.Vector/add
+    #
     def self.add(v1, v2, target = nil)
       v = v1 + v2
       target.set v if self === target
@@ -285,6 +351,9 @@ module Processing
     #
     # @return [Vector] subtracted vector
     #
+    # @see https://processing.org/reference/PVector_sub_.html
+    # @see https://p5js.org/reference/#/p5.Vector/sub
+    #
     def self.sub(v1, v2, target = nil)
       v = v1 - v2
       target.set v if self === target
@@ -302,6 +371,9 @@ module Processing
     #
     # @return [Vector] multiplied vector
     #
+    # @see https://processing.org/reference/PVector_mult_.html
+    # @see https://p5js.org/reference/#/p5.Vector/mult
+    #
     def self.mult(v1, num, target = nil)
       v = v1 * num
       target.set v if self === target
@@ -319,6 +391,9 @@ module Processing
     #
     # @return [Vector] divided vector
     #
+    # @see https://processing.org/reference/PVector_div_.html
+    # @see https://p5js.org/reference/#/p5.Vector/div
+    #
     def self.div(v1, num, target = nil)
       v = v1 / num
       target.set v if self === target
@@ -329,6 +404,9 @@ module Processing
     #
     # @return [Numeric] length
     #
+    # @see https://processing.org/reference/PVector_mag_.html
+    # @see https://p5js.org/reference/#/p5.Vector/mag
+    #
     def mag()
       @point.length
     end
@@ -337,6 +415,9 @@ module Processing
     #
     # @return [Numeric] squared length
     #
+    # @see https://processing.org/reference/PVector_magSq_.html
+    # @see https://p5js.org/reference/#/p5.Vector/magSq
+    #
     def magSq()
       Rays::Point::dot(@point, @point)
     end
@@ -351,6 +432,9 @@ module Processing
     #
     # @return [Vector] vector with new length
     #
+    # @see https://processing.org/reference/PVector_setMag_.html
+    # @see https://p5js.org/reference/#/p5.Vector/setMag
+    #
     def setMag(target = nil, len)
       (target || self).set @point.normal * len
     end
@@ -361,6 +445,9 @@ module Processing
     #
     # @return [Vector] normalized vector
     #
+    # @see https://processing.org/reference/PVector_normalize_.html
+    # @see https://p5js.org/reference/#/p5.Vector/normalize
+    #
     def normalize(target = nil)
       (target || self).set @point.normal
     end
@@ -371,6 +458,9 @@ module Processing
     #
     # @return [Vector] new vector
     #
+    # @see https://processing.org/reference/PVector_limit_.html
+    # @see https://p5js.org/reference/#/p5.Vector/limit
+    #
     def limit(max)
       setMag max if magSq > max ** 2
       self
@@ -382,6 +472,9 @@ module Processing
     #
     # @return [Numeric] the distance
     #
+    # @see https://processing.org/reference/PVector_dist_.html
+    # @see https://p5js.org/reference/#/p5.Vector/dist
+    #
     def dist(v)
       (self - v).mag
     end
@@ -393,6 +486,9 @@ module Processing
     #
     # @return [Numeric] the distance
     #
+    # @see https://processing.org/reference/PVector_dist_.html
+    # @see https://p5js.org/reference/#/p5.Vector/dist
+    #
     def self.dist(v1, v2)
       v1.dist v2
     end
@@ -410,6 +506,9 @@ module Processing
     #
     # @return [Numeric] result of dot product
     #
+    # @see https://processing.org/reference/PVector_dot_.html
+    # @see https://p5js.org/reference/#/p5.Vector/dot
+    #
     def dot(*args)
       Rays::Point::dot getInternal__, toVector__(*args).getInternal__
     end
@@ -421,6 +520,9 @@ module Processing
     #
     # @return [Numeric] result of dot product
     #
+    # @see https://processing.org/reference/PVector_dot_.html
+    # @see https://p5js.org/reference/#/p5.Vector/dot
+    #
     def self.dot(v1, v2)
       v1.dot v2
     end
@@ -438,6 +540,9 @@ module Processing
     #
     # @return [Numeric] result of cross product
     #
+    # @see https://processing.org/reference/PVector_cross_.html
+    # @see https://p5js.org/reference/#/p5.Vector/cross
+    #
     def cross(a, *rest)
       target = self.class === rest.last ? rest.pop : nil
       v = self.class.new Rays::Point::cross getInternal__, toVector__(a, *rest).getInternal__
@@ -452,6 +557,9 @@ module Processing
     #
     # @return [Numeric] result of cross product
     #
+    # @see https://processing.org/reference/PVector_cross_.html
+    # @see https://p5js.org/reference/#/p5.Vector/cross
+    #
     def self.cross(v1, v2, target = nil)
       v1.cross v2, target
     end
@@ -462,6 +570,9 @@ module Processing
     #
     # @return [Vector] rotated this object
     #
+    # @see https://processing.org/reference/PVector_rotate_.html
+    # @see https://p5js.org/reference/#/p5.Vector/rotate
+    #
     def rotate(angle)
       deg = @context ?
         @context.toDegrees__(angle) : angle * GraphicsContext::RAD2DEG__
@@ -473,6 +584,9 @@ module Processing
     #
     # @return [Numeric] the angle in radians
     #
+    # @see https://processing.org/reference/PVector_heading_.html
+    # @see https://p5js.org/reference/#/p5.Vector/heading
+    #
     def heading()
       Math.atan2 y, x
     end
@@ -484,6 +598,9 @@ module Processing
     #
     # @return [Vector] rotated vector
     #
+    # @see https://processing.org/reference/PVector_fromAngle_.html
+    # @see https://p5js.org/reference/#/p5.Vector/fromAngle
+    #
     def self.fromAngle(angle, target = nil)
       v = self.new(1, 0, 0).rotate(angle)
       target.set v if target
@@ -497,6 +614,9 @@ module Processing
     #
     # @return [Numeric] angle in radians
     #
+    # @see https://processing.org/reference/PVector_angleBetween_.html
+    # @see https://p5js.org/reference/#/p5.Vector/angleBetween
+    #
     def self.angleBetween(v1, v2)
       x1, y1, z1 = v1.array
       x2, y2, z2 = v2.array
@@ -514,6 +634,9 @@ module Processing
     #
     # @return [Vector] a random vector
     #
+    # @see https://processing.org/reference/PVector_random2D_.html
+    # @see https://p5js.org/reference/#/p5.Vector/random2D
+    #
     def self.random2D(target = nil)
       v = self.new(1, 0, 0)
       v.getInternal__.rotate! rand 0.0...360.0
@@ -527,6 +650,9 @@ module Processing
     #
     # @return [Vector] a random vector
     #
+    # @see https://processing.org/reference/PVector_random3D_.html
+    # @see https://p5js.org/reference/#/p5.Vector/random3D
+    #
     def self.random3D(target = nil)
       angle = rand 0.0...(Math::PI * 2)
       z     = rand(-1.0..1.0)

data/lib/processing/window.rb

@@ -212,6 +212,7 @@ module Processing
   end# Window
 
 
+  # @private
   class Window::Canvas
 
     def initialize(window, width, height)
@@ -297,6 +298,7 @@ module Processing
   end# Window::Canvas
 
 
+  # @private
   class Window::CanvasView < Reflex::View
 
     def on_update(e)

data/processing.gemspec

@@ -25,10 +25,10 @@ Gem::Specification.new do |s|
   s.platform              = Gem::Platform::RUBY
   s.required_ruby_version = '>= 3.0.0'
 
-  s.add_runtime_dependency 'xot',       '~> 0.1.42'
-  s.add_runtime_dependency 'rucy',      '~> 0.1.44'
-  s.add_runtime_dependency 'rays',      '~> 0.1.49'
-  s.add_runtime_dependency 'reflexion', '~> 0.1.57'
+  s.add_runtime_dependency 'xot',       '~> 0.2'
+  s.add_runtime_dependency 'rucy',      '~> 0.2'
+  s.add_runtime_dependency 'rays',      '~> 0.2'
+  s.add_runtime_dependency 'reflexion', '~> 0.2'
 
   s.files            = `git ls-files`.split $/
   s.test_files       = s.files.grep %r{^(test|spec|features)/}