processing 0.5.32 → 0.5.34

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f96427cef5e2add31fe4baa3c6055a94bdff9d126d1ae194cd937c24066d4af4
-  data.tar.gz: a4a797bb6246dbb1de3450d6a802ec273553cdf4d5c4b8b2a87e82160f8a22b4
+  metadata.gz: e54026be3e0523b71c57d18c46525a46dd0291fea20c916c9a77d06398735e15
+  data.tar.gz: 7c38db77660d2ddddaba759396e54ea6245b1bca132684292e25d306273e433e
 SHA512:
-  metadata.gz: 8d39fcf7857c9ad1b10597811adcb23b04f96f1f78e128ff089b2cd7cd1fe4b851ba0ff235813f8946853d940383ec82568300d9a9914ce028fc9d3622d58b4a
-  data.tar.gz: 226f9d830533ae9f5836ad447bd84de2bb8939d8a5718d1b43c4f66dc073b776c67c7b5c5ccfa421e9271707a9511568b626a9124b6cfaf65dd61ba95fd88af5
+  metadata.gz: 7d2f9f2a261da953754a3476140069d6493b17d1d476bdc7907e35662ce1f9e7633339995f2613871fa3a0f3053cc1397300d1827382270e0783dad80b5f8640
+  data.tar.gz: 97c6eeff19b69a6874db4f1672bd0d140081fda349ca64850f5c10b7ecf343517e3a87e60bb5b5c5a2b005d89103a8ca1308ce460d55736507c33cb206c9a50f

data/ChangeLog.md

@@ -1,6 +1,54 @@
 # processing ChangeLog
 
 
+## [v0.5.34] - 2024-02-16
+
+- Add '@see' links to documents
+- Fix missing nil returning
+
+
+## [v0.5.33] - 2024-02-07
+
+- Add curveDetail() and bezierDetail()
+- Add curvePoint(), curveTangent(), curveTightness(), bezierPoint(), and bezierTangent()
+- Add textLeading()
+- Add deltaTime
+- Add hue(), saturation(), and brightness()
+- Add noiseSeed() and noiseDetail()
+- Add randomGaussian()
+- Add randomSeed()
+- Add rotateX(), rotateY(), and rotateZ()
+- Add rotateX(), rotateY(), and rotateZ() to Shape class
+- Add shearX() and shearY()
+- Add applyMatrix()
+- Add printMatrix()
+- Add fullscreen() (fullScreen()) function
+- Add smooth() and noSmooth()
+- Add keyIsDown()
+- Add keyIsPressed()
+- Add mouseWheel()
+- Add doubleClicked()
+- Add renderMode()
+
+- Setup view projection matrix by using perspective() instead of ortho()
+- Display window in the center of the screen by default
+- loadImage() uses Net::HTTP.get() instead of URI.open() to retrieve images via http(s)
+- loadImage() writes a file in streaming mode
+- loadImage() raises Net::HTTPClientException instead of OpenURI::HTTPError
+- Reimplement the noise() for better compatibility
+- push/popStyle() manage colorMode, angleMode, blendMode, and miter_limit states
+- size() and createCanvas() resize the window by themselves
+- texture_mode/wrap -> texcoord_mode/wrap
+- updatePixels() can take block
+
+- Fix that textFont() did not return current font
+- Fix that updatePixels() did not update the texture
+- Fix the performance of requestImage() by calling Thread.pass
+- Fix an issue with unintended canvas resizing when the screen pixel density changes
+- Fix some missing attribute copies on the canvas
+- Fix Matrix::to_a order
+
+
 ## [v0.5.32] - 2024-01-08
 
 - Add requestImage()
@@ -22,7 +70,7 @@
 - Add createShape(), shape(), shapeMode()
 - Add beginShape(), endShape(), and vertex(x, y)
 - Test with p5.rb
-- GraphicsContext#rotate() can take z parameter
+- GraphicsContext#scale() can take z parameter
 - Set default miter_limit to 10
 - Trigger github actions on all pull_request
 

data/VERSION

@@ -1 +1 @@
-0.5.32
+0.5.34

data/lib/processing/all.rb

@@ -2,7 +2,8 @@ require 'set'
 require 'digest/sha1'
 require 'pathname'
 require 'tmpdir'
-require 'open-uri'
+require 'net/http'
+require 'uri'
 require 'xot/inspectable'
 require 'reflex'
 
@@ -19,4 +20,5 @@ require 'processing/shader'
 require 'processing/capture'
 require 'processing/graphics_context'
 require 'processing/graphics'
+require 'processing/events'
 require 'processing/context'

data/lib/processing/context.rb

@@ -41,9 +41,10 @@ module Processing
 
       @window__ = window
       init__(
-        @window__.canvas_image,
-        @window__.canvas_painter.paint {background 0.8})
+        @window__.canvas.image,
+        @window__.canvas.painter.paint {background 0.8})
 
+      @smooth__           = true
       @loop__             = true
       @redraw__           = false
       @frameCount__       = 0
@@ -65,7 +66,7 @@ module Processing
 
       # @private
       def @window__.draw_screen(painter)
-        @context__.drawImage__ painter
+        @context__.drawImage__ painter, image__: canvas.render
       end
 
       drawFrame = -> {
@@ -89,8 +90,8 @@ module Processing
         @key__     = event.chars
         @keyCode__ = event.key
         if pressed != nil
-          set, key = @keysPressed__, event.key
-          pressed ? set.add(key) : set.delete(key)
+          set = @keysPressed__
+          pressed ? set.add(@keyCode__) : set.delete(@keyCode__)
         end
       }
 
@@ -143,8 +144,8 @@ module Processing
         updatePointersPressedAndReleased.call e, false
         if e.any? {|p| p.id == @pointer__.id}
           @mouseReleasedBlock__&.call
-          @mouseClickedBlock__&.call if
-            (@pointer__.pos - @pointer__.down.pos).length < 3
+          @mouseClickedBlock__&.call  if e.click_count > 0
+          @doubleClickedBlock__&.call if e.click_count == 2
         end
         @touchEndedBlock__&.call
         @pointersReleased__.clear
@@ -157,6 +158,10 @@ module Processing
         @touchMovedBlock__&.call
       end
 
+      @window__.wheel = proc do |e|
+        @mouseWheelBlock__&.call WheelEvent.new(e)
+      end
+
       @window__.move = proc do |e|
         @windowMovedBlock__&.call
       end
@@ -175,6 +180,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/setup_.html
+    # @see https://p5js.org/reference/#/p5/setup
+    #
     def setup(&block)
       @window__.setup = block if block
       nil
@@ -191,6 +199,8 @@ module Processing
       @mouseMovedBlock__    ||
       @mouseDraggedBlock__  ||
       @mouseClickedBlock__  ||
+      @doubleClickedBlock__ ||
+      @mouseWheelBlock__    ||
       @touchStartedBlock__  ||
       @touchEndedBlock__    ||
       @touchMovedBlock__    ||
@@ -203,6 +213,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/draw_.html
+    # @see https://p5js.org/reference/#/p5/draw
+    #
     def draw(&block)
       @drawBlock__ = block if block
       nil
@@ -212,15 +225,21 @@ module Processing
     #
     # @return [Boolean] is any key pressed or not
     #
+    # @see https://processing.org/reference/keyPressed_.html
+    # @see https://p5js.org/reference/#/p5/keyPressed
+    #
     def keyPressed(&block)
       @keyPressedBlock__ = block if block
-      not @keysPressed__.empty?
+      keyIsPressed
     end
 
     # Defines keyReleased block.
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/keyReleased_.html
+    # @see https://p5js.org/reference/#/p5/keyReleased
+    #
     def keyReleased(&block)
       @keyReleasedBlock__ = block if block
       nil
@@ -230,6 +249,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/keyTyped_.html
+    # @see https://p5js.org/reference/#/p5/keyTyped
+    #
     def keyTyped(&block)
       @keyTypedBlock__ = block if block
       nil
@@ -239,6 +261,10 @@ module Processing
     #
     # @return [Boolean] is any mouse button pressed or not
     #
+    # @see https://processing.org/reference/mousePressed_.html
+    # @see https://processing.org/reference/mousePressed.html
+    # @see https://p5js.org/reference/#/p5/mousePressed
+    #
     def mousePressed(&block)
       @mousePressedBlock__ = block if block
       not @pointersPressed__.empty?
@@ -248,6 +274,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/mouseReleased_.html
+    # @see https://p5js.org/reference/#/p5/mouseReleased
+    #
     def mouseReleased(&block)
       @mouseReleasedBlock__ = block if block
       nil
@@ -257,6 +286,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/mouseMoved_.html
+    # @see https://p5js.org/reference/#/p5/mouseMoved
+    #
     def mouseMoved(&block)
       @mouseMovedBlock__ = block if block
       nil
@@ -266,6 +298,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/mouseDragged_.html
+    # @see https://p5js.org/reference/#/p5/mouseDragged
+    #
     def mouseDragged(&block)
       @mouseDraggedBlock__ = block if block
       nil
@@ -275,15 +310,43 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/mouseClicked_.html
+    # @see https://p5js.org/reference/#/p5/mouseClicked
+    #
     def mouseClicked(&block)
       @mouseClickedBlock__ = block if block
       nil
     end
 
+    # Defines doubleClicked block.
+    #
+    # @return [nil] nil
+    #
+    # @see https://p5js.org/reference/#/p5/doubleClicked
+    #
+    def doubleClicked(&block)
+      @doubleClickedBlock__ = block if block
+      nil
+    end
+
+    # Defines mouseWheel block.
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/mouseWheel_.html
+    # @see https://p5js.org/reference/#/p5/mouseWheel
+    #
+    def mouseWheel(&block)
+      @mouseWheelBlock__ = block if block
+      nil
+    end
+
     # Defines touchStarted block.
     #
     # @return [nil] nil
     #
+    # @see https://p5js.org/reference/#/p5/touchStarted
+    #
     def touchStarted(&block)
       @touchStartedBlock__ = block if block
       nil
@@ -293,6 +356,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://p5js.org/reference/#/p5/touchEnded
+    #
     def touchEnded(&block)
       @touchEndedBlock__ = block if block
       nil
@@ -302,6 +367,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://p5js.org/reference/#/p5/touchMoved
+    #
     def touchMoved(&block)
       @touchMovedBlock__ = block if block
       nil
@@ -311,6 +378,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/windowMoved_.html
+    #
     def windowMoved(&block)
       @windowMovedBlock__ = block if block
       nil
@@ -320,6 +389,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/windowResized_.html
+    # @see https://p5js.org/reference/#/p5/windowResized
+    #
     def windowResized(&block)
       @windowResizedBlock__ = block if block
       nil
@@ -342,8 +414,11 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/size_.html
+    #
     def size(width, height, pixelDensity: self.pixelDensity)
-      resizeCanvas__ :size, width, height, pixelDensity
+      windowResize width, height
+      resizeCanvas__ width, height, pixelDensity
       nil
     end
 
@@ -355,8 +430,11 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://p5js.org/reference/#/p5/createCanvas
+    #
     def createCanvas(width, height, pixelDensity: self.pixelDensity)
-      resizeCanvas__ :createCanvas, width, height, pixelDensity
+      windowResize width, height
+      resizeCanvas__ width, height, pixelDensity
       nil
     end
 
@@ -366,6 +444,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/setTitle_.html
+    #
     def setTitle(title)
       @window__.title = title
       nil
@@ -377,16 +457,59 @@ module Processing
     #
     # @return [Numeric] current pixel density
     #
+    # @see https://processing.org/reference/pixelDensity_.html
+    # @see https://p5js.org/reference/#/p5/pixelDensity
+    #
     def pixelDensity(density = nil)
-      resizeCanvas__ :pixelDensity, width, height, density if density
-      @painter__.pixel_density
+      resizeCanvas__ width, height, density if density
+      @window__.canvas.pixel_density
     end
 
-    # @private
-    def resizeCanvas__(name, width, height, pixelDensity)
-      raise '#{name}() must be called on startup or setup block' if @started__
+    # Toggles full-screen state or returns the current state.
+    #
+    # @param state [Boolean] Whether to display full-screen or not
+    #
+    # @return [Boolean] current state
+    #
+    # @see https://processing.org/reference/fullScreen_.html
+    # @see https://p5js.org/reference/#/p5/fullscreen
+    #
+    def fullscreen(state = nil)
+      @window__.fullscreen = state if state != nil
+      @window__.fullscreen?
+    end
+
+    alias fullScreen fullscreen
+
+    # Enables anti-aliasing.
+    # (Anti-aliasing is disabled on high DPI screen)
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/smooth_.html
+    # @see https://p5js.org/reference/#/p5/smooth
+    #
+    def smooth()
+      @smooth__ = true
+      resizeCanvas__ width, height, pixelDensity
+      nil
+    end
+
+    # Disables anti-aliasing.
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/noSmooth_.html
+    # @see https://p5js.org/reference/#/p5/noSmooth
+    #
+    def noSmooth()
+      @smooth__ = false
+      resizeCanvas__ width, height, pixelDensity
+    end
 
-      @window__.resize_canvas width, height, pixelDensity
+    # @private
+    def resizeCanvas__(width, height, pixelDensity)
+      @window__.resize_canvas width, height, pixelDensity, antialiasing: @smooth__
       @window__.auto_resize = false
     end
 
@@ -394,6 +517,9 @@ module Processing
     #
     # @return [Numeric] width
     #
+    # @see https://processing.org/reference/displayWidth.html
+    # @see https://p5js.org/reference/#/p5/displayWidth
+    #
     def displayWidth()
       @window__.screen.width
     end
@@ -402,6 +528,9 @@ module Processing
     #
     # @return [Numeric] height
     #
+    # @see https://processing.org/reference/displayHeight.html
+    # @see https://p5js.org/reference/#/p5/displayHeight
+    #
     def displayHeight()
       @window__.screen.height
     end
@@ -410,6 +539,9 @@ module Processing
     #
     # @return [Numeric] pixel density
     #
+    # @see https://processing.org/reference/displayDensity_.html
+    # @see https://p5js.org/reference/#/p5/displayDensity
+    #
     def displayDensity()
       @window__.painter.pixel_density
     end
@@ -421,6 +553,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/windowMove_.html
+    #
     def windowMove(x, y)
       @window__.pos = [x, y]
       nil
@@ -433,6 +567,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/windowResize_.html
+    #
     def windowResize(width, height)
       @window__.size = [width, height]
       nil
@@ -444,6 +580,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/windowResizable_.html
+    #
     def windowResizable(resizable)
       @window__.resizable = resizable
       nil
@@ -455,6 +593,7 @@ module Processing
     #
     # @return [nil] nil
     #
+    #
     def windowOrientation(*orientations)
       @window__.orientations = orientations.flatten.uniq
     end
@@ -479,6 +618,8 @@ module Processing
     #
     # @return [Numeric] window width
     #
+    # @see https://p5js.org/reference/#/p5/windowWidth
+    #
     def windowWidth()
       @window__.width
     end
@@ -487,6 +628,8 @@ module Processing
     #
     # @return [Numeric] window height
     #
+    # @see https://p5js.org/reference/#/p5/windowHeight
+    #
     def windowHeight()
       @window__.height
     end
@@ -495,6 +638,9 @@ module Processing
     #
     # @return [Boolean] active or not
     #
+    # @see https://processing.org/reference/focused.html
+    # @see https://p5js.org/reference/#/p5/focused
+    #
     def focused()
       @window__.active?
     end
@@ -503,6 +649,9 @@ module Processing
     #
     # @return [Integer] total number of frames
     #
+    # @see https://processing.org/reference/frameCount.html
+    # @see https://p5js.org/reference/#/p5/frameCount
+    #
     def frameCount()
       @frameCount__
     end
@@ -511,14 +660,30 @@ module Processing
     #
     # @return [Float] frames per second
     #
+    # @see https://processing.org/reference/frameRate.html
+    # @see https://p5js.org/reference/#/p5/frameRate
+    #
     def frameRate()
       @window__.event.fps
     end
 
+    # Returns the elapsed time after previous drawing event
+    #
+    # @return [Float] elapsed time in milliseconds
+    #
+    # @see https://p5js.org/reference/#/p5/deltaTime
+    #
+    def deltaTime()
+      @window__.event.dt * 1000
+    end
+
     # Returns the last key that was pressed or released.
     #
     # @return [String] last key
     #
+    # @see https://processing.org/reference/key.html
+    # @see https://p5js.org/reference/#/p5/key
+    #
     def key()
       @key__
     end
@@ -527,14 +692,42 @@ module Processing
     #
     # @return [Symbol] last key code
     #
+    # @see https://processing.org/reference/keyCode.html
+    # @see https://p5js.org/reference/#/p5/keyCode
+    #
     def keyCode()
       @keyCode__
     end
 
+    # Returns whether or not any key is pressed.
+    #
+    # @return [Boolean] is any key pressed or not
+    #
+    # @see https://p5js.org/reference/#/p5/keyIsPressed
+    #
+    def keyIsPressed()
+      not @keysPressed__.empty?
+    end
+
+    # Returns weather or not the key is currently pressed.
+    #
+    # @param keyCode [Numeric] code for the key
+    #
+    # @return [Boolean] is the key pressed or not
+    #
+    # @see https://p5js.org/reference/#/p5/keyIsDown
+    #
+    def keyIsDown(keyCode)
+      @keysPressed__.include? keyCode
+    end
+
     # Returns mouse x position
     #
     # @return [Numeric] horizontal position of mouse
     #
+    # @see https://processing.org/reference/mouseX.html
+    # @see https://p5js.org/reference/#/p5/mouseX
+    #
     def mouseX()
       @pointer__&.x || 0
     end
@@ -543,6 +736,9 @@ module Processing
     #
     # @return [Numeric] vertical position of mouse
     #
+    # @see https://processing.org/reference/mouseY.html
+    # @see https://p5js.org/reference/#/p5/mouseY
+    #
     def mouseY()
       @pointer__&.y || 0
     end
@@ -551,6 +747,9 @@ module Processing
     #
     # @return [Numeric] horizontal position of mouse
     #
+    # @see https://processing.org/reference/pmouseX.html
+    # @see https://p5js.org/reference/#/p5/pmouseX
+    #
     def pmouseX()
       @pointerPrev__&.x || 0
     end
@@ -559,6 +758,9 @@ module Processing
     #
     # @return [Numeric] vertical position of mouse
     #
+    # @see https://processing.org/reference/pmouseY.html
+    # @see https://p5js.org/reference/#/p5/pmouseY
+    #
     def pmouseY()
       @pointerPrev__&.y || 0
     end
@@ -567,6 +769,9 @@ module Processing
     #
     # @return [Numeric] LEFT, RIGHT, CENTER or 0
     #
+    # @see https://processing.org/reference/mouseButton.html
+    # @see https://p5js.org/reference/#/p5/mouseButton
+    #
     def mouseButton()
       ((@pointersPressed__ + @pointersReleased__) & [LEFT, RIGHT, CENTER]).last
     end
@@ -575,6 +780,8 @@ module Processing
     #
     # @return [Array] Touch objects
     #
+    # @see https://p5js.org/reference/#/p5/touches
+    #
     def touches()
       @touches__
     end
@@ -591,6 +798,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/loop_.html
+    # @see https://p5js.org/reference/#/p5/loop
+    #
     def loop()
       @loop__ = true
     end
@@ -599,6 +809,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/noLoop_.html
+    # @see https://p5js.org/reference/#/p5/noLoop
+    #
     def noLoop()
       @loop__ = false
     end
@@ -607,6 +820,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/redraw_.html
+    # @see https://p5js.org/reference/#/p5/redraw
+    #
     def redraw()
       @redraw__ = true
     end

data/lib/processing/events.rb

@@ -0,0 +1,22 @@
+module Processing
+
+
+  # Mouse wheel event object.
+  #
+  class WheelEvent
+
+    # @private
+    def initialize(event)
+      @event = event
+    end
+
+    def delta()
+      @event.dy
+    end
+
+    alias getCount delta
+
+  end# WheelEvent
+
+
+end# Processing