littlejsengine 1.6.0 → 1.6.4

package/build/littlejs.esm.js

@@ -45,6 +45,12 @@ let showWatermark = 1;
  *  @memberof Debug */
 let godMode = 0;
 
+/** Key code used to toggle debug mode, Esc by default
+ *  @type {Boolean}
+ *  @default
+ *  @memberof Debug */
+let debugKey = 27;
+
 // Engine internal variables not exposed to documentation
 let debugPrimitives = [], debugOverlay = 0, debugPhysics = 0, debugRaycast = 0,
 debugParticles = 0, debugGamepads = 0, debugMedals = 0, debugTakeScreenshot, downloadLink;
@@ -166,7 +172,7 @@ const debugUpdate = ()=>
     if (!debug)
         return;
 
-    if (keyWasPressed(192)) // ~
+    if (keyWasPressed(debugKey)) // Esc
         debugOverlay = !debugOverlay;
     if (debugOverlay)
     {
@@ -351,7 +357,7 @@ const debugRender = ()=>
             overlayContext.fillText('Time: ' + formatTime(time), x, y += h);
             overlayContext.fillText('---------', x, y += h);
             overlayContext.fillStyle = '#f00';
-            overlayContext.fillText('~: Debug Overlay', x, y += h);
+            overlayContext.fillText('ESC: Debug Overlay', x, y += h);
             overlayContext.fillStyle = debugPhysics ? '#f00' : '#fff';
             overlayContext.fillText('1: Debug Physics', x, y += h);
             overlayContext.fillStyle = debugParticles ? '#f00' : '#fff';
@@ -741,7 +747,7 @@ class Vector2
  * @return {Color}
  * @memberof Utilities
  */
-const colorRGBA = (r, g, b, a)=> new Color(r, g, b, a);
+const rgb = (r, g, b, a)=> new Color(r, g, b, a);
 
 /** 
  * Create a color object with HSLA values
@@ -752,7 +758,7 @@ const colorRGBA = (r, g, b, a)=> new Color(r, g, b, a);
  * @return {Color}
  * @memberof Utilities
  */
-const colorHSLA = (h, s, l, a)=> new Color().setHSLA(h, s, l, a);
+const hsl = (h, s, l, a)=> new Color().setHSLA(h, s, l, a);
 
 /** 
  * Color object (red, green, blue, alpha) with some helpful functions
@@ -760,8 +766,8 @@ const colorHSLA = (h, s, l, a)=> new Color().setHSLA(h, s, l, a);
  * let a = new Color;              // white
  * let b = new Color(1, 0, 0);     // red
  * let c = new Color(0, 0, 0, 0);  // transparent black
- * let d = colorRGBA(0, 0, 1);     // blue using rgb color
- * let e = colorHSLA(.3, 1, .5);   // green using hsl color
+ * let d = RGB(0, 0, 1);           // blue using rgb color
+ * let e = HSL(.3, 1, .5);         // green using hsl color
  */
 class Color
 {
@@ -1336,6 +1342,7 @@ class EngineObject
         this.velocity.y += gravity * this.gravityScale;
         this.pos.x += this.velocity.x *= this.damping;
         this.pos.y += this.velocity.y *= this.damping;
+        this.angle += this.angleVelocity *= this.angleDamping;
 
         // physics sanity checks
         ASSERT(this.angleDamping >= 0 && this.angleDamping <= 1);
@@ -1392,6 +1399,7 @@ class EngineObject
                 const smallStepUp = (oldPos.y - o.pos.y)*2 > sizeBoth.y + gravity; // prefer to push up if small delta
                 const isBlockedX = abs(oldPos.y - o.pos.y)*2 < sizeBoth.y;
                 const isBlockedY = abs(oldPos.x - o.pos.x)*2 < sizeBoth.x;
+                const elasticity = max(this.elasticity, o.elasticity);
                 
                 if (smallStepUp | isBlockedY | !isBlockedX) // resolve y collision
                 {
@@ -1404,7 +1412,7 @@ class EngineObject
                             this.groundObject = o;
 
                         // bounce if other object is fixed or grounded
-                        this.velocity.y *= -this.elasticity;
+                        this.velocity.y *= -elasticity;
                     }
                     else if (o.mass)
                     {
@@ -1418,7 +1426,6 @@ class EngineObject
                             + this.velocity.y * 2 * this.mass / (this.mass + o.mass);
 
                         // lerp betwen elastic or inelastic based on elasticity
-                        const elasticity = max(this.elasticity, o.elasticity);
                         this.velocity.y = lerp(elasticity, inelastic, elastic0);
                         o.velocity.y = lerp(elasticity, inelastic, elastic1);
                     }
@@ -1439,12 +1446,11 @@ class EngineObject
                             + this.velocity.x * 2 * this.mass / (this.mass + o.mass);
 
                         // lerp betwen elastic or inelastic based on elasticity
-                        const elasticity = max(this.elasticity, o.elasticity);
                         this.velocity.x = lerp(elasticity, inelastic, elastic0);
                         o.velocity.x = lerp(elasticity, inelastic, elastic1);
                     }
                     else // bounce if other object is fixed
-                        this.velocity.x *= -this.elasticity;
+                        this.velocity.x *= -elasticity;
                 }
                 debugOverlay && debugPhysics && debugAABB(this.pos, this.size, o.pos, o.size, '#f0f');
             }
@@ -1826,6 +1832,23 @@ function setBlendMode(additive, useWebGL=glEnable)
         mainContext.globalCompositeOperation = additive ? 'lighter' : 'source-over';
 }
 
+/** Draw text on overlay canvas in world space
+ *  Automatically splits new lines into rows
+ *  @param {String}  text
+ *  @param {Vector2} pos
+ *  @param {Number}  [size=1]
+ *  @param {Color}   [color=Color()]
+ *  @param {Number}  [lineWidth=0]
+ *  @param {Color}   [lineColor=Color(0,0,0)]
+ *  @param {String}  [textAlign='center']
+ *  @param {String}  [font=fontDefault]
+ *  @param {CanvasRenderingContext2D} [context=overlayContext]
+ *  @memberof Draw */
+function drawText(text, pos, size=1, color, lineWidth=0, lineColor, textAlign, font, context)
+{
+    drawTextScreen(text, worldToScreen(pos), size*cameraScale, color, lineWidth*cameraScale, lineColor, textAlign, font, context);
+}
+
 /** Draw text on overlay canvas in screen space
  *  Automatically splits new lines into rows
  *  @param {String}  text
@@ -1835,6 +1858,8 @@ function setBlendMode(additive, useWebGL=glEnable)
  *  @param {Number}  [lineWidth=0]
  *  @param {Color}   [lineColor=Color(0,0,0)]
  *  @param {String}  [textAlign='center']
+ *  @param {String}  [font=fontDefault]
+ *  @param {CanvasRenderingContext2D} [context=overlayContext]
  *  @memberof Draw */
 function drawTextScreen(text, pos, size=1, color=new Color, lineWidth=0, lineColor=new Color(0,0,0), textAlign='center', font=fontDefault, context=overlayContext)
 {
@@ -1855,21 +1880,6 @@ function drawTextScreen(text, pos, size=1, color=new Color, lineWidth=0, lineCol
     });
 }
 
-/** Draw text on overlay canvas in world space
- *  Automatically splits new lines into rows
- *  @param {String}  text
- *  @param {Vector2} pos
- *  @param {Number}  [size=1]
- *  @param {Color}   [color=Color()]
- *  @param {Number}  [lineWidth=0]
- *  @param {Color}   [lineColor=Color(0,0,0)]
- *  @param {String}  [textAlign='center']
- *  @memberof Draw */
-function drawText(text, pos, size=1, color, lineWidth=0, lineColor, textAlign, font)
-{
-    drawTextScreen(text, worldToScreen(pos), size*cameraScale, color, lineWidth*cameraScale, lineColor, textAlign, font, mainContext);
-}
-
 ///////////////////////////////////////////////////////////////////////////////
 
 let engineFontImage;
@@ -2273,6 +2283,9 @@ if (isTouchDevice)
             return true;
         }
 
+        // try to create touch game pad
+        touchGamepadEnable && touchGamepadCreate();
+
         return ontouchstart(e);
     }
 }
@@ -2286,76 +2299,69 @@ let touchGamepadTimer = new Timer, touchGamepadButtons, touchGamepadStick;
 // create the touch gamepad, called automatically by the engine
 function touchGamepadCreate()
 {
-    if (!touchGamepadEnable || !isTouchDevice)
-        return;
-
     // touch input internal variables
     touchGamepadButtons = [];
     touchGamepadStick = vec2();
 
-    // setup touch input
-    ontouchstart = (e)=>
+    let touchHandler = ontouchstart;
+    ontouchstart = ontouchmove = ontouchend = (e)=> 
     {
-        // fix mobile audio, force it to play a sound on first touch
-        zzfx(0);
-
-        ontouchstart = ontouchmove = ontouchend = (e)=> 
+        // clear touch gamepad input
+        touchGamepadStick = vec2();
+        touchGamepadButtons = [];
+            
+        const touching = e.touches.length;
+        if (touching)
         {
-            // clear touch gamepad input
-            touchGamepadStick = vec2();
-            touchGamepadButtons = [];
-                
-            const touching = e.touches.length;
-            if (touching)
+            touchGamepadTimer.set();
+            if (paused)
             {
-                // set that gamepad is active
-                isUsingGamepad = 1;
-                touchGamepadTimer.set();
-
-                if (paused)
-                {
-                    // touch anywhere to press start when paused
-                    touchGamepadButtons[9] = 1;
-                    return;
-                }
+                // touch anywhere to press start when paused
+                touchGamepadButtons[9] = 1;
+                return;
             }
+        }
 
-            // get center of left and right sides
-            const stickCenter = vec2(touchGamepadSize, mainCanvasSize.y-touchGamepadSize);
-            const buttonCenter = mainCanvasSize.subtract(vec2(touchGamepadSize, touchGamepadSize));
-            const startCenter = mainCanvasSize.scale(.5);
+        // get center of left and right sides
+        const stickCenter = vec2(touchGamepadSize, mainCanvasSize.y-touchGamepadSize);
+        const buttonCenter = mainCanvasSize.subtract(vec2(touchGamepadSize, touchGamepadSize));
+        const startCenter = mainCanvasSize.scale(.5);
 
-            // check each touch point
-            for (const touch of e.touches)
+        // check each touch point
+        for (const touch of e.touches)
+        {
+            const touchPos = mouseToScreen(vec2(touch.clientX, touch.clientY));
+            if (touchPos.distance(stickCenter) < touchGamepadSize)
             {
-                const touchPos = mouseToScreen(vec2(touch.clientX, touch.clientY));
-                if (touchPos.distance(stickCenter) < touchGamepadSize)
+                // virtual analog stick
+                if (touchGamepadAnalog)
+                    touchGamepadStick = touchPos.subtract(stickCenter).scale(2/touchGamepadSize).clampLength();
+                else
                 {
-                    // virtual analog stick
-                    if (touchGamepadAnalog)
-                        touchGamepadStick = touchPos.subtract(stickCenter).scale(2/touchGamepadSize).clampLength();
-                    else
-                    {
-                        // 8 way dpad
-                        const angle = touchPos.subtract(stickCenter).angle();
-                        touchGamepadStick.setAngle((angle * 4 / PI + 8.5 | 0) * PI / 4);
-                    }
-                }
-                else if (touchPos.distance(buttonCenter) < touchGamepadSize)
-                {
-                    // virtual face buttons
-                    const button = touchPos.subtract(buttonCenter).direction();
-                    touchGamepadButtons[button] = 1;
-                }
-                else if (touchPos.distance(startCenter) < touchGamepadSize)
-                {
-                    // virtual start button in center
-                    touchGamepadButtons[9] = 1;
+                    // 8 way dpad
+                    const angle = touchPos.subtract(stickCenter).angle();
+                    touchGamepadStick.setAngle((angle * 4 / PI + 8.5 | 0) * PI / 4);
                 }
             }
+            else if (touchPos.distance(buttonCenter) < touchGamepadSize)
+            {
+                // virtual face buttons
+                const button = touchPos.subtract(buttonCenter).direction();
+                touchGamepadButtons[button] = 1;
+            }
+            else if (touchPos.distance(startCenter) < touchGamepadSize)
+            {
+                // virtual start button in center
+                touchGamepadButtons[9] = 1;
+            }
         }
 
-        return ontouchstart(e);
+        // call default touch handler and set to using gamepad
+        touchHandler(e);
+        isUsingGamepad = 1;
+        
+        // must return true so the document will get focus
+        return true;
     }
 }
 
@@ -2381,7 +2387,7 @@ function touchGamepadRender()
     overlayContext.beginPath();
 
     const leftCenter = vec2(touchGamepadSize, mainCanvasSize.y-touchGamepadSize);
-    if (touchGamepadAnalog)
+    if (touchGamepadAnalog) // draw circle shaped gamepad
     {
         overlayContext.arc(leftCenter.x, leftCenter.y, touchGamepadSize/2, 0, 9);
         overlayContext.fill();
@@ -2686,7 +2692,7 @@ function playSamples(sampleChannels, volume=1, rate=1, pan=0, loop=0)
 }
 
 ///////////////////////////////////////////////////////////////////////////////
-// ZzFXMicro - Zuper Zmall Zound Zynth - v1.1.8 by Frank Force
+// ZzFXMicro - Zuper Zmall Zound Zynth - v1.2.0 by Frank Force
 
 /** Generate and play a ZzFX sound
  *  <br>
@@ -2712,11 +2718,11 @@ function zzfxG
     bitCrush = 0, delay = 0, sustainVolume = 1, decay = 0, tremolo = 0
 )
 {
-    // init parameters
+    // locals
     let PI2 = PI*2, startSlide = slide *= 500 * PI2 / zzfxR / zzfxR, b=[],
         startFrequency = frequency *= (1 + randomness*rand(-1,1)) * PI2 / zzfxR,
-        t=0, tm=0, i=0, j=1, r=0, c=0, s=0, f, length;
-        
+        t=0, tm=0, i=0, j=1, r=0, c=0, s=0, f, length
+
     // scale by sample rate
     attack = attack * zzfxR + 9; // minimum attack to prevent pop
     decay *= zzfxR;
@@ -2766,18 +2772,18 @@ function zzfxG
             Math.cos(modulation*tm++);                    // modulation
         t += f - f*noise*(1 - (Math.sin(i)+1)*1e9%2);     // noise
 
-        if (j && ++j > pitchJumpTime)       // pitch jump
+        if (j && ++j > pitchJumpTime)    // pitch jump
         {
-            frequency += pitchJump;         // apply pitch jump
-            startFrequency += pitchJump;    // also apply to start
-            j = 0;                          // reset pitch jump time
+            frequency += pitchJump;      // apply pitch jump
+            startFrequency += pitchJump; // also apply to start
+            j = 0;                       // reset pitch jump time
         }
 
         if (repeatTime && !(++r % repeatTime)) // repeat
         {
-            frequency = startFrequency;     // reset frequency
-            slide = startSlide;             // reset slide
-            j = j || 1;                     // reset pitch jump time
+            frequency = startFrequency;  // reset frequency
+            slide = startSlide;          // reset slide
+            j ||= 1;                     // reset pitch jump time
         }
     }
     
@@ -4269,7 +4275,7 @@ const engineName = 'LittleJS';
  *  @type {String}
  *  @default
  *  @memberof Engine */
-const engineVersion = '1.6.0';
+const engineVersion = '1.6.4';
 
 /** Frames per second to update objects
  *  @type {Number}
@@ -4360,7 +4366,6 @@ function engineInit(gameInit, gameUpdate, gameUpdatePost, gameRender, gameRender
         (glCanvas||mainCanvas).style = mainCanvas.style = overlayCanvas.style = styleCanvas;
         
         gameInit();
-        touchGamepadCreate();
         engineUpdate();
     };
 
@@ -4756,6 +4761,11 @@ const setShowWatermark = (show)=> showWatermark = show;
  *  @memberof Debug */
 const setGodMode = (enable)=> godMode = enable;
 
+/** Set key code used to toggle debug mode, Esc by default
+ *  @param {Number} key
+ *  @memberof Debug */
+const setDebugKey = (key)=> debugKey = key;
+
 export {
 	// Setters for global variables
 	setCameraPos,
@@ -4796,6 +4806,7 @@ export {
 	setMedalsPreventUnlock,
 	setShowWatermark,
 	setGodMode,
+	setDebugKey,
 
 	// Settings
 	canvasMaxSize,
@@ -4882,8 +4893,8 @@ export {
 	Color,
 	Timer,
 	vec2,
-	colorRGBA,
-	colorHSLA,
+	rgb,
+	hsl,
 
 	// Base
 	EngineObject,