Added CanvasTexture.drawFrame method.

Author: photonstorm

CHANGELOG.md

@@ -154,6 +154,7 @@ one set of bindings ever created, which makes things a lot cleaner.
 * The Animation class now emits the `restart` event when it restarts playing on any Game Object.
 * The Animation class now emits the `complete` event when it finishes playing on any Game Object.
 * The Animation Component has a new method called `chain` which allows you to line-up another animation to start playing as soon as the current one stops, no matter how it stops (either by reaching its natural end, or directly by having stop called on it). You can chain a new animation at any point, including before the current one starts playing, during it, or when it ends (via its `animationcomplete` callback). Chained animations are specific to a Game Object, meaning different Game Objects can have different chained animations without impacting the global animation they're playing.
+* `CanvasTexture.drawFrame` is a new method that allows you to draw a texture frame to the CanvasTexture based on the texture key and frame given.
 
 ### Updates
 

src/textures/CanvasTexture.js

@@ -223,6 +223,45 @@ var CanvasTexture = new Class({
         return this.update();
     },
 
+    /**
+     * Draws the given texture frame to this CanvasTexture, then updates the internal
+     * ImageData buffer and arrays.
+     *
+     * @method Phaser.Textures.CanvasTexture#drawFrame
+     * @since 3.16.0
+     * 
+     * @param {string} key - The unique string-based key of the Texture.
+     * @param {(string|integer)} [frame] - The string-based name, or integer based index, of the Frame to get from the Texture.
+     * @param {integer} [x=0] - The x coordinate to draw the source at.
+     * @param {integer} [y=0] - The y coordinate to draw the source at.
+     * 
+     * @return {Phaser.Textures.CanvasTexture} This CanvasTexture.
+     */
+    drawFrame: function (key, frame, x, y)
+    {
+        if (x === undefined) { x = 0; }
+        if (y === undefined) { y = 0; }
+
+        var frame = this.manager.getFrame(key, frame);
+
+        if (frame)
+        {
+            var cd = frame.canvasData;
+
+            var frameWidth = frame.cutWidth;
+            var frameHeight = frame.cutHeight;
+            var res = frame.source.resolution;
+
+            this.context.drawImage(frame.source.image, cd.x, cd.y, frameWidth, frameHeight, x, y, frameWidth / res, frameHeight / res);
+
+            return this.update();
+        }
+        else
+        {
+            return this;
+        }
+    },
+
     /**
      * Get the color of a specific pixel from this texture and store it in a Color object.
      *