Updated the Device little / big endianess check.

Author: photonstorm

README.md

@@ -75,6 +75,7 @@ Version 2.0.4 - "Mos Shirare" - in development
 * All Game Objects have a new property: destroyPhase (boolean) which is true if the object is in the process of being destroyed, otherwise false.
 * If Tween.yoyo was true but repeat was 0 then it wouldn't yoyo. Now if yoyo is set, but not repeat, the repeat count gets set to 1 (thanks @hilts-vaughan, fix #744)
 * RandomDataGenerator.integerInRange uses a new method of rounding the value to an integer to avoid distribution probability issues (thanks PhaserFan)
+* Updated the Device little / big endianess check.
 
 
 ### New Features

build/phaser.d.ts

@@ -1132,6 +1132,7 @@ declare module Phaser {
         add(object: any): void;
         alphaMask(source: any, mask: any): void;
         clear(): void;
+        cls(): void;
         copyPixels(source: any, area: Phaser.Rectangle, destX: number, destY: number): void;
         draw(source: any, destX: number, destY: number): void;
         getPixel(x: number, y: number): number;

src/core/Game.js

@@ -208,7 +208,7 @@ 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.
+    * @property {Phaser.BitmapData} scratch - A handy BitmapData scratch-pad that can be used for off-screen bitmap manipulation. Defaults to 1024 x 1024 in size and doesn't upload to the GPU.
     */
     this.scratch = null;
 
@@ -450,7 +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.scratch = new Phaser.BitmapData(this, '__root', 1024, 1024);
 
             this.time.boot();
             this.stage.boot();

src/gameobjects/BitmapData.js

@@ -106,6 +106,11 @@ Phaser.BitmapData = function (game, key, width, height) {
     */
     this.dirty = false;
 
+    /**
+    * @property {function} cls - Alias for BitmapData.clear.
+    */
+    this.cls = this.clear;
+
 };
 
 Phaser.BitmapData.prototype = {
@@ -183,6 +188,59 @@ Phaser.BitmapData.prototype = {
 
     /**
     * Sets the color of the given pixel to the specified red, green, blue and alpha values.
+    *
+    * @method Phaser.BitmapData#replaceRGB
+    * @param {number} x - The X coordinate of the pixel to be set.
+    * @param {number} y - The Y coordinate of the pixel to be set.
+    * @param {number} red - The red color value, between 0 and 0xFF (255).
+    * @param {number} green - The green color value, between 0 and 0xFF (255).
+    * @param {number} blue - The blue color value, between 0 and 0xFF (255).
+    * @param {number} alpha - The alpha color value, between 0 and 0xFF (255).
+    */
+    replaceRGB: function (sourceR, sourceG, sourceB, sourceA, destR, destG, destB, destA, region) {
+
+        var x = 0;
+        var y = 0;
+        var w = this.width;
+        var h = this.height;
+
+        if (region instanceof Phaser.Rectangle)
+        {
+            x = region.x;
+            y = region.y;
+            w = region.width;
+            h = region.height;
+        }
+
+
+
+        if (x >= 0 && x <= this.width && y >= 0 && y <= this.height)
+        {
+            this.pixels[y * this.width + x] = (alpha << 24) | (blue << 16) | (green << 8) | red;
+
+            /*
+            if (this.isLittleEndian)
+            {
+                this.data32[y * this.width + x] = (alpha << 24) | (blue << 16) | (green << 8) | red;
+            }
+            else
+            {
+                this.data32[y * this.width + x] = (red << 24) | (green << 16) | (blue << 8) | alpha;
+            }
+           */
+
+            // this.imageData.data.set(this.data8);
+
+            this.context.putImageData(this.imageData, 0, 0);
+
+            this.dirty = true;
+        }
+
+    },
+
+    /**
+    * Sets the color of the given pixel to the specified red, green, blue and alpha values.
+    *
     * @method Phaser.BitmapData#setPixel32
     * @param {number} x - The X coordinate of the pixel to be set.
     * @param {number} y - The Y coordinate of the pixel to be set.
@@ -252,6 +310,7 @@ Phaser.BitmapData.prototype = {
     /**
     * Get the color of a specific pixel including its alpha value.
     *
+    * @method Phaser.BitmapData#getPixel32
     * @param {number} x - The X coordinate of the pixel to get.
     * @param {number} y - The Y coordinate of the pixel to get.
     * @return {number} A native color value integer (format: 0xAARRGGBB)
@@ -268,6 +327,7 @@ Phaser.BitmapData.prototype = {
     /**
     * Gets all the pixels from the region specified by the given Rectangle object.
     *
+    * @method Phaser.BitmapData#getPixels
     * @param {Phaser.Rectangle} rect - The Rectangle region to get.
     * @return {array} CanvasPixelArray.
     */
@@ -280,6 +340,7 @@ Phaser.BitmapData.prototype = {
     /**
     * Copies the pixels from the source image to this BitmapData based on the given area and destination.
     *
+    * @method Phaser.BitmapData#copyPixels
     * @param {HTMLImage|string} source - The Image to draw. If you give a key it will try and find the Image in the Game.Cache.
     * @param {Phaser.Rectangle} area - The Rectangle region to copy from the source image.
     * @param {number} destX - The destination x coordinate to copy the image to.
@@ -302,11 +363,15 @@ Phaser.BitmapData.prototype = {
     /**
     * Draws the given image to this BitmapData at the coordinates specified. If you need to only draw a part of the image use BitmapData.copyPixels instead.
     *
-    * @param {HTMLImage|string} source - The Image to draw. If you give a key it will try and find the Image in the Game.Cache.
-    * @param {number} destX - The destination x coordinate to draw the image to.
-    * @param {number} destY - The destination y coordinate to draw the image to.
+    * @method Phaser.BitmapData#draw
+    * @param {HTMLImage|string} source - The Image to draw. If you give a string it will try and find the Image in the Game.Cache.
+    * @param {number} [x=0] - The x coordinate to draw the image to.
+    * @param {number} [y=0] - The y coordinate to draw the image to.
     */
-    draw: function (source, destX, destY) {
+    draw: function (source, x, y) {
+
+        if (typeof x === 'undefined') { x = 0; }
+        if (typeof y === 'undefined') { y = 0; }
 
         if (typeof source === 'string')
         {
@@ -315,11 +380,30 @@ Phaser.BitmapData.prototype = {
 
         if (source)
         {
-            this.context.drawImage(source, 0, 0, source.width, source.height, destX, destY, source.width, source.height);
+            this.context.drawImage(source, 0, 0, source.width, source.height, x, y, source.width, source.height);
         }
 
     },
 
+    /**
+    * Draws the given image to this BitmapData at the coordinates specified. If you need to only draw a part of the image use BitmapData.copyPixels instead.
+    *
+    * @method Phaser.BitmapData#drawSprite
+    * @param {Phaser.Sprite|Phaser.Image} sprite - The Sprite to draw. Must have a loaded texture and frame.
+    * @param {number} [x=0] - The x coordinate to draw the Sprite to.
+    * @param {number} [y=0] - The y coordinate to draw the Sprite to.
+    */
+    drawSprite: function (sprite, x, y) {
+
+        if (typeof x === 'undefined') { x = 0; }
+        if (typeof y === 'undefined') { y = 0; }
+
+        var frame = sprite.texture.frame;
+
+        this.context.drawImage(sprite.texture.baseTexture.source, frame.x, frame.y, frame.width, frame.height, x, y, frame.width, frame.height);
+
+    },
+
     /**
     * Draws the given image onto this BitmapData using an image as an alpha mask.
     *

src/system/Device.js

@@ -663,7 +663,7 @@ Phaser.Device.prototype = {
     },
 
     /**
-    * Check PixelRatio of devices.
+    * Check PixelRatio, iOS device, Vibration API, ArrayBuffers and endianess.
     * @method Phaser.Device#_checkDevice
     * @private
     */
@@ -676,15 +676,18 @@ Phaser.Device.prototype = {
 
         if (typeof Int8Array !== 'undefined')
         {
-            this.littleEndian = new Int8Array(new Int16Array([1]).buffer)[0] > 0;
             this.typedArray = true;
         }
         else
         {
-            this.littleEndian = false;
             this.typedArray = false;
         }
 
+        if (typeof ArrayBuffer !== 'undefined' && typeof Uint8Array !== 'undefined' && typeof Uint32Array !== 'undefined')
+        {
+            this.littleEndian = this._checkIsLittleEndian();
+        }
+
         navigator.vibrate = navigator.vibrate || navigator.webkitVibrate || navigator.mozVibrate || navigator.msVibrate;
 
         if (navigator.vibrate)
@@ -694,6 +697,40 @@ Phaser.Device.prototype = {
 
     },
 
+    /**
+    * Check Little or Big Endian system.
+    * @author Matt DesLauriers (@mattdesl)
+    * @method Phaser.Device#_checkIsLittleEndian
+    * @private
+    */
+    _checkIsLittleEndian: function () {
+
+        var a = new ArrayBuffer(4);
+        var b = new Uint8Array(a);
+        var c = new Uint32Array(a);
+
+        b[0] = 0xa1;
+        b[1] = 0xb2;
+        b[2] = 0xc3;
+        b[3] = 0xd4;
+
+        if (c[0] == 0xd4c3b2a1)
+        {
+            return true;
+        }
+
+        if (c[0] == 0xa1b2c3d4)
+        {
+            return false;
+        }
+        else
+        {
+            //  Could not determine endianness
+            return null;
+        }
+
+    },
+
     /**
     * Check whether the host environment support 3D CSS.
     * @method Phaser.Device#_checkCSS3D