processing 0.5.31 → 0.5.33

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
@@ -129,6 +137,18 @@ module Processing
     # 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
 
@@ -247,29 +267,50 @@ module Processing
     # @private
     RAD2DEG__ = 180.0 / Math::PI
 
+    # @private
+    FONT_SIZE_DEFAULT__ = 12
+
+    # @private
+    FONT_SIZE_MAX__     = 256
+
     # @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
-      @tint__        = nil
-      @filter__      = nil
-      @matrixStack__ = []
-      @styleStack__  = []
-      @fontCache__   = {}
+      @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
@@ -280,11 +321,20 @@ module Processing
       strokeCap   ROUND
       strokeJoin  MITER
       textAlign   LEFT
+      textFont    createFont(nil, nil)
+      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
@@ -300,6 +350,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
@@ -313,7 +383,7 @@ module Processing
     # @return [Numeric] width
     #
     def width()
-      @image__.width
+      getInternal__.width
     end
 
     # Returns the height of the graphics object.
@@ -321,7 +391,7 @@ module Processing
     # @return [Numeric] height
     #
     def height()
-      @image__.height
+      getInternal__.height
     end
 
     # Returns the width of the graphics object in pixels.
@@ -348,6 +418,20 @@ module Processing
       @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)
@@ -441,19 +525,56 @@ module Processing
       ((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
+    #
+    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
+    #
+    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
+    #
+    def brightness(color)
+      _, _, b = toRawColor__(color).to_hsv
+      b * (@hsbColor__ ? @colorMaxes__[2] : 1)
+    end
+
     # @private
     private def toRGBA__(*args)
-      a, b, c, d = args
+      a, b = args
       return parseColor__(a, b || alphaMax__) if a.kind_of?(String)
+      rawColor__(*args).to_a
+    end
 
+    # @private
+    def rawColor__(*args)
+      a, b, c, d = args
       rgba = case args.size
         when 1, 2 then [a, a, a, b || alphaMax__]
         when 3, 4 then [a, b, c, d || alphaMax__]
         else raise ArgumentError
         end
-      rgba  = rgba.map.with_index {|value, i| value / @colorMaxes__[i]}
-      color = @hsbColor__ ? Rays::Color.hsv(*rgba) : Rays::Color.new(*rgba)
-      color.to_a
+      rgba = rgba.map.with_index {|value, i| value / @colorMaxes__[i]}
+      @hsbColor__ ? Rays::Color.hsv(*rgba) : Rays::Color.new(*rgba)
     end
 
     # @private
@@ -470,6 +591,15 @@ 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
@@ -479,37 +609,34 @@ module Processing
     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.
@@ -618,6 +745,11 @@ module Processing
       nil
     end
 
+    # @private
+    def getFill__()
+      @painter__.fill
+    end
+
     # Disables filling.
     #
     # @return [nil] nil
@@ -692,6 +824,52 @@ module Processing
       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)
@@ -723,6 +901,11 @@ module Processing
       @tint__ = nil
     end
 
+    # @private
+    def getTint__()
+      @tint__ ? toRGBA__(*@tint__) : 1
+    end
+
     # Limits the drawable rectangle.
     #
     # The parameters a, b, c, and d are determined by rectMode().
@@ -749,12 +932,14 @@ module Processing
       nil
     end
 
-    # Sets font.
+    # 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
@@ -763,8 +948,17 @@ module Processing
     # @return [Font] current font
     #
     def textFont(font = nil, size = nil)
-      setFont__ font, size if font || size
-      Font.new @painter__.font
+      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__
     end
 
     # Sets text size.
@@ -774,8 +968,7 @@ module Processing
     # @return [nil] nil
     #
     def textSize(size)
-      setFont__ nil, size
-      nil
+      textFont @textFont__, size
     end
 
     def textWidth(str)
@@ -795,16 +988,60 @@ module Processing
       @textAlignV__ = vertical
     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
+    #
+    def textLeading(leading = nil)
+      @painter__.line_height = leading if leading
+      @painter__.line_height
+    end
+
+    def texture(image)
+      @painter__.texture image&.getInternal__
+      nil
+    end
+
     # @private
-    def setFont__(fontOrName, size)
-      name = case fontOrName
-        when Font then fontOrName.name
-        else fontOrName || @painter__.font.name
-        end
-      size ||= @painter__.font.size
-      size = 256 if size > 256
-      font = @fontCache__[[name, size]] ||= Rays::Font.new name, size
-      @painter__.font = font
+    def drawWithTexture__(&block)
+      if @painter__.texture
+        @painter__.push fill: getTint__, &block
+      else
+        block.call
+      end
+    end
+
+    # Sets the coordinate space for texture mapping.
+    #
+    # @param mode [IMAGE, NORMAL] image coordinate, or normalized coordinate
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/textureMode_.html
+    # @see https://p5js.org/reference/#/p5/textureMode
+    #
+    def textureMode(mode)
+      @painter__.texcoord_mode = mode
+      nil
+    end
+
+    # Sets the texture wrapping mode.
+    #
+    # @param wrap [CLAMP, REPEAT] how texutres behave when go outside of the range
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/textureWrap_.html
+    # @see https://p5js.org/reference/#/p5/textureWrap
+    #
+    def textureWrap(wrap)
+      @painter__.texcoord_wrap = wrap
+      nil
     end
 
     # Sets shader.
@@ -887,7 +1124,7 @@ module Processing
     #
     def point(x, y)
       assertDrawing__
-      @painter__.line x, y, x, y
+      @painter__.point x, y
       nil
     end
 
@@ -1070,7 +1307,9 @@ module Processing
     #
     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
 
@@ -1091,7 +1330,9 @@ module Processing
     #
     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
 
@@ -1156,8 +1397,7 @@ 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
-      tint       = @tint__ ? toRGBA__(*@tint__) : 1
-      img.drawImage__ @painter__, x, y, w, h, fill: tint, stroke: :none
+      img.drawImage__ @painter__, x, y, w, h, fill: getTint__, stroke: :none
       nil
     end
 
@@ -1182,11 +1422,13 @@ module Processing
       assertDrawing__
       return nil unless shp.isVisible
 
-      if c || d || @shapeMode__ != CORNER
-        x, y, w, h = toXYWH__ @shapeMode__, a, b, c || shp.width, d || shp.height
-        shp.draw__ @painter__, x, y, w, h
-      else
-        shp.draw__ @painter__, a, b
+      drawWithTexture__ do |_|
+        if c || d || @shapeMode__ != CORNER
+          x, y, w, h = toXYWH__ @shapeMode__, a, b, c || shp.width, d || shp.height
+          shp.draw__ @painter__, x, y, w, h
+        else
+          shp.draw__ @painter__, a, b
+        end
       end
       nil
     end
@@ -1195,7 +1437,7 @@ module Processing
 
     # Begins drawing complex shapes.
     #
-    # @param mode [POINTS, LINES, TRIANGLES, TRIANGLE_FAN, TRIANGLE_STRIP, QUADS, QUAD_STRIP, TESS]
+    # @param type [POINTS, LINES, TRIANGLES, TRIANGLE_FAN, TRIANGLE_STRIP, QUADS, QUAD_STRIP, TESS]
     #
     # @return [nil] nil
     #
@@ -1217,9 +1459,10 @@ module Processing
     #
     # @see https://processing.org/reference/beginShape_.html
     #
-    def beginShape(mode = nil)
-      @shapeMode__, @shapePoints__ = mode, []
-      nil
+    def beginShape(type = nil)
+      raise "beginShape() cannot be called twice" if @drawingShape__
+      @drawingShape__ = createShape
+      @drawingShape__.beginShape type
     end
 
     # Ends drawing complex shapes.
@@ -1234,25 +1477,114 @@ module Processing
     # @see https://processing.org/reference/endShape_.html
     #
     def endShape(mode = nil)
-      raise "endShape() must be called after beginShape()" unless @shapePoints__
-      polygon = Shape.createPolygon__ @shapeMode__, @shapePoints__, mode == CLOSE
-      @painter__.polygon polygon if polygon
-      @shapeMode__ = @shapePoints__ = nil
+      s = @drawingShape__ or raise "endShape() must be called after beginShape()"
+      s.endShape mode
+      shape s
+      @drawingShape__ = nil
       nil
     end
 
+    # Begins drawing a hole inside shape.
+    #
+    # @return [nil] nil
+    #
+    # @example
+    #  beginShape
+    #  vertex 10, 10
+    #  vertex 10, 50
+    #  vertex 50, 50
+    #  vertex 90, 10
+    #  beginContour
+    #  vertex 20, 20
+    #  vertex 30, 20
+    #  vertex 30, 30
+    #  vertex 20, 30
+    #  endContour
+    #  endShape CLOSE
+    #
+    # @see https://processing.org/reference/beginContour_.html
+    # @see https://p5js.org/reference/#/p5/beginContour
+    #
+    def beginContour()
+      (@drawingShape__ or raise "beginContour() must be called after beginShape()")
+        .beginContour
+    end
+
+    # Ends drawing a hole.
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/endContour_.html
+    # @see https://p5js.org/reference/#/p5/endContour
+    #
+    def endContour()
+      (@drawingShape__ or raise "endContour() must be called after beginShape()")
+        .endContour
+    end
+
     # Append vertex for shape polygon.
     #
+    # @overload vertex(x, y)
+    # @overload vertex(x, y, u, v)
+    #
     # @param x [Numeric] x position of vertex
     # @param y [Numeric] y position of vertex
+    # @param u [Numeric] u texture coordinate of vertex
+    # @param v [Numeric] v texture coordinate of vertex
     #
     # @return [nil] nil
     #
     # @see https://processing.org/reference/vertex_.html
+    # @see https://p5js.org/reference/#/p5/vertex
+    #
+    def vertex(x, y, u = nil, v = nil)
+      (@drawingShape__ or raise "vertex() must be called after beginShape()")
+        .vertex x, y, u, v
+    end
+
+    # Append curve vertex for shape polygon.
+    #
+    # @param x [Numeric] x position of vertex
+    # @param y [Numeric] y position of vertex
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/curveVertex_.html
+    # @see https://p5js.org/reference/#/p5/curveVertex
     #
-    def vertex(x, y)
-      raise "vertex() must be called after beginShape()" unless @shapePoints__
-      @shapePoints__ << x << y
+    def curveVertex(x, y)
+      (@drawingShape__ or raise "curveVertex() must be called after beginShape()")
+        .curveVertex x, y
+    end
+
+    # Append bezier vertex for shape polygon.
+    #
+    # @param x [Numeric] x position of vertex
+    # @param y [Numeric] y position of vertex
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/bezierVertex_.html
+    # @see https://p5js.org/reference/#/p5/bezierVertex
+    #
+    def bezierVertex(x2, y2, x3, y3, x4, y4)
+      (@drawingShape__ or raise "bezierVertex() must be called after beginShape()")
+        .bezierVertex x2, y2, x3, y3, x4, y4
+    end
+
+    # Append quadratic vertex for shape polygon.
+    #
+    # @param x [Numeric] x position of vertex
+    # @param y [Numeric] y position of vertex
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/quadraticVertex_.html
+    # @see https://p5js.org/reference/#/p5/quadraticVertex
+    #
+    def quadraticVertex(cx, cy, x3, y3)
+      (@drawingShape__ or raise "quadraticVertex() must be called after beginShape()")
+        .quadraticVertex cx, cy, x3, y3
     end
 
     # Copies image.
@@ -1296,11 +1628,41 @@ module Processing
     #
     def blend(img = nil, sx, sy, sw, sh, dx, dy, dw, dh, mode)
       assertDrawing__
-      tint  = @tint__ ? toRGBA__(*@tint__) : 1
-      img ||= self
-      img.drawImage__(
+      (img || self).drawImage__(
         @painter__, sx, sy, sw, sh, dx, dy, dw, dh,
-        fill: tint, stroke: :none, blend_mode: mode)
+        fill: getTint__, stroke: :none, blend_mode: mode)
+    end
+
+    # Loads all pixels to the 'pixels' array.
+    #
+    # @return [nil] nil
+    #
+    def loadPixels()
+      @pixels__ = getInternal__.pixels
+    end
+
+    # Update the image pixels with the 'pixels' array.
+    #
+    # @return [nil] nil
+    #
+    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.
+    #
+    def pixels()
+      @pixels__
     end
 
     # Saves screen image to file.
@@ -1310,7 +1672,7 @@ module Processing
     # @return [nil] nil
     #
     def save(filename)
-      @window__.canvas_image.save filename
+      getInternal__.save filename
       nil
     end
 
@@ -1360,6 +1722,42 @@ module Processing
       nil
     end
 
+    def rotateX(angle)
+      assertDrawing__
+      @painter__.rotate toDegrees__(angle), 1, 0, 0
+      nil
+    end
+
+    def rotateY(angle)
+      assertDrawing__
+      @painter__.rotate toDegrees__(angle), 0, 1, 0
+      nil
+    end
+
+    def rotateZ(angle)
+      assertDrawing__
+      @painter__.rotate toDegrees__(angle), 0, 0, 1
+      nil
+    end
+
+    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)
+    end
+
+    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)
+    end
+
     # Pushes the current transformation matrix to stack.
     #
     # @return [Object] result of the expression at the end of the block
@@ -1383,6 +1781,51 @@ 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
+    #
+    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
@@ -1393,6 +1836,17 @@ module Processing
       nil
     end
 
+    # Prints matrix elements to console.
+    #
+    # @return [nil] nil
+    #
+    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
@@ -1405,19 +1859,34 @@ module Processing
         @painter__.stroke_width,
         @painter__.stroke_cap,
         @painter__.stroke_join,
+        @painter__.miter_limit,
+        @painter__.line_height!,
         @painter__.clip,
         @painter__.blend_mode,
         @painter__.font,
+        @painter__.texture,
+        @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__,
         @tint__,
       ]
       block.call if block
@@ -1437,20 +1906,36 @@ module Processing
       @painter__.stroke_width,
       @painter__.stroke_cap,
       @painter__.stroke_join,
+      @painter__.miter_limit,
+      @painter__.line_height,
       @painter__.clip,
       @painter__.blend_mode,
       @painter__.font,
+      @painter__.texture,
+      @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__,
       @tint__ = @styleStack__.pop
+      @textFont__.setSize__ @painter__.font.size
       nil
     end
 
@@ -1481,10 +1966,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
 
@@ -1827,6 +2312,98 @@ module Processing
       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)
@@ -1839,13 +2416,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)
@@ -1856,13 +2472,63 @@ 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
 
-    # Creates a new vector.
+    # 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.
     #
     # @overload createVector()
     # @overload createVector(x, y)
@@ -1878,7 +2544,17 @@ module Processing
       Vector.new(*args, context: self)
     end
 
-    # Creates a new image.
+    # Creates a new font object.
+    #
+    # @param name [String]  font name
+    # @param size [Numeric] font size (max 256)
+    #
+    def createFont(name, size)
+      size = FONT_SIZE_MAX__ if size && size > FONT_SIZE_MAX__
+      Font.new Rays::Font.new(name, size || FONT_SIZE_DEFAULT__)
+    end
+
+    # Creates a new image object.
     #
     # @overload createImage(w, h)
     # @overload createImage(w, h, format)
@@ -1895,7 +2571,7 @@ module Processing
       Image.new Rays::Image.new(w, h, colorspace).paint {background 0, 0}
     end
 
-    # Creates a new shape.
+    # Creates a new shape object.
     #
     # @overload createShape()
     # @overload createShape(LINE, x1, y1, x2, y2)
@@ -1924,7 +2600,7 @@ module Processing
 
     # @private
     private def createLineShape__(x1, y1, x2, y2)
-      Shape.new Rays::Polygon.lines(x1, y1, x2, y2), context: self
+      Shape.new Rays::Polygon.line(x1, y1, x2, y2), context: self
     end
 
     # @private
@@ -2014,6 +2690,23 @@ module Processing
       Capture.new(*args)
     end
 
+    # Loads font from file.
+    #
+    # @param filename  [String] file name to load font file
+    #
+    # @return [Font] loaded font object
+    #
+    # @see https://processing.org/reference/loadFont_.html
+    # @see https://p5js.org/reference/#/p5/loadFont
+    #
+    def loadFont(filename)
+      ext = File.extname filename
+      raise "unsupported font type -- '#{ext}'" unless ext =~ /^\.?(ttf|otf)$/i
+
+      filename = httpGet__ filename, ext if filename =~ %r|^https?://|
+      Font.new Rays::Font.load filename
+    end
+
     # Loads image.
     #
     # @param filename  [String] file name to load image
@@ -2021,11 +2714,39 @@ module Processing
     #
     # @return [Image] loaded image object
     #
+    # @see https://processing.org/reference/loadImage_.html
+    # @see https://p5js.org/reference/#/p5/loadImage
+    #
     def loadImage(filename, extension = nil)
-      filename = getImage__ filename, extension if filename =~ %r|^https?://|
+      ext = extension || File.extname(filename)
+      raise "unsupported image type -- '#{ext}'" unless ext =~ /^\.?(png|jpg|gif)$/i
+
+      filename = httpGet__ filename, ext if filename =~ %r|^https?://|
       Image.new Rays::Image.load filename
     end
 
+    # Loads image on a new thread.
+    # When the image is loading, its width and height will be 0.
+    # If an error occurs while loading the image, its width and height wil be -1.
+    #
+    # @param filename  [String] file name to load image
+    # @param extension [String] type of image to load (ex. 'png')
+    #
+    # @return [Image] loading image object
+    #
+    # @see https://processing.org/reference/requestImage_.html
+    #
+    def requestImage(filename, extension = nil)
+      img = Image.new nil
+      Thread.new filename, extension do |fn, ext|
+        loaded = loadImage(fn, ext) or raise
+        img.setInternal__ loaded.getInternal__
+      rescue
+        img.setInternal__ nil, true
+      end
+      img
+    end
+
     # Loads shader file.
     #
     # @overload loadShader(fragPath)
@@ -2041,24 +2762,16 @@ module Processing
     end
 
     # @private
-    private def getImage__(uri, ext)
-      ext ||= File.extname uri
-      raise "unsupported image type -- #{ext}" unless ext =~ /^\.?(png|jpg|gif)$/i
-
+    private def httpGet__(uri, ext)
       tmpdir = tmpdir__
       path   = tmpdir + Digest::SHA1.hexdigest(uri)
       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