@vpmedia/phaser 1.14.0 → 1.16.0

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

@@ -1,24 +1,11 @@
-/**
- * @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 { GraphicsData } from  './graphics_data';
+import { GraphicsData } from './graphics_data';
 import { Point } from '../../geom/point';
-import {
-  GEOM_CIRCLE,
-  GEOM_ELLIPSE,
-  GEOM_POLYGON,
-  GEOM_RECTANGLE,
-  GEOM_ROUNDED_RECTANGLE,
-} from '../../core/const';
+import { GEOM_CIRCLE, GEOM_ELLIPSE, GEOM_POLYGON, GEOM_RECTANGLE, GEOM_ROUNDED_RECTANGLE } from '../../core/const';
 import { hex2rgb } from '../../util/math';
 import { triangulate } from './earcut';
 
 /**
  * TBD.
- *
  * @returns {number} TBD.
  */
 export function getStencilBufferLimit() {
@@ -30,7 +17,6 @@ export function getStencilBufferLimit() {
 
 /**
  * TBD.
- *
  * @returns {object[]} TBD.
  */
 export function getGraphicsDataPool() {
@@ -42,7 +28,6 @@ export function getGraphicsDataPool() {
 
 /**
  * TBD.
- *
  * @param {object} webGL - TBD.
  * @param {number} type - TBD.
  * @returns {object} TBD.
@@ -67,7 +52,6 @@ export function switchMode(webGL, type) {
 
 /**
  * TBD.
- *
  * @param {object} graphicsData - TBD.
  * @param {object} webGLData - TBD.
  */
@@ -233,7 +217,6 @@ export function buildLine(graphicsData, webGLData) {
 
 /**
  * TBD.
- *
  * @param {object} graphicsData - TBD.
  * @param {object} webGLData - TBD.
  */
@@ -278,7 +261,6 @@ export function buildRectangle(graphicsData, webGLData) {
 
 /**
  * TBD.
- *
  * @param {number} fromX - TBD.
  * @param {number} fromY - TBD.
  * @param {number} cpX - TBD.
@@ -318,7 +300,6 @@ export function quadraticBezierCurve(fromX, fromY, cpX, cpY, toX, toY) {
 
 /**
  * TBD.
- *
  * @param {object} graphicsData - TBD.
  * @param {object} webGLData - TBD.
  */
@@ -331,22 +312,11 @@ export function buildRoundedRectangle(graphicsData, webGLData) {
   const radius = rrectData.radius;
   let recPoints = [];
   recPoints.push(x, y + radius);
+  recPoints = recPoints.concat(quadraticBezierCurve(x, y + height - radius, x, y + height, x + radius, y + height));
   recPoints = recPoints.concat(
-    quadraticBezierCurve(x, y + height - radius, x, y + height, x + radius, y + height)
-  );
-  recPoints = recPoints.concat(
-    quadraticBezierCurve(
-      x + width - radius,
-      y + height,
-      x + width,
-      y + height,
-      x + width,
-      y + height - radius
-    )
-  );
-  recPoints = recPoints.concat(
-    quadraticBezierCurve(x + width, y + radius, x + width, y, x + width - radius, y)
+    quadraticBezierCurve(x + width - radius, y + height, x + width, y + height, x + width, y + height - radius)
   );
+  recPoints = recPoints.concat(quadraticBezierCurve(x + width, y + radius, x + width, y, x + width - radius, y));
   recPoints = recPoints.concat(quadraticBezierCurve(x + radius, y, x, y, x, y + radius));
   if (graphicsData.fill) {
     const color = hex2rgb(graphicsData.fillColor);
@@ -380,7 +350,6 @@ export function buildRoundedRectangle(graphicsData, webGLData) {
 
 /**
  * TBD.
- *
  * @param {object} graphicsData - TBD.
  * @param {object} webGLData - TBD.
  */
@@ -432,7 +401,6 @@ export function buildCircle(graphicsData, webGLData) {
 
 /**
  * TBD.
- *
  * @param {object} graphicsData - TBD.
  * @param {object} webGLData - TBD.
  */
@@ -477,7 +445,6 @@ export function buildComplexPoly(graphicsData, webGLData) {
 
 /**
  * TBD.
- *
  * @param {object} graphicsData - TBD.
  * @param {object} webGLData - TBD.
  * @returns {boolean} TBD.
@@ -517,7 +484,6 @@ export function buildPoly(graphicsData, webGLData) {
 
 /**
  * TBD.
- *
  * @param {object} graphics - TBD.
  * @param {object} gl - TBD.
  */
@@ -607,7 +573,6 @@ export function updateGraphics(graphics, gl) {
 
 /**
  * TBD.
- *
  * @param {object} graphics - TBD.
  * @param {object} renderSession - TBD.
  */

package/src/phaser/display/webgl/graphics_data.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 GraphicsData {
+  /**
+   * TBD.
+   * @param gl - TBD.
+   */
   constructor(gl) {
     this.gl = gl;
     // TODO does this need to be split before uploading??
@@ -19,6 +16,9 @@ export class GraphicsData {
     this.dirty = true;
   }
 
+  /**
+   * TBD.
+   */
   reset() {
     this.points = [];
     this.indices = [];
@@ -26,6 +26,9 @@ export class GraphicsData {
     this.glIndicies = null;
   }
 
+  /**
+   * TBD.
+   */
   upload() {
     const gl = this.gl;
     // this.lastIndex = graphics.graphicsData.length;

package/src/phaser/display/webgl/mask_manager.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 { updateGraphics } from './graphics';
 
 /**
  * TBD.
- *
  * @param {object} maskData - TBD.
  * @param {object} renderSession - TBD.
  */
@@ -29,7 +22,6 @@ export function pushMask(maskData, renderSession) {
 
 /**
  * TBD.
- *
  * @param {object} maskData - TBD.
  * @param {object} renderSession - TBD.
  */

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

@@ -1,10 +1,4 @@
-/**
- * @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 { Rectangle } from  '../../geom/rectangle';
+import { Rectangle } from '../../geom/rectangle';
 import { Point } from '../../geom/point';
 import { Texture } from './texture';
 import { BaseTexture } from './base_texture';
@@ -13,14 +7,19 @@ import { CanvasBuffer } from '../canvas/buffer';
 import { RENDER_WEBGL } from '../../core/const';
 
 export class RenderTexture extends Texture {
+  /**
+   * TBD.
+   * @param {number} width - TBD.
+   * @param {number} height - TBD.
+   * @param renderer
+   * @param scaleMode
+   * @param resolution
+   */
   constructor(width, height, renderer, scaleMode, resolution = 1) {
     const w = width || 100;
     const h = height || 100;
     const res = resolution || 1;
-    const baseTexture = new BaseTexture(
-      null,
-      scaleMode || window.PhaserRegistry.TEXTURE_SCALE_MODE
-    );
+    const baseTexture = new BaseTexture(null, scaleMode || window.PhaserRegistry.TEXTURE_SCALE_MODE);
     baseTexture.width = width * res;
     baseTexture.height = height * res;
     baseTexture._glTextures = [];
@@ -37,53 +36,66 @@ export class RenderTexture extends Texture {
     if (this.renderer.type === RENDER_WEBGL) {
       const gl = this.renderer.gl;
       this.baseTexture._dirty[gl.id] = false;
-      this.textureBuffer = new FilterTexture(
-        gl,
-        this.width,
-        this.height,
-        this.baseTexture.scaleMode
-      );
+      this.textureBuffer = new FilterTexture(gl, this.width, this.height, this.baseTexture.scaleMode);
       this.baseTexture._glTextures[gl.id] = this.textureBuffer.texture;
       this.render = this.renderWebGL;
       this.projection = new Point(this.width * 0.5, -this.height * 0.5);
     } else {
       this.render = this.renderCanvas;
-      this.textureBuffer = new CanvasBuffer(
-        this.width * this.resolution,
-        this.height * this.resolution
-      );
+      this.textureBuffer = new CanvasBuffer(this.width * this.resolution, this.height * this.resolution);
       this.baseTexture.source = this.textureBuffer.canvas;
     }
     this.valid = true;
     this._updateUvs();
   }
 
+  /**
+   * TBD.
+   */
   resize() {
     // TODO
   }
 
+  /**
+   * TBD.
+   */
   clear() {
     // TODO
   }
 
+  /**
+   * TBD.
+   */
   renderWebGL() {
     // TODO
   }
 
+  /**
+   * TBD.
+   */
   renderCanvas() {
     // TODO
   }
 
+  /**
+   * TBD.
+   */
   getImage() {
     const image = new Image();
     image.src = this.getBase64();
     return image;
   }
 
+  /**
+   * TBD.
+   */
   getBase64() {
     return this.getCanvas().toDataURL();
   }
 
+  /**
+   * TBD.
+   */
   getCanvas() {
     // TODO
   }

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

@@ -1,9 +1,3 @@
-/**
- * @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 {
   RENDER_WEBGL,
   SCALE_LINEAR,
@@ -34,8 +28,13 @@ import * as WebGLMaskManager from './mask_manager';
 import { WebGLFilterManager } from './filter_manager';
 import { WebGLStencilManager } from './stencil_manager';
 import { WebGLBlendModeManager } from './blend_manager';
+import { Game } from '../../core/game';
 
 export class WebGLRenderer {
+  /**
+   * TBD.
+   * @param {Game} game - TBD.
+   */
   constructor(game) {
     this.type = RENDER_WEBGL;
     this.resolution = game.config.resolution;
@@ -75,6 +74,9 @@ export class WebGLRenderer {
     this.mapBlendModes();
   }
 
+  /**
+   * TBD.
+   */
   destroy() {
     window.PhaserRegistry.GL_CONTEXTS[this.glContextId] = null;
     this.projection = null;
@@ -100,6 +102,9 @@ export class WebGLRenderer {
     window.PhaserRegistry.GL_CONTEXT_ID -= 1;
   }
 
+  /**
+   * TBD.
+   */
   initRegistry() {
     if (!window.PhaserRegistry.GL_CONTEXT_ID) {
       window.PhaserRegistry.GL_CONTEXT_ID = 0;
@@ -112,6 +117,9 @@ export class WebGLRenderer {
     }
   }
 
+  /**
+   * TBD.
+   */
   initContext() {
     const gl =
       this.view.getContext('webgl', this._contextOptions) ||
@@ -142,6 +150,10 @@ export class WebGLRenderer {
     this.resize(this.width, this.height);
   }
 
+  /**
+   * TBD.
+   * @param stage
+   */
   render(stage) {
     if (this.contextLost) {
       return;
@@ -160,6 +172,13 @@ export class WebGLRenderer {
     this.renderDisplayObject(stage, this.projection);
   }
 
+  /**
+   * TBD.
+   * @param displayObject
+   * @param projection
+   * @param buffer
+   * @param matrix - TBD.
+   */
   renderDisplayObject(displayObject, projection, buffer, matrix) {
     this.renderSession.blendModeManager.setBlendMode(BLEND_NORMAL);
     // reset the render session data..
@@ -180,6 +199,11 @@ export class WebGLRenderer {
     this.spriteBatch.end();
   }
 
+  /**
+   * TBD.
+   * @param {number} width - TBD.
+   * @param {number} height - TBD.
+   */
   resize(width, height) {
     this.width = width * this.resolution;
     this.height = height * this.resolution;
@@ -194,6 +218,10 @@ export class WebGLRenderer {
     this.projection.y = -this.height / 2 / this.resolution;
   }
 
+  /**
+   * TBD.
+   * @param texture
+   */
   updateTexture(texture) {
     if (!texture.hasLoaded) {
       return false;
@@ -205,11 +233,7 @@ export class WebGLRenderer {
     gl.bindTexture(gl.TEXTURE_2D, texture._glTextures[gl.id]);
     gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, texture.premultipliedAlpha);
     gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, texture.source);
-    gl.texParameteri(
-      gl.TEXTURE_2D,
-      gl.TEXTURE_MAG_FILTER,
-      texture.scaleMode === SCALE_LINEAR ? gl.LINEAR : gl.NEAREST
-    );
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, texture.scaleMode === SCALE_LINEAR ? gl.LINEAR : gl.NEAREST);
     if (texture.mipmap && isPowerOfTwo(texture.width, texture.height)) {
       gl.texParameteri(
         gl.TEXTURE_2D,
@@ -236,6 +260,9 @@ export class WebGLRenderer {
     return true;
   }
 
+  /**
+   * TBD.
+   */
   mapBlendModes() {
     if (window.PhaserRegistry.blendModesWebGL) {
       return;

package/src/phaser/display/webgl/shader/complex.js

@@ -1,15 +1,13 @@
-/**
- * @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 { generateShaderID } from '../../../util/math';
 import { compileProgram } from '../util';
 
 // the next one is used for rendering triangle strips
 
 export class ComplexPrimitiveShader {
+  /**
+   * TBD.
+   * @param gl - TBD.
+   */
   constructor(gl) {
     this.gl = gl;
     this._UID = generateShaderID();
@@ -44,6 +42,9 @@ export class ComplexPrimitiveShader {
     this.init();
   }
 
+  /**
+   * TBD.
+   */
   init() {
     const gl = this.gl;
     const program = compileProgram(gl, this.vertexSrc, this.fragmentSrc);
@@ -63,6 +64,9 @@ export class ComplexPrimitiveShader {
     this.program = program;
   }
 
+  /**
+   * TBD.
+   */
   destroy() {
     this.gl.deleteProgram(this.program);
     this.uniforms = null;

package/src/phaser/display/webgl/shader/fast.js

@@ -1,15 +1,13 @@
-/**
- * @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 { generateShaderID } from '../../../util/math';
 import { compileProgram } from '../util';
 
 // this shader is used for the fast sprite rendering
 
 export class FastShader {
+  /**
+   * TBD.
+   * @param gl - TBD.
+   */
   constructor(gl) {
     this.gl = gl;
     this._UID = generateShaderID();
@@ -56,6 +54,9 @@ export class FastShader {
     this.init();
   }
 
+  /**
+   * TBD.
+   */
   init() {
     const gl = this.gl;
     const program = compileProgram(gl, this.vertexSrc, this.fragmentSrc);
@@ -93,6 +94,9 @@ export class FastShader {
     this.program = program;
   }
 
+  /**
+   * TBD.
+   */
   destroy() {
     this.gl.deleteProgram(this.program);
     this.uniforms = null;

package/src/phaser/display/webgl/shader/normal.js

@@ -1,9 +1,3 @@
-/**
- * @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 { generateShaderID } from '../../../util/math';
 import { compileProgram } from '../util';
 
@@ -30,6 +24,10 @@ const defaultVertexSrc = [
 // this shader is used for the default sprite rendering
 
 export class NormalShader {
+  /**
+   * TBD.
+   * @param gl - TBD.
+   */
   constructor(gl) {
     this.gl = gl;
     this._UID = generateShaderID();
@@ -51,6 +49,9 @@ export class NormalShader {
     this.init();
   }
 
+  /**
+   * TBD.
+   */
   init() {
     const gl = this.gl;
     const program = compileProgram(gl, this.vertexSrc || defaultVertexSrc, this.fragmentSrc);
@@ -84,6 +85,9 @@ export class NormalShader {
     this.program = program;
   }
 
+  /**
+   * TBD.
+   */
   initUniforms() {
     this.textureCount = 1;
     const gl = this.gl;
@@ -125,6 +129,10 @@ export class NormalShader {
     }
   }
 
+  /**
+   * TBD.
+   * @param uniform
+   */
   initSampler2D(uniform) {
     if (!uniform.value || !uniform.value.baseTexture || !uniform.value.baseTexture.hasLoaded) {
       return;
@@ -159,27 +167,10 @@ export class NormalShader {
         const border = data.border ? data.border : 0;
 
         // void texImage2D(GLenum target, GLint level, GLenum internalformat, GLsizei width, GLsizei height, GLint border, GLenum format, GLenum type, ArrayBufferView? pixels);
-        gl.texImage2D(
-          gl.TEXTURE_2D,
-          0,
-          format,
-          width,
-          height,
-          border,
-          format,
-          gl.UNSIGNED_BYTE,
-          null
-        );
+        gl.texImage2D(gl.TEXTURE_2D, 0, format, width, height, border, format, gl.UNSIGNED_BYTE, null);
       } else {
         //  void texImage2D(GLenum target, GLint level, GLenum internalformat, GLenum format, GLenum type, ImageData? pixels);
-        gl.texImage2D(
-          gl.TEXTURE_2D,
-          0,
-          format,
-          gl.RGBA,
-          gl.UNSIGNED_BYTE,
-          uniform.value.baseTexture.source
-        );
+        gl.texImage2D(gl.TEXTURE_2D, 0, format, gl.RGBA, gl.UNSIGNED_BYTE, uniform.value.baseTexture.source);
       }
       gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, magFilter);
       gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, minFilter);
@@ -191,6 +182,9 @@ export class NormalShader {
     this.textureCount += 1;
   }
 
+  /**
+   * TBD.
+   */
   syncUniforms() {
     this.textureCount = 1;
     let uniform;
@@ -209,13 +203,7 @@ export class NormalShader {
       } else if (uniform.glValueLength === 2) {
         uniform.glFunc.call(gl, uniform.uniformLocation, uniform.value.x, uniform.value.y);
       } else if (uniform.glValueLength === 3) {
-        uniform.glFunc.call(
-          gl,
-          uniform.uniformLocation,
-          uniform.value.x,
-          uniform.value.y,
-          uniform.value.z
-        );
+        uniform.glFunc.call(gl, uniform.uniformLocation, uniform.value.x, uniform.value.y, uniform.value.z);
       } else if (uniform.glValueLength === 4) {
         uniform.glFunc.call(
           gl,
@@ -244,6 +232,9 @@ export class NormalShader {
     }
   }
 
+  /**
+   * TBD.
+   */
   destroy() {
     this.gl.deleteProgram(this.program);
     this.uniforms = null;

package/src/phaser/display/webgl/shader/primitive.js

@@ -1,15 +1,13 @@
-/**
- * @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 { generateShaderID } from '../../../util/math';
 import { compileProgram } from '../util';
 
 // the next one is used for rendering primitives
 
 export class PrimitiveShader {
+  /**
+   * TBD.
+   * @param gl - TBD.
+   */
   constructor(gl) {
     this.gl = gl;
     this._UID = generateShaderID();
@@ -43,6 +41,9 @@ export class PrimitiveShader {
     this.init();
   }
 
+  /**
+   * TBD.
+   */
   init() {
     const gl = this.gl;
     const program = compileProgram(gl, this.vertexSrc, this.fragmentSrc);
@@ -61,6 +62,9 @@ export class PrimitiveShader {
     this.program = program;
   }
 
+  /**
+   * TBD.
+   */
   destroy() {
     this.gl.deleteProgram(this.program);
     this.uniforms = null;

package/src/phaser/display/webgl/shader/strip.js

@@ -1,15 +1,13 @@
-/**
- * @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 { generateShaderID } from '../../../util/math';
 import { compileProgram } from '../util';
 
 // the next one is used for rendering triangle strips
 
 export class StripShader {
+  /**
+   * TBD.
+   * @param gl - TBD.
+   */
   constructor(gl) {
     this.gl = gl;
     this._UID = generateShaderID();
@@ -47,6 +45,9 @@ export class StripShader {
     this.init();
   }
 
+  /**
+   * TBD.
+   */
   init() {
     const gl = this.gl;
     const program = compileProgram(gl, this.vertexSrc, this.fragmentSrc);
@@ -66,6 +67,9 @@ export class StripShader {
     this.program = program;
   }
 
+  /**
+   * TBD.
+   */
   destroy() {
     this.gl.deleteProgram(this.program);
     this.uniforms = null;