@woosh/meep-engine 2.72.0 → 2.73.0

package/build/meep.module.js

@@ -111512,7 +111512,7 @@ function aabb3_matrix4_project_by_corners(
     result[5] = z1;
 }
 
-const corners = [];
+const corners$1 = [];
 
 class Decal extends AbstractLight {
     constructor() {
@@ -111598,9 +111598,9 @@ class Decal extends AbstractLight {
     }
 
     getAABB(result) {
-        aabb3_build_corners(corners, 0, -0.5, -0.5, -0.5, 0.5, 0.5, 0.5);
+        aabb3_build_corners(corners$1, 0, -0.5, -0.5, -0.5, 0.5, 0.5, 0.5);
 
-        aabb3_matrix4_project_by_corners(result, corners, this.transform);
+        aabb3_matrix4_project_by_corners(result, corners$1, this.transform);
     }
 
     toArray(destination, address) {
@@ -113432,190 +113432,41 @@ class ForwardPlusRenderingPlugin extends EnginePlugin {
  */
 
 
-const projectInWorldSpace = (function () {
-    const corners = [
-        new Vector3(-1, -1, 0),
-        new Vector3(-1, -1, 0),
+const corners = [
+    new Vector3(-1, -1, 0),
+    new Vector3(-1, -1, 0),
 
-        new Vector3(-1, 1, 0),
-        new Vector3(-1, 1, 0),
+    new Vector3(-1, 1, 0),
+    new Vector3(-1, 1, 0),
 
-        new Vector3(1, -1, 0),
-        new Vector3(1, -1, 0),
+    new Vector3(1, -1, 0),
+    new Vector3(1, -1, 0),
 
-        new Vector3(1, 1, 0),
-        new Vector3(1, 1, 0)
-    ];
-
-
-    /**
-     *
-     * @param {Number} nearZ
-     * @param {Number} farZ
-     * @param {THREE.Camera} camera
-     * @param {THREE.Matrix4} matrixWorldInverse
-     * @param {function} callback
-     */
-    function projectInWorldSpace(nearZ, farZ, camera, callback) {
-        corners[0].set(-1, -1, nearZ);
-        corners[1].set(-1, -1, farZ);
-
-        corners[2].set(-1, 1, nearZ);
-        corners[3].set(-1, 1, farZ);
-
-        corners[4].set(1, -1, nearZ);
-        corners[5].set(1, -1, farZ);
-
-        corners[6].set(1, 1, nearZ);
-        corners[7].set(1, 1, farZ);
-
-        //compute corners of view frustum in light space
-        let x0 = Number.POSITIVE_INFINITY;
-        let y0 = Number.POSITIVE_INFINITY;
-        let z0 = Number.POSITIVE_INFINITY;
-
-        let x1 = Number.NEGATIVE_INFINITY;
-        let y1 = Number.NEGATIVE_INFINITY;
-        let z1 = Number.NEGATIVE_INFINITY;
-
-
-        for (let i = 0; i < 8; i++) {
-            const corner = corners[i];
-            corner.unproject(camera);
-
-            if (corner.x < x0) {
-                x0 = corner.x;
-            }
-            if (corner.x > x1) {
-                x1 = corner.x;
-            }
-
-            if (corner.y < y0) {
-                y0 = corner.y;
-            }
-            if (corner.y > y1) {
-                y1 = corner.y;
-            }
-
-            if (corner.z < z0) {
-                z0 = corner.z;
-            }
-            if (corner.z > z1) {
-                z1 = corner.z;
-            }
-        }
-
-        callback(x0, y0, z0, x1, y1, z1);
-    }
-
-    return projectInWorldSpace;
-})();
-
-const project = (function () {
-    const corners = [
-        new Vector3(-1, -1, 0),
-        new Vector3(-1, -1, 0),
-
-        new Vector3(-1, 1, 0),
-        new Vector3(-1, 1, 0),
-
-        new Vector3(1, -1, 0),
-        new Vector3(1, -1, 0),
-
-        new Vector3(1, 1, 0),
-        new Vector3(1, 1, 0)
-    ];
-
-
-    /**
-     *
-     * @param {Number} nearZ
-     * @param {Number} farZ
-     * @param {THREE.Camera} camera
-     * @param {THREE.Matrix4} matrixWorldInverse
-     * @param {AABB3} result
-     */
-    function project(nearZ, farZ, camera, matrixWorldInverse, result) {
-        corners[0].set(-1, -1, nearZ);
-        corners[1].set(-1, -1, farZ);
-
-        corners[2].set(-1, 1, nearZ);
-        corners[3].set(-1, 1, farZ);
-
-        corners[4].set(1, -1, nearZ);
-        corners[5].set(1, -1, farZ);
-
-        corners[6].set(1, 1, nearZ);
-        corners[7].set(1, 1, farZ);
-
-        //compute corners of view frustum in light space
-        let x0 = Number.POSITIVE_INFINITY;
-        let y0 = Number.POSITIVE_INFINITY;
-        let z0 = Number.POSITIVE_INFINITY;
-
-        let x1 = Number.NEGATIVE_INFINITY;
-        let y1 = Number.NEGATIVE_INFINITY;
-        let z1 = Number.NEGATIVE_INFINITY;
-
-
-        for (let i = 0; i < 8; i++) {
-            const corner = corners[i];
-            corner.unproject(camera);
-            corner.applyMatrix4(matrixWorldInverse);
-
-            if (corner.x < x0) {
-                x0 = corner.x;
-            }
-            if (corner.x > x1) {
-                x1 = corner.x;
-            }
-
-            if (corner.y < y0) {
-                y0 = corner.y;
-            }
-            if (corner.y > y1) {
-                y1 = corner.y;
-            }
-
-            if (corner.z < z0) {
-                z0 = corner.z;
-            }
-            if (corner.z > z1) {
-                z1 = corner.z;
-            }
-        }
-
-        result.setBounds(x0, y0, z0, x1, y1, z1);
-    }
+    new Vector3(1, 1, 0),
+    new Vector3(1, 1, 0)
+];
 
-    return project;
-})();
 
 /**
  *
- * @param _x0
- * @param _y0
- * @param _z0
- * @param _x1
- * @param _y1
- * @param _z1
- * @param {Camera} camera
- * @param callback
+ * @param {Number} nearZ
+ * @param {Number} farZ
+ * @param {THREE.Camera} camera
+ * @param {THREE.Matrix4} matrixWorldInverse
+ * @param {AABB3} result
  */
-function unproject(_x0, _y0, _z0, _x1, _y1, _z1, camera, callback) {
-    const corners = [
-        new Vector3(_x0, _y0, _z0),
-        new Vector3(_x0, _y0, _z1),
+function project(nearZ, farZ, camera, matrixWorldInverse, result) {
+    corners[0].set(-1, -1, nearZ);
+    corners[1].set(-1, -1, farZ);
 
-        new Vector3(_x0, _y1, _z0),
-        new Vector3(_x0, _y1, _z1),
+    corners[2].set(-1, 1, nearZ);
+    corners[3].set(-1, 1, farZ);
 
-        new Vector3(_x1, _y0, _z0),
-        new Vector3(_x1, _y0, _z1),
+    corners[4].set(1, -1, nearZ);
+    corners[5].set(1, -1, farZ);
 
-        new Vector3(_x1, _y1, _z0),
-        new Vector3(_x1, _y1, _z1)
-    ];
+    corners[6].set(1, 1, nearZ);
+    corners[7].set(1, 1, farZ);
 
     //compute corners of view frustum in light space
     let x0 = Number.POSITIVE_INFINITY;
@@ -113627,8 +113478,10 @@ function unproject(_x0, _y0, _z0, _x1, _y1, _z1, camera, callback) {
     let z1 = Number.NEGATIVE_INFINITY;
 
 
-    corners.forEach(function (corner) {
-        corner.project(camera);
+    for (let i = 0; i < 8; i++) {
+        const corner = corners[i];
+        corner.unproject(camera);
+        corner.applyMatrix4(matrixWorldInverse);
 
         if (corner.x < x0) {
             x0 = corner.x;
@@ -113650,21 +113503,17 @@ function unproject(_x0, _y0, _z0, _x1, _y1, _z1, camera, callback) {
         if (corner.z > z1) {
             z1 = corner.z;
         }
-    });
+    }
 
-    callback(x0, y0, z0, x1, y1, z1);
+    result.setBounds(x0, y0, z0, x1, y1, z1);
 }
 
+
 var FrustumProjector = {
     /**
      * @deprecated use non-threejs specific code
      */
     project,
-    unproject,
-    /**
-     * @deprecated use non-threejs specific code
-     */
-    projectInWorldSpace
 };
 
 class SystemEntityContext {

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.72.0",
+  "version": "2.73.0",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {
@@ -39,7 +39,8 @@
     "gl-matrix": "3.4.3",
     "opentype.js": "1.3.3",
     "robust-predicates": "3.0.1",
-    "simplex-noise": "2.4.0"
+    "simplex-noise": "2.4.0",
+    "pako": "2.0.3"
   },
   "peerDependencies": {
     "three": ">=0.135.0 & <0.137.0"

package/src/engine/graphics/ecs/camera/FrustumProjector.js

@@ -6,190 +6,41 @@
 import { Vector3 as ThreeVector3 } from 'three';
 
 
-const projectInWorldSpace = (function () {
-    const corners = [
-        new ThreeVector3(-1, -1, 0),
-        new ThreeVector3(-1, -1, 0),
+const corners = [
+    new ThreeVector3(-1, -1, 0),
+    new ThreeVector3(-1, -1, 0),
 
-        new ThreeVector3(-1, 1, 0),
-        new ThreeVector3(-1, 1, 0),
+    new ThreeVector3(-1, 1, 0),
+    new ThreeVector3(-1, 1, 0),
 
-        new ThreeVector3(1, -1, 0),
-        new ThreeVector3(1, -1, 0),
+    new ThreeVector3(1, -1, 0),
+    new ThreeVector3(1, -1, 0),
 
-        new ThreeVector3(1, 1, 0),
-        new ThreeVector3(1, 1, 0)
-    ];
+    new ThreeVector3(1, 1, 0),
+    new ThreeVector3(1, 1, 0)
+];
 
 
-    /**
-     *
-     * @param {Number} nearZ
-     * @param {Number} farZ
-     * @param {THREE.Camera} camera
-     * @param {THREE.Matrix4} matrixWorldInverse
-     * @param {function} callback
-     */
-    function projectInWorldSpace(nearZ, farZ, camera, callback) {
-        corners[0].set(-1, -1, nearZ);
-        corners[1].set(-1, -1, farZ);
-
-        corners[2].set(-1, 1, nearZ);
-        corners[3].set(-1, 1, farZ);
-
-        corners[4].set(1, -1, nearZ);
-        corners[5].set(1, -1, farZ);
-
-        corners[6].set(1, 1, nearZ);
-        corners[7].set(1, 1, farZ);
-
-        //compute corners of view frustum in light space
-        let x0 = Number.POSITIVE_INFINITY;
-        let y0 = Number.POSITIVE_INFINITY;
-        let z0 = Number.POSITIVE_INFINITY;
-
-        let x1 = Number.NEGATIVE_INFINITY;
-        let y1 = Number.NEGATIVE_INFINITY;
-        let z1 = Number.NEGATIVE_INFINITY;
-
-
-        for (let i = 0; i < 8; i++) {
-            const corner = corners[i];
-            corner.unproject(camera);
-
-            if (corner.x < x0) {
-                x0 = corner.x;
-            }
-            if (corner.x > x1) {
-                x1 = corner.x;
-            }
-
-            if (corner.y < y0) {
-                y0 = corner.y;
-            }
-            if (corner.y > y1) {
-                y1 = corner.y;
-            }
-
-            if (corner.z < z0) {
-                z0 = corner.z;
-            }
-            if (corner.z > z1) {
-                z1 = corner.z;
-            }
-        }
-
-        callback(x0, y0, z0, x1, y1, z1);
-    }
-
-    return projectInWorldSpace;
-})();
-
-const project = (function () {
-    const corners = [
-        new ThreeVector3(-1, -1, 0),
-        new ThreeVector3(-1, -1, 0),
-
-        new ThreeVector3(-1, 1, 0),
-        new ThreeVector3(-1, 1, 0),
-
-        new ThreeVector3(1, -1, 0),
-        new ThreeVector3(1, -1, 0),
-
-        new ThreeVector3(1, 1, 0),
-        new ThreeVector3(1, 1, 0)
-    ];
-
-
-    /**
-     *
-     * @param {Number} nearZ
-     * @param {Number} farZ
-     * @param {THREE.Camera} camera
-     * @param {THREE.Matrix4} matrixWorldInverse
-     * @param {AABB3} result
-     */
-    function project(nearZ, farZ, camera, matrixWorldInverse, result) {
-        corners[0].set(-1, -1, nearZ);
-        corners[1].set(-1, -1, farZ);
-
-        corners[2].set(-1, 1, nearZ);
-        corners[3].set(-1, 1, farZ);
-
-        corners[4].set(1, -1, nearZ);
-        corners[5].set(1, -1, farZ);
-
-        corners[6].set(1, 1, nearZ);
-        corners[7].set(1, 1, farZ);
-
-        //compute corners of view frustum in light space
-        let x0 = Number.POSITIVE_INFINITY;
-        let y0 = Number.POSITIVE_INFINITY;
-        let z0 = Number.POSITIVE_INFINITY;
-
-        let x1 = Number.NEGATIVE_INFINITY;
-        let y1 = Number.NEGATIVE_INFINITY;
-        let z1 = Number.NEGATIVE_INFINITY;
-
-
-        for (let i = 0; i < 8; i++) {
-            const corner = corners[i];
-            corner.unproject(camera);
-            corner.applyMatrix4(matrixWorldInverse);
-
-            if (corner.x < x0) {
-                x0 = corner.x;
-            }
-            if (corner.x > x1) {
-                x1 = corner.x;
-            }
-
-            if (corner.y < y0) {
-                y0 = corner.y;
-            }
-            if (corner.y > y1) {
-                y1 = corner.y;
-            }
-
-            if (corner.z < z0) {
-                z0 = corner.z;
-            }
-            if (corner.z > z1) {
-                z1 = corner.z;
-            }
-        }
-
-        result.setBounds(x0, y0, z0, x1, y1, z1);
-    }
-
-    return project;
-})();
-
 /**
  *
- * @param _x0
- * @param _y0
- * @param _z0
- * @param _x1
- * @param _y1
- * @param _z1
- * @param {Camera} camera
- * @param callback
+ * @param {Number} nearZ
+ * @param {Number} farZ
+ * @param {THREE.Camera} camera
+ * @param {THREE.Matrix4} matrixWorldInverse
+ * @param {AABB3} result
  */
-function unproject(_x0, _y0, _z0, _x1, _y1, _z1, camera, callback) {
-    const corners = [
-        new ThreeVector3(_x0, _y0, _z0),
-        new ThreeVector3(_x0, _y0, _z1),
+function project(nearZ, farZ, camera, matrixWorldInverse, result) {
+    corners[0].set(-1, -1, nearZ);
+    corners[1].set(-1, -1, farZ);
 
-        new ThreeVector3(_x0, _y1, _z0),
-        new ThreeVector3(_x0, _y1, _z1),
+    corners[2].set(-1, 1, nearZ);
+    corners[3].set(-1, 1, farZ);
 
-        new ThreeVector3(_x1, _y0, _z0),
-        new ThreeVector3(_x1, _y0, _z1),
+    corners[4].set(1, -1, nearZ);
+    corners[5].set(1, -1, farZ);
 
-        new ThreeVector3(_x1, _y1, _z0),
-        new ThreeVector3(_x1, _y1, _z1)
-    ];
+    corners[6].set(1, 1, nearZ);
+    corners[7].set(1, 1, farZ);
 
     //compute corners of view frustum in light space
     let x0 = Number.POSITIVE_INFINITY;
@@ -201,8 +52,10 @@ function unproject(_x0, _y0, _z0, _x1, _y1, _z1, camera, callback) {
     let z1 = Number.NEGATIVE_INFINITY;
 
 
-    corners.forEach(function (corner) {
-        corner.project(camera);
+    for (let i = 0; i < 8; i++) {
+        const corner = corners[i];
+        corner.unproject(camera);
+        corner.applyMatrix4(matrixWorldInverse);
 
         if (corner.x < x0) {
             x0 = corner.x;
@@ -224,19 +77,15 @@ function unproject(_x0, _y0, _z0, _x1, _y1, _z1, camera, callback) {
         if (corner.z > z1) {
             z1 = corner.z;
         }
-    });
+    }
 
-    callback(x0, y0, z0, x1, y1, z1);
+    result.setBounds(x0, y0, z0, x1, y1, z1);
 }
 
+
 export default {
     /**
      * @deprecated use non-threejs specific code
      */
     project,
-    unproject,
-    /**
-     * @deprecated use non-threejs specific code
-     */
-    projectInWorldSpace
 };

package/src/engine/graphics/texture/virtual/v2/NOTES.md

@@ -14,4 +14,14 @@ The original texture is mip-mapped, down to the size of a single tile, for the s
 
 This is achieved by pre-rendering the scene with a special shader that records UV and mip-level information, which we call `Usage`, this is then analysed to build a list of used tiles (mip level, x, y) and by counting occurrence of this tile in the `Usage` texture we get a much more useful data structure.
 
-Based on the `Usage` data, we populate our `Physical` texture of pages, and based on what's currently in the `Physical` texture - we populate the `Reference` texture that stores information about the entire mip pyramid, and for each tile contains a pointer to the `Physical` texture, where representative tile can be found. 
+Based on the `Usage` data, we populate our `Physical` texture of pages, and based on what's currently in the `Physical` texture - we populate the `Reference` texture that stores information about the entire mip pyramid, and for each tile contains a pointer to the `Physical` texture, where representative tile can be found. 
+
+
+## Considerations
+
+
+### Filtering
+
+Most papers suggest introducing a border into each tile of ~4 pixels. 
+4 pixel border on a 128x128 pixel tile is going to take up 12.1% of space, which is quite a lot.
+We can do filtering in software, that is - sample individual pixels and perform interpolation inside the shader.

package/src/engine/graphics/texture/virtual/v2/ShaderUsage.js

@@ -34,13 +34,15 @@ function fragment() {
     
     float MTCalculateMipLevel( const in vec2 uv, const in float bias ) {
         
-        float scale_x = float(u_mt_tex.x) / u_mt_viewport_size.x;
-        float scale_y = float(u_mt_tex.y) / u_mt_viewport_size.y;
+        float scale_x = float(u_mt_tex.x) ;
+        float scale_y = float(u_mt_tex.y) ;
         
-        vec2 dx = dFdx( uv * scale_x);
-        vec2 dy = dFdy( uv * scale_y);
+        vec2 dx = dFdx( uv * scale_x)/ u_mt_viewport_size.x;
+        vec2 dy = dFdy( uv * scale_y)/ u_mt_viewport_size.y;
         
-        return log2( max( dot( dx, dx ), dot( dy, dy ) ) ) * 0.5 + bias;
+        float d = max( dot( dx, dx ), dot( dy, dy ) );
+        
+        return log2( d ) * 0.5 + bias;
     }
     
     uvec4 MTCalculateTileKeyRGBA( const in vec2 uv ) {