@vpmedia/phaser 1.14.0 → 1.16.0

package/src/phaser/display/webgl/abstract_filter.js

@@ -1,11 +1,9 @@
-/**
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
- * @author       Andras Csizmadia <andras@vpmedia.hu>
- * @author       Richard Davey <rich@photonstorm.com>
- * @author       Mat Groves http://matgroves.com/ @Doormat23
- */
-
 export class AbstractFilter {
+  /**
+   * TBD.
+   * @param fragmentSrc
+   * @param uniforms
+   */
   constructor(fragmentSrc, uniforms) {
     this.passes = [this];
     this.shaders = [];
@@ -15,6 +13,9 @@ export class AbstractFilter {
     this.fragmentSrc = fragmentSrc || [];
   }
 
+  /**
+   * TBD.
+   */
   syncUniforms() {
     for (let i = 0, j = this.shaders.length; i < j; i += 1) {
       this.shaders[i].dirty = true;

package/src/phaser/display/webgl/base_texture.js

@@ -1,13 +1,11 @@
-/**
- * @module display/webgl/base_texture
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
- * @author       Andras Csizmadia <andras@vpmedia.hu>
- * @author       Richard Davey <rich@photonstorm.com>
- * @author       Mat Groves http://matgroves.com/ @Doormat23
- */
 import { removeByCanvas } from '../canvas/pool';
 
 export class BaseTexture {
+  /**
+   * TBD.
+   * @param source
+   * @param scaleMode
+   */
   constructor(source, scaleMode) {
     this.resolution = 1;
     this.width = 100;
@@ -22,11 +20,7 @@ export class BaseTexture {
     this._powerOf2 = false;
     this._dirty = [true, true, true, true];
     if (source) {
-      if (
-        (this.source.complete || this.source.getContext) &&
-        this.source.width &&
-        this.source.height
-      ) {
+      if ((this.source.complete || this.source.getContext) && this.source.width && this.source.height) {
         this.hasLoaded = true;
         this.width = this.source.naturalWidth || this.source.width;
         this.height = this.source.naturalHeight || this.source.height;
@@ -35,6 +29,11 @@ export class BaseTexture {
     }
   }
 
+  /**
+   * TBD.
+   * @param {number} width - TBD.
+   * @param {number} height - TBD.
+   */
   forceLoaded(width, height) {
     this.hasLoaded = true;
     this.width = width;
@@ -42,6 +41,9 @@ export class BaseTexture {
     this.dirty();
   }
 
+  /**
+   * TBD.
+   */
   destroy() {
     if (this.source) {
       removeByCanvas(this.source);
@@ -50,12 +52,18 @@ export class BaseTexture {
     this.unloadFromGPU();
   }
 
+  /**
+   * TBD.
+   */
   dirty() {
     for (let i = 0; i < this._glTextures.length; i += 1) {
       this._dirty[i] = true;
     }
   }
 
+  /**
+   * TBD.
+   */
   unloadFromGPU() {
     this.dirty();
     for (let i = this._glTextures.length - 1; i >= 0; i -= 1) {

package/src/phaser/display/webgl/blend_manager.js

@@ -1,20 +1,24 @@
-/**
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
- * @author       Andras Csizmadia <andras@vpmedia.hu>
- * @author       Richard Davey <rich@photonstorm.com>
- * @author       Mat Groves http://matgroves.com/ @Doormat23
- */
-
 export class WebGLBlendModeManager {
+  /**
+   * TBD.
+   */
   constructor() {
     this.gl = null;
     this.currentBlendMode = 99999;
   }
 
+  /**
+   * TBD.
+   * @param gl - TBD.
+   */
   setContext(gl) {
     this.gl = gl;
   }
 
+  /**
+   * TBD.
+   * @param blendMode
+   */
   setBlendMode(blendMode) {
     if (this.currentBlendMode === blendMode) {
       return false;
@@ -27,6 +31,9 @@ export class WebGLBlendModeManager {
     return true;
   }
 
+  /**
+   * TBD.
+   */
   destroy() {
     this.gl = null;
   }

package/src/phaser/display/webgl/earcut.js

@@ -1,14 +1,7 @@
-/**
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
- * @author       Andras Csizmadia <andras@vpmedia.hu>
- * @author       Richard Davey <rich@photonstorm.com>
- * @author       Mat Groves http://matgroves.com/ @Doormat23
- */
 import { Node } from './earcut_node';
 
 /**
  * TBD.
- *
  * @param {object} list - TBD.
  * @returns {object} TBD.
  */
@@ -75,7 +68,6 @@ export function sortLinked(list) {
 
 /**
  * TBD.
- *
  * @param {object} a - TBD.
  * @param {object} b - TBD.
  * @returns {number} TBD.
@@ -86,7 +78,6 @@ export function compareX(a, b) {
 
 /**
  * TBD.
- *
  * @param {number} x - TBD.
  * @param {number} y - TBD.
  * @param {number} minX - TBD.
@@ -111,7 +102,6 @@ export function zOrder(x, y, minX, minY, size) {
 
 /**
  * TBD.
- *
  * @param {object} start - TBD.
  * @param {number} minX - TBD.
  * @param {number} minY - TBD.
@@ -132,7 +122,6 @@ export function indexCurve(start, minX, minY, size) {
 
 /**
  * TBD.
- *
  * @param {object} start - TBD.
  * @returns {object} TBD.
  */
@@ -148,7 +137,6 @@ export function getLeftmost(start) {
 
 /**
  * TBD.
- *
  * @param {number} ax - TBD.
  * @param {number} ay - TBD.
  * @param {number} bx - TBD.
@@ -169,7 +157,6 @@ export function pointInTriangle(ax, ay, bx, by, cx, cy, px, py) {
 
 /**
  * TBD.
- *
  * @param {object} p - TBD.
  * @param {object} q - TBD.
  * @param {object} r - TBD.
@@ -181,7 +168,6 @@ export function area(p, q, r) {
 
 /**
  * TBD.
- *
  * @param {object} p1 - TBD.
  * @param {object} p2 - TBD.
  * @returns {boolean} TBD.
@@ -192,7 +178,6 @@ export function equals(p1, p2) {
 
 /**
  * TBD.
- *
  * @param {object} p1 - TBD.
  * @param {object} q1 - TBD.
  * @param {object} p2 - TBD.
@@ -200,14 +185,11 @@ export function equals(p1, p2) {
  * @returns {boolean} TBD.
  */
 export function intersects(p1, q1, p2, q2) {
-  return (
-    area(p1, q1, p2) > 0 !== area(p1, q1, q2) > 0 && area(p2, q2, p1) > 0 !== area(p2, q2, q1) > 0
-  );
+  return area(p1, q1, p2) > 0 !== area(p1, q1, q2) > 0 && area(p2, q2, p1) > 0 !== area(p2, q2, q1) > 0;
 }
 
 /**
  * TBD.
- *
  * @param {object} a - TBD.
  * @param {object} b - TBD.
  * @returns {boolean} TBD.
@@ -215,14 +197,7 @@ export function intersects(p1, q1, p2, q2) {
 export function intersectsPolygon(a, b) {
   let p = a;
   do {
-    if (
-      p.i !== a.i &&
-      p.next.i !== a.i &&
-      p.i !== b.i &&
-      p.next.i !== b.i &&
-      intersects(p, p.next, a, b)
-    )
-      return true;
+    if (p.i !== a.i && p.next.i !== a.i && p.i !== b.i && p.next.i !== b.i && intersects(p, p.next, a, b)) return true;
     p = p.next;
   } while (p !== a);
   return false;
@@ -230,7 +205,6 @@ export function intersectsPolygon(a, b) {
 
 /**
  * TBD.
- *
  * @param {object} a - TBD.
  * @param {object} b - TBD.
  * @returns {object} TBD.
@@ -243,7 +217,6 @@ export function locallyInside(a, b) {
 
 /**
  * TBD.
- *
  * @param {object} a - TBD.
  * @param {object} b - TBD.
  * @returns {boolean} TBD.
@@ -254,10 +227,7 @@ export function middleInside(a, b) {
   const px = (a.x + b.x) / 2;
   const py = (a.y + b.y) / 2;
   do {
-    if (
-      p.y > py !== p.next.y > py &&
-      px < ((p.next.x - p.x) * (py - p.y)) / (p.next.y - p.y) + p.x
-    ) {
+    if (p.y > py !== p.next.y > py && px < ((p.next.x - p.x) * (py - p.y)) / (p.next.y - p.y) + p.x) {
       inside = !inside;
     }
     p = p.next;
@@ -267,7 +237,6 @@ export function middleInside(a, b) {
 
 /**
  * TBD.
- *
  * @param {object} a - TBD.
  * @param {object} b - TBD.
  * @returns {boolean} TBD.
@@ -286,7 +255,6 @@ export function isValidDiagonal(a, b) {
 
 /**
  * TBD.
- *
  * @param {object} a - TBD.
  * @param {object} b - TBD.
  * @returns {object} TBD.
@@ -309,7 +277,6 @@ export function splitPolygon(a, b) {
 
 /**
  * TBD.
- *
  * @param {number} i - TBD.
  * @param {number} x - TBD.
  * @param {number} y - TBD.
@@ -332,7 +299,6 @@ export function insertNode(i, x, y, last) {
 
 /**
  * TBD.
- *
  * @param {object} p - TBD.
  */
 export function removeNode(p) {
@@ -348,7 +314,6 @@ export function removeNode(p) {
 
 /**
  * TBD.
- *
  * @param {object} ear - TBD.
  * @returns {boolean} TBD.
  */
@@ -360,8 +325,7 @@ export function isEar(ear) {
   // now make sure we don't have other points inside the potential ear
   let p = ear.next.next;
   while (p !== ear.prev) {
-    if (pointInTriangle(a.x, a.y, b.x, b.y, c.x, c.y, p.x, p.y) && area(p.prev, p, p.next) >= 0)
-      return false;
+    if (pointInTriangle(a.x, a.y, b.x, b.y, c.x, c.y, p.x, p.y) && area(p.prev, p, p.next) >= 0) return false;
     p = p.next;
   }
   return true;
@@ -369,7 +333,6 @@ export function isEar(ear) {
 
 /**
  * TBD.
- *
  * @param {object} ear - TBD.
  * @param {number} minX - TBD.
  * @param {number} minY - TBD.
@@ -420,7 +383,6 @@ export function isEarHashed(ear, minX, minY, size) {
 
 /**
  * TBD.
- *
  * @param {object} data - TBD.
  * @param {number} start - TBD.
  * @param {number} end - TBD.
@@ -449,7 +411,6 @@ export function linkedList(data, start, end, dim, clockwise) {
 
 /**
  * TBD.
- *
  * @param {object} start - TBD.
  * @param {object} end - TBD.
  * @returns {object} TBD.
@@ -476,7 +437,6 @@ export function filterPoints(start, end) {
 
 /**
  * TBD.
- *
  * @param {object} hole - TBD.
  * @param {object} outerNode - TBD.
  * @returns {object} TBD.
@@ -527,7 +487,6 @@ export function findHoleBridge(hole, outerNode) {
 
 /**
  * TBD.
- *
  * @param {object} hole - TBD.
  * @param {object} outerNode - TBD.
  */
@@ -541,7 +500,6 @@ export function eliminateHole(hole, outerNode) {
 
 /**
  * TBD.
- *
  * @param {object} data - TBD.
  * @param {object} holeIndices - TBD.
  * @param {object} outerNode - TBD.
@@ -573,7 +531,6 @@ export function eliminateHoles(data, holeIndices, outerNode, dim) {
 
 /**
  * TBD.
- *
  * @param {object} start - TBD.
  * @param {object} triangles - TBD.
  * @param {number} dim - TBD.
@@ -602,7 +559,6 @@ export function cureLocalIntersections(start, triangles, dim) {
 
 /**
  * TBD.
- *
  * @param {object} start - TBD.
  * @param {object} triangles - TBD.
  * @param {number} dim - TBD.
@@ -635,7 +591,6 @@ export function splitEarcut(start, triangles, dim, minX, minY, size) {
 
 /**
  * TBD.
- *
  * @param {object} ear - TBD.
  * @param {object} triangles - TBD.
  * @param {number} dim - TBD.
@@ -687,7 +642,6 @@ export function earcutLinked(ear, triangles, dim, minX, minY, size, pass) {
 
 /**
  * TBD.
- *
  * @param {object} data - TBD.
  * @param {object} holeIndices - TBD.
  * @param {number} dim - TBD.

package/src/phaser/display/webgl/earcut_node.js

@@ -1,11 +1,10 @@
-/**
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
- * @author       Andras Csizmadia <andras@vpmedia.hu>
- * @author       Richard Davey <rich@photonstorm.com>
- * @author       Mat Groves http://matgroves.com/ @Doormat23
- */
-
 export class Node {
+  /**
+   * TBD.
+   * @param i
+   * @param {number} x - TBD.
+   * @param {number} y - TBD.
+   */
   constructor(i, x, y) {
     // vertice index in coordinates array
     this.i = i;

package/src/phaser/display/webgl/fast_sprite_batch.js

@@ -1,11 +1,8 @@
-/**
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
- * @author       Andras Csizmadia <andras@vpmedia.hu>
- * @author       Richard Davey <rich@photonstorm.com>
- * @author       Mat Groves http://matgroves.com/ @Doormat23
- */
-
 export class FastSpriteBatch {
+  /**
+   * TBD.
+   * @param gl - TBD.
+   */
   constructor(gl) {
     this.vertSize = 10;
     this.maxSize = 6000; // Math.pow(2, 16) / this.vertSize;
@@ -37,6 +34,10 @@ export class FastSpriteBatch {
     this.setContext(gl);
   }
 
+  /**
+   * TBD.
+   * @param gl - TBD.
+   */
   setContext(gl) {
     this.gl = gl;
     // create a couple of buffers
@@ -50,6 +51,11 @@ export class FastSpriteBatch {
     gl.bufferData(gl.ARRAY_BUFFER, this.vertices, gl.DYNAMIC_DRAW);
   }
 
+  /**
+   * TBD.
+   * @param spriteBatch
+   * @param renderSession - TBD.
+   */
   begin(spriteBatch, renderSession) {
     this.renderSession = renderSession;
     this.shader = this.renderSession.shaderManager.fastShader;
@@ -57,10 +63,17 @@ export class FastSpriteBatch {
     this.start();
   }
 
+  /**
+   * TBD.
+   */
   end() {
     this.flush();
   }
 
+  /**
+   * TBD.
+   * @param spriteBatch
+   */
   render(spriteBatch) {
     const children = spriteBatch.children;
     const sprite = children[0];
@@ -81,15 +94,16 @@ export class FastSpriteBatch {
     this.flush();
   }
 
+  /**
+   * TBD.
+   * @param sprite
+   */
   renderSprite(sprite) {
     if (!sprite.visible) {
       return;
     }
     // TODO trim??
-    if (
-      sprite.texture.baseTexture !== this.currentBaseTexture &&
-      !sprite.texture.baseTexture.skipRender
-    ) {
+    if (sprite.texture.baseTexture !== this.currentBaseTexture && !sprite.texture.baseTexture.skipRender) {
       this.flush();
       this.currentBaseTexture = sprite.texture.baseTexture;
       if (!sprite.texture._uvs) {
@@ -187,6 +201,9 @@ export class FastSpriteBatch {
     }
   }
 
+  /**
+   * TBD.
+   */
   flush() {
     // If the batch is length 0 then return as there is nothing to draw
     if (this.currentBatchSize === 0) {
@@ -213,10 +230,16 @@ export class FastSpriteBatch {
     this.renderSession.drawCount += 1;
   }
 
+  /**
+   * TBD.
+   */
   stop() {
     this.flush();
   }
 
+  /**
+   * TBD.
+   */
   start() {
     const gl = this.gl;
     // bind the main texture

package/src/phaser/display/webgl/filter_manager.js

@@ -1,43 +1,61 @@
-/**
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
- * @author       Andras Csizmadia <andras@vpmedia.hu>
- * @author       Richard Davey <rich@photonstorm.com>
- * @author       Mat Groves http://matgroves.com/ @Doormat23
- */
-
 export class WebGLFilterManager {
+  /**
+   * TBD.
+   */
   constructor() {
     this.filterStack = [];
     this.offsetX = 0;
     this.offsetY = 0;
   }
 
+  /**
+   * TBD.
+   * @param gl - TBD.
+   */
   setContext(gl) {
     this.gl = gl;
     this.texturePool = [];
     this.initShaderBuffers();
   }
 
+  /**
+   * TBD.
+   */
   begin() {
     // TODO
   }
 
+  /**
+   * TBD.
+   */
   pushFilter() {
     // TODO
   }
 
+  /**
+   * TBD.
+   */
   popFilter() {
     // TODO
   }
 
+  /**
+   * TBD.
+   */
   applyFilterPass() {
     // TODO
   }
 
+  /**
+   * TBD.
+   */
   initShaderBuffers() {
     // TODO
   }
 
+  /**
+   * TBD.
+   */
   destroy() {
     // TODO
   }

package/src/phaser/display/webgl/filter_texture.js

@@ -1,28 +1,21 @@
-/**
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
- * @author       Andras Csizmadia <andras@vpmedia.hu>
- * @author       Richard Davey <rich@photonstorm.com>
- * @author       Mat Groves http://matgroves.com/ @Doormat23
- */
 import { SCALE_LINEAR } from '../../core/const';
 
 export class FilterTexture {
+  /**
+   * TBD.
+   * @param gl - TBD.
+   * @param {number} width - TBD.
+   * @param {number} height - TBD.
+   * @param scaleMode
+   */
   constructor(gl, width, height, scaleMode) {
     this.gl = gl;
     this.frameBuffer = gl.createFramebuffer();
     this.texture = gl.createTexture();
     scaleMode = scaleMode || window.PhaserRegistry.TEXTURE_SCALE_MODE;
     gl.bindTexture(gl.TEXTURE_2D, this.texture);
-    gl.texParameteri(
-      gl.TEXTURE_2D,
-      gl.TEXTURE_MAG_FILTER,
-      scaleMode === SCALE_LINEAR ? gl.LINEAR : gl.NEAREST
-    );
-    gl.texParameteri(
-      gl.TEXTURE_2D,
-      gl.TEXTURE_MIN_FILTER,
-      scaleMode === SCALE_LINEAR ? gl.LINEAR : gl.NEAREST
-    );
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, scaleMode === SCALE_LINEAR ? gl.LINEAR : gl.NEAREST);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, scaleMode === SCALE_LINEAR ? gl.LINEAR : gl.NEAREST);
     gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
     gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
     gl.bindFramebuffer(gl.FRAMEBUFFER, this.frameBuffer);
@@ -31,21 +24,24 @@ export class FilterTexture {
     // required for masking a mask??
     this.renderBuffer = gl.createRenderbuffer();
     gl.bindRenderbuffer(gl.RENDERBUFFER, this.renderBuffer);
-    gl.framebufferRenderbuffer(
-      gl.FRAMEBUFFER,
-      gl.DEPTH_STENCIL_ATTACHMENT,
-      gl.RENDERBUFFER,
-      this.renderBuffer
-    );
+    gl.framebufferRenderbuffer(gl.FRAMEBUFFER, gl.DEPTH_STENCIL_ATTACHMENT, gl.RENDERBUFFER, this.renderBuffer);
     this.resize(width, height);
   }
 
+  /**
+   * TBD.
+   */
   clear() {
     const gl = this.gl;
     gl.clearColor(0, 0, 0, 0);
     gl.clear(gl.COLOR_BUFFER_BIT);
   }
 
+  /**
+   * TBD.
+   * @param {number} width - TBD.
+   * @param {number} height - TBD.
+   */
   resize(width, height) {
     if (this.width === width && this.height === height) {
       return;
@@ -60,6 +56,9 @@ export class FilterTexture {
     gl.renderbufferStorage(gl.RENDERBUFFER, gl.DEPTH_STENCIL, width, height);
   }
 
+  /**
+   * TBD.
+   */
   destroy() {
     const gl = this.gl;
     gl.deleteFramebuffer(this.frameBuffer);