@vpmedia/phaser 1.17.0 → 1.19.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) {
@@ -820,8 +841,8 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param points - TBD.
-   * @param cull - TBD.
+   * @param {Point[]} points - TBD.
+   * @param {boolean} cull - TBD.
    */
   drawTriangle(points, cull = false) {
     const triangle = new Polygon(points);
@@ -840,9 +861,9 @@ export class Graphics extends DisplayObject {
 
   /**
    * TBD.
-   * @param vertices - TBD.
-   * @param indices - TBD.
-   * @param cull - TBD.
+   * @param {number[]|Point[]} vertices - TBD.
+   * @param {number[]} indices - 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/image.js

@@ -1,7 +1,9 @@
 import { Texture } from './webgl/texture';
 import { AnimationManager } from '../core/animation_manager';
 import { EventManager } from '../core/event_manager';
+import { Frame } from '../core/frame';
 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';
@@ -96,7 +98,7 @@ export class Image extends DisplayObject {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @param frame - TBD.
+   * @param {number} frame - TBD.
    * @param {boolean} stopAnimation - TBD.
    */
   loadTexture(key, frame = 0, stopAnimation = true) {
@@ -139,7 +141,7 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
-   * @param frame - TBD.
+   * @param {Frame} frame - TBD.
    */
   setFrame(frame) {
     this._frame = frame;
@@ -184,7 +186,7 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
-   * @param parent
+   * @param {DisplayObject} parent - TBD.
    * @param {number} width - TBD.
    * @param {number} height - TBD.
    */
@@ -204,6 +206,7 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {number} TBD.
    */
   get frame() {
     return this.animations.frame;
@@ -235,8 +238,8 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
-   * @param rect
-   * @param copy
+   * @param {Rectangle} rect - TBD.
+   * @param {boolean} copy - TBD.
    */
   crop(rect, copy = false) {
     if (rect) {
@@ -289,6 +292,7 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {number} TBD.
    */
   get width() {
     return this.scale.x * this.texture.frame.width;
@@ -304,6 +308,7 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {number} TBD.
    */
   get height() {
     return this.scale.y * this.texture.frame.height;
@@ -332,8 +337,8 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
-   * @param texture
-   * @param destroyBase
+   * @param {Texture} texture - TBD.
+   * @param {boolean} destroyBase - TBD.
    */
   setTexture(texture, destroyBase = false) {
     setTexture(this, texture, destroyBase);
@@ -341,7 +346,8 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
-   * @param matrix - TBD.
+   * @param {Matrix} matrix - TBD.
+   * @returns {Rectangle} TBD.
    */
   getBounds(matrix = null) {
     return getBounds(this, matrix);
@@ -349,6 +355,7 @@ export class Image extends DisplayObject {
 
   /**
    * TBD.
+   * @returns {Rectangle} TBD.
    */
   getLocalBounds() {
     return getLocalBounds(this);
@@ -356,8 +363,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);
@@ -365,8 +372,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;