processing 0.5.30 → 0.5.32

data/lib/processing/graphics_context.rb

@@ -45,15 +45,16 @@ module Processing
     #
     DEGREES = :degrees
 
-    # Mode for rectMode(), ellipseMode() and imageMode().
+    # Mode for rectMode(), ellipseMode(), imageMode(), and shapeMode().
     #
     CORNER  = :corner
 
-    # Mode for rectMode(), ellipseMode() and imageMode().
+    # Mode for rectMode(), ellipseMode(), imageMode(), and shapeMode().
     #
     CORNERS = :corners
 
-    # Mode for rectMode(), ellipseMode(), imageMode() and textAlign().
+    # Mode for rectMode(), ellipseMode(), imageMode(), shapeMode(),
+    # and textAlign().
     #
     CENTER  = :center
 
@@ -128,6 +129,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
 
@@ -140,6 +153,57 @@ module Processing
     # 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
@@ -195,6 +259,12 @@ 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
@@ -206,14 +276,16 @@ module Processing
       @rectMode__    = nil
       @ellipseMode__ = nil
       @imageMode__   = nil
+      @shapeMode__   = nil
       @blendMode__   = nil
       @textAlignH__  = nil
       @textAlignV__  = nil
+      @textFont__    = nil
       @tint__        = nil
       @filter__      = nil
+      @pixels__      = nil
       @matrixStack__ = []
       @styleStack__  = []
-      @fontCache__   = {}
 
       updateCanvas__ image, painter
 
@@ -222,10 +294,14 @@ module Processing
       rectMode    CORNER
       ellipseMode CENTER
       imageMode   CORNER
+      shapeMode   CORNER
       blendMode   BLEND
       strokeCap   ROUND
       strokeJoin  MITER
       textAlign   LEFT
+      textFont    createFont(nil, nil)
+      textureMode IMAGE
+      textureWrap CLAMP
 
       fill 255
       stroke 0
@@ -235,7 +311,9 @@ module Processing
 
     # @private
     def updateCanvas__(image, painter)
-      @image__, @painter__ = image, painter
+      @image__, @painter__     = image, painter
+      @painter__.miter_limit   = 10
+      @painter__.stroke_outset = 0.5
     end
 
     # @private
@@ -257,7 +335,7 @@ module Processing
     # @return [Numeric] width
     #
     def width()
-      @image__.width
+      getInternal__.width
     end
 
     # Returns the height of the graphics object.
@@ -265,7 +343,7 @@ module Processing
     # @return [Numeric] height
     #
     def height()
-      @image__.height
+      getInternal__.height
     end
 
     # Returns the width of the graphics object in pixels.
@@ -387,17 +465,21 @@ module Processing
 
     # @private
     private def toRGBA__(*args)
-      a, b, c, d = args
+      a, b = args
       return parseColor__(a, b || alphaMax__) if a.kind_of?(String)
+      toRaysColor__(*args).to_a
+    end
 
+    # @private
+    def toRaysColor__(*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
@@ -434,7 +516,7 @@ module Processing
     end
 
     # @private
-    def toAngle__(angle)
+    def toDegrees__(angle)
       angle * @angleScale__
     end
 
@@ -460,8 +542,8 @@ module Processing
     #
     # CORNER  -> rect(left, top, width, height)
     # CORNERS -> rect(left, top, right, bottom)
-    # CENTER  -> rect(center_x, center_y, width, height)
-    # RADIUS  -> rect(center_x, center_y, radius_h, radius_v)
+    # CENTER  -> rect(centerX, centerY, width, height)
+    # RADIUS  -> rect(centerX, centerY, radiusH, radiusV)
     #
     # @param mode [CORNER, CORNERS, CENTER, RADIUS]
     #
@@ -475,8 +557,8 @@ module Processing
     #
     # CORNER  -> ellipse(left, top, width, height)
     # CORNERS -> ellipse(left, top, right, bottom)
-    # CENTER  -> ellipse(center_x, center_y, width, height)
-    # RADIUS  -> ellipse(center_x, center_y, radius_h, radius_v)
+    # CENTER  -> ellipse(centerX, centerY, width, height)
+    # RADIUS  -> ellipse(centerX, centerY, radiusH, radiusV)
     #
     # @param mode [CORNER, CORNERS, CENTER, RADIUS]
     #
@@ -490,7 +572,7 @@ module Processing
     #
     # CORNER  -> image(img, left, top, width, height)
     # CORNERS -> image(img, left, top, right, bottom)
-    # CENTER  -> image(img, center_x, center_y, width, height)
+    # CENTER  -> image(img, centerX, centerY, width, height)
     #
     # @param mode [CORNER, CORNERS, CENTER]
     #
@@ -500,6 +582,20 @@ module Processing
       @imageMode__ = mode
     end
 
+    # Sets shape mode. Default is CORNER.
+    #
+    # CORNER  -> shape(shp, left, top, width, height)
+    # CORNERS -> shape(shp, left, top, right, bottom)
+    # CENTER  -> shape(shp, centerX, centerY, width, height)
+    #
+    # @param mode [CORNER, CORNERS, CENTER]
+    #
+    # @return [nil] nil
+    #
+    def shapeMode(mode)
+      @shapeMode__ = mode
+    end
+
     # @private
     private def toXYWH__(mode, a, b, c, d)
       case mode
@@ -548,6 +644,11 @@ module Processing
       nil
     end
 
+    # @private
+    def getFill__()
+      @painter__.fill
+    end
+
     # Disables filling.
     #
     # @return [nil] nil
@@ -653,6 +754,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().
@@ -679,7 +785,9 @@ module Processing
       nil
     end
 
-    # Sets font.
+    # Sets text font.
+    #
+    # (Passing a font name as the first parameter is deprecated)
     #
     # @overload textFont(font)
     # @overload textFont(name)
@@ -690,11 +798,18 @@ module Processing
     # @param name [String]  font name
     # @param size [Numeric] font size (max 256)
     #
-    # @return [Font] current font
+    # @return [nil] nil
     #
-    def textFont(font = nil, size = nil)
-      setFont__ font, size if font || size
-      Font.new @painter__.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
+      end
+      @textFont__     = font
+      @painter__.font = font.getInternal__
+      nil
     end
 
     # Sets text size.
@@ -704,8 +819,7 @@ module Processing
     # @return [nil] nil
     #
     def textSize(size)
-      setFont__ nil, size
-      nil
+      textFont @textFont__, size
     end
 
     def textWidth(str)
@@ -725,16 +839,46 @@ module Processing
       @textAlignV__ = vertical
     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.
@@ -924,9 +1068,8 @@ module Processing
     def arc(a, b, c, d, start, stop)
       assertDrawing__
       x, y, w, h = toXYWH__ @ellipseMode__, a, b, c, d
-      start      = toAngle__(-start)
-      stop       = toAngle__(-stop)
-      @painter__.ellipse x, y, w, h, from: start, to: stop
+      from, to   = toDegrees__(-start), toDegrees__(-stop)
+      @painter__.ellipse x, y, w, h, from: from, to: to
       nil
     end
 
@@ -1087,13 +1230,196 @@ 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
 
     alias drawImage image
 
+    # Draws a shape.
+    #
+    # The parameters a, b, c, and d are determined by shapeMode().
+    #
+    # @overload shape(img, a, b)
+    # @overload shape(img, a, b, c, d)
+    #
+    # @param shp [Shape] shape to draw
+    # @param a   [Numeric] horizontal position of the shape, by default
+    # @param b   [Numeric] vertical position of the shape, by default
+    # @param c   [Numeric] width of the shape, by default
+    # @param d   [Numeric] height of the shape, by default
+    #
+    # @return [nil] nil
+    #
+    def shape(shp, a = 0, b = 0, c = nil, d = nil)
+      assertDrawing__
+      return nil unless shp.isVisible
+
+      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
+
+    alias drawShape shape
+
+    # Begins drawing complex shapes.
+    #
+    # @param type [POINTS, LINES, TRIANGLES, TRIANGLE_FAN, TRIANGLE_STRIP, QUADS, QUAD_STRIP, TESS]
+    #
+    # @return [nil] nil
+    #
+    # @example
+    #  # Draws polygon
+    #  beginShape
+    #  vertex 10, 10
+    #  vertex 10, 50
+    #  vertex 50, 50
+    #  vertex 90, 10
+    #  endShape CLOSE
+    #
+    #  # Draws triangles
+    #  beginShape TRIANGLES
+    #  vertex 10, 10
+    #  vertex 10, 50
+    #  vertex 50, 50
+    #  endShape
+    #
+    # @see https://processing.org/reference/beginShape_.html
+    #
+    def beginShape(type = nil)
+      raise "beginShape() cannot be called twice" if @drawingShape__
+      @drawingShape__ = createShape
+      @drawingShape__.beginShape type
+    end
+
+    # Ends drawing complex shapes.
+    #
+    # @overload endShape()
+    # @overload endShape(CLOSE)
+    #
+    # @param mode [CLOSE] Use CLOSE to create looped polygon
+    #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/endShape_.html
+    #
+    def endShape(mode = 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 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.
     #
     # @overload copy(sx, sy, sw, sh, dx, dy, dw, dh)
@@ -1135,11 +1461,34 @@ 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()
+      return unless @pixels__
+      getInternal__.pixels = @pixels__
+      @pixels__ = nil
+    end
+
+    # An array of all pixels.
+    # Call loadPixels() before accessing the array.
+    #
+    def pixels()
+      @pixels__
     end
 
     # Saves screen image to file.
@@ -1149,7 +1498,7 @@ module Processing
     # @return [nil] nil
     #
     def save(filename)
-      @window__.canvas_image.save filename
+      getInternal__.save filename
       nil
     end
 
@@ -1181,9 +1530,9 @@ module Processing
     #
     # @return [nil] nil
     #
-    def scale(x, y)
+    def scale(x, y = nil, z = 1)
       assertDrawing__
-      @painter__.scale x, y
+      @painter__.scale x, (y || x), z
       nil
     end
 
@@ -1195,7 +1544,7 @@ module Processing
     #
     def rotate(angle)
       assertDrawing__
-      @painter__.rotate toAngle__ angle
+      @painter__.rotate toDegrees__ angle
       nil
     end
 
@@ -1247,6 +1596,9 @@ module Processing
         @painter__.clip,
         @painter__.blend_mode,
         @painter__.font,
+        @painter__.texture,
+        @painter__.texcoord_mode,
+        @painter__.texcoord_wrap,
         @painter__.shader,
         @hsbColor__,
         @colorMaxes__,
@@ -1254,8 +1606,10 @@ module Processing
         @rectMode__,
         @ellipseMode__,
         @imageMode__,
+        @shapeMode__,
         @textAlignH__,
         @textAlignV__,
+        @textFont__,
         @tint__,
       ]
       block.call if block
@@ -1278,6 +1632,9 @@ module Processing
       @painter__.clip,
       @painter__.blend_mode,
       @painter__.font,
+      @painter__.texture,
+      @painter__.texcoord_mode,
+      @painter__.texcoord_wrap,
       @painter__.shader,
       @hsbColor__,
       @colorMaxes__,
@@ -1285,9 +1642,12 @@ module Processing
       @rectMode__,
       @ellipseMode__,
       @imageMode__,
+      @shapeMode__,
       @textAlignH__,
       @textAlignV__,
+      @textFont__,
       @tint__ = @styleStack__.pop
+      @textFont__.setSize__ @painter__.font.size
       nil
     end
 
@@ -1699,7 +2059,7 @@ module Processing
       rand (low || 0).to_f...(high || 1).to_f
     end
 
-    # Creates a new vector.
+    # Creates a new vector object.
     #
     # @overload createVector()
     # @overload createVector(x, y)
@@ -1715,7 +2075,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)
@@ -1732,6 +2102,67 @@ module Processing
       Image.new Rays::Image.new(w, h, colorspace).paint {background 0, 0}
     end
 
+    # Creates a new shape object.
+    #
+    # @overload createShape()
+    # @overload createShape(LINE, x1, y1, x2, y2)
+    # @overload createShape(RECT, a, b, c, d)
+    # @overload createShape(ELLIPSE, a, b, c, d)
+    # @overload createShape(ARC, a, b, c, d, start, stop)
+    # @overload createShape(TRIANGLE, x1, y1, x2, y2, x3, y3)
+    # @overload createShape(QUAD, x1, y1, x2, y2, x3, y3, x4, y4)
+    # @overload createShape(GROUP)
+    #
+    # @param kind [LINE, RECT, ELLIPSE, ARC, TRIANGLE, QUAD, GROUP]
+    #
+    def createShape(kind = nil, *args)
+      case kind
+      when LINE     then createLineShape__(    *args)
+      when RECT     then createRectShape__(    *args)
+      when ELLIPSE  then createEllipseShape__( *args)
+      when ARC      then createArcShape__(     *args)
+      when TRIANGLE then createTriangleShape__(*args)
+      when QUAD     then createQuadShape__(    *args)
+      when GROUP    then Shape.new nil, [], context: self
+      when nil      then Shape.new context: self
+      else raise ArgumentError, "Unknown shape kind '#{kind}'"
+      end
+    end
+
+    # @private
+    private def createLineShape__(x1, y1, x2, y2)
+      Shape.new Rays::Polygon.line(x1, y1, x2, y2), context: self
+    end
+
+    # @private
+    private def createRectShape__(a, b, c, d)
+      x, y, w, h = toXYWH__ @rectMode__, a, b, c, d
+      Shape.new Rays::Polygon.rect(x, y, w, h), context: self
+    end
+
+    # @private
+    private def createEllipseShape__(a, b, c, d)
+      x, y, w, h = toXYWH__ @ellipseMode__, a, b, c, d
+      Shape.new Rays::Polygon.ellipse(x, y, w, h), context: self
+    end
+
+    # @private
+    private def createArcShape__(a, b, c, d, start, stop)
+      x, y, w, h = toXYWH__ @ellipseMode__, a, b, c, d
+      from, to   = toDegrees__(-start), toDegrees__(-stop)
+      Shape.new Rays::Polygon.ellipse(x, y, w, h, from: from, to: to), context: self
+    end
+
+    # @private
+    private def createTriangleShape__(x1, y1, x2, y2, x3, y3)
+      Shape.new Rays::Polygon.new(x1, y1, x2, y2, x3, y3, loop: true), context: self
+    end
+
+    # @private
+    private def createQuadShape__(x1, y1, x2, y2, x3, y3, x4, y4)
+      Shape.new Rays::Polygon.quads(x1, y1, x2, y2, x3, y3, x4, y4), context: self
+    end
+
     # Creates a new off-screen graphics context object.
     #
     # @param width        [Numeric] width of graphics image
@@ -1790,6 +2221,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 p filename
+    end
+
     # Loads image.
     #
     # @param filename  [String] file name to load image
@@ -1797,11 +2245,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)
@@ -1817,10 +2293,7 @@ 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