The setFrame method of the Texture component has been updated so that it will now automatically reset the width and height of a Game Object to match that of the new Frame. Related, it will also adjust the display origin values, because they are size based. If the Frame has a custom pivot it will set the origin to match the custom pivot instead.

Author: photonstorm

CHANGELOG.md

@@ -37,7 +37,7 @@
 * If you set `transparent` in the Game Config but didn't provide a `backgroundColor` then it would render as black. It will now be properly transparent. If you do provide a color value then it must include an alpha component.
 * You can now pass normal Groups to Arcade Physics collide / overlap, as well as Physics Groups. Fix #3277 (thanks @nkholski)
 * Texture.get has been optimized to fail first, then error, with a new falsey check. This allows you to skip out specifying animation frames in the animation config without generating a console warning.
-
+* The `setFrame` method of the Texture component has been updated so that it will now automatically reset the `width` and `height` of a Game Object to match that of the new Frame. Related, it will also adjust the display origin values, because they are size based. If the Frame has a custom pivot it will set the origin to match the custom pivot instead.
 * Documentation updates: thanks to @melissaelopez @samme
 
 

src/gameobjects/components/Origin.js

@@ -16,6 +16,17 @@
 
 var Origin = {
 
+    /**
+     * A property indicating that a Game Object has this component.
+     * 
+     * @name Phaser.GameObjects.Components.Origin#_originComponent
+     * @type {boolean}
+     * @private
+     * @default true
+     * @since 3.2.0
+     */
+    _originComponent: true,
+
     /**
      * The horizontal origin of this Game Object.
      * The origin maps the relationship between the size and position of the Game Object.

src/gameobjects/components/Size.js

@@ -13,6 +13,17 @@
 
 var Size = {
 
+    /**
+     * A property indicating that a Game Object has this component.
+     * 
+     * @name Phaser.GameObjects.Components.Size#_sizeComponent
+     * @type {boolean}
+     * @private
+     * @default true
+     * @since 3.2.0
+     */
+    _sizeComponent: true,
+
     /**
      * The native (un-scaled) width of this Game Object.
      * 

src/gameobjects/components/Texture.js

@@ -60,6 +60,9 @@ var Texture = {
      * The Frame has to belong to the current Texture being used.
      *
      * It can be either a string or an index.
+     *
+     * Calling `setFrame` will modify the `width` and `height` properties of your Game Object.
+     * It will also change the `origin` if the Frame has a custom pivot point, as exported from packages like Texture Packer.
      * 
      * @method Phaser.GameObjects.Components.Texture#setFrame
      * @since 3.0.0
@@ -81,9 +84,21 @@ var Texture = {
             this.renderFlags |= _FLAG;
         }
 
-        if (this.frame.customPivot)
+        if (this._sizeComponent)
+        {
+            this.setSizeToFrame();
+        }
+
+        if (this._originComponent)
         {
-            this.setOrigin(this.frame.pivotX, this.frame.pivotY);
+            if (this.frame.customPivot)
+            {
+                this.setOrigin(this.frame.pivotX, this.frame.pivotY);
+            }
+            else
+            {
+                this.updateDisplayOrigin();
+            }
         }
 
         return this;