Game.scratch is a single handy BitmapData instance that can be used as a visual scratch-pad, for off-screen bitmap manipulation (and is used as such by BitmapData itself).

Updated TS defs.

Author: photonstorm

README.md

@@ -88,6 +88,7 @@ Version 2.0.4 - "Mos Shirare" - in development
 * Group.resetCursor will reset the Group cursor back to the start of the group, or to the given index value.
 * World.wrap will take a game object and if its x/y coordinates fall outside of the world bounds it will be repositioned on the opposite side, for a wrap-around effect.
 * Group.classType allows you to change the type of object that Group.create or createMultiple makes to your own custom class.
+* Game.scratch is a single handy BitmapData instance that can be used as a visual scratch-pad, for off-screen bitmap manipulation (and is used as such by BitmapData itself).
 
 
 ### Bug Fixes

build/phaser.d.ts

@@ -1704,6 +1704,7 @@ declare module Phaser {
         renderType: number;
         rnd: Phaser.RandomDataGenerator;
         scale: Phaser.ScaleManager;
+        scratch: Phaser.BitmapData;
         sound: Phaser.SoundManager;
         stage: Phaser.Stage;
         state: Phaser.StateManager;
@@ -1935,6 +1936,7 @@ declare module Phaser {
         angle: number;
         alive: boolean;
         cameraOffset: Phaser.Point;
+        classType: any;
         cursor: any;
         enableBody: boolean;
         enableBodyDebug: boolean;
@@ -1959,8 +1961,8 @@ declare module Phaser {
         callbackFromArray(child: Object, callback: Function, length: number): void;
         countDead(): number;
         countLiving(): number;
-        create(x: number, y: number, key: string, frame?: any, exists?: boolean): Phaser.Sprite;
-        createMultiple(quantity: number, key: string, frame?: any, exists?: boolean): Phaser.Sprite;
+        create(x: number, y: number, key: string, frame?: any, exists?: boolean): any;
+        createMultiple(quantity: number, key: string, frame?: any, exists?: boolean): void;
         customSort(sortHandler: Function, context: Object): void;
         destroy(destroyChildren?: boolean, soft?: boolean): void;
         divideAll(property: string, amount: number, checkAlive?: boolean, checkVisible?: boolean): void;

src/core/Game.js

@@ -207,6 +207,11 @@ Phaser.Game = function (width, height, renderer, parent, state, transparent, ant
     */
     this.particles = null;
 
+    /**
+    * @property {Phaser.BitmapData} scratch - A handy BitmapData scratch-pad that can be used for off-screen bitmap manipulation.
+    */
+    this.scratch = null;
+
     /**
     * @property {boolean} stepping - Enable core loop stepping with Game.enableStep().
     * @default
@@ -445,6 +450,7 @@ Phaser.Game.prototype = {
             this.plugins = new Phaser.PluginManager(this);
             this.net = new Phaser.Net(this);
             this.debug = new Phaser.Utils.Debug(this);
+            this.scratch = new Phaser.BitmapData(this, '__root', this.width, this.height);
 
             this.time.boot();
             this.stage.boot();