Cameras now emit prerender and postrender events if they are set to render to textures.

Author: photonstorm

CHANGELOG.md

@@ -56,6 +56,7 @@ Doing this gives you the ability to modify the texture before this happens, allo
 * `Camera.glTexture` is a WebGL Texture that the Camera will render to if running under the WebGL Renderer and rendering to a texture.
 * `Camera.framebuffer` is a WebGL Frame Buffer that the Camera will render to if running under the WebGL Renderer and rendering to a texture.
 * `Camera.pipeline` is the Pipeline that the Camera will render with if running under the WebGL Renderer and rendering to a texture with a pipeline set.
+* If you set a Camera to render to a texture then it will emit 2 events during the render loop. First, it will emit the event `prerender`. This happens right before any Game Object's are drawn to the Camera texture. Then, it will emit the event `postrender`. This happens after all Game Object's have been drawn, but right before the Camera texture is rendered to the main game canvas. It's the final point at which you can manipulate the texture before it appears in-game.
 
 ## New Features
 

src/cameras/2d/Camera.js

@@ -291,8 +291,17 @@ var Camera = new Class({
      * on the texture.
      * 
      * If running under Canvas the Camera will render to its `canvas` property.
+     * 
      * If running under WebGL the Camera will create a frame buffer, which is stored in its `framebuffer` and `glTexture` properties.
      * 
+     * If you set a camera to render to a texture then it will emit 2 events during the render loop:
+     * 
+     * First, it will emit the event `prerender`. This happens right before any Game Object's are drawn to the Camera texture.
+     * 
+     * Then, it will emit the event `postrender`. This happens after all Game Object's have been drawn, but right before the
+     * Camera texture is rendered to the main game canvas. It's the final point at which you can manipulate the texture before
+     * it appears in-game.
+     * 
      * You should not enable this unless you plan on actually using the texture it creates
      * somehow, otherwise you're just doubling the work required to render your game.
      * 

src/renderer/canvas/CanvasRenderer.js

@@ -401,7 +401,8 @@ var CanvasRenderer = new Class({
         var cw = camera._cw;
         var ch = camera._ch;
 
-        var ctx = scene.sys.context;
+        var ctx = (camera.renderToTexture) ? camera.context : scene.sys.context;
+
         var scissor = (cx !== 0 || cy !== 0 || cw !== ctx.canvas.width || ch !== ctx.canvas.height);
 
         this.currentContext = ctx;
@@ -428,6 +429,11 @@ var CanvasRenderer = new Class({
             ctx.clip();
         }
 
+        if (camera.renderToTexture)
+        {
+            camera.emit('prerender', camera);
+        }
+
         camera.matrix.copyToContext(ctx);
 
         for (var i = 0; i < childCount; i++)
@@ -466,6 +472,13 @@ var CanvasRenderer = new Class({
         {
             ctx.restore();
         }
+
+        if (camera.renderToTexture)
+        {
+            camera.emit('postrender', camera);
+
+            scene.sys.context.drawImage(camera.canvas, cx, cy);
+        }
     },
 
     /**

src/renderer/webgl/WebGLRenderer.js

@@ -1569,6 +1569,8 @@ var WebGLRenderer = new Class({
                     color.alphaGL
                 );
             }
+            
+            camera.emit('prerender', camera);
         }
         else if (color.alphaGL > 0)
         {
@@ -1608,11 +1610,12 @@ var WebGLRenderer = new Class({
 
         if (camera.renderToTexture)
         {
-            // this.flush();
             TextureTintPipeline.flush();
 
             this.setFramebuffer(null);
 
+            camera.emit('postrender', camera);
+
             TextureTintPipeline.projOrtho(0, TextureTintPipeline.width, TextureTintPipeline.height, 0, -1000.0, 1000.0);
 
             var getTint = Utils.getTintAppendFloatAlpha;
@@ -1641,8 +1644,6 @@ var WebGLRenderer = new Class({
                 null
             );
 
-            // this.setPipeline(TextureTintPipeline);
-
             //  Force clear the current texture so that items next in the batch (like Graphics) don't try and use it
             this.setBlankTexture(true);
         }