phaser/Plugins/CameraFX/Flash.ts

/// <reference path="../../Phaser/Game.ts" />
/// <reference path="../../Phaser/core/Plugin.ts" />

/**
* Phaser - Plugins - Camera FX - Flash
*
* The camera is filled with the given color and returns to normal at the given duration.
*/

module Phaser.Plugins.CameraFX {

    export class Flash extends Phaser.Plugin {

        constructor(game: Phaser.Game, parent) {

            super(game, parent);
            this.camera = parent;

        }

        public camera: Phaser.Camera;

        private _fxFlashColor: string;
        private _fxFlashComplete = null;
        private _fxFlashDuration: number = 0;
        private _fxFlashAlpha: number = 0;

        /**
        * The camera is filled with this color and returns to normal at the given duration.
        * 
        * @param	Color		The color you want to use in 0xRRGGBB format, i.e. 0xffffff for white.
        * @param	Duration	How long it takes for the flash to fade.
        * @param	OnComplete	An optional function you want to run when the flash finishes. Set to null for no callback.
        * @param	Force		Force an already running flash effect to reset.
        */
        public start(color: number = 0xffffff, duration: number = 1, onComplete = null, force: bool = false) {

            if (force === false && this._fxFlashAlpha > 0)
            {
                //  You can't flash again unless you force it
                return;
            }

            if (duration <= 0)
            {
                duration = 1;
            }

            var red = color >> 16 & 0xFF;
            var green = color >> 8 & 0xFF;
            var blue = color & 0xFF;

            this._fxFlashColor = 'rgba(' + red + ',' + green + ',' + blue + ',';
            this._fxFlashDuration = duration;
            this._fxFlashAlpha = 1;
            this._fxFlashComplete = onComplete;

        }

        public postUpdate() {

            //  Update the Flash effect
            if (this._fxFlashAlpha > 0)
            {
                this._fxFlashAlpha -= this.game.time.elapsed / this._fxFlashDuration;

                if (this.game.math.roundTo(this._fxFlashAlpha, -2) <= 0)
                {
                    this._fxFlashAlpha = 0;

                    if (this._fxFlashComplete !== null)
                    {
                        this._fxFlashComplete();
                    }
                }
            }

        }

        public postRender() {

            if (this._fxFlashAlpha > 0)
            {
                this.game.stage.context.fillStyle = this._fxFlashColor + this._fxFlashAlpha + ')';
                this.game.stage.context.fillRect(this.camera.screenView.x, this.camera.screenView.y, this.camera.width, this.camera.height);
            }

        }

    }

}