Added copyToContext method

Author: photonstorm

CHANGELOG.md

@@ -54,6 +54,7 @@ The process of managing scissors in the WebGLRenderer has been completely rewrit
 * The Canvas Renderer has a new method `setContext` which allows it to swap the context being drawn to by all draw operations. Call the method with no arguments to reset it to the default game canvas.
 * If you set `window.FORCE_WEBGL` or `window.FORCE_CANVAS` in the window in which the Phaser game is loaded it will over-ride the renderer type setting in your game config, and force either WebGL or Canvas. This is handy for quickly testing the differences between renderers without having to do a new build each time.
 * `TextureSource.source` is a new property that contains the original source of the Texture image. It is cleared when the source is destroyed.
+* `TransformMatrix.copyToContext` is a new method that will copy the values from the Matrix to the given Canvas Rendering Context.
 
 ### Updates
 

src/gameobjects/components/TransformMatrix.js

@@ -621,6 +621,25 @@ var TransformMatrix = new Class({
         return this;
     },
 
+    /**
+     * Copy the values from this Matrix to the given Canvas Rendering Context.
+     *
+     * @method Phaser.GameObjects.Components.TransformMatrix#copyToContext
+     * @since 3.12.0
+     *
+     * @param {CanvasRenderingContext2D} ctx - The Canvas Rendering Context to copy the matrix values to.
+     *
+     * @return {CanvasRenderingContext2D} The Canvas Rendering Context.
+     */
+    copyToContext: function (ctx)
+    {
+        var matrix = this.matrix;
+
+        ctx.transform(matrix[0], matrix[1], matrix[2], matrix[3], matrix[4], matrix[5]);
+
+        return ctx;
+    },
+
     /**
      * Copy the values in this Matrix to the array given.
      * 
@@ -643,7 +662,6 @@ var TransformMatrix = new Class({
         }
         else
         {
-
             out[0] = matrix[0];
             out[1] = matrix[1];
             out[2] = matrix[2];