Merge branch 'master' into containers

# Conflicts:
#	src/renderer/webgl/pipelines/TextureTintPipeline.js

Author: bitnenfer

CHANGELOG.md

@@ -19,6 +19,10 @@ being passed to the simulation. The default value is 1 to remain consistent with
 * HTML5AudioSound.setVolume is a chainable way to set the volume of a single Sound instance.
 * HTML5AudioSound.setSeek is a chainable way to set seek to a point of a single Sound instance.
 * HTML5AudioSound.setLoop is a chainable way to set the loop state of a single Sound instance.
+* BitmapText has a new property `letterSpacing` which accepts a positive or negative number to add / reduce spacing between characters (thanks @wtravO)
+* Matter Physics has two new debug properties: `debugShowJoint` and `debugJointColor`. If defined they will display joints in Matter bodies during the postUpdate debug phase (only if debug is enabled) (thanks @OmarShehata)
+* You can now pass a Sprite Sheet or Canvas as the Texture key to `Tilemap.addTileset` and it will work in WebGL, where-as before it would display a corrupted tilemap. Fix #3407 (thanks @Zykino)
+* Graphics.slice allows you to easily draw a Pacman, or slice of pie shape to a Graphics object.
 
 ### Bug Fixes
 
@@ -27,6 +31,13 @@ being passed to the simulation. The default value is 1 to remain consistent with
 * PathFollower.start has been renamed to `startFollow`, but PathFollower.setPath was still using `PathFollower.start` (thanks @samid737)
 * BaseSoundManager.rate and BaseSoundManager.detune would incorrectly called `setRate` on its sounds, instead of `calculateRate`.
 * The Gamepad Axis `getValue` method now correctly applies the threshold and zeroes out the returned value.
+* The HueToComponent module was not correctly exporting itself. Fix #3482 (thanks @jdotrjs)
+* Matter.World was using `setZ` instead of `setDepth` for the Debug Graphics Layer, causing it to appear behind objects in some display lists.
+* Game.destroy now checks to see if the `renderer` exists before calling destroy on it. Fix #3498 (thanks @Huararanga)
+* Keyboard.JustDown and Keyboard.JustUp were being reset too early, causing them to fail when called in `update` loops. Fix #3490 (thanks @belen-albeza)
+* RenderTexture.destroy no longer throws an error when called. Fix #3475 (thanks @kuoruan)
+* The WebGL TileSprite batch now modulates the tilePosition to avoid large values being passed into the UV data, fixing corruption when scrolling TileSprites over a long period of time. Fix #3402 (thanks @vinerz @FrancescoNegri)
+* LineCurve.getResolution was missing the `divisions` argument and always returning 1, which made it fail when used as part of a Path. It now defaults to return 1 unless specified otherwise (thanks _ok)
 
 ### Updates
 
@@ -38,8 +49,10 @@ being passed to the simulation. The default value is 1 to remain consistent with
 * The ComputedSize Component now has `setSize` and `setDisplaySize` methods. This component is used for Game Objects that have a non-texture based size.
 * The GamepadManager now extends EventEmitter directly, just like the KeyboardManager does.
 * The Gamepad Axis threshold has been increased from 0.05 to 0.1.
+* Animation.updateFrame will now call `setSizeToFrame` on the Game Object, which will adjust the Game Objects `width` and `height` properties to match the frame size. Fix #3473 (thanks @wtravO @jp-gc)
+* Animation.updateFrame now supports animation frames with custom pivot points and injects these into the Game Object origin.
 
-Also, my thanks to the following for helping with the Phaser 3 Examples, either by reporting errors or fixing them: @gabegordon @melissaelopez @samid737 @nbs @tgrajewski @pagesrichie @hexus
+Also, my thanks to the following for helping with the Phaser 3 Examples and Docs, either by reporting errors, fixing them or helping author the docs: @gabegordon @melissaelopez @samid737 @nbs @tgrajewski @pagesrichie @hexus @mbrickn @erd0s @icbat @Matthew-Herman
 
 
 

README.md

@@ -70,7 +70,7 @@ Extra special thanks to our top-tier sponsors: [Orange Games](http://orangegames
 
 Every week we publish the [Phaser World](https://phaser.io/community/newsletter) newsletter. It's packed full of the latest Phaser games, tutorials, videos, meet-ups, talks, and more. The newsletter also contains our weekly Development Progress updates which let you know about the new features we're working on.
 
-Over 100 previous editions can be found on our [Back Issues](http://phaser.io/community/backissues) page.
+Over 100 previous editions can be found on our [Back Issues](https://phaser.io/community/backissues) page.
 
 ![Download Phaser](https://phaser.io/images/github/div-download.png "Download Phaser")
 <a name="download"></a>
@@ -93,7 +93,7 @@ npm install phaser
 
 [![](https://data.jsdelivr.com/v1/package/gh/photonstorm/phaser/badge)](https://www.jsdelivr.com/package/gh/photonstorm/phaser)
 
-[Phaser is on jsDelivr](http://www.jsdelivr.com/projects/phaser) which is a "super-fast CDN for developers". Include the following in your html:
+[Phaser is on jsDelivr](https://www.jsdelivr.com/projects/phaser) which is a "super-fast CDN for developers". Include the following in your html:
 
 ```html
 <script src="//cdn.jsdelivr.net/npm/phaser@3.3.0/dist/phaser.js"></script>
@@ -137,7 +137,7 @@ Also, please subscribe to the [Phaser World](https://phaser.io/community/newslet
 
 ### Source Code Examples
 
-During our development of Phaser 3, we created hundreds of examples with the full source code and assets. Until these examples are fully integrated into the Phaser website, you can browse them on [Phaser 3 Labs](http://labs.phaser.io), or clone the [examples repo][examples]. Note: Not all examples work, sorry! We're tidying them up as fast as we can.
+During our development of Phaser 3, we created hundreds of examples with the full source code and assets. Until these examples are fully integrated into the Phaser website, you can browse them on [Phaser 3 Labs](https://labs.phaser.io), or clone the [examples repo][examples]. Note: Not all examples work, sorry! We're tidying them up as fast as we can.
 
 ### Create Your First Phaser 3 Example
 
@@ -147,7 +147,7 @@ Create an `index.html` page locally and paste the following code into it:
 <!DOCTYPE html>
 <html>
 <head>
-    <script src="http://labs.phaser.io/build/phaser-arcade-physics.min.js"></script> 
+    <script src="https://labs.phaser.io/build/phaser-arcade-physics.min.js"></script> 
 </head>
 <body>
 

src/boot/Config.js

@@ -57,10 +57,10 @@ var ValueToColor = require('../display/color/ValueToColor');
  * @property {number} [zoom=1] - [description]
  * @property {number} [resolution=1] - [description]
  * @property {number} [type=CONST.AUTO] - [description]
- * @property {*} [?parent=null] - [description]
- * @property {HTMLCanvasElement} [?canvas=null] - [description]
- * @property {string} [?canvasStyle=null] - [description]
- * @property {object} [?scene=null] - [description]
+ * @property {*} [parent=null] - [description]
+ * @property {HTMLCanvasElement} [canvas=null] - [description]
+ * @property {string} [canvasStyle=null] - [description]
+ * @property {object} [scene=null] - [description]
  * @property {string[]} [seed] - [description]
  * @property {string} [title=''] - [description]
  * @property {string} [url='http://phaser.io'] - [description]
@@ -69,17 +69,17 @@ var ValueToColor = require('../display/color/ValueToColor');
  * @property {boolean} [input.keyboard=true] - [description]
  * @property {*} [input.keyboard.target=window] - [description]
  * @property {(boolean|object)} [input.mouse=true] - [description]
- * @property {*} [?input.mouse.target=null] - [description]
+ * @property {*} [input.mouse.target=null] - [description]
  * @property {boolean} [input.touch=true] - [description]
- * @property {*} [?input.touch.target=null] - [description]
- * @property {boolean} [?input.touch.capture=true] - [description]
+ * @property {*} [input.touch.target=null] - [description]
+ * @property {boolean} [input.touch.capture=true] - [description]
  * @property {(boolean|object)} [input.gamepad=false] - [description]
  * @property {boolean} [disableContextMenu=false] - [description]
  * @property {(boolean|object)} [banner=false] - [description]
  * @property {boolean} [banner.hidePhaser=false] - [description]
  * @property {string} [banner.text='#ffffff'] - [description]
  * @property {string[]} [banner.background] - [description]
- * @property {FPSConfig} [?fps] - [description]
+ * @property {FPSConfig} [fps] - [description]
  * @property {boolean} [antialias=true] - [description]
  * @property {boolean} [pixelArt=false] - [description]
  * @property {boolean} [autoResize=false] - [description]
@@ -91,11 +91,11 @@ var ValueToColor = require('../display/color/ValueToColor');
  * @property {boolean} [failIfMajorPerformanceCaveat=false] - [description]
  * @property {boolean} [powerPreference='default'] - "high-performance", "low-power" or "default"
  * @property {(string|number)} [backgroundColor=0x000000] - [description]
- * @property {object} [?callbacks] - [description]
+ * @property {object} [callbacks] - [description]
  * @property {BootCallback} [callbacks.preBoot=NOOP] - [description]
  * @property {BootCallback} [callbacks.postBoot=NOOP] - [description]
- * @property {LoaderConfig} [?loader] - [description]
- * @property {object} [?images] - [description]
+ * @property {LoaderConfig} [loader] - [description]
+ * @property {object} [images] - [description]
  * @property {string} [images.default] - [description]
  * @property {string} [images.missing] - [description]
  */

src/boot/Game.js

@@ -538,15 +538,18 @@ var Game = new Class({
 
         this.scene.destroy();
 
-        this.renderer.destroy();
+        if (this.renderer)
+        {
+            this.renderer.destroy();
+        }
 
         this.events.emit('destroy');
 
         this.events.removeAllListeners();
 
         this.onStepCallback = null;
 
-        if (removeCanvas)
+        if (removeCanvas && this.canvas)
         {
             CanvasPool.remove(this.canvas);
         }

src/cache/CacheManager.js

@@ -43,7 +43,6 @@ var CacheManager = new Class({
          *
          * @name Phaser.Cache.CacheManager#binary
          * @type {Phaser.Cache.BaseCache}
-         * @protected
          * @since 3.0.0
          */
         this.binary = new BaseCache();
@@ -54,7 +53,6 @@ var CacheManager = new Class({
          *
          * @name Phaser.Cache.CacheManager#bitmapFont
          * @type {Phaser.Cache.BaseCache}
-         * @protected
          * @since 3.0.0
          */
         this.bitmapFont = new BaseCache();
@@ -64,7 +62,6 @@ var CacheManager = new Class({
          *
          * @name Phaser.Cache.CacheManager#json
          * @type {Phaser.Cache.BaseCache}
-         * @protected
          * @since 3.0.0
          */
         this.json = new BaseCache();
@@ -74,7 +71,6 @@ var CacheManager = new Class({
          *
          * @name Phaser.Cache.CacheManager#physics
          * @type {Phaser.Cache.BaseCache}
-         * @protected
          * @since 3.0.0
          */
         this.physics = new BaseCache();
@@ -84,7 +80,6 @@ var CacheManager = new Class({
          *
          * @name Phaser.Cache.CacheManager#shader
          * @type {Phaser.Cache.BaseCache}
-         * @protected
          * @since 3.0.0
          */
         this.shader = new BaseCache();
@@ -94,7 +89,6 @@ var CacheManager = new Class({
          *
          * @name Phaser.Cache.CacheManager#audio
          * @type {Phaser.Cache.BaseCache}
-         * @protected
          * @since 3.0.0
          */
         this.audio = new BaseCache();
@@ -104,7 +98,6 @@ var CacheManager = new Class({
          *
          * @name Phaser.Cache.CacheManager#text
          * @type {Phaser.Cache.BaseCache}
-         * @protected
          * @since 3.0.0
          */
         this.text = new BaseCache();
@@ -114,7 +107,6 @@ var CacheManager = new Class({
          *
          * @name Phaser.Cache.CacheManager#obj
          * @type {Phaser.Cache.BaseCache}
-         * @protected
          * @since 3.0.0
          */
         this.obj = new BaseCache();
@@ -125,7 +117,6 @@ var CacheManager = new Class({
          *
          * @name Phaser.Cache.CacheManager#tilemap
          * @type {Phaser.Cache.BaseCache}
-         * @protected
          * @since 3.0.0
          */
         this.tilemap = new BaseCache();
@@ -135,7 +126,6 @@ var CacheManager = new Class({
          *
          * @name Phaser.Cache.CacheManager#xml
          * @type {Phaser.Cache.BaseCache}
-         * @protected
          * @since 3.0.0
          */
         this.xml = new BaseCache();
@@ -146,7 +136,6 @@ var CacheManager = new Class({
          *
          * @name Phaser.Cache.CacheManager#custom
          * @type {Object.<Phaser.Cache.BaseCache>}
-         * @protected
          * @since 3.0.0
          */
         this.custom = {};

src/curves/LineCurve.js

@@ -107,11 +107,15 @@ var LineCurve = new Class({
      * @method Phaser.Curves.LineCurve#getResolution
      * @since 3.0.0
      *
-     * @return {integer} [description]
+     * @param {number} [divisions=1] - [description]
+     *
+     * @return {number} [description]
      */
-    getResolution: function ()
+    getResolution: function (divisions)
     {
-        return 1;
+        if (divisions === undefined) { divisions = 1; }
+
+        return divisions;
     },
 
     /**