@vpmedia/phaser 1.16.0 → 1.18.0

package/src/phaser/display/text.js

@@ -1,5 +1,6 @@
 import { Point } from '../geom/point';
 import { Rectangle } from '../geom/rectangle';
+import { Matrix } from '../geom/matrix';
 import { Image } from './image';
 import { create, remove } from './canvas/pool';
 import { textureFromCanvas } from './webgl/texture_util';
@@ -71,9 +72,9 @@ export class Text extends Image {
    * @param {number} x - TBD.
    * @param {number} y - TBD.
    * @param color - TBD.
-   * @param blur
-   * @param shadowStroke
-   * @param shadowFill
+   * @param blur - TBD.
+   * @param shadowStroke - TBD.
+   * @param shadowFill - TBD.
    */
   setShadow(x = 0, y = 0, color = 'rgba(0, 0, 0, 1)', blur = 0, shadowStroke = true, shadowFill = true) {
     this.style.shadowOffsetX = x;
@@ -297,10 +298,10 @@ export class Text extends Image {
 
   /**
    * TBD.
-   * @param line
+   * @param line - TBD.
    * @param {number} x - TBD.
    * @param {number} y - TBD.
-   * @param fill
+   * @param fill - TBD.
    */
   renderTabLine(line, x, y, fill) {
     const text = line.split(/(?:\t)/);
@@ -354,7 +355,7 @@ export class Text extends Image {
 
   /**
    * TBD.
-   * @param line
+   * @param line - TBD.
    */
   measureLine(line) {
     let lineLength = 0;
@@ -390,7 +391,7 @@ export class Text extends Image {
 
   /**
    * TBD.
-   * @param line
+   * @param line - TBD.
    * @param {number} x - TBD.
    * @param {number} y - TBD.
    */
@@ -428,6 +429,7 @@ export class Text extends Image {
 
   /**
    * TBD.
+   * @returns {Text} TBD.
    */
   clearColors() {
     this.colors = [];
@@ -438,6 +440,7 @@ export class Text extends Image {
 
   /**
    * TBD.
+   * @returns {Text} TBD.
    */
   clearFontValues() {
     this.fontStyles = [];
@@ -450,6 +453,7 @@ export class Text extends Image {
    * TBD.
    * @param color - TBD.
    * @param position - TBD.
+   * @returns {Text} TBD.
    */
   addColor(color, position) {
     this.colors[position] = color;
@@ -461,6 +465,7 @@ export class Text extends Image {
    * TBD.
    * @param color - TBD.
    * @param position - TBD.
+   * @returns {Text} TBD.
    */
   addStrokeColor(color, position) {
     this.strokeColors[position] = color;
@@ -470,8 +475,9 @@ export class Text extends Image {
 
   /**
    * TBD.
-   * @param style
+   * @param style - TBD.
    * @param position - TBD.
+   * @returns {Text} TBD.
    */
   addFontStyle(style, position) {
     this.fontStyles[position] = style;
@@ -481,8 +487,9 @@ export class Text extends Image {
 
   /**
    * TBD.
-   * @param weight
+   * @param weight - TBD.
    * @param position - TBD.
+   * @returns {Text} TBD.
    */
   addFontWeight(weight, position) {
     this.fontWeights[position] = weight;
@@ -643,6 +650,7 @@ export class Text extends Image {
   /**
    * TBD.
    * @param font - TBD.
+   * @returns {object} TBD.
    */
   fontToComponents(font) {
     // The format is specified in http://www.w3.org/TR/CSS2/fonts.html#font-shorthand:
@@ -677,7 +685,7 @@ export class Text extends Image {
 
   /**
    * TBD.
-   * @param components
+   * @param components - TBD.
    */
   componentsToFont(components) {
     const parts = [];
@@ -712,7 +720,8 @@ export class Text extends Image {
   /**
    * TBD.
    * @param text - TBD.
-   * @param immediate
+   * @param immediate - TBD.
+   * @returns {Text} TBD.
    */
   setText(text, immediate = false) {
     this.text = text.toString() || '';
@@ -727,6 +736,7 @@ export class Text extends Image {
   /**
    * TBD.
    * @param list
+   * @returns {Text} TBD.
    */
   parseList(list) {
     if (!Array.isArray(list)) {
@@ -757,6 +767,7 @@ export class Text extends Image {
    * @param {number} y - TBD.
    * @param {number} width - TBD.
    * @param {number} height - TBD.
+   * @returns {Text} TBD.
    */
   setTextBounds(x, y, width, height) {
     if (x === undefined) {
@@ -819,7 +830,7 @@ export class Text extends Image {
 
   /**
    * TBD.
-   * @param renderSession - TBD.
+   * @param {object} renderSession - TBD.
    */
   renderWebGL(renderSession) {
     if (this.dirty) {
@@ -831,7 +842,7 @@ export class Text extends Image {
 
   /**
    * TBD.
-   * @param renderSession - TBD.
+   * @param {object} renderSession - TBD.
    */
   renderCanvas(renderSession) {
     if (this.dirty) {
@@ -843,6 +854,7 @@ export class Text extends Image {
 
   /**
    * TBD.
+   * @returns {object} TBD.
    */
   getFontPropertiesCache() {
     if (!window.PhaserRegistry.fontPropertiesCache) {
@@ -853,6 +865,7 @@ export class Text extends Image {
 
   /**
    * TBD.
+   * @returns {HTMLCanvasElement} TBD.
    */
   getFontPropertiesCanvas() {
     if (!window.PhaserRegistry.fontPropertiesCanvas) {
@@ -953,7 +966,7 @@ export class Text extends Image {
 
   /**
    * TBD.
-   * @param matrix - TBD.
+   * @param {Matrix} matrix - TBD.
    * @returns {Rectangle} TBD.
    */
   getBounds(matrix = null) {

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

@@ -1,8 +1,8 @@
 export class AbstractFilter {
   /**
    * TBD.
-   * @param fragmentSrc
-   * @param uniforms
+   * @param fragmentSrc - TBD.
+   * @param {object} uniforms - TBD.
    */
   constructor(fragmentSrc, uniforms) {
     this.passes = [this];

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

@@ -3,8 +3,8 @@ import { removeByCanvas } from '../canvas/pool';
 export class BaseTexture {
   /**
    * TBD.
-   * @param source
-   * @param scaleMode
+   * @param {HTMLCanvasElement} source - TBD.
+   * @param {number} scaleMode - TBD.
    */
   constructor(source, scaleMode) {
     this.resolution = 1;

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

@@ -9,7 +9,7 @@ export class WebGLBlendModeManager {
 
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   setContext(gl) {
     this.gl = gl;
@@ -17,7 +17,8 @@ export class WebGLBlendModeManager {
 
   /**
    * TBD.
-   * @param blendMode
+   * @param {number} blendMode - TBD.
+   * @returns {boolean} TBD.
    */
   setBlendMode(blendMode) {
     if (this.currentBlendMode === blendMode) {

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

@@ -1,7 +1,7 @@
 export class Node {
   /**
    * TBD.
-   * @param i
+   * @param {number} i - TBD.
    * @param {number} x - TBD.
    * @param {number} y - TBD.
    */

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

@@ -1,7 +1,7 @@
 export class FastSpriteBatch {
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   constructor(gl) {
     this.vertSize = 10;
@@ -36,7 +36,7 @@ export class FastSpriteBatch {
 
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   setContext(gl) {
     this.gl = gl;
@@ -53,8 +53,8 @@ export class FastSpriteBatch {
 
   /**
    * TBD.
-   * @param spriteBatch
-   * @param renderSession - TBD.
+   * @param spriteBatch - TBD.
+   * @param {object} renderSession - TBD.
    */
   begin(spriteBatch, renderSession) {
     this.renderSession = renderSession;
@@ -72,7 +72,7 @@ export class FastSpriteBatch {
 
   /**
    * TBD.
-   * @param spriteBatch
+   * @param spriteBatch - TBD.
    */
   render(spriteBatch) {
     const children = spriteBatch.children;
@@ -96,7 +96,7 @@ export class FastSpriteBatch {
 
   /**
    * TBD.
-   * @param sprite
+   * @param sprite - TBD.
    */
   renderSprite(sprite) {
     if (!sprite.visible) {

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

@@ -10,7 +10,7 @@ export class WebGLFilterManager {
 
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   setContext(gl) {
     this.gl = gl;

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

@@ -3,10 +3,10 @@ import { SCALE_LINEAR } from '../../core/const';
 export class FilterTexture {
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    * @param {number} width - TBD.
    * @param {number} height - TBD.
-   * @param scaleMode
+   * @param {number} scaleMode - TBD.
    */
   constructor(gl, width, height, scaleMode) {
     this.gl = gl;

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

@@ -1,7 +1,7 @@
 export class GraphicsData {
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   constructor(gl) {
     this.gl = gl;

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

@@ -11,9 +11,9 @@ export class RenderTexture extends Texture {
    * TBD.
    * @param {number} width - TBD.
    * @param {number} height - TBD.
-   * @param renderer
-   * @param scaleMode
-   * @param resolution
+   * @param renderer - TBD.
+   * @param {number} scaleMode - TBD.
+   * @param {number} resolution - TBD.
    */
   constructor(width, height, renderer, scaleMode, resolution = 1) {
     const w = width || 100;
@@ -79,6 +79,7 @@ export class RenderTexture extends Texture {
 
   /**
    * TBD.
+   * @returns {HTMLImageElement} TBD.
    */
   getImage() {
     const image = new Image();
@@ -88,6 +89,7 @@ export class RenderTexture extends Texture {
 
   /**
    * TBD.
+   * @returns {string} TBD.
    */
   getBase64() {
     return this.getCanvas().toDataURL();
@@ -95,8 +97,10 @@ export class RenderTexture extends Texture {
 
   /**
    * TBD.
+   * @returns {HTMLCanvasElement} TBD.
    */
   getCanvas() {
     // TODO
+    return null;
   }
 }

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

@@ -22,6 +22,7 @@ import {
 import { remove } from '../canvas/pool';
 import { isPowerOfTwo } from '../../util/math';
 import { Point } from '../../geom/point';
+import { Matrix } from '../../geom/matrix';
 import { WebGLShaderManager } from './shader_manager';
 import { WebGLSpriteBatch } from './sprite_batch';
 import * as WebGLMaskManager from './mask_manager';
@@ -39,6 +40,7 @@ export class WebGLRenderer {
     this.type = RENDER_WEBGL;
     this.resolution = game.config.resolution;
     this.autoResize = false;
+    this.contextLost = false;
     this.clearBeforeRender = game.config.clearBeforeRender;
     this.width = game.width;
     this.height = game.height;
@@ -152,7 +154,7 @@ export class WebGLRenderer {
 
   /**
    * TBD.
-   * @param stage
+   * @param stage - TBD.
    */
   render(stage) {
     if (this.contextLost) {
@@ -174,10 +176,10 @@ export class WebGLRenderer {
 
   /**
    * TBD.
-   * @param displayObject
-   * @param projection
-   * @param buffer
-   * @param matrix - TBD.
+   * @param displayObject - TBD.
+   * @param projection - TBD.
+   * @param buffer - TBD.
+   * @param {Matrix} matrix - TBD.
    */
   renderDisplayObject(displayObject, projection, buffer, matrix) {
     this.renderSession.blendModeManager.setBlendMode(BLEND_NORMAL);
@@ -220,7 +222,8 @@ export class WebGLRenderer {
 
   /**
    * TBD.
-   * @param texture
+   * @param texture - TBD.
+   * @returns {boolean} TBD.
    */
   updateTexture(texture) {
     if (!texture.hasLoaded) {

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

@@ -6,7 +6,7 @@ import { compileProgram } from '../util';
 export class ComplexPrimitiveShader {
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   constructor(gl) {
     this.gl = gl;

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

@@ -6,7 +6,7 @@ import { compileProgram } from '../util';
 export class FastShader {
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   constructor(gl) {
     this.gl = gl;

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

@@ -26,7 +26,7 @@ const defaultVertexSrc = [
 export class NormalShader {
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   constructor(gl) {
     this.gl = gl;
@@ -131,7 +131,7 @@ export class NormalShader {
 
   /**
    * TBD.
-   * @param uniform
+   * @param uniform - TBD.
    */
   initSampler2D(uniform) {
     if (!uniform.value || !uniform.value.baseTexture || !uniform.value.baseTexture.hasLoaded) {

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

@@ -6,7 +6,7 @@ import { compileProgram } from '../util';
 export class PrimitiveShader {
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   constructor(gl) {
     this.gl = gl;

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

@@ -6,7 +6,7 @@ import { compileProgram } from '../util';
 export class StripShader {
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   constructor(gl) {
     this.gl = gl;

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

@@ -26,7 +26,7 @@ export class WebGLShaderManager {
 
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   setContext(gl) {
     this.gl = gl;
@@ -40,7 +40,7 @@ export class WebGLShaderManager {
 
   /**
    * TBD.
-   * @param attribs
+   * @param attribs - TBD.
    */
   setAttribs(attribs) {
     // reset temp state
@@ -68,7 +68,7 @@ export class WebGLShaderManager {
 
   /**
    * TBD.
-   * @param shader
+   * @param shader - TBD.
    */
   setShader(shader) {
     if (this._currentId === shader._UID) {

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

@@ -1,5 +1,7 @@
 import { AbstractFilter } from './abstract_filter';
 import { NormalShader } from './shader/normal';
+import { BaseTexture } from './base_texture';
+import { Matrix } from '../../geom/matrix';
 
 export class WebGLSpriteBatch {
   /**
@@ -46,7 +48,7 @@ export class WebGLSpriteBatch {
 
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   setContext(gl) {
     this.gl = gl;
@@ -69,7 +71,7 @@ export class WebGLSpriteBatch {
 
   /**
    * TBD.
-   * @param renderSession - TBD.
+   * @param {object} renderSession - TBD.
    */
   begin(renderSession) {
     this.renderSession = renderSession;
@@ -86,8 +88,8 @@ export class WebGLSpriteBatch {
 
   /**
    * TBD.
-   * @param sprite
-   * @param matrix - TBD.
+   * @param sprite - TBD.
+   * @param {Matrix} matrix - TBD.
    */
   render(sprite, matrix) {
     const texture = sprite.texture;
@@ -294,9 +296,9 @@ export class WebGLSpriteBatch {
 
   /**
    * TBD.
-   * @param texture
-   * @param size
-   * @param startIndex
+   * @param {BaseTexture} texture - TBD.
+   * @param {number} size - TBD.
+   * @param {number} startIndex - TBD.
    */
   renderBatch(texture, size, startIndex) {
     if (size === 0) {

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

@@ -12,7 +12,7 @@ export class WebGLStencilManager {
 
   /**
    * TBD.
-   * @param gl - TBD.
+   * @param {WebGLRenderingContext} gl - TBD.
    */
   setContext(gl) {
     this.gl = gl;
@@ -29,8 +29,8 @@ export class WebGLStencilManager {
   /**
    * TBD.
    * @param graphics - TBD.
-   * @param webGLData
-   * @param renderSession - TBD.
+   * @param webGLData - TBD.
+   * @param {object} renderSession - TBD.
    */
   pushStencil(graphics, webGLData, renderSession) {
     const gl = renderSession.gl;
@@ -87,8 +87,8 @@ export class WebGLStencilManager {
   /**
    * TBD.
    * @param graphics - TBD.
-   * @param webGLData
-   * @param renderSession - TBD.
+   * @param webGLData - TBD.
+   * @param {object} renderSession - TBD.
    */
   bindGraphics(graphics, webGLData, renderSession) {
     // if(this._currentGraphics === graphics)return;
@@ -134,8 +134,8 @@ export class WebGLStencilManager {
   /**
    * TBD.
    * @param graphics - TBD.
-   * @param webGLData
-   * @param renderSession - TBD.
+   * @param webGLData - TBD.
+   * @param {object} renderSession - TBD.
    */
   popStencil(graphics, webGLData, renderSession) {
     const gl = renderSession.gl;

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

@@ -1,4 +1,5 @@
 import { Rectangle } from '../../geom/rectangle';
+import { BaseTexture } from './base_texture';
 
 export class TextureUvs {
   /**
@@ -19,10 +20,10 @@ export class TextureUvs {
 export class Texture {
   /**
    * TBD.
-   * @param baseTexture - TBD.
-   * @param frame - TBD.
-   * @param crop - TBD.
-   * @param trim - TBD.
+   * @param {BaseTexture} baseTexture - TBD.
+   * @param {Rectangle} frame - TBD.
+   * @param {Rectangle} crop - TBD.
+   * @param {Rectangle} trim - TBD.
    */
   constructor(baseTexture, frame, crop, trim) {
     this.noFrame = false;
@@ -64,7 +65,7 @@ export class Texture {
 
   /**
    * TBD.
-   * @param destroyBase - TBD.
+   * @param {boolean} destroyBase - TBD.
    */
   destroy(destroyBase = false) {
     if (destroyBase) {
@@ -75,7 +76,8 @@ export class Texture {
 
   /**
    * TBD.
-   * @param frame - TBD.
+   * @param {Rectangle} frame - TBD.
+   * @throws Error.
    */
   setFrame(frame) {
     this.noFrame = false;