processing 0.5.33 → 0.5.34

data/lib/processing/graphics_context.rb

@@ -123,96 +123,127 @@ module Processing
     REPLACE   = :replace
 
     # Key code or Mode for textAlign().
+    #
     LEFT     = :left
 
     # Key code or Mode for textAlign().
+    #
     RIGHT    = :right
 
     # Mode for textAlign().
+    #
     TOP      = :top
 
     # Mode for textAlign().
+    #
     BOTTOM   = :bottom
 
     # Mode for textAlign().
+    #
     BASELINE = :baseline
 
     # Mode for textureMode().
+    #
     IMAGE  = :image
 
     # Mode for textureMode().
+    #
     NORMAL = :normal
 
     # Mode for textureWrap().
+    #
     CLAMP  = :clamp
 
     # Mode for textureWrap().
+    #
     REPEAT = :repeat
 
     # Filter type for filter()
+    #
     THRESHOLD = :threshold
 
     # Filter type for filter()
+    #
     GRAY      = :gray
 
     # Filter type for filter()
+    #
     INVERT    = :invert
 
     # Filter type for filter()
+    #
     BLUR      = :blur
 
     # Shape mode for createShape()
+    #
     LINE     = :line
 
     # Shape mode for createShape()
+    #
     RECT     = :rect
 
     # Shape mode for createShape()
+    #
     ELLIPSE  = :ellipse
 
     # Shape mode for createShape()
+    #
     ARC      = :arc
 
     # Shape mode for createShape()
+    #
     TRIANGLE = :triangle
 
     # Shape mode for createShape()
+    #
     QUAD     = :quad
 
     # Shape mode for createShape()
+    #
     GROUP    = :group
 
     # Shape mode for beginShape()
+    #
     POINTS         = :points
 
     # Shape mode for beginShape()
+    #
     LINES          = :lines
 
     # Shape mode for beginShape()
+    #
     TRIANGLES      = :triangles
 
     # Shape mode for beginShape()
+    #
     TRIANGLE_FAN   = :triangle_fan
 
     # Shape mode for beginShape()
+    #
     TRIANGLE_STRIP = :triangle_strip
 
     # Shape mode for beginShape()
+    #
     QUADS          = :quads
 
     # Shape mode for beginShape()
+    #
     QUAD_STRIP     = :quad_strip
 
     # Shape mode for beginShape()
+    #
     TESS           = :tess
 
     # OPEN flag for endShape()
+    #
     OPEN           = :open
 
     # CLOSE flag for endShape()
+    #
     CLOSE          = :close
 
     # Key codes.
+    #
     ENTER     = :enter
     SPACE     = :space
     TAB       = :tab
@@ -382,6 +413,9 @@ module Processing
     #
     # @return [Numeric] width
     #
+    # @see https://processing.org/reference/width.html
+    # @see https://p5js.org/reference/#/p5/width
+    #
     def width()
       getInternal__.width
     end
@@ -390,6 +424,9 @@ module Processing
     #
     # @return [Numeric] height
     #
+    # @see https://processing.org/reference/height.html
+    # @see https://p5js.org/reference/#/p5/height
+    #
     def height()
       getInternal__.height
     end
@@ -398,6 +435,8 @@ module Processing
     #
     # @return [Numeric] width
     #
+    # @see https://processing.org/reference/pixelWidth.html
+    #
     def pixelWidth()
       width * pixelDensity
     end
@@ -406,6 +445,8 @@ module Processing
     #
     # @return [Numeric] height
     #
+    # @see https://processing.org/reference/pixelHeight.html
+    #
     def pixelHeight()
       height * pixelDensity
     end
@@ -414,6 +455,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 +492,9 @@ module Processing
     #
     # @return [RGB, HSB] current mode
     #
+    # @see https://processing.org/reference/colorMode_.html
+    # @see https://p5js.org/reference/#/p5/colorMode
+    #
     def colorMode(mode = nil, *maxes)
       if mode != nil
         mode = mode.downcase.to_sym
@@ -479,6 +526,9 @@ module Processing
     #
     # @return [Integer] the rgba color value
     #
+    # @see https://processing.org/reference/color_.html
+    # @see https://p5js.org/reference/#/p5/color
+    #
     def color(*args)
       toRGBA__(*args)
         .map {|n| (n * 255).to_i.clamp 0, 255}
@@ -491,6 +541,9 @@ module Processing
     #
     # @return [Numeric] the red value
     #
+    # @see https://processing.org/reference/red_.html
+    # @see https://p5js.org/reference/#/p5/red
+    #
     def red(color)
       ((color >> 16) & 0xff) / 255.0 * @colorMaxes__[0]
     end
@@ -501,6 +554,9 @@ module Processing
     #
     # @return [Numeric] the green value
     #
+    # @see https://processing.org/reference/green_.html
+    # @see https://p5js.org/reference/#/p5/green
+    #
     def green(color)
       ((color >> 8) & 0xff) / 255.0 * @colorMaxes__[1]
     end
@@ -511,6 +567,9 @@ module Processing
     #
     # @return [Numeric] the blue value
     #
+    # @see https://processing.org/reference/blue_.html
+    # @see https://p5js.org/reference/#/p5/blue
+    #
     def blue(color)
       (color & 0xff) / 255.0 * @colorMaxes__[2]
     end
@@ -521,6 +580,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,6 +593,9 @@ 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 * (@hsbColor__ ? @colorMaxes__[0] : 1)
@@ -542,6 +607,9 @@ 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 * (@hsbColor__ ? @colorMaxes__[1] : 1)
@@ -553,6 +621,9 @@ 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 * (@hsbColor__ ? @colorMaxes__[2] : 1)
@@ -606,6 +677,8 @@ module Processing
     #
     # @return [RADIANS, DEGREES] current mode
     #
+    # @see https://p5js.org/reference/#/p5/angleMode
+    #
     def angleMode(mode = nil)
       if mode != nil
         @angleMode__  = mode
@@ -650,6 +723,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/rectMode_.html
+    # @see https://p5js.org/reference/#/p5/rectMode
+    #
     def rectMode(mode)
       @rectMode__ = mode
     end
@@ -665,6 +741,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/ellipseMode_.html
+    # @see https://p5js.org/reference/#/p5/ellipseMode
+    #
     def ellipseMode(mode)
       @ellipseMode__ = mode
     end
@@ -679,6 +758,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/imageMode_.html
+    # @see https://p5js.org/reference/#/p5/imageMode
+    #
     def imageMode(mode)
       @imageMode__ = mode
     end
@@ -693,6 +775,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/shapeMode_.html
+    #
     def shapeMode(mode)
       @shapeMode__ = mode
     end
@@ -714,6 +798,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/blendMode_.html
+    # @see https://p5js.org/reference/#/p5/blendMode
+    #
     def blendMode(mode = nil)
       if mode != nil
         @blendMode__          = mode
@@ -740,6 +827,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/fill_.html
+    # @see https://p5js.org/reference/#/p5/fill
+    #
     def fill(*args)
       @painter__.fill(*toRGBA__(*args))
       nil
@@ -754,6 +844,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/noFill_.html
+    # @see https://p5js.org/reference/#/p5/noFill
+    #
     def noFill()
       @painter__.fill nil
       nil
@@ -777,6 +870,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/stroke_.html
+    # @see https://p5js.org/reference/#/p5/stroke
+    #
     def stroke(*args)
       @painter__.stroke(*toRGBA__(*args))
       nil
@@ -786,6 +882,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/noStroke_.html
+    # @see https://p5js.org/reference/#/p5/noStroke
+    #
     def noStroke()
       @painter__.stroke nil
       nil
@@ -797,6 +896,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/strokeWeight_.html
+    # @see https://p5js.org/reference/#/p5/strokeWeight
+    #
     def strokeWeight(weight)
       @painter__.stroke_width weight
       nil
@@ -808,6 +910,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/strokeCap_.html
+    # @see https://p5js.org/reference/#/p5/strokeCap
+    #
     def strokeCap(cap)
       @painter__.stroke_cap cap
       nil
@@ -819,6 +924,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/strokeJoin_.html
+    # @see https://p5js.org/reference/#/p5/strokeJoin
+    #
     def strokeJoin(join)
       @painter__.stroke_join join
       nil
@@ -888,6 +996,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/tint_.html
+    # @see https://p5js.org/reference/#/p5/tint
+    #
     def tint(*args)
       @tint__ = args
       nil
@@ -897,6 +1008,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/noTint_.html
+    # @see https://p5js.org/reference/#/p5/noTint
+    #
     def noTint()
       @tint__ = nil
     end
@@ -917,6 +1031,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/clip_.html
+    # @see https://p5js.org/reference/#/p5/clip
+    #
     def clip(a, b, c, d)
       x, y, w, h = toXYWH__ @imageMode__, a, b, c, d
       @painter__.clip x, y, w, h
@@ -927,6 +1044,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/noClip_.html
+    #
     def noClip()
       @painter__.no_clip
       nil
@@ -947,6 +1066,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 +1089,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 +1157,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 +1222,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/shader_.html
+    # @see https://p5js.org/reference/#/p5/shader
+    #
     def shader(shader)
       @painter__.shader shader&.getInternal__
       nil
@@ -1059,6 +1234,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/resetShader_.html
+    # @see https://p5js.org/reference/#/p5/resetShader
+    #
     def resetShader()
       @painter__.no_shader
       nil
@@ -1074,8 +1252,14 @@ module Processing
     # @param type   [THRESHOLD, GRAY, INVERT, BLUR] filter type
     # @param param  [Numeric] a parameter for each filter
     #
+    # @return [nil] nil
+    #
+    # @see https://processing.org/reference/filter_.html
+    # @see https://p5js.org/reference/#/p5/filter
+    #
     def filter(*args)
       @filter__ = Shader.createFilter__(*args)
+      nil
     end
 
     # Clears screen.
@@ -1096,6 +1280,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/background_.html
+    # @see https://p5js.org/reference/#/p5/background
+    #
     def background(*args)
       assertDrawing__
       rgba = toRGBA__(*args)
@@ -1122,6 +1309,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 +1329,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/line_.html
+    # @see https://p5js.org/reference/#/p5/line
+    #
     def line(x1, y1, x2, y2)
       assertDrawing__
       @painter__.line x1, y1, x2, y2
@@ -1167,6 +1360,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/rect_.html
+    # @see https://p5js.org/reference/#/p5/rect
+    #
     def rect(a, b, c, d, *args)
       assertDrawing__
       x, y, w, h = toXYWH__ @rectMode__, a, b, c, d
@@ -1192,6 +1388,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/ellipse_.html
+    # @see https://p5js.org/reference/#/p5/ellipse
+    #
     def ellipse(a, b, c, d)
       assertDrawing__
       x, y, w, h = toXYWH__ @ellipseMode__, a, b, c, d
@@ -1209,6 +1408,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/circle_.html
+    # @see https://p5js.org/reference/#/p5/circle
+    #
     def circle(x, y, extent)
       ellipse x, y, extent, extent
     end
@@ -1228,6 +1430,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/arc_.html
+    # @see https://p5js.org/reference/#/p5/arc
+    #
     def arc(a, b, c, d, start, stop)
       assertDrawing__
       x, y, w, h = toXYWH__ @ellipseMode__, a, b, c, d
@@ -1246,6 +1451,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/square_.html
+    # @see https://p5js.org/reference/#/p5/square
+    #
     def square(x, y, extent)
       rect x, y, extent, extent
     end
@@ -1263,6 +1471,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/triangle_.html
+    # @see https://p5js.org/reference/#/p5/triangle
+    #
     def triangle(x1, y1, x2, y2, x3, y3)
       assertDrawing__
       @painter__.line x1, y1, x2, y2, x3, y3, loop: true
@@ -1284,6 +1495,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/quad_.html
+    # @see https://p5js.org/reference/#/p5/quad
+    #
     def quad(x1, y1, x2, y2, x3, y3, x4, y4)
       assertDrawing__
       @painter__.line x1, y1, x2, y2, x3, y3, x4, y4, loop: true
@@ -1305,6 +1519,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 +1545,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 +1576,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/text_.html
+    # @see https://p5js.org/reference/#/p5/text
+    #
     def text(str, x, y, x2 = nil, y2 = nil)
       assertDrawing__
       if x2
@@ -1394,6 +1617,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/image_.html
+    # @see https://p5js.org/reference/#/p5/image
+    #
     def image(img, a, b, c = nil, d = nil)
       assertDrawing__
       x, y, w, h = toXYWH__ @imageMode__, a, b, c || img.width, d || img.height
@@ -1418,6 +1644,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/shape_.html
+    #
     def shape(shp, a = 0, b = 0, c = nil, d = nil)
       assertDrawing__
       return nil unless shp.isVisible
@@ -1604,6 +1832,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/copy_.html
+    # @see https://p5js.org/reference/#/p5/copy
+    #
     def copy(img = nil, sx, sy, sw, sh, dx, dy, dw, dh)
       blend img, sx, sy, sw, sh, dx, dy, dw, dh, BLEND
     end
@@ -1626,6 +1857,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/blend_.html
+    # @see https://p5js.org/reference/#/p5/blend
+    #
     def blend(img = nil, sx, sy, sw, sh, dx, dy, dw, dh, mode)
       assertDrawing__
       (img || self).drawImage__(
@@ -1637,6 +1871,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/loadPixels_.html
+    # @see https://p5js.org/reference/#/p5/loadPixels
+    #
     def loadPixels()
       @pixels__ = getInternal__.pixels
     end
@@ -1645,6 +1882,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 +1901,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 +1916,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/save_.html
+    # @see https://p5js.org/reference/#/p5/save
+    #
     def save(filename)
       getInternal__.save filename
       nil
@@ -1683,10 +1931,13 @@ module Processing
     #
     # @param x [Numeric] left/right translation
     # @param y [Numeric] up/down translation
-    # @param y [Numeric] forward/backward translation
+    # @param z [Numeric] forward/backward translation
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/translate_.html
+    # @see https://p5js.org/reference/#/p5/translate
+    #
     def translate(x, y, z = 0)
       assertDrawing__
       @painter__.translate x, y, z
@@ -1697,13 +1948,18 @@ module Processing
     #
     # @overload scale(s)
     # @overload scale(x, y)
+    # @overload scale(x, y, z)
     #
     # @param s [Numeric] horizontal and vertical scale
     # @param x [Numeric] horizontal scale
     # @param y [Numeric] vertical scale
+    # @param z [Numeric] depth scale
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/scale_.html
+    # @see https://p5js.org/reference/#/p5/scale
+    #
     def scale(x, y = nil, z = 1)
       assertDrawing__
       @painter__.scale x, (y || x), z
@@ -1716,30 +1972,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 +2042,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 +2061,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 +2082,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 +2117,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 +2143,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 +2156,8 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/printMatrix_.html
+    #
     def printMatrix()
       m = @painter__.matrix
       m.transpose! if @p5jsMode__
@@ -1851,6 +2169,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 +2218,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 +2265,9 @@ module Processing
     #
     # @return [Object] result of the expression at the end of the block
     #
+    # @see https://processing.org/reference/push_.html
+    # @see https://p5js.org/reference/#/p5/push
+    #
     def push(&block)
       pushMatrix
       pushStyle
@@ -1955,6 +2280,9 @@ module Processing
     #
     # @return [nil] nil
     #
+    # @see https://processing.org/reference/pop_.html
+    # @see https://p5js.org/reference/#/p5/pop
+    #
     def pop()
       popMatrix
       popStyle
@@ -1988,6 +2316,9 @@ module Processing
     #
     # @return [Numeric] absolute number
     #
+    # @see https://processing.org/reference/abs_.html
+    # @see https://p5js.org/reference/#/p5/abs
+    #
     def abs(value)
       value.abs
     end
@@ -1998,6 +2329,9 @@ module Processing
     #
     # @return [Numeric] rounded up number
     #
+    # @see https://processing.org/reference/ceil_.html
+    # @see https://p5js.org/reference/#/p5/ceil
+    #
     def ceil(value)
       value.ceil
     end
@@ -2008,6 +2342,9 @@ module Processing
     #
     # @return [Numeric] rounded down number
     #
+    # @see https://processing.org/reference/floor_.html
+    # @see https://p5js.org/reference/#/p5/floor
+    #
     def floor(value)
       value.floor
     end
@@ -2018,6 +2355,9 @@ module Processing
     #
     # @return [Numeric] rounded number
     #
+    # @see https://processing.org/reference/round_.html
+    # @see https://p5js.org/reference/#/p5/round
+    #
     def round(value)
       value.round
     end
@@ -2028,6 +2368,9 @@ module Processing
     #
     # @return [Numeric] result number
     #
+    # @see https://processing.org/reference/log_.html
+    # @see https://p5js.org/reference/#/p5/log
+    #
     def log(n)
       Math.log n
     end
@@ -2038,6 +2381,9 @@ module Processing
     #
     # @return [Numeric] result number
     #
+    # @see https://processing.org/reference/exp_.html
+    # @see https://p5js.org/reference/#/p5/exp
+    #
     def exp(n)
       Math.exp n
     end
@@ -2049,6 +2395,9 @@ module Processing
     #
     # @return [Numeric] value ** exponent
     #
+    # @see https://processing.org/reference/pow_.html
+    # @see https://p5js.org/reference/#/p5/pow
+    #
     def pow(value, exponent)
       value ** exponent
     end
@@ -2059,6 +2408,9 @@ module Processing
     #
     # @return [Numeric] squared value
     #
+    # @see https://processing.org/reference/sq_.html
+    # @see https://p5js.org/reference/#/p5/sq
+    #
     def sq(value)
       value * value
     end
@@ -2069,6 +2421,9 @@ module Processing
     #
     # @return [Numeric] squared value
     #
+    # @see https://processing.org/reference/sqrt_.html
+    # @see https://p5js.org/reference/#/p5/sqrt
+    #
     def sqrt(value)
       Math.sqrt value
     end
@@ -2084,6 +2439,9 @@ module Processing
     #
     # @return [Numeric] magnitude
     #
+    # @see https://processing.org/reference/mag_.html
+    # @see https://p5js.org/reference/#/p5/mag
+    #
     def mag(*args)
       x, y, z = *args
       case args.size
@@ -2107,6 +2465,9 @@ module Processing
     #
     # @return [Numeric] distance between 2 points
     #
+    # @see https://processing.org/reference/dist_.html
+    # @see https://p5js.org/reference/#/p5/dist
+    #
     def dist(*args)
       case args.size
       when 4
@@ -2129,6 +2490,9 @@ module Processing
     #
     # @return [Numeric] normalized value between 0..1
     #
+    # @see https://processing.org/reference/norm_.html
+    # @see https://p5js.org/reference/#/p5/norm
+    #
     def norm(value, start, stop)
       (value.to_f - start.to_f) / (stop.to_f - start.to_f)
     end
@@ -2141,6 +2505,9 @@ module Processing
     #
     # @return [Numeric] interporated number
     #
+    # @see https://processing.org/reference/lerp_.html
+    # @see https://p5js.org/reference/#/p5/lerp
+    #
     def lerp(start, stop, amount)
       start + (stop - start) * amount
     end
@@ -2153,6 +2520,9 @@ module Processing
     #
     # @return [Integer] interporated color
     #
+    # @see https://processing.org/reference/lerpColor_.html
+    # @see https://p5js.org/reference/#/p5/lerpColor
+    #
     def lerpColor(color1, color2, amount)
       color(
         lerp(red(  color1), red(  color2), amount),
@@ -2171,6 +2541,9 @@ module Processing
     #
     # @return [Numeric] mapped number
     #
+    # @see https://processing.org/reference/map_.html
+    # @see https://p5js.org/reference/#/p5/map
+    #
     def map(value, start1, stop1, start2, stop2)
       lerp start2, stop2, norm(value, start1, stop1)
     end
@@ -2188,6 +2561,9 @@ module Processing
     #
     # @return [Numeric] minimum value
     #
+    # @see https://processing.org/reference/min_.html
+    # @see https://p5js.org/reference/#/p5/min
+    #
     def min(*args)
       args.flatten.min
     end
@@ -2205,6 +2581,9 @@ module Processing
     #
     # @return [Numeric] maximum value
     #
+    # @see https://processing.org/reference/max_.html
+    # @see https://p5js.org/reference/#/p5/max
+    #
     def max(*args)
       args.flatten.max
     end
@@ -2217,6 +2596,9 @@ module Processing
     #
     # @return [Numeric] constrained number
     #
+    # @see https://processing.org/reference/constrain_.html
+    # @see https://p5js.org/reference/#/p5/constrain
+    #
     def constrain(value, min, max)
       value < min ? min : (value > max ? max : value)
     end
@@ -2227,6 +2609,9 @@ module Processing
     #
     # @return [Numeric] radian
     #
+    # @see https://processing.org/reference/radians_.html
+    # @see https://p5js.org/reference/#/p5/radians
+    #
     def radians(degree)
       degree * DEG2RAD__
     end
@@ -2237,6 +2622,9 @@ module Processing
     #
     # @return [Numeric] degree
     #
+    # @see https://processing.org/reference/degrees_.html
+    # @see https://p5js.org/reference/#/p5/degrees
+    #
     def degrees(radian)
       radian * RAD2DEG__
     end
@@ -2247,6 +2635,9 @@ module Processing
     #
     # @return [Numeric] the sine
     #
+    # @see https://processing.org/reference/sin_.html
+    # @see https://p5js.org/reference/#/p5/sin
+    #
     def sin(angle)
       Math.sin angle
     end
@@ -2257,6 +2648,9 @@ module Processing
     #
     # @return [Numeric] the cosine
     #
+    # @see https://processing.org/reference/cos_.html
+    # @see https://p5js.org/reference/#/p5/cos
+    #
     def cos(angle)
       Math.cos angle
     end
@@ -2267,6 +2661,9 @@ module Processing
     #
     # @return [Numeric] the tangent
     #
+    # @see https://processing.org/reference/tan_.html
+    # @see https://p5js.org/reference/#/p5/tan
+    #
     def tan(angle)
       Math.tan angle
     end
@@ -2277,6 +2674,9 @@ module Processing
     #
     # @return [Numeric] the arc sine
     #
+    # @see https://processing.org/reference/asin_.html
+    # @see https://p5js.org/reference/#/p5/asin
+    #
     def asin(value)
       Math.asin value
     end
@@ -2287,6 +2687,9 @@ module Processing
     #
     # @return [Numeric] the arc cosine
     #
+    # @see https://processing.org/reference/acos_.html
+    # @see https://p5js.org/reference/#/p5/acos
+    #
     def acos(value)
       Math.acos value
     end
@@ -2297,6 +2700,9 @@ module Processing
     #
     # @return [Numeric] the arc tangent
     #
+    # @see https://processing.org/reference/atan_.html
+    # @see https://p5js.org/reference/#/p5/atan
+    #
     def atan(value)
       Math.atan value
     end
@@ -2308,6 +2714,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 +2949,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 +2960,10 @@ module Processing
     # @param name [String]  font name
     # @param size [Numeric] font size (max 256)
     #
+    # @return [Font] new font
+    #
+    # @see https://processing.org/reference/createFont_.html
+    #
     def createFont(name, size)
       size = FONT_SIZE_MAX__ if size && size > FONT_SIZE_MAX__
       Font.new Rays::Font.new(name, size || FONT_SIZE_DEFAULT__)
@@ -2565,6 +2980,9 @@ module Processing
     #
     # @return [Image] new image
     #
+    # @see https://processing.org/reference/createImage_.html
+    # @see https://p5js.org/reference/#/p5/createImage
+    #
     def createImage(w, h, format = RGBA)
       colorspace = {RGB => Rays::RGB, RGBA => Rays::RGBA}[format]
       raise ArgumentError, "Unknown image format" unless colorspace
@@ -2584,6 +3002,10 @@ module Processing
     #
     # @param kind [LINE, RECT, ELLIPSE, ARC, TRIANGLE, QUAD, GROUP]
     #
+    # @return [Shape] new shape
+    #
+    # @see https://processing.org/reference/createShape_.html
+    #
     def createShape(kind = nil, *args)
       case kind
       when LINE     then createLineShape__(    *args)
@@ -2640,6 +3062,9 @@ module Processing
     #
     # @return [Graphics] graphics object
     #
+    # @see https://processing.org/reference/createGraphics_.html
+    # @see https://p5js.org/reference/#/p5/createGraphics
+    #
     def createGraphics(width, height, pixelDensity = 1)
       Graphics.new width, height, pixelDensity
     end
@@ -2676,6 +3101,8 @@ module Processing
     #
     # @return [Shader] shader object
     #
+    # @see https://p5js.org/reference/#/p5/createShader
+    #
     def createShader(vert, frag)
       vert = File.read if vert && File.exist?(vert)
       frag = File.read if frag && File.exist?(frag)
@@ -2757,6 +3184,9 @@ module Processing
     #
     # @return [Shader] loaded shader object
     #
+    # @see https://processing.org/reference/loadShader_.html
+    # @see https://p5js.org/reference/#/p5/loadShader
+    #
     def loadShader(fragPath, vertPath = nil)
       createShader vertPath, fragPath
     end