processing 1.1.13 → 1.1.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 520edd002c7033054088f9ae142fe1b4ed325604a20ba382a6fc2619c4346234
-  data.tar.gz: c82348b712cd16403d7554a06c56b484ad594435f1f471c8520bef9f11529dc1
+  metadata.gz: e9356a7a72f0d28756fb6b5d16e2af279391fdcfe0ec23340fcf12b5deaadc2a
+  data.tar.gz: 5faa1b56b3ac103100d1fdb2739051de3a8118dc5e1235ceee68f0ad28667793
 SHA512:
-  metadata.gz: 4757f375457a2366d32cf127669c7e61d06ae15b0a326ed1210cf1165604a84851a83f47042be5d0dbe3f674213de54199b5bcfc1812ac825bf2ab6708aa8ddd
-  data.tar.gz: b54ab5f3c6f58a65d32e8f21e13fbbe5b009f66f77a0c60806a8f5c2115b4b26a9d65a8242856e2f4be01f4509f6fe38e08787a34b27fa4fcf7001f458a60115
+  metadata.gz: be329673b2a28ab0535bbc2be7ba14f9b6d326bb64598d31afb345317129d7a74f8a669941c2c47a70276fcde61977fc617f6286a0e518b94a147a9ccaeb8121
+  data.tar.gz: 2d0609561fafd770c8c2c9b8e050776cc767b8220e14ef462118213fa680b3f2e662d2cbd413eef4a7285286e12d6398143a56eca964cf8bc5a9172b2d4bc393

data/CLAUDE.md

@@ -0,0 +1,22 @@
+# Processing
+
+Processing/p5.js-compatible creative coding framework for Ruby.
+
+## Dual API
+
+- Default: Processing-compatible camelCase (`colorMode`, `ellipseMode`)
+- Optional: `Processing(snake_case: true)` enables snake_case aliases
+
+## Naming Convention
+
+- Internal methods use `__` suffix (e.g., `init__`, `beginDraw__`, `@context__`)
+- Methods matching `/__[!?]?$/` are excluded from the public API
+
+## Visual Regression Testing
+
+Set `TEST_WITH_BROWSER=1` to enable browser-based drawing tests via Ferrum.
+`assert_p5_draw` performs screenshot comparison.
+
+## GraphicsContext
+
+Drawing logic is concentrated in the `GraphicsContext` module, mixed into both `Context` (top-level) and `Graphics` (offscreen buffer).

data/ChangeLog.md

@@ -1,6 +1,24 @@
 # processing ChangeLog
 
 
+## [v1.1.15] - 2026-04-10
+
+- Update dependencies
+
+
+## [v1.1.14] - 2026-04-09
+
+- Add Graphics#size
+- Add Graphics#initialize_copy
+- Add the 'smooth' param to createFont() and loadFont()
+- loadFont() can take size parameter
+- WheelEvent#delta returns dy and dx
+- Image#resize does nothing when called with the same width and height
+- Text is now vertically centered based on ascent rather than total height
+- Handle key and midi events in focused canvas view
+- Update dependencies
+
+
 ## [v1.1.13] - 2025-07-06
 
 - Add method docs for background(), fill(), stroke(), point(), line(), rect(), ellipse(), circle(), image(), translate(), scale(), and rotate()

data/Gemfile.lock

@@ -12,7 +12,7 @@ GEM
     power_assert (2.0.3)
     public_suffix (5.0.3)
     rake (13.1.0)
-    rexml (3.4.1)
+    rexml (3.4.4)
     test-unit (3.6.1)
       power_assert
     webrick (1.7.0)

data/VERSION

@@ -1 +1 @@
-1.1.13
+1.1.15

data/lib/processing/all.rb

@@ -22,6 +22,8 @@ module Processing
     windowMoved windowResized motion
   ]
 
+  SUFFIX_PRIVATE = /__[!?]?$/
+
   # @private
   def self.setup__(namespace)
     w = (ENV['WIDTH']  || 500).to_i
@@ -36,7 +38,7 @@ module Processing
   # @private
   def self.funcs__(context)
     (context.methods - Object.instance_methods)
-      .reject {_1 =~ /__$/} # methods for internal use
+      .reject {_1 =~ SUFFIX_PRIVATE} # methods for internal use
   end
 
   # @private
@@ -47,7 +49,7 @@ module Processing
   # @private
   def self.alias_snake_case_methods__(klass, recursive = 1)
     to_snake_case__(klass.instance_methods false)
-      .reject {|camel, snake| camel =~ /__$/}
+      .reject {|camel, snake| camel =~ SUFFIX_PRIVATE}
       .reject {|camel, snake| klass.method_defined? snake}
       .each   {|camel, snake| klass.alias_method snake, camel}
     if recursive > 0

data/lib/processing/events.rb

@@ -11,10 +11,12 @@ module Processing
     end
 
     def delta()
-      @event.dy
+      [@event.dx, @event.dy]
     end
 
-    alias getCount delta
+    def getCount()
+      @event.dy
+    end
 
   end# WheelEvent
 

data/lib/processing/font.rb

@@ -64,8 +64,8 @@ module Processing
     # @private
     def setSize__(size)
       return if size == @font.size
-      @cachedSizes[@font.size] = @font
-      @font = getInternal__ size
+      @cachedSizes[@font.size.to_f] = @font
+      @font                         = getInternal__ size
     end
 
   end# Font

data/lib/processing/graphics.rb

@@ -21,6 +21,28 @@ module Processing
       init__ image, image.painter
     end
 
+    def initialize_copy(o)
+      super
+      raise 'cannot duplicate during drawing' if @drawing__
+      raise 'cannot duplicate because each stack is not empty' unless
+        @matrixStack__.empty? && @styleStack__.empty?
+
+      image = getInternal__.dup
+      updateCanvas__ image, image.painter
+      restoreStyles__ o.styles__
+    end
+
+    alias w width
+    alias h height
+
+    # Returns the width and height of graphics.
+    #
+    # @return [Array<Numeric>] [width, height]
+    #
+    def size()
+      [width, height]
+    end
+
     # Start drawing.
     #
     # @see https://processing.org/reference/PGraphics_beginDraw_.html

data/lib/processing/graphics_context.rb

@@ -1786,21 +1786,23 @@ module Processing
     #
     def text(str, x, y, x2 = nil, y2 = nil)
       assertDrawing__
+      font = @painter__.font
       if x2
         raise ArgumentError, "missing y2 parameter" unless y2
         x, y, w, h = toXYWH__ @rectMode__, x, y, x2, y2
         case @textAlignH__
-        when RIGHT  then x +=  w - @painter__.font.width(str)
-        when CENTER then x += (w - @painter__.font.width(str)) / 2
+        when RIGHT  then x +=  w - font.width(str)
+        when CENTER then x += (w - font.width(str)) / 2.0
         end
         case @textAlignV__
-        when BOTTOM then y +=  h - @painter__.font.height
-        when CENTER then y += (h - @painter__.font.height) / 2
+        when BOTTOM then y +=  h - font.ascent
+        when CENTER then y += (h - font.ascent) / 2.0
         else
         end
       else
-        y -= @painter__.font.ascent
+        y -= font.ascent
       end
+      x, y = x.round, y.round unless font.smooth
       @painter__.text str, x, y
       nil
     end
@@ -2397,7 +2399,28 @@ module Processing
     #
     def pushStyle(&block)
       assertDrawing__
-      @styleStack__.push [
+      @styleStack__.push styles__
+      block.call if block
+    ensure
+      popStyle if block
+    end
+
+    # Restore style values from the style stack.
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/popStyle_.html
+    #
+    def popStyle()
+      assertDrawing__
+      raise "style stack underflow" if @styleStack__.empty?
+      restoreStyles__ @styleStack__.pop
+      nil
+    end
+
+    # @private
+    def styles__()
+      [
         @painter__.fill,
         @painter__.stroke,
         @painter__.stroke_width,
@@ -2433,20 +2456,10 @@ module Processing
         @textFont__,
         @tint__,
       ]
-      block.call if block
-    ensure
-      popStyle if block
     end
 
-    # Restore style values from the style stack.
-    #
-    # @return [nil] nil
-    #
-    # @see https://processing.org/reference/popStyle_.html
-    #
-    def popStyle()
-      assertDrawing__
-      raise "style stack underflow" if @styleStack__.empty?
+    # @private
+    def restoreStyles__(styles)
       @painter__.fill,
       @painter__.stroke,
       @painter__.stroke_width,
@@ -2480,9 +2493,8 @@ module Processing
       @textAlignH__,
       @textAlignV__,
       @textFont__,
-      @tint__ = @styleStack__.pop
+      @tint__ = styles
       @textFont__.setSize__ @painter__.font.size
-      nil
     end
 
     # Save current styles and transformations to stack.
@@ -3186,16 +3198,18 @@ module Processing
 
     # Creates a new font object.
     #
-    # @param name [String]  font name
-    # @param size [Numeric] font size (max 256)
+    # @param name   [String]  font name
+    # @param size   [Numeric] font size (max 256)
+    # @param smooth [Boolean] anti-aliased or pixel-perfect
     #
     # @return [Font] new font
     #
     # @see https://processing.org/reference/createFont_.html
     #
-    def createFont(name, size)
-      size = FONT_SIZE_MAX__ if size && size > FONT_SIZE_MAX__
-      Font.new Rays::Font.new(name, size || FONT_SIZE_DEFAULT__)
+    def createFont(name, size, smooth: true)
+      size ||= FONT_SIZE_DEFAULT__
+      size   = FONT_SIZE_MAX__ if size > FONT_SIZE_MAX__
+      Font.new Rays::Font.new(name, size, smooth)
     end
 
     # Creates a new image object.
@@ -3348,19 +3362,23 @@ module Processing
 
     # Loads font from file.
     #
-    # @param filename  [String] file name to load font file
+    # @param filename [String]  file name to load font file
+    # @param smooth   [Boolean] anti-aliased or pixel-perfect
     #
     # @return [Font] loaded font object
     #
     # @see https://processing.org/reference/loadFont_.html
     # @see https://p5js.org/reference/p5/loadFont/
     #
-    def loadFont(filename)
+    def loadFont(filename, size: nil, smooth: true)
       ext = File.extname filename
       raise "unsupported font type -- '#{ext}'" unless ext =~ /^\.?(ttf|otf)$/i
 
-      filename = httpGet__ filename, ext if filename =~ %r|^https?://|
-      Font.new Rays::Font.load filename
+      filename    = httpGet__ filename, ext if filename =~ %r|^https?://|
+      font        = Rays::Font.load filename
+      font.size   = size if size
+      font.smooth = smooth
+      Font.new font
     end
 
     # Loads image.

data/lib/processing/image.rb

@@ -140,6 +140,7 @@ module Processing
     # @see https://p5js.org/reference/p5.Image/resize/
     #
     def resize(width, height)
+      return nil if width == @image.width && height == @image.height
       @image = Rays::Image.new(width, height).paint do |painter|
         painter.image getInternal__, 0, 0, width, height
       end

data/lib/processing/vector.rb

@@ -325,7 +325,7 @@ module Processing
     # @return [Vector] negated vector
     #
     def -@()
-      dup.mult -1
+      dup.mult(-1)
     end
 
     # Adds 2 vectors.

data/lib/processing/window.rb

@@ -18,7 +18,9 @@ module Processing
       @overlay_view = @canvas_view.add Reflex::View.new name: :overlay
 
       super(*args, size: [width, height], **kwargs, &block)
+
       self.center = screen.center
+      @canvas_view.focus
     end
 
     attr_accessor :setup, :update, :draw, :move, :resize, :motion,
@@ -83,26 +85,6 @@ module Processing
       update_canvas_view
     end
 
-    def on_key_down(e)
-      draw_canvas {call_block @key_down, e} if @key_down
-    end
-
-    def on_key_up(e)
-      draw_canvas {call_block @key_up,   e} if @key_up
-    end
-
-    def on_note_on(e)
-      draw_canvas {call_block @note_on,  e} if @note_on
-    end
-
-    def on_note_off(e)
-      draw_canvas {call_block @note_off, e} if @note_off
-    end
-
-    def on_control_change(e)
-      draw_canvas {call_block @control_change, e} if @control_change
-    end
-
     def on_move(e)
       draw_canvas {call_block @move, e} if @move
     end
@@ -126,6 +108,14 @@ module Processing
       draw_screen e.painter
     end
 
+    def on_canvas_key_down(e)
+      draw_canvas {call_block @key_down, e} if @key_down
+    end
+
+    def on_canvas_key_up(e)
+      draw_canvas {call_block @key_up,   e} if @key_up
+    end
+
     def on_canvas_pointer(e)
       block = case e.action
         when :down        then @pointer_down
@@ -139,6 +129,18 @@ module Processing
       draw_canvas {call_block @wheel, e} if @wheel
     end
 
+    def on_canvas_note_on(e)
+      draw_canvas {call_block @note_on,  e} if @note_on
+    end
+
+    def on_canvas_note_off(e)
+      draw_canvas {call_block @note_off, e} if @note_off
+    end
+
+    def on_canvas_control_change(e)
+      draw_canvas {call_block @control_change, e} if @control_change
+    end
+
     def on_canvas_resize(e)
       resize_canvas e.width, e.height if @auto_resize
       draw_canvas {call_block @resize, e} if @resize
@@ -330,6 +332,14 @@ module Processing
       window.on_canvas_draw e
     end
 
+    def on_key_down(e)
+      window.on_canvas_key_down e
+    end
+
+    def on_key_up(e)
+      window.on_canvas_key_up e
+    end
+
     def on_pointer(e)
       window.on_canvas_pointer e
     end
@@ -338,6 +348,18 @@ module Processing
       window.on_canvas_wheel e
     end
 
+    def on_note_on(e)
+      window.on_canvas_note_on e
+    end
+
+    def on_note_off(e)
+      window.on_canvas_note_off e
+    end
+
+    def on_control_change(e)
+      window.on_canvas_control_change e
+    end
+
     def on_resize(e)
       window.on_canvas_resize e
     end

data/processing.gemspec

@@ -26,10 +26,10 @@ Gem::Specification.new do |s|
   s.required_ruby_version = '>= 3.0.0'
 
   s.add_dependency 'rexml'
-  s.add_dependency 'xot',       '~> 0.3.9', '>= 0.3.9'
-  s.add_dependency 'rucy',      '~> 0.3.9', '>= 0.3.9'
-  s.add_dependency 'rays',      '~> 0.3.9', '>= 0.3.9'
-  s.add_dependency 'reflexion', '~> 0.3.10', '>= 0.3.10'
+  s.add_dependency 'xot',       '~> 0.3.10'
+  s.add_dependency 'rucy',      '~> 0.3.10'
+  s.add_dependency 'rays',      '~> 0.3.10'
+  s.add_dependency 'reflexion', '~> 0.3.12'
 
   s.files            = `git ls-files`.split $/
   s.test_files       = s.files.grep %r{^(test|spec|features)/}

data/test/test_graphics.rb

@@ -3,6 +3,25 @@ require_relative 'helper'
 
 class TestGraphics < Test::Unit::TestCase
 
+  def test_dup()
+    g = graphics 1, 1
+    assert_equal g.color(0, 0, 0, 0),     g.dup.loadPixels[0]
+
+    g.fill 255, 0, 0
+    g.noStroke
+    g.beginDraw {g.rect 0, 0, 1, 1}
+    assert_equal g.color(255, 0, 0, 255), g.dup.loadPixels[0]
+
+    g.fill 0, 255, 0
+    assert_equal(
+      g.color(0, 255, 0, 255),
+      g.dup.tap {|gg| gg.beginDraw {gg.rect 0, 0, 1, 1}}.loadPixels[0])
+  end
+
+  def test_size()
+    assert_equal [1, 2], graphics(1, 2).size
+  end
+
   def test_beginDraw()
     g = graphics
     g.beginDraw
@@ -10,8 +29,7 @@ class TestGraphics < Test::Unit::TestCase
   end
 
   def test_save()
-    g = graphics 100, 100
-    g.beginDraw do
+    g = graphics 100, 100 do |g|
       g.background 200
       g.fill 255
       g.stroke 0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: processing
 version: !ruby/object:Gem::Version
-  version: 1.1.13
+  version: 1.1.15
 platform: ruby
 authors:
 - xordog
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-05 00:00:00.000000000 Z
+date: 2026-04-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rexml
@@ -30,80 +30,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.9
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 0.3.10
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.9
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 0.3.10
 - !ruby/object:Gem::Dependency
   name: rucy
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.9
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 0.3.10
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.9
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 0.3.10
 - !ruby/object:Gem::Dependency
   name: rays
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.9
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 0.3.10
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.9
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 0.3.10
 - !ruby/object:Gem::Dependency
   name: reflexion
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.10
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.10
+        version: 0.3.12
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.10
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.3.10
+        version: 0.3.12
 description: Creative Coding Framework has API compatible to Processing or p5.js.
 email: xordog@gmail.com
 executables: []
@@ -118,6 +94,7 @@ files:
 - ".github/workflows/utils.rb"
 - ".gitignore"
 - ".yardopts"
+- CLAUDE.md
 - CONTRIBUTING.md
 - ChangeLog.md
 - Gemfile