processing 1.1.18 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb185e6835ce1e5361fcb66b667eb4d328c2af7e32a047bbb54e3397f4ea6973
-  data.tar.gz: 4988d984b6c9ef039902d812ff2af813a967f11e43834cbfc168a980e2cc3179
+  metadata.gz: 854a85bdbae535597d51821ec8a2b8cc0c948ad355a889bfdd714dbcf2f2ee38
+  data.tar.gz: 5ed6cb2ae766ad26658a85826a660be0fbe92575c1b221a8440a38c722d8ec63
 SHA512:
-  metadata.gz: '09f27de2e255f090068e1e4a9c3d421debbe37758e64e0436859be28a7a0fcf0fbc43c39f9bcafb913847df3a8eb3ddbe0ee0e5ee7cc9f680f6bef6ddb8cfeb0'
-  data.tar.gz: 0b51113d2705579a0f7474aa60d8b73f393afc0f76c30085a87dd9381afa5c98ab69a2062d222550f04b9e06b56ae830898879628e8379323a4bd3ff71e4826d
+  metadata.gz: 49a769fbfd6e72f538b007b6da83dae50b873b2f15f1e4240bb4639f90ec459a56b0b1266a8e262aee994ed06e2f01be8e212c1215cbe815f54f188caefdef01
+  data.tar.gz: d5cd70ca39f8bd953d322efa398a4325863937c9d28338bd29d7f0004b8882c59d0004e49ca9b8468c89920e0980272f5fd8ad764ff754ebeb137f0b81c02169

data/.github/workflows/release-gem.yml

@@ -36,23 +36,9 @@ jobs:
           echo path=$(ruby -e 'print Dir.glob("*.gem").first') >> $GITHUB_OUTPUT
 
       - name: create github release
-        id: release
-        uses: actions/create-release@v1
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          tag_name: ${{ github.ref }}
-          release_name: ${{ github.ref }}
-
-      - name: upload to github release
-        uses: actions/upload-release-asset@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          upload_url: ${{ steps.release.outputs.upload_url }}
-          asset_path: ./${{ steps.gem.outputs.path }}
-          asset_name:   ${{ steps.gem.outputs.path }}
-          asset_content_type: application/zip
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: ruby -I.github/workflows -rutils -e 'release(*ARGV)' ./${{ steps.gem.outputs.path }}
 
       - name: upload to rubygems
         env:

data/ChangeLog.md

@@ -1,6 +1,15 @@
 # processing ChangeLog
 
 
+## [v1.2.0] - 2026-05-17
+
+- [BREAKING] Wheel Y delta now follows top-left origin convention (from reflex)
+
+- Avoid painter.push overhead in image/blend draws
+- Rewrite README.md
+- CI: Migrate release-gem.yml from actions/create-release to gh release create
+
+
 ## [v1.1.18] - 2026-05-10
 
 - Support WebAssembly

data/README.md

@@ -1,4 +1,4 @@
-# Processing for CRuby - Processing compatible Creative Coding Framework
+# Processing for CRuby - A Processing-compatible creative coding framework
 
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/xord/processing)
 ![License](https://img.shields.io/github/license/xord/processing)
@@ -21,18 +21,28 @@ Thanks for your support! 🙌
 
 ## 🚀 About
 
-**Processing for CRuby** is a creative coding framework compatible with the Processing language, designed specifically for CRuby.
+**Processing for CRuby** is an independent, OpenGL-based Ruby implementation of the [Processing](https://processing.org/) API. It is **not** affiliated with the original Processing project, and it is not the JRuby / JOGL-based [`ruby-processing`](https://github.com/jashkenas/ruby-processing) either — this gem runs on CRuby (MRI), and all rendering goes through the `xord/*` family's own OpenGL 2D drawing engine ([Rays](https://github.com/xord/rays), via [Reflex](https://github.com/xord/reflex)).
 
-It allows artists and developers to create visual art and interactive graphics using the familiar Processing syntax and concepts, leveraging the power and flexibility of Ruby.
+Write a `setup do ... end` and a `draw do ... end` at the top of a Ruby file, run it, and a window appears — just like a `.pde` sketch. This gem is the thin, pure-Ruby layer that maps Processing's vocabulary onto the underlying engine (windowing, drawing, input, MIDI, camera, physics).
+
+> Looking for the same API on mobile / with a game-engine flavor? See [RubySketch](https://github.com/xord/rubysketch).
+
+## 📋 Requirements
+
+- Ruby **3.0.0** or later
+- All the runtime requirements of [Reflex](https://github.com/xord/reflex) (which in turn brings Rays, Rucy, Xot, plus the platform GUI backend — AppKit / UIKit / Win32 / SDL2 — and OpenGL)
+- The dependent gems are installed automatically: `rexml`, `xot`, `rucy`, `rays`, `reflexion`
+
+There is no native C/C++ extension in this gem; the heavy lifting is done by the dependencies' extensions.
 
 ## 📦 Installation
 
 Add this line to your Gemfile:
 ```ruby
-$ gem 'processing'
+gem 'processing'
 ```
 
-Then, install gem:
+Then install:
 ```bash
 $ bundle install
 ```
@@ -42,7 +52,178 @@ Or install it directly:
 $ gem install processing
 ```
 
+## 📚 What's Provided
+
+`require 'processing'` exposes a `Processing` module that, when activated, makes the Processing API available as top-level methods inside the current file. There are two ways to activate it.
+
+### Two ways to use the gem
+
+| Style                          | How                                                                                       |
+| ------------------------------ | ----------------------------------------------------------------------------------------- |
+| **Refinement, camelCase**      | `require 'processing'` + `using Processing` — the standard, Processing-compatible style   |
+| **Refinement, snake_case too** | `require 'processing'` + `using Processing(snake_case: true)` — adds Ruby-idiomatic aliases (`color_mode`, `ellipse_mode`, ...) alongside the camelCase originals |
+
+In both cases, the framework opens a window for you and runs the sketch automatically when the file exits. You do not need an explicit `start` call.
+
+### Core API
+
+| Area              | Examples                                                                                            |
+| ----------------- | --------------------------------------------------------------------------------------------------- |
+| Sketch lifecycle  | `setup`, `draw`, `windowResized`, `windowMoved`                                                     |
+| State             | `size`, `frameRate`, `frameCount`, `width`, `height`, `pixelDensity`, `noLoop` / `loop_` / `redraw` |
+| Color & state     | `background`, `fill`, `stroke`, `noFill`, `noStroke`, `strokeWeight`, `colorMode`, `blendMode`      |
+| Shapes            | `point`, `line`, `rect`, `square`, `triangle`, `quad`, `ellipse`, `circle`, `arc`, `curve`, `bezier`, `beginShape` / `endShape` / `vertex` |
+| Transforms        | `push` / `pop`, `pushMatrix` / `popMatrix`, `translate`, `rotate`, `scale`, `shearX`, `shearY`      |
+| Text              | `text`, `textSize`, `textFont`, `textAlign`, `textWidth`, `loadFont`                                |
+| Images            | `image`, `loadImage` (file path *or* URL), `createImage`, `tint`, `noTint`                          |
+| Vectors & math    | `PVector`, `createVector`, `random`, `noise`, `map`, `lerp`, `dist`, `radians`, `degrees`           |
+| Input             | `mousePressed`, `mouseReleased`, `mouseMoved`, `mouseDragged`, `mouseClicked`, `doubleClicked`, `mouseWheel`, `keyPressed`, `keyReleased`, `keyTyped`, `touchStarted` / `touchEnded` / `touchMoved`, `motion` |
+| Live state        | `mouseX`, `mouseY`, `pmouseX`, `pmouseY`, `key`, `keyCode`, `touches`                               |
+| Off-screen buffer | `createGraphics` → a `Graphics` object that shares the same drawing API                             |
+| Shapes / SVG      | `createShape`, `loadShape` (SVG)                                                                    |
+| Shaders           | `loadShader`, `shader`, `resetShader` — GLSL shaders go straight to the OpenGL pipeline             |
+| Camera            | `createCapture` — live camera capture via `Rays::Camera`                                            |
+
+### Top-level constants
+
+The familiar Processing constants are defined: `RGB`, `HSB`, `RADIANS`, `DEGREES`, `CORNER`, `CORNERS`, `CENTER`, `RADIUS`, `LEFT`, `RIGHT`, `TOP`, `BOTTOM`, `BASELINE`, `BLEND`, `ADD`, `MULTIPLY`, `SCREEN`, ...
+
+### Internal API convention
+
+Methods ending in `__` (e.g. `init__`, `beginDraw__`, `@context__`) are framework internals and are deliberately excluded from the refinement-exposed top-level method set, so they will not collide with names in your sketch.
+
+## 💡 Usage
+
+### Hello, world
+
+```ruby
+require 'processing'
+using Processing
+
+draw do
+  background 0, 10           # alpha trail
+  textSize 50
+  text 'hello, world!', mouseX, mouseY
+end
+```
+
+Save as `hello.rb`, then `ruby hello.rb`. A 500 × 500 window opens automatically.
+
+### `setup` and `draw`
+
+```ruby
+require 'processing'
+using Processing
+
+setup do
+  size 600, 400
+  colorMode RGB, 1
+  angleMode DEGREES
+end
+
+draw do
+  background 0
+  fill 1, 0.4, 0.1
+  stroke 1
+  strokeWeight 2
+
+  rectMode CENTER
+  push
+    translate width / 2, height / 2
+    rotate frameCount      # one degree per frame
+    rect 0, 0, 200, 120, 12
+  pop
+end
+```
+
+### Loading an image from a URL
+
+```ruby
+require 'processing'
+using Processing
+
+icon = loadImage 'https://xord.org/rubysketch/images/rubysketch128.png'
+
+draw do
+  background 0, 10
+  image icon, mouseX, mouseY, icon.width / 10, icon.height / 10
+end
+```
+
+### Mouse and keyboard input
+
+```ruby
+require 'processing'
+using Processing
+
+setup { background 0 }
+
+draw do
+  fill 1
+  ellipse mouseX, mouseY, 20, 20
+end
+
+mousePressed { background 0 }
+keyPressed   { puts "pressed: #{key.inspect} (#{keyCode})" }
+```
+
+### Snake_case aliases
+
+```ruby
+require 'processing'
+using Processing(snake_case: true)
+
+draw do
+  background 0
+  fill 1
+  stroke_weight 4              # alias of strokeWeight
+  no_fill                      # alias of noFill
+  ellipse mouse_x, mouse_y, 50, 50
+end
+```
+
+### Off-screen rendering with `createGraphics`
+
+```ruby
+require 'processing'
+using Processing
+
+g = nil
+
+setup do
+  size 400, 400
+  g = createGraphics 200, 200
+  g.beginDraw
+  g.background 0, 100, 200
+  g.fill 255
+  g.ellipse 100, 100, 120, 120
+  g.endDraw
+end
+
+draw do
+  background 0
+  image g, mouseX - 100, mouseY - 100
+end
+```
+
+More examples live in [`examples/`](./examples) — `breakout.rb`, `camera.rb`, `clock.rb`, `delay_camera.rb`, `filter.rb`, `image.rb`, `shake.rb`, `shapes.rb`.
+
+## 🛠️ Development
+
+```bash
+$ rake test         # run the test suite (drawing tests run headless by default)
+$ rake test:draw    # run drawing tests only
+$ rake doc          # generate YARD docs
+$ rake              # default tasks
+```
+
+Visual regression tests can be enabled with `TEST_WITH_BROWSER=1` — the suite then drives [Ferrum](https://github.com/rubycdp/ferrum) to capture browser-rendered screenshots and compare them against the gem's output.
+
+In the [`xord/all`](https://github.com/xord/all) monorepo you can scope by module, e.g. `rake processing test`.
+
 ## 📜 License
 
 **Processing for CRuby** is licensed under the MIT License.
 See the [LICENSE](./LICENSE) file for details.
+
+This project is not affiliated with [Processing.org](https://processing.org/); it is an independent reimplementation of their API.

data/VERSION

@@ -1 +1 @@
-1.1.18
+1.2.0

data/lib/processing/capture.rb

@@ -108,11 +108,15 @@ module Processing
     end
 
     # @private
-    def drawImage__(painter, *args, **states)
-      shader = painter.shader || @filter&.getInternal__
-      painter.push shader: shader, **states do |_|
-        painter.image getInternal__, *args
+    def drawImage__(painter, *args)
+      if @filter
+        shader         = painter.shader
+        painter.shader = @filter.getInternal__
       end
+      painter.image getInternal__, *args
+      nil
+    ensure
+      painter.shader   = shader if @filter
     end
 
   end# Capture

data/lib/processing/graphics_context.rb

@@ -1835,8 +1835,14 @@ module Processing
     def image(img, a, b, c = nil, d = nil)
       assertDrawing__
       x, y, w, h = toXYWH__ @imageMode__, a, b, c || img.width, d || img.height
-      img.drawImage__ @painter__, x, y, w, h, fill: getTint__, stroke: :none
-      nil
+      fill       = @painter__.fill
+      begin
+        @painter__.fill = getTint__
+        img.drawImage__ @painter__, x, y, w, h
+        nil
+      ensure
+        @painter__.fill = fill
+      end
     end
 
     alias drawImage image
@@ -2074,9 +2080,17 @@ module Processing
     #
     def blend(img = nil, sx, sy, sw, sh, dx, dy, dw, dh, mode)
       assertDrawing__
-      (img || self).drawImage__(
-        @painter__, sx, sy, sw, sh, dx, dy, dw, dh,
-        fill: getTint__, stroke: :none, blend_mode: mode)
+      fill       = @painter__.fill
+      blend_mode = @painter__.blend_mode
+      begin
+        @painter__.fill       = getTint__
+        @painter__.blend_mode = mode
+        (img || self).drawImage__(@painter__, sx, sy, sw, sh, dx, dy, dw, dh)
+        nil
+      ensure
+        @painter__.fill       = fill
+        @painter__.blend_mode = blend_mode
+      end
     end
 
     # Loads all pixels to the 'pixels' array.
@@ -2535,11 +2549,15 @@ module Processing
     end
 
     # @private
-    def drawImage__(painter, *args, image__: getInternal__, **states)
-      shader = painter.shader || @filter__&.getInternal__
-      painter.push shader: shader, **states do |_|
-        painter.image image__, *args
+    def drawImage__(painter, *args, image__: getInternal__)
+      if @filter__
+        shader         = painter.shader
+        painter.shader = @filter__.getInternal__
       end
+      painter.image image__, *args
+      nil
+    ensure
+      painter.shader   = shader if @filter__
     end
 
     # @private

data/lib/processing/image.rb

@@ -200,7 +200,13 @@ module Processing
     def blend(img = nil, sx, sy, sw, sh, dx, dy, dw, dh, mode)
       img ||= self
       getInternal__.paint do |painter|
-        img.drawImage__ painter, sx, sy, sw, sh, dx, dy, dw, dh, blend_mode: mode
+        blend_mode = painter.blend_mode
+        begin
+          painter.blend_mode = mode
+          img.drawImage__ painter, sx, sy, sw, sh, dx, dy, dw, dh
+        ensure
+          painter.blend_mode = blend_mode
+        end
       end
       nil
     end
@@ -270,11 +276,15 @@ module Processing
     end
 
     # @private
-    def drawImage__(painter, *args, **states)
-      shader = painter.shader || @filter&.getInternal__
-      painter.push shader: shader, **states do |_|
-        painter.image getInternal__, *args
+    def drawImage__(painter, *args)
+      if @filter
+        shader         = painter.shader
+        painter.shader = @filter.getInternal__
       end
+      painter.image getInternal__, *args
+      nil
+    ensure
+      painter.shader   = shader if @filter
     end
 
     # @private

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.12'
-  s.add_dependency 'rucy',      '~> 0.3.12'
-  s.add_dependency 'rays',      '~> 0.3.12'
-  s.add_dependency 'reflexion', '~> 0.3.15'
+  s.add_dependency 'xot',       '~> 0.3.13'
+  s.add_dependency 'rucy',      '~> 0.3.13'
+  s.add_dependency 'rays',      '~> 0.3.13'
+  s.add_dependency 'reflexion', '~> 0.4.0'
 
   s.files            = `git ls-files`.split $/
   s.test_files       = s.files.grep %r{^(test|spec|features)/}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: processing
 version: !ruby/object:Gem::Version
-  version: 1.1.18
+  version: 1.2.0
 platform: ruby
 authors:
 - xordog
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-09 00:00:00.000000000 Z
+date: 2026-05-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rexml
@@ -30,56 +30,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.12
+        version: 0.3.13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.12
+        version: 0.3.13
 - !ruby/object:Gem::Dependency
   name: rucy
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.12
+        version: 0.3.13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.12
+        version: 0.3.13
 - !ruby/object:Gem::Dependency
   name: rays
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.12
+        version: 0.3.13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.12
+        version: 0.3.13
 - !ruby/object:Gem::Dependency
   name: reflexion
   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
 description: Creative Coding Framework has API compatible to Processing or p5.js.
 email: xordog@gmail.com
 executables: []