processing 0.5.32 → 0.5.34

data/lib/processing/graphics_context.rb

@@ -25,6 +25,14 @@ module Processing
     #
     TAU        = PI * 2
 
+    # Processing mode for renderMode().
+    #
+    PROCESSING = :processing
+
+    # p5.js mode for renderMode().
+    #
+    P5JS       = :p5js
+
     # RGBA format for createImage().
     #
     RGBA = :rgba
@@ -115,96 +123,127 @@ module Processing
     REPLACE   = :replace
 
     # Key code or Mode for textAlign().
+    #
     LEFT     = :left
 
     # Key code or Mode for textAlign().
+    #
     RIGHT    = :right
 
     # Mode for textAlign().
+    #
     TOP      = :top
 
     # Mode for textAlign().
+    #
     BOTTOM   = :bottom
 
     # Mode for textAlign().
+    #
     BASELINE = :baseline
 
     # Mode for textureMode().
+    #
     IMAGE  = :image
 
     # Mode for textureMode().
+    #
     NORMAL = :normal
 
     # Mode for textureWrap().
+    #
     CLAMP  = :clamp
 
     # Mode for textureWrap().
+    #
     REPEAT = :repeat
 
     # Filter type for filter()
+    #
     THRESHOLD = :threshold
 
     # Filter type for filter()
+    #
     GRAY      = :gray
 
     # Filter type for filter()
+    #
     INVERT    = :invert
 
     # Filter type for filter()
+    #
     BLUR      = :blur
 
     # Shape mode for createShape()
+    #
     LINE     = :line
 
     # Shape mode for createShape()
+    #
     RECT     = :rect
 
     # Shape mode for createShape()
+    #
     ELLIPSE  = :ellipse
 
     # Shape mode for createShape()
+    #
     ARC      = :arc
 
     # Shape mode for createShape()
+    #
     TRIANGLE = :triangle
 
     # Shape mode for createShape()
+    #
     QUAD     = :quad
 
     # Shape mode for createShape()
+    #
     GROUP    = :group
 
     # Shape mode for beginShape()
+    #
     POINTS         = :points
 
     # Shape mode for beginShape()
+    #
     LINES          = :lines
 
     # Shape mode for beginShape()
+    #
     TRIANGLES      = :triangles
 
     # Shape mode for beginShape()
+    #
     TRIANGLE_FAN   = :triangle_fan
 
     # Shape mode for beginShape()
+    #
     TRIANGLE_STRIP = :triangle_strip
 
     # Shape mode for beginShape()
+    #
     QUADS          = :quads
 
     # Shape mode for beginShape()
+    #
     QUAD_STRIP     = :quad_strip
 
     # Shape mode for beginShape()
+    #
     TESS           = :tess
 
     # OPEN flag for endShape()
+    #
     OPEN           = :open
 
     # CLOSE flag for endShape()
+    #
     CLOSE          = :close
 
     # Key codes.
+    #
     ENTER     = :enter
     SPACE     = :space
     TAB       = :tab
@@ -267,28 +306,42 @@ module Processing
 
     # @private
     def init__(image, painter)
-      @drawing__     = false
-      @colorMode__   = nil
-      @hsbColor__    = false
-      @colorMaxes__  = [1.0] * 4
-      @angleMode__   = nil
-      @angleScale__  = 1.0
-      @rectMode__    = nil
-      @ellipseMode__ = nil
-      @imageMode__   = nil
-      @shapeMode__   = nil
-      @blendMode__   = nil
-      @textAlignH__  = nil
-      @textAlignV__  = nil
-      @textFont__    = nil
-      @tint__        = nil
-      @filter__      = nil
-      @pixels__      = nil
-      @matrixStack__ = []
-      @styleStack__  = []
+      @drawing__        = false
+      @renderMode__     = nil
+      @p5jsMode__       = false
+      @colorMode__      = nil
+      @hsbColor__       = false
+      @colorMaxes__     = [1.0] * 4
+      @angleMode__      = nil
+      @toRad__          = 1.0
+      @toDeg__          = 1.0
+      @fromRad__        = 1.0
+      @fromDeg__        = 1.0
+      @rectMode__       = nil
+      @ellipseMode__    = nil
+      @imageMode__      = nil
+      @shapeMode__      = nil
+      @blendMode__      = nil
+      @curveDetail__    = nil
+      @curveTightness__ = nil
+      @bezierDetail__   = nil
+      @textAlignH__     = nil
+      @textAlignV__     = nil
+      @textFont__       = nil
+      @tint__           = nil
+      @filter__         = nil
+      @pixels__         = nil
+      @random__         = nil
+      @nextGaussian__   = nil
+      @noiseSeed__      = nil
+      @noiseOctaves__   = nil
+      @noiseFallOff__   = nil
+      @matrixStack__    = []
+      @styleStack__     = []
 
       updateCanvas__ image, painter
 
+      renderMode  PROCESSING
       colorMode   RGB, 255
       angleMode   RADIANS
       rectMode    CORNER
@@ -303,10 +356,16 @@ module Processing
       textureMode IMAGE
       textureWrap CLAMP
 
-      fill 255
-      stroke 0
-      strokeWeight 1
+      fill           255
+      stroke         0
+      strokeWeight   1
       noTint
+      curveDetail    20
+      curveTightness 0
+      bezierDetail   20
+      randomSeed     Random.new_seed
+      noiseSeed      Random.new_seed
+      noiseDetail    4, 0.5
     end
 
     # @private
@@ -322,6 +381,26 @@ module Processing
       @matrixStack__.clear
       @styleStack__.clear
       @drawing__ = true
+      setupMatrix__
+    end
+
+    # @private
+    def setupMatrix__()
+      w, h = width.to_f, height.to_f
+      x, y = w / 2.0, h / 2.0
+
+      fov, z = nil
+      if @p5jsMode__
+        z   = 800
+        fov = degrees Math.atan(y / z) * 2.0
+      else
+        fov = 60
+        z   = y / Math.tan(radians(fov) / 2.0)
+      end
+
+      @painter__.matrix =
+        Rays::Matrix.perspective(fov, w / h, z / 10.0, z * 10.0) *
+        Rays::Matrix.look_at(x, y, z, x, y, 0)
     end
 
     # @private
@@ -334,6 +413,9 @@ module Processing
     #
     # @return [Numeric] width
     #
+    # @see https://processing.org/reference/width.html
+    # @see https://p5js.org/reference/#/p5/width
+    #
     def width()
       getInternal__.width
     end
@@ -342,6 +424,9 @@ module Processing
     #
     # @return [Numeric] height
     #
+    # @see https://processing.org/reference/height.html
+    # @see https://p5js.org/reference/#/p5/height
+    #
     def height()
       getInternal__.height
     end
@@ -350,6 +435,8 @@ module Processing
     #
     # @return [Numeric] width
     #
+    # @see https://processing.org/reference/pixelWidth.html
+    #
     def pixelWidth()
       width * pixelDensity
     end
@@ -358,6 +445,8 @@ module Processing
     #
     # @return [Numeric] height
     #
+    # @see https://processing.org/reference/pixelHeight.html
+    #
     def pixelHeight()
       height * pixelDensity
     end
@@ -366,10 +455,27 @@ module Processing
     #
     # @return [Numeric] pixel density
     #
+    # @see https://processing.org/reference/pixelDensity_.html
+    # @see https://p5js.org/reference/#/p5/pixelDensity
+    #
     def pixelDensity()
       @painter__.pixel_density
     end
 
+    # Sets render mode.
+    #
+    # @param mode [PROCESSING, P5JS] compatible to Processing or p5.js
+    #
+    # @return [PROCESSING, P5JS] current mode
+    #
+    def renderMode(mode = nil)
+      if mode
+        @renderMode__ = mode
+        @p5jsMode__   = mode == P5JS
+      end
+      @renderMode__
+    end
+
     # Sets color mode and max color values.
     #
     # @overload colorMode(mode)
@@ -386,6 +492,9 @@ module Processing
     #
     # @return [RGB, HSB] current mode
     #
+    # @see https://processing.org/reference/colorMode_.html
+    # @see https://p5js.org/reference/#/p5/colorMode
+    #
     def colorMode(mode = nil, *maxes)
       if mode != nil
         mode = mode.downcase.to_sym
@@ -417,6 +526,9 @@ module Processing
     #
     # @return [Integer] the rgba color value
     #
+    # @see https://processing.org/reference/color_.html
+    # @see https://p5js.org/reference/#/p5/color
+    #
     def color(*args)
       toRGBA__(*args)
         .map {|n| (n * 255).to_i.clamp 0, 255}
@@ -429,6 +541,9 @@ module Processing
     #
     # @return [Numeric] the red value
     #
+    # @see https://processing.org/reference/red_.html
+    # @see https://p5js.org/reference/#/p5/red
+    #
     def red(color)
       ((color >> 16) & 0xff) / 255.0 * @colorMaxes__[0]
     end
@@ -439,6 +554,9 @@ module Processing
     #
     # @return [Numeric] the green value
     #
+    # @see https://processing.org/reference/green_.html
+    # @see https://p5js.org/reference/#/p5/green
+    #
     def green(color)
       ((color >> 8) & 0xff) / 255.0 * @colorMaxes__[1]
     end
@@ -449,6 +567,9 @@ module Processing
     #
     # @return [Numeric] the blue value
     #
+    # @see https://processing.org/reference/blue_.html
+    # @see https://p5js.org/reference/#/p5/blue
+    #
     def blue(color)
       (color & 0xff) / 255.0 * @colorMaxes__[2]
     end
@@ -459,19 +580,64 @@ module Processing
     #
     # @return [Numeric] the red value
     #
+    # @see https://processing.org/reference/alpha_.html
+    # @see https://p5js.org/reference/#/p5/alpha
+    #
     def alpha(color)
       ((color >> 24) & 0xff) / 255.0 * @colorMaxes__[3]
     end
 
+    # Returns the hue value of the color.
+    #
+    # @param color [Numeric] color value
+    #
+    # @return [Numeric] the hue value
+    #
+    # @see https://processing.org/reference/hue_.html
+    # @see https://p5js.org/reference/#/p5/hue
+    #
+    def hue(color)
+      h, = toRawColor__(color).to_hsv
+      h * (@hsbColor__ ? @colorMaxes__[0] : 1)
+    end
+
+    # Returns the saturation value of the color.
+    #
+    # @param color [Numeric] color value
+    #
+    # @return [Numeric] the saturation value
+    #
+    # @see https://processing.org/reference/saturation_.html
+    # @see https://p5js.org/reference/#/p5/saturation
+    #
+    def saturation(color)
+      _, s, = toRawColor__(color).to_hsv
+      s * (@hsbColor__ ? @colorMaxes__[1] : 1)
+    end
+
+    # Returns the brightness value of the color.
+    #
+    # @param color [Numeric] color value
+    #
+    # @return [Numeric] the brightness value
+    #
+    # @see https://processing.org/reference/brightness_.html
+    # @see https://p5js.org/reference/#/p5/brightness
+    #
+    def brightness(color)
+      _, _, b = toRawColor__(color).to_hsv
+      b * (@hsbColor__ ? @colorMaxes__[2] : 1)
+    end
+
     # @private
     private def toRGBA__(*args)
       a, b = args
       return parseColor__(a, b || alphaMax__) if a.kind_of?(String)
-      toRaysColor__(*args).to_a
+      rawColor__(*args).to_a
     end
 
     # @private
-    def toRaysColor__(*args)
+    def rawColor__(*args)
       a, b, c, d = args
       rgba = case args.size
         when 1, 2 then [a, a, a, b || alphaMax__]
@@ -496,46 +662,54 @@ module Processing
       @colorMaxes__[3]
     end
 
+    # @private
+    private def toRawColor__(color)
+      Rays::Color.new(
+        ((color >> 16) & 0xff) / 255.0,
+        ((color >> 8)  & 0xff) / 255.0,
+        ( color        & 0xff) / 255.0,
+        ((color >> 24) & 0xff) / 255.0)
+    end
+
     # Sets angle mode.
     #
     # @param mode [RADIANS, DEGREES] RADIANS or DEGREES
     #
     # @return [RADIANS, DEGREES] current mode
     #
+    # @see https://p5js.org/reference/#/p5/angleMode
+    #
     def angleMode(mode = nil)
       if mode != nil
         @angleMode__  = mode
-        @angleScale__ =
+        @toRad__, @toDeg__, @fromRad__, @fromDeg__ =
           case mode.downcase.to_sym
-          when RADIANS then RAD2DEG__
-          when DEGREES then 1.0
+          when RADIANS then [1.0,      RAD2DEG__, 1.0,       DEG2RAD__]
+          when DEGREES then [DEG2RAD__, 1.0,      RAD2DEG__, 1.0]
           else raise ArgumentError, "invalid angle mode: #{mode}"
           end
       end
       @angleMode__
     end
 
+    # @private
+    def toRadians__(angle)
+      angle * @toRad__
+    end
+
     # @private
     def toDegrees__(angle)
-      angle * @angleScale__
+      angle * @toDeg__
     end
 
     # @private
     def fromRadians__(radians)
-      case @angleMode__
-      when RADIANS then radians
-      when DEGREES then radians * RAD2DEG__
-      else raise "invalid angle mode: #{mode}"
-      end
+      radians * @fromRad__
     end
 
     # @private
     def fromDegrees__(degrees)
-      case @angleMode__
-      when RADIANS then degrees * DEG2RAD__
-      when DEGREES then degrees
-      else raise "invalid angle mode: #{mode}"
-      end
+      degrees * @fromDeg__
     end
 
     # Sets rect mode. Default is CORNER.
@@ -549,6 +723,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/rectMode_.html
+    # @see https://p5js.org/reference/#/p5/rectMode
+    #
     def rectMode(mode)
       @rectMode__ = mode
     end
@@ -564,6 +741,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/ellipseMode_.html
+    # @see https://p5js.org/reference/#/p5/ellipseMode
+    #
     def ellipseMode(mode)
       @ellipseMode__ = mode
     end
@@ -578,6 +758,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/imageMode_.html
+    # @see https://p5js.org/reference/#/p5/imageMode
+    #
     def imageMode(mode)
       @imageMode__ = mode
     end
@@ -592,6 +775,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/shapeMode_.html
+    #
     def shapeMode(mode)
       @shapeMode__ = mode
     end
@@ -613,6 +798,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/blendMode_.html
+    # @see https://p5js.org/reference/#/p5/blendMode
+    #
     def blendMode(mode = nil)
       if mode != nil
         @blendMode__          = mode
@@ -639,6 +827,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/fill_.html
+    # @see https://p5js.org/reference/#/p5/fill
+    #
     def fill(*args)
       @painter__.fill(*toRGBA__(*args))
       nil
@@ -653,6 +844,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/noFill_.html
+    # @see https://p5js.org/reference/#/p5/noFill
+    #
     def noFill()
       @painter__.fill nil
       nil
@@ -676,6 +870,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/stroke_.html
+    # @see https://p5js.org/reference/#/p5/stroke
+    #
     def stroke(*args)
       @painter__.stroke(*toRGBA__(*args))
       nil
@@ -685,6 +882,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/noStroke_.html
+    # @see https://p5js.org/reference/#/p5/noStroke
+    #
     def noStroke()
       @painter__.stroke nil
       nil
@@ -696,6 +896,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/strokeWeight_.html
+    # @see https://p5js.org/reference/#/p5/strokeWeight
+    #
     def strokeWeight(weight)
       @painter__.stroke_width weight
       nil
@@ -707,6 +910,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/strokeCap_.html
+    # @see https://p5js.org/reference/#/p5/strokeCap
+    #
     def strokeCap(cap)
       @painter__.stroke_cap cap
       nil
@@ -718,11 +924,60 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/strokeJoin_.html
+    # @see https://p5js.org/reference/#/p5/strokeJoin
+    #
     def strokeJoin(join)
       @painter__.stroke_join join
       nil
     end
 
+    # Sets the resolution at which curves display.
+    # The default value is 20 while the minimum value is 3.
+    #
+    # @param detail [Numeric] resolution of the curves
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/curveDetail_.html
+    # @see https://p5js.org/reference/#/p5/curveDetail
+    #
+    def curveDetail(detail)
+      detail = 3 if detail < 3
+      @curveDetail__ = detail
+      nil
+    end
+
+    # Sets the quality of curve forms.
+    #
+    # @param tightness [Numeric] determines how the curve fits to the vertex points
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/curveTightness_.html
+    # @see https://p5js.org/reference/#/p5/curveTightness
+    #
+    def curveTightness(tightness)
+      @curveTightness__ = tightness
+      nil
+    end
+
+    # Sets the resolution at which Bezier's curve is displayed.
+    # The default value is 20.
+    #
+    # @param detail [Numeric] resolution of the curves
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/bezierDetail_.html
+    # @see https://p5js.org/reference/#/p5/bezierDetail
+    #
+    def bezierDetail(detail)
+      detail = 1 if detail < 1
+      @bezierDetail__ = detail
+      nil
+    end
+
     # Sets fill color for drawing images.
     #
     # @overload tint(rgb)
@@ -741,6 +996,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/tint_.html
+    # @see https://p5js.org/reference/#/p5/tint
+    #
     def tint(*args)
       @tint__ = args
       nil
@@ -750,6 +1008,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/noTint_.html
+    # @see https://p5js.org/reference/#/p5/noTint
+    #
     def noTint()
       @tint__ = nil
     end
@@ -770,6 +1031,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/clip_.html
+    # @see https://p5js.org/reference/#/p5/clip
+    #
     def clip(a, b, c, d)
       x, y, w, h = toXYWH__ @imageMode__, a, b, c, d
       @painter__.clip x, y, w, h
@@ -780,36 +1044,43 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/noClip_.html
+    #
     def noClip()
       @painter__.no_clip
       nil
     end
 
     # Sets text font.
-    #
     # (Passing a font name as the first parameter is deprecated)
     #
+    # @overload textFont()
     # @overload textFont(font)
-    # @overload textFont(name)
+    # @overload textFont(name) [DEPRECATED]
     # @overload textFont(font, size)
-    # @overload textFont(name, size)
+    # @overload textFont(name, size) [DEPRECATED]
     #
     # @param font [Font]    font
     # @param name [String]  font name
     # @param size [Numeric] font size (max 256)
     #
-    # @return [nil] nil
+    # @return [Font] current font
     #
-    def textFont(font, size = nil)
-      size = FONT_SIZE_MAX__ if size && size > FONT_SIZE_MAX__
-      if font.nil? || font.kind_of?(String)
-        font = createFont font, size
-      elsif size
-        font.setSize__ size
+    # @see https://processing.org/reference/textFont_.html
+    # @see https://p5js.org/reference/#/p5/textFont
+    #
+    def textFont(font = nil, size = nil)
+      if font != nil || size != nil
+        size = FONT_SIZE_MAX__ if size && size > FONT_SIZE_MAX__
+        if font.nil? || font.kind_of?(String)
+          font = createFont font, size
+        elsif size
+          font.setSize__ size
+        end
+        @painter__.font = font.getInternal__
+        @textFont__     = font
       end
-      @textFont__     = font
-      @painter__.font = font.getInternal__
-      nil
+      @textFont__
     end
 
     # Sets text size.
@@ -818,27 +1089,91 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/textSize_.html
+    # @see https://p5js.org/reference/#/p5/textSize
+    #
     def textSize(size)
       textFont @textFont__, size
+      nil
     end
 
+    # Returns the width of the text.
+    #
+    # @param str [String] text string
+    #
+    # @return [Numeric] width of the text
+    #
+    # @see https://processing.org/reference/textWidth_.html
+    # @see https://p5js.org/reference/#/p5/textWidth
+    #
     def textWidth(str)
       @painter__.font.width str
     end
 
+    # Returns ascent of the current font at its current size.
+    #
+    # @return [Numeric] ascent
+    #
+    # @see https://processing.org/reference/textAscent_.html
+    # @see https://p5js.org/reference/#/p5/textAscent
+    #
     def textAscent()
       @painter__.font.ascent
     end
 
+    # Returns descent of the current font at its current size.
+    #
+    # @return [Numeric] descent
+    #
+    # @see https://processing.org/reference/textDescent_.html
+    # @see https://p5js.org/reference/#/p5/textDescent
+    #
     def textDescent()
       @painter__.font.descent
     end
 
+    # Sets the alignment for drawing text.
+    #
+    # @param horizontal [LEFT, CENTER, RIGHT]           horizontal alignment
+    # @param vertical   [TOP, BOTTOM, CENTER, BASELINE] vertical alignment
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/textAlign_.html
+    # @see https://p5js.org/reference/#/p5/textAlign
+    #
     def textAlign(horizontal, vertical = BASELINE)
       @textAlignH__ = horizontal
       @textAlignV__ = vertical
+      nil
     end
 
+    # Sets the spacing between lines of text in units of pixels.
+    #
+    # @overload textLeading()
+    # @overload textLeading(leading)
+    #
+    # @param leading [Numeric] the size in pixels for spacing between lines
+    #
+    # @return [Numeric] current spacing
+    #
+    # @see https://processing.org/reference/textLeading_.html
+    # @see https://p5js.org/reference/#/p5/textLeading
+    #
+    def textLeading(leading = nil)
+      @painter__.line_height = leading if leading
+      @painter__.line_height
+    end
+
+    # Sets texture.
+    #
+    # @param image [Image] texture image
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/texture_.html
+    # @see https://p5js.org/reference/#/p5/texture
+    #
     def texture(image)
       @painter__.texture image&.getInternal__
       nil
@@ -887,6 +1222,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/shader_.html
+    # @see https://p5js.org/reference/#/p5/shader
+    #
     def shader(shader)
       @painter__.shader shader&.getInternal__
       nil
@@ -896,6 +1234,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/resetShader_.html
+    # @see https://p5js.org/reference/#/p5/resetShader
+    #
     def resetShader()
       @painter__.no_shader
       nil
@@ -911,8 +1252,14 @@ module Processing
     # @param type   [THRESHOLD, GRAY, INVERT, BLUR] filter type
     # @param param  [Numeric] a parameter for each filter
     #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/filter_.html
+    # @see https://p5js.org/reference/#/p5/filter
+    #
     def filter(*args)
       @filter__ = Shader.createFilter__(*args)
+      nil
     end
 
     # Clears screen.
@@ -933,6 +1280,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/background_.html
+    # @see https://p5js.org/reference/#/p5/background
+    #
     def background(*args)
       assertDrawing__
       rgba = toRGBA__(*args)
@@ -959,9 +1309,12 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/point_.html
+    # @see https://p5js.org/reference/#/p5/point
+    #
     def point(x, y)
       assertDrawing__
-      @painter__.line x, y, x, y
+      @painter__.point x, y
       nil
     end
 
@@ -976,6 +1329,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/line_.html
+    # @see https://p5js.org/reference/#/p5/line
+    #
     def line(x1, y1, x2, y2)
       assertDrawing__
       @painter__.line x1, y1, x2, y2
@@ -1004,6 +1360,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/rect_.html
+    # @see https://p5js.org/reference/#/p5/rect
+    #
     def rect(a, b, c, d, *args)
       assertDrawing__
       x, y, w, h = toXYWH__ @rectMode__, a, b, c, d
@@ -1029,6 +1388,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/ellipse_.html
+    # @see https://p5js.org/reference/#/p5/ellipse
+    #
     def ellipse(a, b, c, d)
       assertDrawing__
       x, y, w, h = toXYWH__ @ellipseMode__, a, b, c, d
@@ -1046,6 +1408,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/circle_.html
+    # @see https://p5js.org/reference/#/p5/circle
+    #
     def circle(x, y, extent)
       ellipse x, y, extent, extent
     end
@@ -1065,6 +1430,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/arc_.html
+    # @see https://p5js.org/reference/#/p5/arc
+    #
     def arc(a, b, c, d, start, stop)
       assertDrawing__
       x, y, w, h = toXYWH__ @ellipseMode__, a, b, c, d
@@ -1083,6 +1451,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/square_.html
+    # @see https://p5js.org/reference/#/p5/square
+    #
     def square(x, y, extent)
       rect x, y, extent, extent
     end
@@ -1100,6 +1471,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/triangle_.html
+    # @see https://p5js.org/reference/#/p5/triangle
+    #
     def triangle(x1, y1, x2, y2, x3, y3)
       assertDrawing__
       @painter__.line x1, y1, x2, y2, x3, y3, loop: true
@@ -1121,6 +1495,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/quad_.html
+    # @see https://p5js.org/reference/#/p5/quad
+    #
     def quad(x1, y1, x2, y2, x3, y3, x4, y4)
       assertDrawing__
       @painter__.line x1, y1, x2, y2, x3, y3, x4, y4, loop: true
@@ -1142,9 +1519,14 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/curve_.html
+    # @see https://p5js.org/reference/#/p5/curve
+    #
     def curve(cx1, cy1, x1, y1, x2, y2, cx2, cy2)
       assertDrawing__
+      @painter__.nsegment = @curveDetail__
       @painter__.curve cx1, cy1, x1, y1, x2, y2, cx2, cy2
+      @painter__.nsegment = 0
       nil
     end
 
@@ -1163,9 +1545,14 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/bezier_.html
+    # @see https://p5js.org/reference/#/p5/bezier
+    #
     def bezier(x1, y1, cx1, cy1, cx2, cy2, x2, y2)
       assertDrawing__
+      @painter__.nsegment = @bezierDetail__
       @painter__.bezier x1, y1, cx1, cy1, cx2, cy2, x2, y2
+      @painter__.nsegment = 0
       nil
     end
 
@@ -1189,6 +1576,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/text_.html
+    # @see https://p5js.org/reference/#/p5/text
+    #
     def text(str, x, y, x2 = nil, y2 = nil)
       assertDrawing__
       if x2
@@ -1227,6 +1617,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/image_.html
+    # @see https://p5js.org/reference/#/p5/image
+    #
     def image(img, a, b, c = nil, d = nil)
       assertDrawing__
       x, y, w, h = toXYWH__ @imageMode__, a, b, c || img.width, d || img.height
@@ -1251,6 +1644,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/shape_.html
+    #
     def shape(shp, a = 0, b = 0, c = nil, d = nil)
       assertDrawing__
       return nil unless shp.isVisible
@@ -1437,6 +1832,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/copy_.html
+    # @see https://p5js.org/reference/#/p5/copy
+    #
     def copy(img = nil, sx, sy, sw, sh, dx, dy, dw, dh)
       blend img, sx, sy, sw, sh, dx, dy, dw, dh, BLEND
     end
@@ -1459,6 +1857,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/blend_.html
+    # @see https://p5js.org/reference/#/p5/blend
+    #
     def blend(img = nil, sx, sy, sw, sh, dx, dy, dw, dh, mode)
       assertDrawing__
       (img || self).drawImage__(
@@ -1470,6 +1871,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/loadPixels_.html
+    # @see https://p5js.org/reference/#/p5/loadPixels
+    #
     def loadPixels()
       @pixels__ = getInternal__.pixels
     end
@@ -1478,15 +1882,30 @@ module Processing
     #
     # @return [nil] nil
     #
-    def updatePixels()
-      return unless @pixels__
-      getInternal__.pixels = @pixels__
+    # @see https://processing.org/reference/updatePixels_.html
+    # @see https://p5js.org/reference/#/p5/updatePixels
+    #
+    def updatePixels(&block)
+      return if !block && !@pixels__
+      if block
+        loadPixels
+        block.call pixels
+      end
+      getInternal__.tap do |img|
+        img.pixels = @pixels__
+        img.paint {} # update texture and set modifiied
+      end
       @pixels__ = nil
     end
 
     # An array of all pixels.
     # Call loadPixels() before accessing the array.
     #
+    # @return [Array] color array
+    #
+    # @see https://processing.org/reference/pixels.html
+    # @see https://p5js.org/reference/#/p5/pixels
+    #
     def pixels()
       @pixels__
     end
@@ -1497,6 +1916,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/save_.html
+    # @see https://p5js.org/reference/#/p5/save
+    #
     def save(filename)
       getInternal__.save filename
       nil
@@ -1509,10 +1931,13 @@ module Processing
     #
     # @param x [Numeric] left/right translation
     # @param y [Numeric] up/down translation
-    # @param y [Numeric] forward/backward translation
+    # @param z [Numeric] forward/backward translation
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/translate_.html
+    # @see https://p5js.org/reference/#/p5/translate
+    #
     def translate(x, y, z = 0)
       assertDrawing__
       @painter__.translate x, y, z
@@ -1523,13 +1948,18 @@ module Processing
     #
     # @overload scale(s)
     # @overload scale(x, y)
+    # @overload scale(x, y, z)
     #
     # @param s [Numeric] horizontal and vertical scale
     # @param x [Numeric] horizontal scale
     # @param y [Numeric] vertical scale
+    # @param z [Numeric] depth scale
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/scale_.html
+    # @see https://p5js.org/reference/#/p5/scale
+    #
     def scale(x, y = nil, z = 1)
       assertDrawing__
       @painter__.scale x, (y || x), z
@@ -1542,16 +1972,104 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/rotate_.html
+    # @see https://p5js.org/reference/#/p5/rotate
+    #
     def rotate(angle)
       assertDrawing__
       @painter__.rotate toDegrees__ angle
       nil
     end
 
+    # Applies rotation around the x-axis.
+    #
+    # @param angle [Numeric] angle for rotation
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/rotateX_.html
+    # @see https://p5js.org/reference/#/p5/rotateX
+    #
+    def rotateX(angle)
+      assertDrawing__
+      @painter__.rotate toDegrees__(angle), 1, 0, 0
+      nil
+    end
+
+    # Applies rotation around the y-axis.
+    #
+    # @param angle [Numeric] angle for rotation
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/rotateY_.html
+    # @see https://p5js.org/reference/#/p5/rotateY
+    #
+    def rotateY(angle)
+      assertDrawing__
+      @painter__.rotate toDegrees__(angle), 0, 1, 0
+      nil
+    end
+
+    # Applies rotation around the z-axis.
+    #
+    # @param angle [Numeric] angle for rotation
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/rotateZ_.html
+    # @see https://p5js.org/reference/#/p5/rotateZ
+    #
+    def rotateZ(angle)
+      assertDrawing__
+      @painter__.rotate toDegrees__(angle), 0, 0, 1
+      nil
+    end
+
+    # Applies shear around the x-axis.
+    #
+    # @param angle [Numeric] angle for shearing
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/shearX_.html
+    # @see https://p5js.org/reference/#/p5/shearX
+    #
+    def shearX(angle)
+      t = Math.tan toRadians__(angle)
+      @painter__.matrix *= Rays::Matrix.new(
+        1, t, 0, 0,
+        0, 1, 0, 0,
+        0, 0, 1, 0,
+        0, 0, 0, 1)
+      nil
+    end
+
+    # Applies shear around the y-axis.
+    #
+    # @param angle [Numeric] angle for shearing
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/shearY_.html
+    # @see https://p5js.org/reference/#/p5/shearY
+    #
+    def shearY(angle)
+      t = Math.tan toRadians__(angle)
+      @painter__.matrix *= Rays::Matrix.new(
+        1, 0, 0, 0,
+        t, 1, 0, 0,
+        0, 0, 1, 0,
+        0, 0, 0, 1)
+      nil
+    end
+
     # Pushes the current transformation matrix to stack.
     #
     # @return [Object] result of the expression at the end of the block
     #
+    # @see https://processing.org/reference/pushMatrix_.html
+    #
     def pushMatrix(&block)
       assertDrawing__
       @matrixStack__.push @painter__.matrix
@@ -1564,6 +2082,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/popMatrix_.html
+    #
     def popMatrix()
       assertDrawing__
       raise "matrix stack underflow" if @matrixStack__.empty?
@@ -1571,20 +2091,86 @@ module Processing
       nil
     end
 
+    # Reset current transformation matrix with 2x3, or 4x4 matrix.
+    #
+    # @overload applyMatrix(array)
+    # @overload applyMatrix(a, b, c, d, e, f)
+    # @overload applyMatrix(a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p)
+    #
+    # @param array [Array]   6 or 16 numbers which define the matrix
+    # @param a     [Numeric] number which defines the matrix
+    # @param b     [Numeric] number which defines the matrix
+    # @param c     [Numeric] number which defines the matrix
+    # @param d     [Numeric] number which defines the matrix
+    # @param e     [Numeric] number which defines the matrix
+    # @param f     [Numeric] number which defines the matrix
+    # @param g     [Numeric] number which defines the matrix
+    # @param h     [Numeric] number which defines the matrix
+    # @param i     [Numeric] number which defines the matrix
+    # @param j     [Numeric] number which defines the matrix
+    # @param k     [Numeric] number which defines the matrix
+    # @param l     [Numeric] number which defines the matrix
+    # @param m     [Numeric] number which defines the matrix
+    # @param n     [Numeric] number which defines the matrix
+    # @param o     [Numeric] number which defines the matrix
+    # @param p     [Numeric] number which defines the matrix
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/applyMatrix_.html
+    # @see https://p5js.org/reference/#/p5/applyMatrix
+    #
+    def applyMatrix(*args)
+      assertDrawing__
+      args = args.first if args.first.kind_of?(Array)
+      if args.size == 6
+        a, b, c, d, e, f = args
+        args = [
+          a, b, 0, 0,
+          c, d, 0, 0,
+          0, 0, 1, 0,
+          e, f, 0, 1
+        ]
+      end
+      raise ArgumentError unless args.size == 16
+      m = Rays::Matrix.new(*args)
+      m.transpose! if @p5jsMode__
+      @painter__.matrix *= m
+      nil
+    end
+
     # Reset current transformation matrix with identity matrix.
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/resetMatrix_.html
+    # @see https://p5js.org/reference/#/p5/resetMatrix
+    #
     def resetMatrix()
       assertDrawing__
       @painter__.matrix = 1
       nil
     end
 
+    # Prints matrix elements to console.
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/printMatrix_.html
+    #
+    def printMatrix()
+      m = @painter__.matrix
+      m.transpose! if @p5jsMode__
+      print "%f %f %f %f\n%f %f %f %f\n%f %f %f %f\n%f %f %f %f\n" % m.to_a
+      nil
+    end
+
     # Save current style values to the style stack.
     #
     # @return [Object] result of the expression at the end of the block
     #
+    # @see https://processing.org/reference/pushStyle_.html
+    #
     def pushStyle(&block)
       assertDrawing__
       @styleStack__.push [
@@ -1593,6 +2179,8 @@ module Processing
         @painter__.stroke_width,
         @painter__.stroke_cap,
         @painter__.stroke_join,
+        @painter__.miter_limit,
+        @painter__.line_height!,
         @painter__.clip,
         @painter__.blend_mode,
         @painter__.font,
@@ -1600,13 +2188,22 @@ module Processing
         @painter__.texcoord_mode,
         @painter__.texcoord_wrap,
         @painter__.shader,
+        @colorMode__,
         @hsbColor__,
         @colorMaxes__,
-        @angleScale__,
+        @angleMode__,
+        @toRad__,
+        @toDeg__,
+        @fromRad__,
+        @fromDeg__,
         @rectMode__,
         @ellipseMode__,
         @imageMode__,
         @shapeMode__,
+        @blendMode__,
+        @curveDetail__,
+        @curveTightness__,
+        @bezierDetail__,
         @textAlignH__,
         @textAlignV__,
         @textFont__,
@@ -1621,6 +2218,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/popStyle_.html
+    #
     def popStyle()
       assertDrawing__
       raise "style stack underflow" if @styleStack__.empty?
@@ -1629,6 +2228,8 @@ module Processing
       @painter__.stroke_width,
       @painter__.stroke_cap,
       @painter__.stroke_join,
+      @painter__.miter_limit,
+      @painter__.line_height,
       @painter__.clip,
       @painter__.blend_mode,
       @painter__.font,
@@ -1636,13 +2237,22 @@ module Processing
       @painter__.texcoord_mode,
       @painter__.texcoord_wrap,
       @painter__.shader,
+      @colorMode__,
       @hsbColor__,
       @colorMaxes__,
-      @angleScale__,
+      @angleMode__,
+      @toRad__,
+      @toDeg__,
+      @fromRad__,
+      @fromDeg__,
       @rectMode__,
       @ellipseMode__,
       @imageMode__,
       @shapeMode__,
+      @blendMode__,
+      @curveDetail__,
+      @curveTightness__,
+      @bezierDetail__,
       @textAlignH__,
       @textAlignV__,
       @textFont__,
@@ -1655,6 +2265,9 @@ module Processing
     #
     # @return [Object] result of the expression at the end of the block
     #
+    # @see https://processing.org/reference/push_.html
+    # @see https://p5js.org/reference/#/p5/push
+    #
     def push(&block)
       pushMatrix
       pushStyle
@@ -1667,6 +2280,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/pop_.html
+    # @see https://p5js.org/reference/#/p5/pop
+    #
     def pop()
       popMatrix
       popStyle
@@ -1678,10 +2294,10 @@ module Processing
     end
 
     # @private
-    def drawImage__(painter, *args, **states)
+    def drawImage__(painter, *args, image__: getInternal__, **states)
       shader = painter.shader || @filter__&.getInternal__
       painter.push shader: shader, **states do |_|
-        painter.image getInternal__, *args
+        painter.image image__, *args
       end
     end
 
@@ -1700,6 +2316,9 @@ module Processing
     #
     # @return [Numeric] absolute number
     #
+    # @see https://processing.org/reference/abs_.html
+    # @see https://p5js.org/reference/#/p5/abs
+    #
     def abs(value)
       value.abs
     end
@@ -1710,6 +2329,9 @@ module Processing
     #
     # @return [Numeric] rounded up number
     #
+    # @see https://processing.org/reference/ceil_.html
+    # @see https://p5js.org/reference/#/p5/ceil
+    #
     def ceil(value)
       value.ceil
     end
@@ -1720,6 +2342,9 @@ module Processing
     #
     # @return [Numeric] rounded down number
     #
+    # @see https://processing.org/reference/floor_.html
+    # @see https://p5js.org/reference/#/p5/floor
+    #
     def floor(value)
       value.floor
     end
@@ -1730,6 +2355,9 @@ module Processing
     #
     # @return [Numeric] rounded number
     #
+    # @see https://processing.org/reference/round_.html
+    # @see https://p5js.org/reference/#/p5/round
+    #
     def round(value)
       value.round
     end
@@ -1740,6 +2368,9 @@ module Processing
     #
     # @return [Numeric] result number
     #
+    # @see https://processing.org/reference/log_.html
+    # @see https://p5js.org/reference/#/p5/log
+    #
     def log(n)
       Math.log n
     end
@@ -1750,6 +2381,9 @@ module Processing
     #
     # @return [Numeric] result number
     #
+    # @see https://processing.org/reference/exp_.html
+    # @see https://p5js.org/reference/#/p5/exp
+    #
     def exp(n)
       Math.exp n
     end
@@ -1761,6 +2395,9 @@ module Processing
     #
     # @return [Numeric] value ** exponent
     #
+    # @see https://processing.org/reference/pow_.html
+    # @see https://p5js.org/reference/#/p5/pow
+    #
     def pow(value, exponent)
       value ** exponent
     end
@@ -1771,6 +2408,9 @@ module Processing
     #
     # @return [Numeric] squared value
     #
+    # @see https://processing.org/reference/sq_.html
+    # @see https://p5js.org/reference/#/p5/sq
+    #
     def sq(value)
       value * value
     end
@@ -1781,6 +2421,9 @@ module Processing
     #
     # @return [Numeric] squared value
     #
+    # @see https://processing.org/reference/sqrt_.html
+    # @see https://p5js.org/reference/#/p5/sqrt
+    #
     def sqrt(value)
       Math.sqrt value
     end
@@ -1796,6 +2439,9 @@ module Processing
     #
     # @return [Numeric] magnitude
     #
+    # @see https://processing.org/reference/mag_.html
+    # @see https://p5js.org/reference/#/p5/mag
+    #
     def mag(*args)
       x, y, z = *args
       case args.size
@@ -1819,6 +2465,9 @@ module Processing
     #
     # @return [Numeric] distance between 2 points
     #
+    # @see https://processing.org/reference/dist_.html
+    # @see https://p5js.org/reference/#/p5/dist
+    #
     def dist(*args)
       case args.size
       when 4
@@ -1841,6 +2490,9 @@ module Processing
     #
     # @return [Numeric] normalized value between 0..1
     #
+    # @see https://processing.org/reference/norm_.html
+    # @see https://p5js.org/reference/#/p5/norm
+    #
     def norm(value, start, stop)
       (value.to_f - start.to_f) / (stop.to_f - start.to_f)
     end
@@ -1853,6 +2505,9 @@ module Processing
     #
     # @return [Numeric] interporated number
     #
+    # @see https://processing.org/reference/lerp_.html
+    # @see https://p5js.org/reference/#/p5/lerp
+    #
     def lerp(start, stop, amount)
       start + (stop - start) * amount
     end
@@ -1865,6 +2520,9 @@ module Processing
     #
     # @return [Integer] interporated color
     #
+    # @see https://processing.org/reference/lerpColor_.html
+    # @see https://p5js.org/reference/#/p5/lerpColor
+    #
     def lerpColor(color1, color2, amount)
       color(
         lerp(red(  color1), red(  color2), amount),
@@ -1883,6 +2541,9 @@ module Processing
     #
     # @return [Numeric] mapped number
     #
+    # @see https://processing.org/reference/map_.html
+    # @see https://p5js.org/reference/#/p5/map
+    #
     def map(value, start1, stop1, start2, stop2)
       lerp start2, stop2, norm(value, start1, stop1)
     end
@@ -1900,6 +2561,9 @@ module Processing
     #
     # @return [Numeric] minimum value
     #
+    # @see https://processing.org/reference/min_.html
+    # @see https://p5js.org/reference/#/p5/min
+    #
     def min(*args)
       args.flatten.min
     end
@@ -1917,6 +2581,9 @@ module Processing
     #
     # @return [Numeric] maximum value
     #
+    # @see https://processing.org/reference/max_.html
+    # @see https://p5js.org/reference/#/p5/max
+    #
     def max(*args)
       args.flatten.max
     end
@@ -1929,6 +2596,9 @@ module Processing
     #
     # @return [Numeric] constrained number
     #
+    # @see https://processing.org/reference/constrain_.html
+    # @see https://p5js.org/reference/#/p5/constrain
+    #
     def constrain(value, min, max)
       value < min ? min : (value > max ? max : value)
     end
@@ -1939,6 +2609,9 @@ module Processing
     #
     # @return [Numeric] radian
     #
+    # @see https://processing.org/reference/radians_.html
+    # @see https://p5js.org/reference/#/p5/radians
+    #
     def radians(degree)
       degree * DEG2RAD__
     end
@@ -1949,6 +2622,9 @@ module Processing
     #
     # @return [Numeric] degree
     #
+    # @see https://processing.org/reference/degrees_.html
+    # @see https://p5js.org/reference/#/p5/degrees
+    #
     def degrees(radian)
       radian * RAD2DEG__
     end
@@ -1959,6 +2635,9 @@ module Processing
     #
     # @return [Numeric] the sine
     #
+    # @see https://processing.org/reference/sin_.html
+    # @see https://p5js.org/reference/#/p5/sin
+    #
     def sin(angle)
       Math.sin angle
     end
@@ -1969,6 +2648,9 @@ module Processing
     #
     # @return [Numeric] the cosine
     #
+    # @see https://processing.org/reference/cos_.html
+    # @see https://p5js.org/reference/#/p5/cos
+    #
     def cos(angle)
       Math.cos angle
     end
@@ -1979,6 +2661,9 @@ module Processing
     #
     # @return [Numeric] the tangent
     #
+    # @see https://processing.org/reference/tan_.html
+    # @see https://p5js.org/reference/#/p5/tan
+    #
     def tan(angle)
       Math.tan angle
     end
@@ -1989,6 +2674,9 @@ module Processing
     #
     # @return [Numeric] the arc sine
     #
+    # @see https://processing.org/reference/asin_.html
+    # @see https://p5js.org/reference/#/p5/asin
+    #
     def asin(value)
       Math.asin value
     end
@@ -1999,6 +2687,9 @@ module Processing
     #
     # @return [Numeric] the arc cosine
     #
+    # @see https://processing.org/reference/acos_.html
+    # @see https://p5js.org/reference/#/p5/acos
+    #
     def acos(value)
       Math.acos value
     end
@@ -2009,6 +2700,9 @@ module Processing
     #
     # @return [Numeric] the arc tangent
     #
+    # @see https://processing.org/reference/atan_.html
+    # @see https://p5js.org/reference/#/p5/atan
+    #
     def atan(value)
       Math.atan value
     end
@@ -2020,10 +2714,105 @@ module Processing
     #
     # @return [Numeric] the angle in radians
     #
+    # @see https://processing.org/reference/atan2_.html
+    # @see https://p5js.org/reference/#/p5/atan2
+    #
     def atan2(y, x)
       Math.atan2 y, x
     end
 
+    # Evaluates the curve at point t for points a, b, c, d.
+    #
+    # @param a [Numeric] coordinate of first control point
+    # @param b [Numeric] coordinate of first point on the curve
+    # @param c [Numeric] coordinate of second point on the curve
+    # @param d [Numeric] coordinate of second control point
+    # @param t [Numeric] value between 0.0 and 1.0
+    #
+    # @return [Numeric] interpolated value
+    #
+    # @see https://processing.org/reference/curvePoint_.html
+    # @see https://p5js.org/reference/#/p5/curvePoint
+    #
+    def curvePoint(a, b, c, d, t)
+      s  = @curveTightness__
+      t3 = t * t * t
+      t2 = t * t
+      f1 = ( s - 1.0) / 2.0 * t3 + ( 1.0 - s)       * t2 + (s - 1.0) / 2.0 * t
+      f2 = ( s + 3.0) / 2.0 * t3 + (-5.0 - s) / 2.0 * t2 +  1.0
+      f3 = (-3.0 - s) / 2.0 * t3 + ( s + 2.0)       * t2 + (1.0 - s) / 2.0 * t
+      f4 = ( 1.0 - s) / 2.0 * t3 + ( s - 1.0) / 2.0 * t2
+      a * f1 + b * f2 + c * f3 + d * f4
+    end
+
+    # Calculates the tangent of a point on a curve.
+    #
+    # @param a [Numeric] coordinate of first control point
+    # @param b [Numeric] coordinate of first point on the curve
+    # @param c [Numeric] coordinate of second point on the curve
+    # @param d [Numeric] coordinate of second control point
+    # @param t [Numeric] value between 0.0 and 1.0
+    #
+    # @return [Numeric] tangent value
+    #
+    # @see https://processing.org/reference/curveTangent_.html
+    # @see https://p5js.org/reference/#/p5/curveTangent
+    #
+    def curveTangent(a, b, c, d, t)
+      s = @curveTightness__
+      tt3 = t * t * 3.0
+      t2  = t * 2.0
+      f1  = ( s - 1.0) / 2.0 * tt3 + ( 1.0 - s)       * t2 + (s - 1.0) / 2.0
+      f2  = ( s + 3.0) / 2.0 * tt3 + (-5.0 - s) / 2.0 * t2
+      f3  = (-3.0 - s) / 2.0 * tt3 + ( s + 2.0)       * t2 + (1.0 - s) / 2.0
+      f4  = ( 1.0 - s) / 2.0 * tt3 + ( s - 1.0) / 2.0 * t2
+      a * f1 + b * f2 + c * f3 + d * f4
+    end
+
+    # Evaluates the Bezier at point t for points a, b, c, d.
+    #
+    # @param a [Numeric] coordinate of first point on the curve
+    # @param b [Numeric] coordinate of first control point
+    # @param c [Numeric] coordinate of second control point
+    # @param d [Numeric] coordinate of second point on the curve
+    # @param t [Numeric] value between 0.0 and 1.0
+    #
+    # @return [Numeric] interpolated value
+    #
+    # @see https://processing.org/reference/bezierPoint_.html
+    # @see https://p5js.org/reference/#/p5/bezierPoint
+    #
+    def bezierPoint(a, b, c, d, t)
+      tt = 1.0 - t
+      tt ** 3.0 * a +
+      tt ** 2.0 * b * 3.0 * t +
+      t  ** 2.0 * c * 3.0 * tt +
+      t  ** 3.0 * d
+    end
+
+    # Calculates the tangent of a point on a Bezier curve.
+    #
+    # @param a [Numeric] coordinate of first point on the curve
+    # @param b [Numeric] coordinate of first control point
+    # @param c [Numeric] coordinate of second control point
+    # @param d [Numeric] coordinate of second point on the curve
+    # @param t [Numeric] value between 0.0 and 1.0
+    #
+    # @return [Numeric] tangent value
+    #
+    # @see https://processing.org/reference/bezierTangent_.html
+    # @see https://p5js.org/reference/#/p5/bezierTangent
+    #
+    def bezierTangent(a, b, c, d, t)
+      tt = 1.0 - t
+      3.0 * d * t  ** 2.0 -
+      3.0 * c * t  ** 2.0 +
+      6.0 * c * tt *  t   -
+      6.0 * b * tt *  t   +
+      3.0 * b * tt ** 2.0 -
+      3.0 * a * tt ** 2.0
+    end
+
     # Returns the perlin noise value.
     #
     # @overload noise(x)
@@ -2036,13 +2825,52 @@ module Processing
     #
     # @return [Numeric] noise value (0.0..1.0)
     #
+    # @see https://processing.org/reference/noise_.html
+    # @see https://p5js.org/reference/#/p5/noise
+    #
     def noise(x, y = 0, z = 0)
-      Rays.perlin(x, y, z) / 2.0 + 0.5
+      seed, falloff = @noiseSeed__, @noiseFallOff__
+      amp           = 0.5
+      @noiseOctaves__.times.reduce(0) do |sum|
+        value = (Rays.perlin(x, y, z, seed) / 2.0 + 0.5) * amp
+        x    *= 2
+        y    *= 2
+        z    *= 2
+        amp  *= falloff
+        sum + value
+      end
+    end
+
+    # Sets the seed value for noise()
+    #
+    # @param seed [Numeric] seed value
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/noiseSeed_.html
+    # @see https://p5js.org/reference/#/p5/noiseSeed
+    #
+    def noiseSeed(seed)
+      @noiseSeed__ = Random.new(seed).rand 0.0..1.0
+    end
+
+    # Adjusts the character and level of detail produced by the Perlin noise function.
+    #
+    # @param lod     [Numeric] number of octaves to be used by the noise
+    # @param falloff [Numeric] falloff factor for each octave
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/noiseDetail_.html
+    # @see https://p5js.org/reference/#/p5/noiseDetail
+    #
+    def noiseDetail(lod, falloff = nil)
+      @noiseOctaves__ = lod     if lod     && lod > 0
+      @noiseFallOff__ = falloff if falloff && falloff > 0
     end
 
     # Returns a random number in range low...high
     #
-    # @overload random()
     # @overload random(high)
     # @overload random(low, high)
     # @overload random(choices)
@@ -2053,10 +2881,60 @@ module Processing
     #
     # @return [Float] random number
     #
+    # @see https://processing.org/reference/random_.html
+    # @see https://p5js.org/reference/#/p5/random
+    #
     def random(*args)
-      return args.first.sample if args.first.kind_of? Array
-      high, low = args.reverse
-      rand (low || 0).to_f...(high || 1).to_f
+      if args.first.kind_of? Array
+        a = args.first
+        a.empty? ? nil : a[@random__.rand a.size]
+      else
+        high, low = args.reverse
+        @random__.rand (low || 0).to_f...(high || 1).to_f
+      end
+    end
+
+    # Sets the seed value for random()
+    #
+    # @param seed [Numeric] seed value
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/randomSeed_.html
+    # @see https://p5js.org/reference/#/p5/randomSeed
+    #
+    def randomSeed(seed)
+      @random__       = Random.new seed
+      @nextGaussian__ = nil
+    end
+
+    # Returns a random number fitting a Gaussian, or normal, distribution.
+    #
+    # @param mean [Numeric] mean
+    # @param sd   [Numeric] standard deviation
+    #
+    # @return [Float] random number
+    #
+    # @see https://processing.org/reference/randomGaussian_.html
+    # @see https://p5js.org/reference/#/p5/randomGaussian
+    #
+    def randomGaussian(mean = 0, sd = 1)
+      value =
+        if @nextGaussian__
+          x, @nextGaussian__ = @nextGaussian__, nil
+          x
+        else
+          a, b, w = 0, 0, 1
+          until w < 1
+            a = random(2) - 1
+            b = random(2) - 1
+            w = a ** 2 + b ** 2
+          end
+          w = Math.sqrt(-2 * Math.log(w) / w)
+          @randomGaussian__ = a * w
+          b * w
+        end
+      value * sd + mean
     end
 
     # Creates a new vector object.
@@ -2071,6 +2949,8 @@ module Processing
     #
     # @return [Vector] new vector
     #
+    # @see https://p5js.org/reference/#/p5/createVector
+    #
     def createVector(*args)
       Vector.new(*args, context: self)
     end
@@ -2080,6 +2960,10 @@ module Processing
     # @param name [String]  font name
     # @param size [Numeric] font size (max 256)
     #
+    # @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__)
@@ -2096,6 +2980,9 @@ module Processing
     #
     # @return [Image] new image
     #
+    # @see https://processing.org/reference/createImage_.html
+    # @see https://p5js.org/reference/#/p5/createImage
+    #
     def createImage(w, h, format = RGBA)
       colorspace = {RGB => Rays::RGB, RGBA => Rays::RGBA}[format]
       raise ArgumentError, "Unknown image format" unless colorspace
@@ -2115,6 +3002,10 @@ module Processing
     #
     # @param kind [LINE, RECT, ELLIPSE, ARC, TRIANGLE, QUAD, GROUP]
     #
+    # @return [Shape] new shape
+    #
+    # @see https://processing.org/reference/createShape_.html
+    #
     def createShape(kind = nil, *args)
       case kind
       when LINE     then createLineShape__(    *args)
@@ -2171,6 +3062,9 @@ module Processing
     #
     # @return [Graphics] graphics object
     #
+    # @see https://processing.org/reference/createGraphics_.html
+    # @see https://p5js.org/reference/#/p5/createGraphics
+    #
     def createGraphics(width, height, pixelDensity = 1)
       Graphics.new width, height, pixelDensity
     end
@@ -2207,6 +3101,8 @@ module Processing
     #
     # @return [Shader] shader object
     #
+    # @see https://p5js.org/reference/#/p5/createShader
+    #
     def createShader(vert, frag)
       vert = File.read if vert && File.exist?(vert)
       frag = File.read if frag && File.exist?(frag)
@@ -2235,7 +3131,7 @@ module Processing
       raise "unsupported font type -- '#{ext}'" unless ext =~ /^\.?(ttf|otf)$/i
 
       filename = httpGet__ filename, ext if filename =~ %r|^https?://|
-      Font.new Rays::Font.load p filename
+      Font.new Rays::Font.load filename
     end
 
     # Loads image.
@@ -2288,6 +3184,9 @@ module Processing
     #
     # @return [Shader] loaded shader object
     #
+    # @see https://processing.org/reference/loadShader_.html
+    # @see https://p5js.org/reference/#/p5/loadShader
+    #
     def loadShader(fragPath, vertPath = nil)
       createShader vertPath, fragPath
     end
@@ -2299,15 +3198,10 @@ module Processing
       path   = path.sub_ext ext
 
       unless path.file?
-        URI.open uri do |input|
-          input.set_encoding nil# disable default_internal
+        Net::HTTP.get_response URI.parse(uri) do |res|
+          res.value # raise an error unless successful
           tmpdir.mkdir unless tmpdir.directory?
-          path.open('w') do |output|
-            output.set_encoding Encoding::ASCII_8BIT
-            while buf = input.read(2 ** 16)
-              output.write buf
-            end
-          end
+          path.open('wb') {|file| res.read_body {|body| file.write body}}
         end
       end
       path.to_s