littlejsengine 1.11.7 → 1.11.9

package/examples/index.html

@@ -164,7 +164,8 @@ for (const example of exampleList)
 }
 
 // select first option
-selectExample.selectedIndex = 1;
+selectExample.selectedIndex = location.hash.split`#`[1] | 0
+
 setExample();
 
 onresize = () =>
@@ -182,12 +183,17 @@ onresize();
 
 function setExample()
 {
-    const example = exampleList[selectExample.selectedIndex];
+    if (selectExample.selectedIndex < 1 || selectExample.selectedIndex >= exampleList.length)
+        selectExample.selectedIndex = 1;  // reset to default
+    let example = exampleList[selectExample.selectedIndex];
+    if (!example.filename)
+        example = exampleList[selectExample.selectedIndex = 1]; // reset to default
     exampleInfo.innerText = example.name + (example.description ? ' - ' + example.description : '');
     const filename = 'examples/' + example.filename;
     exampleLink.href = 'https://github.com/KilledByAPixel/LittleJS/tree/main/' + filename;
     exampleLink.innerText = filename;
     loadFile(example.filename, example.fullExample);
+    location.hash = selectExample.selectedIndex;
 }
 
 function codeInput()
@@ -267,7 +273,7 @@ function setCode(code, largeExample)
         iframeContent.console.assert = function (condition, output)
         {
             if (!condition)
-                setErrorMessage('Assertion failed: ' + (output || ''));
+                setErrorMessage('Assertion failed!\n' + (output || '') + '\n' + (new Error).stack);
             originalAssert.apply(this, arguments);
         };
 

package/examples/shorts/shapes.js

@@ -13,9 +13,9 @@ function gameRender()
     }
 
     // circles and ellipses
-    drawCircle(vec2(0,5), 1, 0,  hsl(.15,1,.5));
+    drawCircle(vec2(0,5), 1, hsl(.15,1,.5));
     drawEllipse(vec2(-5,5), 2, 1, 0, hsl(0,1,.5));
-    drawEllipse(vec2(5,5), 1, .5, 0, hsl(.55,1,.5));
+    drawEllipse(vec2(5,5), .5, 2, .5, hsl(.55,1,.5));
 
     // rects and lines
     drawRect(vec2(0,-5), vec2(13,2), hsl(.6,1,.5));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "littlejsengine",
-  "version": "1.11.7",
+  "version": "1.11.9",
   "description": "LittleJS - Tiny and Fast HTML5 Game Engine",
   "main": "dist/littlejs.esm.js",
   "types": "dist/littlejs.d.ts",

package/reference.md

@@ -1,11 +1,11 @@
 # LittleJS Engine Quick Reference Sheet
 
-##  This cheat sheet contains all LittleJS essentials.
+## This cheat sheet contains all LittleJS essentials.
 - [LittleJS on GitHub](https://github.com/KilledByAPixel/LittleJS) - Official LittleJS website with more info
 - [LittleJS Documentation](https://killedbyapixel.github.io/LittleJS/docs) - LittleJS documentation browser
 - [Particle System Designer](https://killedbyapixel.github.io/LittleJS/examples/particles) - Editor for LittleJS Particle Systems
 - [Sound Effect Designer](https://killedbyapixel.github.io/ZzFX) - Tool for creating ZzFX sound effects
-- [Starter Project](https://killedbyapixel.github.io/LittleJS/examples/starter) - Simple LittleJS demo  to start with
+- [Starter Project](https://killedbyapixel.github.io/LittleJS/examples/starter) - Simple LittleJS demo to start with
 
 ## LittleJS Setup
 
@@ -32,7 +32,7 @@ hsl(h=0, s=0, l=1, a=1)                       // Create a color object with HSLA
 tile(pos=(0,0), size, textureIndex=0)         // Create a tile info object
 
 // Helper functions 
-abs(value)                                    // Get absoulte value
+abs(value)                                    // Get absolute value
 min(valueA, valueB)                           // Get lowest of values
 max(valueA, valueB)                           // Get highest of values
 sign(value)                                   // Get the sign of value

package/src/engine.js

@@ -30,7 +30,7 @@ const engineName = 'LittleJS';
  *  @type {String}
  *  @default
  *  @memberof Engine */
-const engineVersion = '1.11.7';
+const engineVersion = '1.11.9';
 
 /** Frames per second to update
  *  @type {Number}

package/src/engineDraw.js

@@ -216,6 +216,8 @@ function drawTile(pos, size=vec2(1), tileInfo, color=new Color,
     ASSERT(!context || !useWebGL, 'context only supported in canvas 2D mode'); 
     ASSERT(typeof tileInfo !== 'number' || !tileInfo, 
         'this is an old style calls, to fix replace it with tile(tileIndex, tileSize)');
+    ASSERT(isVector2(pos) && isVector2(size));
+    ASSERT(isColor(color) && isColor(additiveColor));
 
     const textureInfo = tileInfo && tileInfo.getTextureInfo();
     if (useWebGL)
@@ -269,7 +271,7 @@ function drawTile(pos, size=vec2(1), tileInfo, color=new Color,
             else
             {
                 // if no tile info, force untextured
-                context.fillStyle = color;
+                context.fillStyle = color.toString();
                 context.fillRect(-.5, -.5, 1, 1);
             }
         }, screenSpace, context);
@@ -316,6 +318,7 @@ function drawLine(posA, posB, thickness=.1, color, useWebGL, screenSpace, contex
  *  @memberof Draw */
 function drawPoly(points, color=new Color, lineWidth=0, lineColor=new Color(0,0,0), screenSpace, context=mainContext)
 {
+    ASSERT(isColor(color) && isColor(lineColor));
     context.fillStyle = color.toString();
     context.beginPath();
     for (const point of screenSpace ? points : points.map(worldToScreen))
@@ -343,6 +346,7 @@ function drawPoly(points, color=new Color, lineWidth=0, lineColor=new Color(0,0,
  *  @memberof Draw */
 function drawEllipse(pos, width=1, height=1, angle=0, color=new Color, lineWidth=0, lineColor=new Color(0,0,0), screenSpace, context=mainContext)
 {
+    ASSERT(isColor(color) && isColor(lineColor));
     if (!screenSpace)
     {
         pos = worldToScreen(pos);

package/src/engineExport.js

@@ -252,7 +252,6 @@ export {
 	gamepadWasPressed,
 	gamepadWasReleased,
 	gamepadStick,
-	mouseToScreen,
 	gamepadsUpdate,
 	vibrate,
 	vibrateStop,

package/src/engineObject.js

@@ -118,7 +118,7 @@ class EngineObject
         {
             // copy parent pos/angle
             const mirror = parent.getMirrorSign();
-            this.pos = this.localPos.multiply(vec2(mirror,1)).rotate(-parent.angle).add(parent.pos);
+            this.pos = this.localPos.multiply(vec2(mirror,1)).rotate(parent.angle).add(parent.pos);
             this.angle = mirror*this.localAngle + parent.angle;
         }
 
@@ -346,11 +346,11 @@ class EngineObject
 
     /** Convert from local space to world space for a vector (rotation only)
      *  @param {Vector2} vec - local space vector */
-    localToWorldVector(vec) { return vec.rotate(-this.angle); }
+    localToWorldVector(vec) { return vec.rotate(this.angle); }
 
     /** Convert from world space to local space for a vector (rotation only)
      *  @param {Vector2} vec - world space vector */
-    worldToLocalVector(vec) { return vec.rotate(this.angle); }
+    worldToLocalVector(vec) { return vec.rotate(-this.angle); }
     
     /** Called to check if a tile collision should be resolved
      *  @param {Number}  tileData - the value of the tile at the position

package/src/engineUtilities.js

@@ -272,7 +272,7 @@ class RandomGenerator
         this.seed ^= this.seed << 13; 
         this.seed ^= this.seed >>> 17; 
         this.seed ^= this.seed << 5;
-        return valueB + (valueA - valueB) * abs(this.seed % 1e8) / 1e8;
+        return valueB + (valueA - valueB) * ((this.seed >>> 0) / 2**32);
     }
 
     /** Returns a floored seeded random value the two values passed in
@@ -461,11 +461,11 @@ class Vector2
         return this.x*v.y - this.y*v.x;
     }
 
-    /** Returns the angle of this vector, up is angle 0
+    /** Returns the clockwise angle of this vector, up is angle 0
      * @return {Number} */
     angle() { return Math.atan2(this.x, this.y); }
 
-    /** Sets this vector with angle and length passed in
+    /** Sets this vector with clockwise angle and length passed in
      * @param {Number} [angle]
      * @param {Number} [length]
      * @return {Vector2} */
@@ -476,13 +476,13 @@ class Vector2
         return this;
     }
 
-    /** Returns copy of this vector rotated by the angle passed in
+    /** Returns copy of this vector rotated by the clockwise angle passed in
      * @param {Number} angle
      * @return {Vector2} */
     rotate(angle)
     { 
-        const c = Math.cos(angle), s = Math.sin(angle); 
-        return new Vector2(this.x*c + this.y*s, this.x*s + this.y*c);
+        const c = Math.cos(-angle), s = Math.sin(-angle); 
+        return new Vector2(this.x*c - this.y*s, this.x*s + this.y*c);
     }
 
     /** Set the integer direction of this vector, corresponding to multiples of 90 degree rotation (0-3)
@@ -817,57 +817,57 @@ class Color
 ///////////////////////////////////////////////////////////////////////////////
 // default colors
 
-/** Color - White
+/** Color - White #ffffff
  *  @type {Color}
  *  @memberof Utilities */
-const WHITE = rgb();
+const WHITE = rgb(); 
 
-/** Color - Black
+/** Color - Black #000000
  *  @type {Color}
  *  @memberof Utilities */
 const BLACK = rgb(0,0,0);
 
-/** Color - Gray
+/** Color - Gray #808080
  *  @type {Color}
  *  @memberof Utilities */
 const GRAY = rgb(.5,.5,.5);
 
-/** Color - Red
+/** Color - Red #ff0000
  *  @type {Color}
  *  @memberof Utilities */
 const RED = rgb(1,0,0);
 
-/** Color - Orange
+/** Color - Orange #ff8000
  *  @type {Color}
  *  @memberof Utilities */
 const ORANGE = rgb(1,.5,0);
 
-/** Color - Yellow
+/** Color - Yellow #ffff00
  *  @type {Color}
  *  @memberof Utilities */
 const YELLOW = rgb(1,1,0);
 
-/** Color - Green
+/** Color - Green #00ff00
  *  @type {Color}
  *  @memberof Utilities */
 const GREEN = rgb(0,1,0);
 
-/** Color - Cyan
+/** Color - Cyan #00ffff
  *  @type {Color}
  *  @memberof Utilities */
 const CYAN = rgb(0,1,1);
 
-/** Color - Blue
+/** Color - Blue #0000ff
  *  @type {Color}
  *  @memberof Utilities */
 const BLUE = rgb(0,0,1);
 
-/** Color - Purple
+/** Color - Purple #8000ff
  *  @type {Color}
  *  @memberof Utilities */
 const PURPLE = rgb(.5,0,1);
 
-/** Color - Magenta
+/** Color - Magenta #ff00ff
  *  @type {Color}
  *  @memberof Utilities */
 const MAGENTA = rgb(1,0,1);

package/.vscode/launch.json

@@ -1,14 +0,0 @@
-{
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "type": "chrome",
-            "request": "launch",
-            "name": "Open index.html",
-            "file": "c:\\dev\\FrankGames\\html5\\LittleJS\\LittleJS\\shortExamples\\index.html"
-        }
-    ]
-}