@vpmedia/phaser 1.16.0 → 1.18.0

package/src/phaser/display/graphics.js

@@ -7,6 +7,7 @@ import { Polygon } from '../geom/polygon';
 import { Circle } from '../geom/circle';
 import { Ellipse } from '../geom/ellipse';
 import { Point } from '../geom/point';
+import { Matrix } from '../geom/matrix';
 import { GraphicsData } from './graphics_data';
 import { CanvasBuffer } from './canvas/buffer';
 import { textureFromCanvas } from './webgl/texture_util';
@@ -51,6 +52,7 @@ export class Graphics extends DisplayObject {
     this._localBounds = new Rectangle(0, 0, 1, 1);
     this.dirty = true;
     this._boundsDirty = false;
+    this._cacheAsBitmap = false;
     this.webGLDirty = false;
     this.cachedSpriteDirty = false;
   }
@@ -66,9 +68,10 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param lineWidth - TBD.
-   * @param color - TBD.
-   * @param alpha - TBD.
+   * @param {number} lineWidth - TBD.
+   * @param {number} color - TBD.
+   * @param {number} alpha - TBD.
+   * @returns {Graphics} TBD.
    */
   lineStyle(lineWidth = 0, color = 0, alpha = 1) {
     this.lineWidth = lineWidth || 0;
@@ -92,6 +95,7 @@ export class Graphics extends DisplayObject {
    * TBD.
    * @param {number} x - TBD.
    * @param {number} y - TBD.
+   * @returns {Graphics} TBD.
    */
   moveTo(x, y) {
     this.drawShape(new Polygon([x, y]));
@@ -102,6 +106,7 @@ export class Graphics extends DisplayObject {
    * TBD.
    * @param {number} x - TBD.
    * @param {number} y - TBD.
+   * @returns {Graphics} TBD.
    */
   lineTo(x, y) {
     if (!this.currentPath) {
@@ -115,10 +120,11 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param cpX - TBD.
-   * @param cpY - TBD.
-   * @param toX - TBD.
-   * @param toY - TBD.
+   * @param {number} cpX - TBD.
+   * @param {number} cpY - TBD.
+   * @param {number} toX - TBD.
+   * @param {number} toY - TBD.
+   * @returns {Graphics} TBD.
    */
   quadraticCurveTo(cpX, cpY, toX, toY) {
     if (this.currentPath) {
@@ -151,12 +157,13 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param cpX - TBD.
-   * @param cpY - TBD.
-   * @param cpX2 - TBD.
-   * @param cpY2 - TBD.
-   * @param toX - TBD.
-   * @param toY - TBD.
+   * @param {number} cpX - TBD.
+   * @param {number} cpY - TBD.
+   * @param {number} cpX2 - TBD.
+   * @param {number} cpY2 - TBD.
+   * @param {number} toX - TBD.
+   * @param {number} toY - TBD.
+   * @returns {Graphics} TBD.
    */
   bezierCurveTo(cpX, cpY, cpX2, cpY2, toX, toY) {
     if (this.currentPath) {
@@ -195,11 +202,12 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param x1 - TBD.
-   * @param y1 - TBD.
-   * @param x2 - TBD.
-   * @param y2 - TBD.
-   * @param radius - TBD.
+   * @param {number} x1 - TBD.
+   * @param {number} y1 - TBD.
+   * @param {number} x2 - TBD.
+   * @param {number} y2 - TBD.
+   * @param {number} radius - TBD.
+   * @returns {Graphics} TBD.
    */
   arcTo(x1, y1, x2, y2, radius) {
     if (this.currentPath) {
@@ -246,13 +254,14 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param cx - TBD.
-   * @param cy - TBD.
-   * @param radius - TBD.
-   * @param startAngle - TBD.
-   * @param endAngle - TBD.
-   * @param anticlockwise - TBD.
-   * @param segments - TBD.
+   * @param {number} cx - TBD.
+   * @param {number} cy - TBD.
+   * @param {number} radius - TBD.
+   * @param {number} startAngle - TBD.
+   * @param {number} endAngle - TBD.
+   * @param {boolean} anticlockwise - TBD.
+   * @param {number} segments - TBD.
+   * @returns {Graphics} TBD.
    */
   arc(cx, cy, radius, startAngle, endAngle, anticlockwise = false, segments = 40) {
     //  If we do this we can never draw a full circle
@@ -299,8 +308,9 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param color - TBD.
-   * @param alpha - TBD.
+   * @param {number} color - TBD.
+   * @param {number} alpha - TBD.
+   * @returns {Graphics} TBD.
    */
   beginFill(color = 0, alpha = 1) {
     this.filling = true;
@@ -318,6 +328,7 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {Graphics} TBD.
    */
   endFill() {
     this.filling = false;
@@ -332,6 +343,7 @@ export class Graphics extends DisplayObject {
    * @param {number} y - TBD.
    * @param {number} width - TBD.
    * @param {number} height - TBD.
+   * @returns {Graphics} TBD.
    */
   drawRect(x, y, width, height) {
     this.drawShape(new Rectangle(x, y, width, height));
@@ -344,7 +356,8 @@ export class Graphics extends DisplayObject {
    * @param {number} y - TBD.
    * @param {number} width - TBD.
    * @param {number} height - TBD.
-   * @param radius - TBD.
+   * @param {number} radius - TBD.
+   * @returns {Graphics} TBD.
    */
   drawRoundedRect(x, y, width, height, radius) {
     this.drawShape(new RoundedRectangle(x, y, width, height, radius));
@@ -355,7 +368,8 @@ export class Graphics extends DisplayObject {
    * TBD.
    * @param {number} x - TBD.
    * @param {number} y - TBD.
-   * @param diameter - TBD.
+   * @param {number} diameter - TBD.
+   * @returns {Graphics} TBD.
    */
   drawCircle(x, y, diameter) {
     this.drawShape(new Circle(x, y, diameter));
@@ -368,6 +382,7 @@ export class Graphics extends DisplayObject {
    * @param {number} y - TBD.
    * @param {number} width - TBD.
    * @param {number} height - TBD.
+   * @returns {Graphics} TBD.
    */
   drawEllipse(x, y, width, height) {
     this.drawShape(new Ellipse(x, y, width, height));
@@ -376,7 +391,8 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param path - TBD.
+   * @param {Polygon} path - TBD.
+   * @returns {Graphics} TBD.
    */
   drawPolygon(path) {
     let points;
@@ -400,6 +416,7 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {Graphics} TBD.
    */
   clear() {
     this.lineWidth = 0;
@@ -422,7 +439,7 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param renderSession - TBD.
+   * @param {object} renderSession - TBD.
    */
   renderWebGL(renderSession) {
     // if the sprite is not visible or the alpha is 0 then no need to render this element
@@ -482,7 +499,7 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param renderSession - TBD.
+   * @param {object} renderSession - TBD.
    */
   renderCanvas(renderSession) {
     // if the sprite is not visible or the alpha is 0 then no need to render this element
@@ -538,7 +555,8 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param matrix - TBD.
+   * @param {Matrix} matrix - TBD.
+   * @returns {Rectangle} TBD.
    */
   getBounds(matrix = null) {
     if (!this.renderable) {
@@ -598,6 +616,7 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {Rectangle} TBD.
    */
   getLocalBounds() {
     const matrixCache = this.worldTransform;
@@ -615,8 +634,9 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param point - TBD.
-   * @param tempPoint - TBD.
+   * @param {Point} point - TBD.
+   * @param {Point} tempPoint - TBD.
+   * @returns {boolean} TBD.
    */
   containsPoint(point, tempPoint) {
     this.worldTransform.applyInverse(point, tempPoint);
@@ -772,6 +792,7 @@ export class Graphics extends DisplayObject {
   /**
    * TBD.
    * @param shape - TBD.
+   * @returns {GraphicsData} TBD.
    */
   drawShape(shape) {
     if (this.currentPath) {
@@ -842,7 +863,7 @@ export class Graphics extends DisplayObject {
    * TBD.
    * @param vertices - TBD.
    * @param indices - TBD.
-   * @param cull - TBD.
+   * @param {boolean} cull - TBD.
    */
   drawTriangles(vertices, indices, cull = false) {
     const point1 = new Point();

package/src/phaser/display/graphics_data.js

@@ -3,13 +3,13 @@ import { clone } from './graphics_data_util';
 export class GraphicsData {
   /**
    * TBD.
-   * @param lineWidth - TBD.
-   * @param lineColor - TBD.
-   * @param lineAlpha - TBD.
-   * @param fillColor - TBD.
-   * @param fillAlpha - TBD.
-   * @param fill - TBD.
-   * @param shape - TBD.
+   * @param {number} lineWidth - TBD.
+   * @param {number} lineColor - TBD.
+   * @param {number} lineAlpha - TBD.
+   * @param {number} fillColor - TBD.
+   * @param {number} fillAlpha - TBD.
+   * @param {boolean} fill - TBD.
+   * @param {object} shape - TBD.
    */
   constructor(lineWidth, lineColor, lineAlpha, fillColor, fillAlpha, fill, shape) {
     this.lineWidth = lineWidth;

package/src/phaser/display/group.js

@@ -47,8 +47,8 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
-   * @param destroyChildren - TBD.
-   * @param soft - TBD.
+   * @param {boolean} destroyChildren - TBD.
+   * @param {boolean} soft - TBD.
    */
   destroy(destroyChildren = true, soft = false) {
     if (this.game === null || this.ignoreDestroy) {
@@ -70,9 +70,10 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
-   * @param child - TBD.
-   * @param silent - TBD.
-   * @param index - TBD.
+   * @param {DisplayObject} child - TBD.
+   * @param {boolean} silent - TBD.
+   * @param {number} index - TBD.
+   * @returns {DisplayObject} TBD.
    */
   add(child, silent = false, index = -1) {
     if (child.parent === this) {
@@ -99,9 +100,9 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
-   * @param child - TBD.
-   * @param index - TBD.
-   * @param silent - TBD.
+   * @param {DisplayObject} child - TBD.
+   * @param {number} index - TBD.
+   * @param {boolean} silent - TBD.
    */
   addAt(child, index, silent) {
     this.add(child, silent, index);
@@ -109,7 +110,8 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
-   * @param index - TBD.
+   * @param {number} index - TBD.
+   * @returns {DisplayObject} TBD.
    */
   getAt(index) {
     if (index < 0 || index >= this.children.length) {
@@ -131,6 +133,7 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {DisplayObject} TBD.
    */
   next() {
     if (this.cursor) {
@@ -148,6 +151,7 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {DisplayObject} TBD.
    */
   previous() {
     if (this.cursor) {
@@ -165,8 +169,8 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
-   * @param child1 - TBD.
-   * @param child2 - TBD.
+   * @param {DisplayObject} child1 - TBD.
+   * @param {DisplayObject} child2 - TBD.
    */
   swap(child1, child2) {
     this.swapChildren(child1, child2);
@@ -175,7 +179,8 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
-   * @param child - TBD.
+   * @param {DisplayObject} child - TBD.
+   * @returns {DisplayObject} TBD.
    */
   bringToTop(child) {
     if (child.parent === this && this.getIndex(child) < this.children.length) {
@@ -187,7 +192,8 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
-   * @param child - TBD.
+   * @param {DisplayObject} child - TBD.
+   * @returns {DisplayObject} TBD.
    */
   sendToBack(child) {
     if (child.parent === this && this.getIndex(child) > 0) {
@@ -207,7 +213,8 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
-   * @param child - TBD.
+   * @param {DisplayObject} child - TBD.
+   * @returns {number} TBD.
    */
   getIndex(child) {
     return this.children.indexOf(child);
@@ -252,9 +259,10 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
-   * @param child - TBD.
-   * @param destroy - TBD.
-   * @param silent - TBD.
+   * @param {DisplayObject} child - TBD.
+   * @param {boolean} destroy - TBD.
+   * @param {boolean} silent - TBD.
+   * @returns {boolean} TBD.
    */
   remove(child, destroy = true, silent = false) {
     if (this.children.length === 0 || this.children.indexOf(child) === -1) {
@@ -276,9 +284,9 @@ export class Group extends DisplayObject {
 
   /**
    * TBD.
-   * @param destroy - TBD.
-   * @param silent - TBD.
-   * @param destroyTexture - TBD.
+   * @param {boolean} destroy - TBD.
+   * @param {boolean} silent - TBD.
+   * @param {boolean} destroyTexture - TBD.
    */
   removeAll(destroy = true, silent = false, destroyTexture = false) {
     if (this.children.length === 0) {

package/src/phaser/display/image.js

@@ -2,6 +2,7 @@ import { Texture } from './webgl/texture';
 import { AnimationManager } from '../core/animation_manager';
 import { EventManager } from '../core/event_manager';
 import { Rectangle } from '../geom/rectangle';
+import { Matrix } from '../geom/matrix';
 import { DisplayObject } from './display_object';
 import { Game } from '../core/game';
 import { clone } from '../geom/util/rectangle';
@@ -33,6 +34,7 @@ export class Image extends DisplayObject {
     this.blendMode = BLEND_NORMAL;
     this.shader = null;
     this._frame = null;
+    this.pendingDestroy = false;
     /* if (this.texture.baseTexture.hasLoaded) {
       this.onTextureUpdate();
     } */
@@ -95,8 +97,8 @@ export class Image extends DisplayObject {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @param frame - TBD.
-   * @param stopAnimation - TBD.
+   * @param {number} frame - TBD.
+   * @param {boolean} stopAnimation - TBD.
    */
   loadTexture(key, frame = 0, stopAnimation = true) {
     if (key === PENDING_ATLAS) {
@@ -183,7 +185,7 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
-   * @param parent
+   * @param parent - TBD.
    * @param {number} width - TBD.
    * @param {number} height - TBD.
    */
@@ -217,6 +219,7 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {string} TBD.
    */
   get frameName() {
     return this.animations.frameName;
@@ -233,8 +236,8 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
-   * @param rect
-   * @param copy
+   * @param rect - TBD.
+   * @param {boolean} copy - TBD.
    */
   crop(rect, copy = false) {
     if (rect) {
@@ -287,6 +290,7 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {number} TBD.
    */
   get width() {
     return this.scale.x * this.texture.frame.width;
@@ -302,6 +306,7 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {number} TBD.
    */
   get height() {
     return this.scale.y * this.texture.frame.height;
@@ -330,8 +335,8 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
-   * @param texture
-   * @param destroyBase
+   * @param texture - TBD.
+   * @param {boolean} destroyBase - TBD.
    */
   setTexture(texture, destroyBase = false) {
     setTexture(this, texture, destroyBase);
@@ -339,7 +344,8 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
-   * @param matrix - TBD.
+   * @param {Matrix} matrix - TBD.
+   * @returns {Rectangle} TBD.
    */
   getBounds(matrix = null) {
     return getBounds(this, matrix);
@@ -347,6 +353,7 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {Rectangle} TBD.
    */
   getLocalBounds() {
     return getLocalBounds(this);
@@ -354,8 +361,8 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
-   * @param renderSession - TBD.
-   * @param matrix - TBD.
+   * @param {object} renderSession - TBD.
+   * @param {Matrix} matrix - TBD.
    */
   renderWebGL(renderSession, matrix = null) {
     renderWebGL(this, renderSession, matrix);
@@ -363,8 +370,8 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
-   * @param renderSession - TBD.
-   * @param matrix - TBD.
+   * @param {object} renderSession - TBD.
+   * @param {Matrix} matrix - TBD.
    */
   renderCanvas(renderSession, matrix = null) {
     renderCanvas(this, renderSession, matrix);

package/src/phaser/display/sprite_util.js

@@ -1,5 +1,6 @@
 import { getTintedTexture } from './canvas/tinter';
 import { getIdentityMatrix } from '../geom/util/matrix';
+import { Rectangle } from '../geom/rectangle';
 import { SCALE_LINEAR } from '../core/const';
 
 /**
@@ -22,7 +23,7 @@ export function setTexture(target, texture, destroyBase = false) {
  * TBD.
  * @param {object} target - TBD.
  * @param {object} matrix - TBD.
- * @returns {object} TBD.
+ * @returns {Rectangle} TBD.
  */
 export function getBounds(target, matrix = null) {
   // TODO verify
@@ -104,7 +105,7 @@ export function getBounds(target, matrix = null) {
 /**
  * TBD.
  * @param {object} target - TBD.
- * @returns {object} TBD.
+ * @returns {Rectangle} TBD.
  */
 export function getLocalBounds(target) {
   const matrixCache = target.worldTransform;