processing 0.5.33 → 1.0.1

data/lib/processing/graphics_context.rb

@@ -70,6 +70,14 @@ module Processing
     #
     RADIUS  = :radius
 
+    # Mode for strokeCap() and strokeJoin().
+    #
+    ROUND   = :round
+
+    # Mode for strokeCap().
+    #
+    SQUARE  = :butt
+
     # Mode for strokeCap().
     #
     PROJECT = :square
@@ -80,11 +88,7 @@ module Processing
 
     # Mode for strokeCap() and strokeJoin().
     #
-    ROUND   = :round
-
-    # Mode for strokeCap() and strokeJoin().
-    #
-    SQUARE  = :butt
+    BEVEL   = :square
 
     # Mode for blendMode().
     #
@@ -123,96 +127,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
@@ -261,6 +296,158 @@ module Processing
     UP        = :up
     DOWN      = :down
 
+    COLOR_CODES = {
+      aliceblue:            '#f0f8ff',
+      antiquewhite:         '#faebd7',
+      aqua:                 '#00ffff',
+      aquamarine:           '#7fffd4',
+      azure:                '#f0ffff',
+      beige:                '#f5f5dc',
+      bisque:               '#ffe4c4',
+      black:                '#000000',
+      blanchedalmond:       '#ffebcd',
+      blue:                 '#0000ff',
+      blueviolet:           '#8a2be2',
+      brown:                '#a52a2a',
+      burlywood:            '#deb887',
+      cadetblue:            '#5f9ea0',
+      chartreuse:           '#7fff00',
+      chocolate:            '#d2691e',
+      coral:                '#ff7f50',
+      cornflowerblue:       '#6495ed',
+      cornsilk:             '#fff8dc',
+      crimson:              '#dc143c',
+      cyan:                 '#00ffff',
+      darkblue:             '#00008b',
+      darkcyan:             '#008b8b',
+      darkgoldenrod:        '#b8860b',
+      darkgray:             '#a9a9a9',
+      darkgreen:            '#006400',
+      darkgrey:             '#a9a9a9',
+      darkkhaki:            '#bdb76b',
+      darkmagenta:          '#8b008b',
+      darkolivegreen:       '#556b2f',
+      darkorange:           '#ff8c00',
+      darkorchid:           '#9932cc',
+      darkred:              '#8b0000',
+      darksalmon:           '#e9967a',
+      darkseagreen:         '#8fbc8f',
+      darkslateblue:        '#483d8b',
+      darkslategray:        '#2f4f4f',
+      darkslategrey:        '#2f4f4f',
+      darkturquoise:        '#00ced1',
+      darkviolet:           '#9400d3',
+      deeppink:             '#ff1493',
+      deepskyblue:          '#00bfff',
+      dimgray:              '#696969',
+      dimgrey:              '#696969',
+      dodgerblue:           '#1e90ff',
+      firebrick:            '#b22222',
+      floralwhite:          '#fffaf0',
+      forestgreen:          '#228b22',
+      fuchsia:              '#ff00ff',
+      gainsboro:            '#dcdcdc',
+      ghostwhite:           '#f8f8ff',
+      goldenrod:            '#daa520',
+      gold:                 '#ffd700',
+      gray:                 '#808080',
+      green:                '#008000',
+      greenyellow:          '#adff2f',
+      grey:                 '#808080',
+      honeydew:             '#f0fff0',
+      hotpink:              '#ff69b4',
+      indianred:            '#cd5c5c',
+      indigo:               '#4b0082',
+      ivory:                '#fffff0',
+      khaki:                '#f0e68c',
+      lavenderblush:        '#fff0f5',
+      lavender:             '#e6e6fa',
+      lawngreen:            '#7cfc00',
+      lemonchiffon:         '#fffacd',
+      lightblue:            '#add8e6',
+      lightcoral:           '#f08080',
+      lightcyan:            '#e0ffff',
+      lightgoldenrodyellow: '#fafad2',
+      lightgray:            '#d3d3d3',
+      lightgreen:           '#90ee90',
+      lightgrey:            '#d3d3d3',
+      lightpink:            '#ffb6c1',
+      lightsalmon:          '#ffa07a',
+      lightseagreen:        '#20b2aa',
+      lightskyblue:         '#87cefa',
+      lightslategray:       '#778899',
+      lightslategrey:       '#778899',
+      lightsteelblue:       '#b0c4de',
+      lightyellow:          '#ffffe0',
+      lime:                 '#00ff00',
+      limegreen:            '#32cd32',
+      linen:                '#faf0e6',
+      magenta:              '#ff00ff',
+      maroon:               '#800000',
+      mediumaquamarine:     '#66cdaa',
+      mediumblue:           '#0000cd',
+      mediumorchid:         '#ba55d3',
+      mediumpurple:         '#9370db',
+      mediumseagreen:       '#3cb371',
+      mediumslateblue:      '#7b68ee',
+      mediumspringgreen:    '#00fa9a',
+      mediumturquoise:      '#48d1cc',
+      mediumvioletred:      '#c71585',
+      midnightblue:         '#191970',
+      mintcream:            '#f5fffa',
+      mistyrose:            '#ffe4e1',
+      moccasin:             '#ffe4b5',
+      navajowhite:          '#ffdead',
+      navy:                 '#000080',
+      oldlace:              '#fdf5e6',
+      olive:                '#808000',
+      olivedrab:            '#6b8e23',
+      orange:               '#ffa500',
+      orangered:            '#ff4500',
+      orchid:               '#da70d6',
+      palegoldenrod:        '#eee8aa',
+      palegreen:            '#98fb98',
+      paleturquoise:        '#afeeee',
+      palevioletred:        '#db7093',
+      papayawhip:           '#ffefd5',
+      peachpuff:            '#ffdab9',
+      peru:                 '#cd853f',
+      pink:                 '#ffc0cb',
+      plum:                 '#dda0dd',
+      powderblue:           '#b0e0e6',
+      purple:               '#800080',
+      rebeccapurple:        '#663399',
+      red:                  '#ff0000',
+      rosybrown:            '#bc8f8f',
+      royalblue:            '#4169e1',
+      saddlebrown:          '#8b4513',
+      salmon:               '#fa8072',
+      sandybrown:           '#f4a460',
+      seagreen:             '#2e8b57',
+      seashell:             '#fff5ee',
+      sienna:               '#a0522d',
+      silver:               '#c0c0c0',
+      skyblue:              '#87ceeb',
+      slateblue:            '#6a5acd',
+      slategray:            '#708090',
+      slategrey:            '#708090',
+      snow:                 '#fffafa',
+      springgreen:          '#00ff7f',
+      steelblue:            '#4682b4',
+      tan:                  '#d2b48c',
+      teal:                 '#008080',
+      thistle:              '#d8bfd8',
+      tomato:               '#ff6347',
+      turquoise:            '#40e0d0',
+      violet:               '#ee82ee',
+      wheat:                '#f5deb3',
+      white:                '#ffffff',
+      whitesmoke:           '#f5f5f5',
+      yellow:               '#ffff00',
+      yellowgreen:          '#9acd32',
+      none:                 '#00000000',
+    }
+
     # @private
     DEG2RAD__ = Math::PI / 180.0
 
@@ -382,6 +569,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
@@ -390,6 +580,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
@@ -398,6 +591,8 @@ module Processing
     #
     # @return [Numeric] width
     #
+    # @see https://processing.org/reference/pixelWidth.html
+    #
     def pixelWidth()
       width * pixelDensity
     end
@@ -406,6 +601,8 @@ module Processing
     #
     # @return [Numeric] height
     #
+    # @see https://processing.org/reference/pixelHeight.html
+    #
     def pixelHeight()
       height * pixelDensity
     end
@@ -414,6 +611,9 @@ 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
@@ -448,6 +648,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
@@ -479,18 +682,33 @@ 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}
         .then {|r, g, b, a| Image.toColor__ r, g, b, a}
     end
 
+    # @private
+    private def color2raw__(color)
+      Rays::Color.new(
+        ((color >> 16) & 0xff) / 255.0,
+        ((color >> 8)  & 0xff) / 255.0,
+        ( color        & 0xff) / 255.0,
+        ((color >> 24) & 0xff) / 255.0)
+    end
+
     # Returns the red value of the color.
     #
     # @param color [Numeric] color value
     #
     # @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
@@ -501,6 +719,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
@@ -511,6 +732,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
@@ -521,6 +745,9 @@ 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
@@ -531,8 +758,11 @@ module Processing
     #
     # @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, = color2raw__(color).to_hsv
       h * (@hsbColor__ ? @colorMaxes__[0] : 1)
     end
 
@@ -542,8 +772,11 @@ module Processing
     #
     # @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, = color2raw__(color).to_hsv
       s * (@hsbColor__ ? @colorMaxes__[1] : 1)
     end
 
@@ -553,37 +786,46 @@ module Processing
     #
     # @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 = color2raw__(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)
-      rawColor__(*args).to_a
+      toRawColor__(*args).to_a
     end
 
     # @private
-    def rawColor__(*args)
+    def toRawColor__(*args)
       a, b, c, d = args
-      rgba = case args.size
+      return parseColor__(a, b || alphaMax__) if a.is_a?(String) || a.is_a?(Symbol)
+      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]}
+      rgba = rgba.map.with_index {|n, i| n / @colorMaxes__[i]}
       @hsbColor__ ? Rays::Color.hsv(*rgba) : Rays::Color.new(*rgba)
     end
 
     # @private
     private def parseColor__(str, alpha)
-      result = str.match(/^\s*##{'([0-9a-f]{2})' * 3}\s*$/i)
-      raise ArgumentError, "invalid color code: '#{str}'" unless result
-
-      rgb = result[1..3].map.with_index {|hex, i| hex.to_i(16) / 255.0}
-      return *rgb, (alpha / alphaMax__)
+      str        = COLOR_CODES[str.downcase.to_sym] || str if str !~ /^\s*#\d+/
+      r, g, b, a =
+        case str
+        when /^\s*##{'([0-9a-f]{2})' * 3}([0-9a-f]{2})?\s*$/i
+          $~[1..4].map {|n| n.to_i(16) / 255.0 if n}
+        when /^\s*##{'([0-9a-f]{1})' * 3}([0-9a-f]{1})?\s*$/i
+          $~[1..4].map {|n| n.to_i(16) / 15.0  if n}
+        else
+          raise ArgumentError, "invalid color code: '#{str}'"
+        end
+      Rays::Color.new(r, g, b, a || (alpha / alphaMax__))
     end
 
     # @private
@@ -591,21 +833,14 @@ 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
@@ -650,6 +885,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
@@ -665,6 +903,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
@@ -679,6 +920,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
@@ -693,6 +937,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/shapeMode_.html
+    #
     def shapeMode(mode)
       @shapeMode__ = mode
     end
@@ -714,6 +960,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
@@ -740,20 +989,21 @@ 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
     end
 
-    # @private
-    def getFill__()
-      @painter__.fill
-    end
-
     # Disables filling.
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/noFill_.html
+    # @see https://p5js.org/reference/#/p5/noFill
+    #
     def noFill()
       @painter__.fill nil
       nil
@@ -777,6 +1027,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
@@ -786,6 +1039,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
@@ -797,28 +1053,39 @@ 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
     end
 
     # Sets stroke cap mode.
+    # The default cap if ROUND.
     #
-    # @param cap [BUTT, ROUND, SQUARE]
+    # @param cap [ROUND, SQUARE, PROJECT]
     #
     # @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
     end
 
     # Sets stroke join mode.
+    # The default join is MITER.
     #
-    # @param join [MITER, ROUND, SQUARE]
+    # @param join [MITER, BEVEL, ROUND]
     #
     # @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
@@ -888,6 +1155,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
@@ -897,6 +1167,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
@@ -917,6 +1190,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
@@ -927,6 +1203,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/noClip_.html
+    #
     def noClip()
       @painter__.no_clip
       nil
@@ -947,6 +1225,9 @@ module Processing
     #
     # @return [Font] current font
     #
+    # @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__
@@ -967,25 +1248,63 @@ 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.
@@ -997,11 +1316,23 @@ module Processing
     #
     # @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
@@ -1050,6 +1381,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
@@ -1059,6 +1393,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
@@ -1074,8 +1411,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.
@@ -1096,6 +1439,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)
@@ -1122,6 +1468,9 @@ 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__.point x, y
@@ -1139,6 +1488,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
@@ -1167,6 +1519,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
@@ -1192,6 +1547,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
@@ -1209,6 +1567,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
@@ -1228,6 +1589,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
@@ -1246,6 +1610,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
@@ -1263,6 +1630,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
@@ -1284,6 +1654,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
@@ -1305,6 +1678,9 @@ 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__
@@ -1328,6 +1704,9 @@ 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__
@@ -1356,6 +1735,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
@@ -1394,6 +1776,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
@@ -1418,6 +1803,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
@@ -1604,6 +1991,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
@@ -1626,6 +2016,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__(
@@ -1637,6 +2030,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
@@ -1645,6 +2041,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/updatePixels_.html
+    # @see https://p5js.org/reference/#/p5/updatePixels
+    #
     def updatePixels(&block)
       return if !block && !@pixels__
       if block
@@ -1661,6 +2060,11 @@ module Processing
     # 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
@@ -1671,6 +2075,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
@@ -1683,10 +2090,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
@@ -1697,13 +2107,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
@@ -1716,30 +2131,69 @@ 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(
@@ -1747,8 +2201,18 @@ module Processing
         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(
@@ -1756,12 +2220,15 @@ module Processing
         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
@@ -1774,6 +2241,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/popMatrix_.html
+    #
     def popMatrix()
       assertDrawing__
       raise "matrix stack underflow" if @matrixStack__.empty?
@@ -1807,6 +2276,9 @@ module Processing
     #
     # @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)
@@ -1830,6 +2302,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/resetMatrix_.html
+    # @see https://p5js.org/reference/#/p5/resetMatrix
+    #
     def resetMatrix()
       assertDrawing__
       @painter__.matrix = 1
@@ -1840,6 +2315,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/printMatrix_.html
+    #
     def printMatrix()
       m = @painter__.matrix
       m.transpose! if @p5jsMode__
@@ -1851,6 +2328,8 @@ module Processing
     #
     # @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 [
@@ -1898,6 +2377,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/popStyle_.html
+    #
     def popStyle()
       assertDrawing__
       raise "style stack underflow" if @styleStack__.empty?
@@ -1943,6 +2424,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
@@ -1955,11 +2439,19 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/pop_.html
+    # @see https://p5js.org/reference/#/p5/pop
+    #
     def pop()
       popMatrix
       popStyle
     end
 
+    # @private
+    def getPainter__()
+      @painter__
+    end
+
     # @private
     def getInternal__()
       @image__
@@ -1988,6 +2480,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
@@ -1998,6 +2493,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
@@ -2008,6 +2506,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
@@ -2018,6 +2519,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
@@ -2028,6 +2532,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
@@ -2038,6 +2545,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
@@ -2049,6 +2559,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
@@ -2059,6 +2572,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
@@ -2069,6 +2585,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
@@ -2084,6 +2603,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
@@ -2107,6 +2629,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
@@ -2129,6 +2654,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
@@ -2141,6 +2669,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
@@ -2153,6 +2684,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),
@@ -2171,6 +2705,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
@@ -2188,6 +2725,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
@@ -2205,6 +2745,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
@@ -2217,6 +2760,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
@@ -2227,6 +2773,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
@@ -2237,6 +2786,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
@@ -2247,6 +2799,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
@@ -2257,6 +2812,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
@@ -2267,6 +2825,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
@@ -2277,6 +2838,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
@@ -2287,6 +2851,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
@@ -2297,6 +2864,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
@@ -2308,6 +2878,9 @@ 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
@@ -2540,6 +3113,8 @@ module Processing
     #
     # @return [Vector] new vector
     #
+    # @see https://p5js.org/reference/#/p5/createVector
+    #
     def createVector(*args)
       Vector.new(*args, context: self)
     end
@@ -2549,6 +3124,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__)
@@ -2565,6 +3144,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
@@ -2584,6 +3166,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)
@@ -2599,19 +3185,19 @@ module Processing
     end
 
     # @private
-    private def createLineShape__(x1, y1, x2, y2)
+    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
+    def createRectShape__(a, b, c, d, *args, mode: @rectMode__)
+      x, y, w, h = toXYWH__ mode, a, b, c, d
+      Shape.new Rays::Polygon.rect(x, y, w, h, *args), context: self
     end
 
     # @private
-    private def createEllipseShape__(a, b, c, d)
-      x, y, w, h = toXYWH__ @ellipseMode__, a, b, c, d
+    def createEllipseShape__(a, b, c, d, mode: @ellipseMode__)
+      x, y, w, h = toXYWH__ mode, a, b, c, d
       Shape.new Rays::Polygon.ellipse(x, y, w, h), context: self
     end
 
@@ -2640,6 +3226,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
@@ -2676,6 +3265,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)
@@ -2747,6 +3338,10 @@ module Processing
       img
     end
 
+    def loadShape(filename)
+      Processing::SVGLoader.new(self).load filename
+    end
+
     # Loads shader file.
     #
     # @overload loadShader(fragPath)
@@ -2757,6 +3352,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