melonjs 10.9.0 → 10.10.0

package/src/video/webgl/webgl_renderer.js

@@ -2,8 +2,8 @@ import Color from "./../../math/color.js";
 import Matrix2d from "./../../math/matrix2.js";
 import WebGLCompositor from "./webgl_compositor.js";
 import Renderer from "./../renderer.js";
-import TextureCache from "./../texture_cache.js";
-import { TextureAtlas, createAtlas } from "./../texture.js";
+import TextureCache from "./../texture/cache.js";
+import { TextureAtlas, createAtlas } from "./../texture/atlas.js";
 import { createCanvas, renderer } from "./../video.js";
 import * as event from "./../../system/event.js";
 import pool from "./../../system/pooling.js";
@@ -70,8 +70,8 @@ class WebGLRenderer extends Renderer {
         /**
          * The WebGL context
          * @name gl
-         * @memberof WebGLRenderer#
-         * type {WebGLRenderingContext}
+         * @memberof WebGLRenderer
+         * @type {WebGLRenderingContext}
          */
         this.context = this.gl = this.getContextGL(this.getScreenCanvas(), options.transparent);
 
@@ -171,7 +171,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Reset context state
      * @name reset
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      */
     reset() {
@@ -198,7 +198,7 @@ class WebGLRenderer extends Renderer {
      * @name setCompositor
      * @function
      * @param {WebGLCompositor|string} compositor a compositor name or instance
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      */
     setCompositor(compositor = "default") {
@@ -224,7 +224,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Reset the gl transform to identity
      * @name resetTransform
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      */
     resetTransform() {
@@ -271,7 +271,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Create a pattern with the specified repetition
      * @name createPattern
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {Image} image Source image
      * @param {string} repeat Define how the pattern should be repeated
@@ -304,7 +304,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Flush the compositor to the frame buffer
      * @name flush
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      */
     flush() {
@@ -314,7 +314,7 @@ class WebGLRenderer extends Renderer {
     /**
      * set/change the current projection matrix (WebGL only)
      * @name setProjection
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {Matrix3d} matrix
      */
@@ -326,7 +326,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Clears the gl context with the given color.
      * @name clearColor
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {Color|string} [color="#000000"] CSS color.
      * @param {boolean} [opaque=false] Allow transparency [default] or clear the surface completely [true]
@@ -354,7 +354,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Erase the pixels in the given rectangular area by setting them to transparent black (rgba(0,0,0,0)).
      * @name clearRect
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x x axis of the coordinate for the rectangle starting point.
      * @param {number} y y axis of the coordinate for the rectangle starting point.
@@ -404,7 +404,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Draw an image to the gl context
      * @name drawImage
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {Image} image An element to draw into the context. The specification permits any canvas image source (CanvasImageSource), specifically, a CSSImageValue, an HTMLImageElement, an SVGImageElement, an HTMLVideoElement, an HTMLCanvasElement, an ImageBitmap, or an OffscreenCanvas.
      * @param {number} sx The X coordinate of the top left corner of the sub-rectangle of the source image to draw into the destination context.
@@ -457,7 +457,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Draw a pattern within the given rectangle.
      * @name drawPattern
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {TextureAtlas} pattern Pattern object
      * @param {number} x
@@ -475,7 +475,7 @@ class WebGLRenderer extends Renderer {
     /**
      * return a reference to the screen canvas corresponding WebGL Context
      * @name getScreenContext
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @returns {WebGLRenderingContext}
      */
@@ -486,7 +486,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Returns the WebGL Context object of the given Canvas
      * @name getContextGL
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {HTMLCanvasElement} canvas
      * @param {boolean} [transparent=true] use false to disable transparency
@@ -544,7 +544,7 @@ class WebGLRenderer extends Renderer {
      * Returns the WebGLContext instance for the renderer
      * return a reference to the system 2d Context
      * @name getContext
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @returns {WebGLRenderingContext}
      */
@@ -565,7 +565,7 @@ class WebGLRenderer extends Renderer {
      * <img src="images/screen-blendmode.png" width="510"/> <br>
      * @name setBlendMode
      * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {string} [mode="normal"] blend mode : "normal", "multiply", "lighter", "additive", "screen"
      * @param {WebGLRenderingContext} [gl]
@@ -616,7 +616,7 @@ class WebGLRenderer extends Renderer {
     /**
      * restores the canvas context
      * @name restore
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      */
     restore() {
@@ -652,7 +652,7 @@ class WebGLRenderer extends Renderer {
     /**
      * saves the canvas context
      * @name save
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      */
     save() {
@@ -670,7 +670,7 @@ class WebGLRenderer extends Renderer {
     /**
      * rotates the uniform matrix
      * @name rotate
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} angle in radians
      */
@@ -681,7 +681,7 @@ class WebGLRenderer extends Renderer {
     /**
      * scales the uniform matrix
      * @name scale
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x
      * @param {number} y
@@ -702,7 +702,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Set the global alpha
      * @name setGlobalAlpha
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} alpha 0.0 to 1.0 values accepted.
      */
@@ -713,7 +713,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Return the global alpha
      * @name getGlobalAlpha
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @returns {number} global alpha value
      */
@@ -725,7 +725,7 @@ class WebGLRenderer extends Renderer {
      * Set the current fill & stroke style color.
      * By default, or upon reset, the value is set to #000000.
      * @name setColor
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {Color|string} color css color string.
      */
@@ -738,7 +738,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Set the line width
      * @name setLineWidth
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} width Line width
      */
@@ -749,7 +749,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Stroke an arc at the specified coordinates with given radius, start and end points
      * @name strokeArc
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x arc center point x-axis
      * @param {number} y arc center point y-axis
@@ -777,7 +777,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Fill an arc at the specified coordinates with given radius, start and end points
      * @name fillArc
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x arc center point x-axis
      * @param {number} y arc center point y-axis
@@ -793,7 +793,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Stroke an ellipse at the specified coordinates with given radius
      * @name strokeEllipse
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x ellipse center point x-axis
      * @param {number} y ellipse center point y-axis
@@ -819,7 +819,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Fill an ellipse at the specified coordinates with given radius
      * @name fillEllipse
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x ellipse center point x-axis
      * @param {number} y ellipse center point y-axis
@@ -833,7 +833,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Stroke a line of the given two points
      * @name strokeLine
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} startX the start x coordinate
      * @param {number} startY the start y coordinate
@@ -855,7 +855,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Fill a line of the given two points
      * @name fillLine
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} startX the start x coordinate
      * @param {number} startY the start y coordinate
@@ -869,7 +869,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Stroke a me.Polygon on the screen with a specified color
      * @name strokePolygon
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {Polygon} poly the shape to draw
      * @param {boolean} [fill=false] also fill the shape with the current color if true
@@ -901,7 +901,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Fill a me.Polygon on the screen
      * @name fillPolygon
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {Polygon} poly the shape to draw
      */
@@ -912,7 +912,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Draw a stroke rectangle at the specified coordinates
      * @name strokeRect
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x
      * @param {number} y
@@ -937,7 +937,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Draw a filled rectangle at the specified coordinates
      * @name fillRect
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x
      * @param {number} y
@@ -951,7 +951,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Stroke a rounded rectangle at the specified coordinates
      * @name strokeRoundRect
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x
      * @param {number} y
@@ -978,7 +978,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Draw a rounded filled rectangle at the specified coordinates
      * @name fillRoundRect
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x
      * @param {number} y
@@ -994,7 +994,7 @@ class WebGLRenderer extends Renderer {
      * Reset (overrides) the renderer transformation matrix to the
      * identity one, and then apply the given transformation matrix.
      * @name setTransform
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {Matrix2d} mat2d Matrix to transform by
      */
@@ -1006,7 +1006,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Multiply given matrix into the renderer tranformation matrix
      * @name transform
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {Matrix2d} mat2d Matrix to transform by
      */
@@ -1024,7 +1024,7 @@ class WebGLRenderer extends Renderer {
     /**
      * Translates the uniform matrix by the given coordinates
      * @name translate
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x
      * @param {number} y
@@ -1047,7 +1047,7 @@ class WebGLRenderer extends Renderer {
      * and restore it (with the restore() method) any time in the future.
      * (<u>this is an experimental feature !</u>)
      * @name clipRect
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      * @param {number} x
      * @param {number} y
@@ -1095,31 +1095,46 @@ class WebGLRenderer extends Renderer {
      * So, if the renderable is larger than the mask, only the intersecting part of the renderable will be visible.
      * Mask are not preserved through renderer context save and restore.
      * @name setMask
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
-     * @param {Rect|RoundRect|Polygon|Line|Ellipse} [mask] the shape defining the mask to be applied
+     * @param {Rect|RoundRect|Polygon|Line|Ellipse} [mask] a shape defining the mask to be applied
+     * @param {boolean} [invert=false] either the given shape should define what is visible (default) or the opposite
      */
-    setMask(mask) {
+    setMask(mask, invert = false) {
         var gl = this.gl;
 
         // flush the compositor
         this.flush();
 
-        // Enable and setup GL state to write to stencil buffer
-        gl.enable(gl.STENCIL_TEST);
-        gl.clear(gl.STENCIL_BUFFER_BIT);
+        if (this.maskLevel === 0) {
+            // Enable and setup GL state to write to stencil buffer
+            gl.enable(gl.STENCIL_TEST);
+            gl.clear(gl.STENCIL_BUFFER_BIT);
+
+
+        }
+
+        this.maskLevel++;
+
         gl.colorMask(false, false, false, false);
-        gl.stencilFunc(gl.NOTEQUAL, 1, 1);
+        gl.stencilFunc(gl.EQUAL, this.maskLevel, 1);
         gl.stencilOp(gl.REPLACE, gl.REPLACE, gl.REPLACE);
 
+
+        // fill the given mask shape
         this.fill(mask);
 
         // flush the compositor
         this.flush();
 
-        // Use stencil buffer to affect next rendering object
         gl.colorMask(true, true, true, true);
-        gl.stencilFunc(gl.EQUAL, 1, 1);
+
+        // Use stencil buffer to affect next rendering object
+        if (invert === true) {
+            gl.stencilFunc(gl.EQUAL, this.maskLevel + 1, 1);
+        } else {
+            gl.stencilFunc(gl.NOTEQUAL, this.maskLevel + 1, 1);
+        }
         gl.stencilOp(gl.KEEP, gl.KEEP, gl.KEEP);
     }
 
@@ -1127,13 +1142,16 @@ class WebGLRenderer extends Renderer {
      * disable (remove) the rendering mask set through setMask.
      * @name clearMask
      * @see WebGLRenderer#setMask
-     * @memberof WebGLRenderer.prototype
+     * @memberof WebGLRenderer
      * @function
      */
     clearMask() {
-        // flush the compositor
-        this.flush();
-        this.gl.disable(this.gl.STENCIL_TEST);
+        if (this.maskLevel > 0) {
+            // flush the compositor
+            this.flush();
+            this.maskLevel = 0;
+            this.gl.disable(this.gl.STENCIL_TEST);
+        }
     }
 };