@vpmedia/phaser 1.11.0 → 1.13.0

package/src/phaser/display/sprite_util.js

@@ -1,17 +1,19 @@
 /**
+ * @module display/sprite_util
+ * @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>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
 import { getTintedTexture } from './canvas/tinter';
 import { getIdentityMatrix } from '../geom/util/matrix';
 import { SCALE_LINEAR } from '../core/const';
 
 /**
+ * TBD.
  *
- * @param {object} target TBD
- * @param {object} texture TBD
- * @param {boolean} destroyBase TBD
+ * @param {object} target - TBD.
+ * @param {object} texture - TBD.
+ * @param {boolean} destroyBase - TBD.
  */
 export function setTexture(target, texture, destroyBase = false) {
   if (destroyBase) {
@@ -24,10 +26,11 @@ export function setTexture(target, texture, destroyBase = false) {
 }
 
 /**
+ * TBD.
  *
- * @param {object} target TBD
- * @param {object} matrix TBD
- * @returns {object} TBD
+ * @param {object} target - TBD.
+ * @param {object} matrix - TBD.
+ * @returns {object} TBD.
  */
 export function getBounds(target, matrix = null) {
   // TODO verify
@@ -107,9 +110,10 @@ export function getBounds(target, matrix = null) {
 }
 
 /**
+ * TBD.
  *
- * @param {object} target TBD
- * @returns {object} TBD
+ * @param {object} target - TBD.
+ * @returns {object} TBD.
  */
 export function getLocalBounds(target) {
   const matrixCache = target.worldTransform;
@@ -127,10 +131,11 @@ export function getLocalBounds(target) {
 }
 
 /**
+ * TBD.
  *
- * @param {object} target TBD
- * @param {object} renderSession TBD
- * @param {object} matrix TBD
+ * @param {object} target - TBD.
+ * @param {object} renderSession - TBD.
+ * @param {object} matrix - TBD.
  */
 export function renderWebGL(target, renderSession, matrix) {
   // if the sprite is not visible or the alpha is 0 then no need to render this element
@@ -176,14 +181,21 @@ export function renderWebGL(target, renderSession, matrix) {
 }
 
 /**
+ * TBD.
  *
- * @param {object} target TBD
- * @param {object} renderSession TBD
- * @param {object} matrix TBD
+ * @param {object} target - TBD.
+ * @param {object} renderSession - TBD.
+ * @param {object} matrix - TBD.
  */
 export function renderCanvas(target, renderSession, matrix) {
   // If the sprite is not visible or the alpha is 0 then no need to render this element
-  if (!target.visible || target.alpha === 0 || !target.renderable || target.texture.crop.width <= 0 || target.texture.crop.height <= 0) {
+  if (
+    !target.visible ||
+    target.alpha === 0 ||
+    !target.renderable ||
+    target.texture.crop.width <= 0 ||
+    target.texture.crop.height <= 0
+  ) {
     return;
   }
   let wt = target.worldTransform;
@@ -193,7 +205,8 @@ export function renderCanvas(target, renderSession, matrix) {
   }
   if (target.blendMode !== renderSession.currentBlendMode) {
     renderSession.currentBlendMode = target.blendMode;
-    renderSession.context.globalCompositeOperation = window.PhaserRegistry.blendModesCanvas[renderSession.currentBlendMode];
+    renderSession.context.globalCompositeOperation =
+      window.PhaserRegistry.blendModesCanvas[renderSession.currentBlendMode];
   }
   if (target._mask) {
     renderSession.maskManager.pushMask(target._mask, renderSession);
@@ -204,15 +217,23 @@ export function renderCanvas(target, renderSession, matrix) {
     renderSession.context.globalAlpha = target.worldAlpha;
 
     //  If smoothingEnabled is supported and we need to change the smoothing property for this texture
-    if (renderSession.smoothProperty && renderSession.scaleMode !== target.texture.baseTexture.scaleMode) {
+    if (
+      renderSession.smoothProperty &&
+      renderSession.scaleMode !== target.texture.baseTexture.scaleMode
+    ) {
       renderSession.scaleMode = target.texture.baseTexture.scaleMode;
-      renderSession.context[renderSession.smoothProperty] = (renderSession.scaleMode === SCALE_LINEAR);
+      renderSession.context[renderSession.smoothProperty] =
+        renderSession.scaleMode === SCALE_LINEAR;
     }
     //  If the texture is trimmed we offset by the trim x/y, otherwise we use the frame dimensions
-    let dx = (target.texture.trim) ? target.texture.trim.x - target.anchor.x * target.texture.trim.width : target.anchor.x * -target.texture.frame.width;
-    let dy = (target.texture.trim) ? target.texture.trim.y - target.anchor.y * target.texture.trim.height : target.anchor.y * -target.texture.frame.height;
-    const tx = (wt.tx * renderSession.resolution) + renderSession.shakeX;
-    const ty = (wt.ty * renderSession.resolution) + renderSession.shakeY;
+    let dx = target.texture.trim
+      ? target.texture.trim.x - target.anchor.x * target.texture.trim.width
+      : target.anchor.x * -target.texture.frame.width;
+    let dy = target.texture.trim
+      ? target.texture.trim.y - target.anchor.y * target.texture.trim.height
+      : target.anchor.y * -target.texture.frame.height;
+    const tx = wt.tx * renderSession.resolution + renderSession.shakeX;
+    const ty = wt.ty * renderSession.resolution + renderSession.shakeY;
     //  Allow for pixel rounding
     if (renderSession.roundPixels) {
       renderSession.context.setTransform(wt.a, wt.b, wt.c, wt.d, tx | 0, ty | 0);
@@ -225,20 +246,40 @@ export function renderCanvas(target, renderSession, matrix) {
     let ch = target.texture.crop.height;
     dx /= resolution;
     dy /= resolution;
-    if (target.tint !== 0xFFFFFF) {
+    if (target.tint !== 0xffffff) {
       if (target.texture.requiresReTint || target.cachedTint !== target.tint) {
         target.tintedTexture = getTintedTexture(target, target.tint);
         target.cachedTint = target.tint;
         target.texture.requiresReTint = false;
       }
-      renderSession.context.drawImage(target.tintedTexture, 0, 0, cw, ch, dx, dy, cw / resolution, ch / resolution);
+      renderSession.context.drawImage(
+        target.tintedTexture,
+        0,
+        0,
+        cw,
+        ch,
+        dx,
+        dy,
+        cw / resolution,
+        ch / resolution
+      );
     } else {
       const cx = target.texture.crop.x;
       const cy = target.texture.crop.y;
       // https://github.com/photonstorm/phaser-ce/pull/61
       cw = Math.floor(cw);
       ch = Math.floor(ch);
-      renderSession.context.drawImage(target.texture.baseTexture.source, cx, cy, cw, ch, dx, dy, cw / resolution, ch / resolution);
+      renderSession.context.drawImage(
+        target.texture.baseTexture.source,
+        cx,
+        cy,
+        cw,
+        ch,
+        dx,
+        dy,
+        cw / resolution,
+        ch / resolution
+      );
     }
   }
   for (let i = 0; i < target.children.length; i += 1) {

package/src/phaser/display/text.js

@@ -1,19 +1,28 @@
 /**
+ * @module display/text
+ * @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>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-import Point from '../geom/point';
-import Rectangle from '../geom/rectangle';
-import Image from './image';
+import { Point } from '../geom/point';
+import { Rectangle } from  '../geom/rectangle';
+import { Image } from './image';
 import { create, remove } from './canvas/pool';
 import { textureFromCanvas } from './webgl/texture_util';
 import { TEXT } from '../core/const';
 import { snapToCeil } from '../util/math';
 import { renderCanvas, renderWebGL, getBounds } from './sprite_util';
 
-export default class extends Image {
-
+export class Text extends Image {
+  /**
+   * TBD.
+   *
+   * @param {object} game - TBD.
+   * @param {number} x - TBD.
+   * @param {number} y - TBD.
+   * @param {string} text - TBD.
+   * @param {object} style - TBD.
+   */
   constructor(game, x, y, text = '', style = {}) {
     super(game, x, y, null);
     this.game = game;
@@ -60,7 +69,14 @@ export default class extends Image {
     super.destroy();
   }
 
-  setShadow(x = 0, y = 0, color = 'rgba(0, 0, 0, 1)', blur = 0, shadowStroke = true, shadowFill = true) {
+  setShadow(
+    x = 0,
+    y = 0,
+    color = 'rgba(0, 0, 0, 1)',
+    blur = 0,
+    shadowStroke = true,
+    shadowFill = true
+  ) {
     this.style.shadowOffsetX = x;
     this.style.shadowOffsetY = y;
     this.style.shadowColor = color;
@@ -139,7 +155,12 @@ export default class extends Image {
       if (tabs === 0) {
         //  Simple layout (no tabs)
         lineWidth = this.style.strokeThickness + this.padding.x;
-        if (this.colors.length > 0 || this.strokeColors.length > 0 || this.fontWeights.length > 0 || this.fontStyles.length > 0) {
+        if (
+          this.colors.length > 0 ||
+          this.strokeColors.length > 0 ||
+          this.fontWeights.length > 0 ||
+          this.fontStyles.length > 0
+        ) {
           lineWidth += this.measureLine(lines[i]);
         } else {
           lineWidth += this.context.measureText(lines[i]).width;
@@ -156,7 +177,12 @@ export default class extends Image {
           let tab = 0;
           for (let c = 0; c < line.length; c += 1) {
             let section = 0;
-            if (this.colors.length > 0 || this.strokeColors.length > 0 || this.fontWeights.length > 0 || this.fontStyles.length > 0) {
+            if (
+              this.colors.length > 0 ||
+              this.strokeColors.length > 0 ||
+              this.fontWeights.length > 0 ||
+              this.fontStyles.length > 0
+            ) {
               section = this.measureLine(line[c]);
             } else {
               section = Math.ceil(this.context.measureText(line[c]).width);
@@ -169,7 +195,12 @@ export default class extends Image {
         } else {
           for (let c = 0; c < line.length; c += 1) {
             //  How far to the next tab?
-            if (this.colors.length > 0 || this.strokeColors.length > 0 || this.fontWeights.length > 0 || this.fontStyles.length > 0) {
+            if (
+              this.colors.length > 0 ||
+              this.strokeColors.length > 0 ||
+              this.fontWeights.length > 0 ||
+              this.fontStyles.length > 0
+            ) {
               lineWidth += this.measureLine(line[c]);
             } else {
               lineWidth += Math.ceil(this.context.measureText(line[c]).width);
@@ -192,7 +223,7 @@ export default class extends Image {
     }
     // Adjust for line spacing
     if (lineSpacing !== 0) {
-      height += (lineSpacing > 0) ? lineSpacing * lines.length : lineSpacing * (lines.length - 1);
+      height += lineSpacing > 0 ? lineSpacing * lines.length : lineSpacing * (lines.length - 1);
     }
     this.canvas.height = height * this._res;
     this.context.scale(this._res, this._res);
@@ -214,9 +245,9 @@ export default class extends Image {
     for (let i = 0; i < drawnLines; i += 1) {
       // Split the line by
       linePositionX = this.style.strokeThickness / 2;
-      linePositionY = (this.style.strokeThickness / 2 + i * lineHeight) + fontProperties.ascent;
+      linePositionY = this.style.strokeThickness / 2 + i * lineHeight + fontProperties.ascent;
       if (i > 0) {
-        linePositionY += (lineSpacing * i);
+        linePositionY += lineSpacing * i;
       }
       if (this.style.align === 'right') {
         linePositionX += maxLineWidth - lineWidths[i];
@@ -227,7 +258,12 @@ export default class extends Image {
         linePositionX = Math.round(linePositionX);
         linePositionY = Math.round(linePositionY);
       }
-      if (this.colors.length > 0 || this.strokeColors.length > 0 || this.fontWeights.length > 0 || this.fontStyles.length > 0) {
+      if (
+        this.colors.length > 0 ||
+        this.strokeColors.length > 0 ||
+        this.fontWeights.length > 0 ||
+        this.fontStyles.length > 0
+      ) {
         this.updateLine(lines[i], linePositionX, linePositionY);
       } else {
         if (this.style.stroke && this.style.strokeThickness) {
@@ -456,7 +492,9 @@ export default class extends Image {
               // if wordWrapWidth is too small for even a single
               // letter, shame user failure with a fatal error
               if (!newWord.length) {
-                throw new Error('This text\'s wordWrapWidth setting is less than a single character!');
+                throw new Error(
+                  "This text's wordWrapWidth setting is less than a single character!"
+                );
               }
               // replace current word in array with remainder
               const secondPart = word.substr(newWord.length);
@@ -465,10 +503,13 @@ export default class extends Image {
               out += newWord;
             }
             // if existing word length is 0, don't include it
-            const offset = (words[j].length) ? j : j + 1;
+            const offset = words[j].length ? j : j + 1;
             // collapse rest of sentence
             // remove any trailing white space
-            const remainder = words.slice(offset).join(' ').replace(/[ \n]*$/gi, '');
+            const remainder = words
+              .slice(offset)
+              .join(' ')
+              .replace(/[ \n]*$/gi, '');
             // prepend remainder to next line
             lines[i + 1] = remainder + ' ' + (lines[i + 1] || '');
             linesCount = lines.length;
@@ -536,11 +577,16 @@ export default class extends Image {
     //        larger | smaller
     //        {number} (em | ex | ch | rem | vh | vw | vmin | vmax | px | mm | cm | in | pt | pc | %)
     // font-family - rest (but identifiers or quoted with comma separation)
-    const m = font.match(/^\s*(?:\b(normal|italic|oblique|inherit)?\b)\s*(?:\b(normal|small-caps|inherit)?\b)\s*(?:\b(normal|bold|bolder|lighter|100|200|300|400|500|600|700|800|900|inherit)?\b)\s*(?:\b(xx-small|x-small|small|medium|large|x-large|xx-large|larger|smaller|0|\d*(?:[.]\d*)?(?:%|[a-z]{2,5}))?\b)\s*(.*)\s*$/);
+    const m = font.match(
+      /^\s*(?:\b(normal|italic|oblique|inherit)?\b)\s*(?:\b(normal|small-caps|inherit)?\b)\s*(?:\b(normal|bold|bolder|lighter|100|200|300|400|500|600|700|800|900|inherit)?\b)\s*(?:\b(xx-small|x-small|small|medium|large|x-large|xx-large|larger|smaller|0|\d*(?:[.]\d*)?(?:%|[a-z]{2,5}))?\b)\s*(.*)\s*$/
+    );
     if (m) {
       let family = m[5].trim();
       // If it looks like the value should be quoted, but isn't, then quote it.
-      if (!/^(?:inherit|serif|sans-serif|cursive|fantasy|monospace)$/.exec(family) && !/['",]/.exec(family)) {
+      if (
+        !/^(?:inherit|serif|sans-serif|cursive|fantasy|monospace)$/.exec(family) &&
+        !/['",]/.exec(family)
+      ) {
         family = "'" + family + "'";
       }
       return {
@@ -560,15 +606,25 @@ export default class extends Image {
     const parts = [];
     let v;
     v = components.fontStyle;
-    if (v && v !== 'normal') { parts.push(v); }
+    if (v && v !== 'normal') {
+      parts.push(v);
+    }
     v = components.fontVariant;
-    if (v && v !== 'normal') { parts.push(v); }
+    if (v && v !== 'normal') {
+      parts.push(v);
+    }
     v = components.fontWeight;
-    if (v && v !== 'normal') { parts.push(v); }
+    if (v && v !== 'normal') {
+      parts.push(v);
+    }
     v = components.fontSize;
-    if (v && v !== 'medium') { parts.push(v); }
+    if (v && v !== 'medium') {
+      parts.push(v);
+    }
     v = components.fontFamily;
-    if (v) { parts.push(v); }
+    if (v) {
+      parts.push(v);
+    }
     if (!parts.length) {
       // Fallback to whatever value the 'font' was
       parts.push(components.font);
@@ -649,18 +705,18 @@ export default class extends Image {
       if (this.style.boundsAlignH === 'right') {
         x += this.textBounds.width - this.canvas.width / this.resolution;
       } else if (this.style.boundsAlignH === 'center') {
-        x += this.textBounds.halfWidth - (this.canvas.width / this.resolution / 2);
+        x += this.textBounds.halfWidth - this.canvas.width / this.resolution / 2;
       }
       if (this.style.boundsAlignV === 'bottom') {
         y += this.textBounds.height - this.canvas.height / this.resolution;
       } else if (this.style.boundsAlignV === 'middle') {
-        y += this.textBounds.halfHeight - (this.canvas.height / this.resolution / 2);
+        y += this.textBounds.halfHeight - this.canvas.height / this.resolution / 2;
       }
       this.pivot.x = -x;
       this.pivot.y = -y;
     }
     // Can't render something with a zero sized dimension
-    this.renderable = (w !== 0 && h !== 0);
+    this.renderable = w !== 0 && h !== 0;
     this.texture.requiresReTint = true;
     this.texture.baseTexture.dirty();
   }
@@ -697,7 +753,10 @@ export default class extends Image {
 
   getFontPropertiesContext() {
     if (!window.PhaserRegistry.fontPropertiesContext) {
-      window.PhaserRegistry.fontPropertiesContext = this.getFontPropertiesCanvas().getContext('2d', { willReadFrequently: true });
+      window.PhaserRegistry.fontPropertiesContext = this.getFontPropertiesCanvas().getContext(
+        '2d',
+        { willReadFrequently: true }
+      );
     }
     return window.PhaserRegistry.fontPropertiesContext;
   }
@@ -713,7 +772,7 @@ export default class extends Image {
       const width = Math.ceil(context.measureText('|MÉq').width);
       let baseline = Math.ceil(context.measureText('|MÉq').width);
       const height = 2 * baseline;
-      baseline = baseline * 1.4 | 0;
+      baseline = (baseline * 1.4) | 0;
       canvas.width = width;
       canvas.height = height;
       context.fillStyle = '#f00';
@@ -815,7 +874,10 @@ export default class extends Image {
     let mutatedValue = value || 'Arial';
     mutatedValue = mutatedValue.trim();
     // If it looks like the value should be quoted, but isn't, then quote it.
-    if (!/^(?:inherit|serif|sans-serif|cursive|fantasy|monospace)$/.exec(mutatedValue) && !/['",]/.exec(mutatedValue)) {
+    if (
+      !/^(?:inherit|serif|sans-serif|cursive|fantasy|monospace)$/.exec(mutatedValue) &&
+      !/['",]/.exec(mutatedValue)
+    ) {
       mutatedValue = "'" + mutatedValue + "'";
     }
 
@@ -1082,5 +1144,4 @@ export default class extends Image {
     this.scale.y = value / this.texture.frame.height;
     this._height = value;
   }
-
 }

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

@@ -1,12 +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
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
 
 export default class {
-
   constructor(fragmentSrc, uniforms) {
     this.passes = [this];
     this.shaders = [];
@@ -21,5 +20,4 @@ export default class {
       this.shaders[i].dirty = true;
     }
   }
-
 }

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

@@ -1,13 +1,13 @@
 /**
+ * @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
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
 import { removeByCanvas } from '../canvas/pool';
 
-export default class {
-
+export class BaseTexture {
   constructor(source, scaleMode) {
     this.resolution = 1;
     this.width = 100;
@@ -22,7 +22,11 @@ export default class {
     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;
@@ -64,5 +68,4 @@ export default class {
     this._glTextures.length = 0;
     this.dirty();
   }
-
 }

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

@@ -1,12 +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
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
 
 export default class {
-
   constructor() {
     this.gl = null;
     this.currentBlendMode = 99999;
@@ -31,5 +30,4 @@ export default class {
   destroy() {
     this.gl = null;
   }
-
 }