@woosh/meep-engine 2.40.0 → 2.40.1

package/core/binary/BinaryBuffer.js

@@ -959,14 +959,19 @@ export class BinaryBuffer {
     /**
      *
      * @param {number} length
+     * @param {boolean} [null_terminated]
      * @returns {string}
      */
-    readASCIICharacters(length) {
+    readASCIICharacters(length, null_terminated = false) {
         let result = "";
 
         for (let i = 0; i < length; i++) {
             const code = this.readUint8();
 
+            if (null_terminated && code === 0) {
+                break;
+            }
+
             result += String.fromCharCode(code);
         }
 

package/core/geom/Quaternion.js

@@ -1470,7 +1470,7 @@ class Quaternion {
 
     /**
      * Based on GDC talk from Bungie on destiny, compressing quaternions for animation
-     * @param value
+     * @param {number} value
      */
     decodeFromUint32(value) {
         //read components
@@ -1481,9 +1481,9 @@ class Quaternion {
         const iv2 = (value >> 22) & 0x3FF;
 
         //scale components back to quaternion range
-        const v0 = (iv0 / 511.5 - 1) * K_CONST;
-        const v1 = (iv1 / 511.5 - 1) * K_CONST;
-        const v2 = (iv2 / 511.5 - 1) * K_CONST;
+        const v0 = (iv0 / 511 - 1) * K_CONST;
+        const v1 = (iv1 / 511 - 1) * K_CONST;
+        const v2 = (iv2 / 511 - 1) * K_CONST;
 
         //restore dropped component using quaternion identity: x^2 + y^2 + z^2 + w^2 = 1
         const dropped_2 = 1 - v0 * v0 - v1 * v1 - v2 * v2;
@@ -1501,7 +1501,7 @@ class Quaternion {
     }
 
     /**
-     *
+     * Based on GDC talk from Bungie on destiny, compressing quaternions for animation
      * @returns {number}
      */
     encodeToUint32() {
@@ -1590,9 +1590,9 @@ class Quaternion {
         const m = 1 / (l * K_CONST);
 
         //re-normalize the remaining components to 10 bit UINT value
-        const oV0 = ((v0 * m + 1) * 511.5) | 0;
-        const oV1 = ((v1 * m + 1) * 511.5) | 0;
-        const oV2 = ((v2 * m + 1) * 511.5) | 0;
+        const oV0 = Math.round((v0 * m + 1) * 511);
+        const oV1 = Math.round((v1 * m + 1) * 511);
+        const oV2 = Math.round((v2 * m + 1) * 511);
 
         assert.ok(oV0 <= 1023 && oV0 >= 0, `expected 0 <= ov0 <= 1023, instead was '${oV0}'`);
         assert.ok(oV1 <= 1023 && oV1 >= 0, `expected 0 <= ov1 <= 1023, instead was '${oV1}'`);

package/core/geom/Quaternion.spec.js

@@ -154,6 +154,19 @@ test('encoding to Uint32 consistency', () => {
     check(1, 0, 0, 0);
 });
 
+test('encoding to Uint32 and decoding identity correctly', () => {
+    const a = new Quaternion();
+    a.copy(Quaternion.identity);
+
+    const b = new Quaternion();
+
+    const encoded = a.encodeToUint32();
+
+    b.decodeFromUint32(encoded);
+
+    expect(b.toJSON()).toEqual(a.toJSON());
+});
+
 
 test('to/from euler YXZ consistency', () => {
     function check(x, y, z) {

package/core/geom/Vector1.d.ts

@@ -10,4 +10,6 @@ export default class Vector1 {
     _sub(v: number): void
 
     isZero(): boolean
+
+    process(callback: (x) => any): void
 }

package/editor/view/ecs/components/common/NumberController.js

@@ -24,7 +24,7 @@ export class NumberController extends View {
         const el = document.createElement('input');
         this.el = el;
 
-        classList.forEach(c => this.addClass(c));
+        this.addClasses(classList);
 
         el.setAttribute('type', 'text');
         el.setAttribute('spellcheck', false);
@@ -34,6 +34,7 @@ export class NumberController extends View {
 
         let lockForward = false;
 
+
         /**
          *
          * @param {number} num_value
@@ -44,7 +45,26 @@ export class NumberController extends View {
             let str = String(num_value);
 
             if (Math.abs(num_value) > 0 && Math.abs(num_value % 1).toString().length > (figures + 2)) {
-                str = num_value.toFixed(figures);
+                const long_form = num_value.toFixed(figures);
+
+                const separator_index = long_form.indexOf('.');
+
+                if (separator_index !== -1) {
+                    // has a decimal fraction, remove trailing zeroes
+                    let i = long_form.length - 1;
+
+                    while (i > 0 && long_form.charAt(i) === "0") {
+                        i--;
+                    }
+
+                    if (long_form.charAt(i) === '.') {
+                        i--;
+                    }
+
+                    str = long_form.slice(0, i + 1);
+                } else {
+                    str = long_form;
+                }
             }
 
             return str;
@@ -80,10 +100,8 @@ export class NumberController extends View {
          * Input field stops being edited
          */
         function handle_blur() {
-            if (Number.isNaN(parseFloat(el.value))) {
-                // input in the field is invalid, replace with the value held in the data container
-                el.value = format_value_string(_value.getValue());
-            }
+            // reformat contents of the input field
+            el.value = format_value_string(_value.getValue());
         }
 
         _value.process(data2view);

package/engine/EngineHarness.js

@@ -81,7 +81,7 @@ export class EngineHarness {
 
         window.engine = this.engine;
 
-        logger.addBackend(new ConsoleLoggerBackend());
+        logger.addBackend(ConsoleLoggerBackend.INSTANCE);
 
         this.p = null;
     }
@@ -437,6 +437,7 @@ export class EngineHarness {
 
         const eb = new EntityBuilder();
 
+        eb.add(new Transform())
         eb.add(terrain);
 
         if (enableWater) {

package/engine/asset/loaders/image/png/PNG.js

@@ -40,6 +40,12 @@ export function PNG() {
      */
     this.trns = null;
 
+
+    /**
+     * Text metadata coming from tEXt chunks
+     * @type {Object<string>}
+     */
+    this.text = {};
 }
 
 PNG.prototype.getWidth = function () {

package/engine/asset/loaders/image/png/PNGReader.js

@@ -157,12 +157,53 @@ PNGReader.prototype.decodeChunk = function () {
         case 'IEND':
             this.decodeIEND(chunk);
             break;
+        default:
+            //console.log(`Unsupported block ${type}`);
+            break;
     }
 
     return type;
 
 };
 
+/**
+ * https://www.w3.org/TR/PNG/#11tEXt
+ * @param {Uint8Array} chunk
+ */
+PNGReader.prototype.decodetEXt = function (chunk) {
+    const buff = BinaryBuffer.fromArrayBuffer(chunk.buffer);
+    const keyword = buff.readASCIICharacters(Number.POSITIVE_INFINITY, true);
+
+    const value = buff.readASCIICharacters(keyword.length - 1, false);
+
+    this.png.text[keyword] = value;
+}
+/**
+ * NOTE: untested
+ * https://www.w3.org/TR/PNG/#11iEXt
+ * @param {Uint8Array} chunk
+ */
+PNGReader.prototype.decodeiEXt = function (chunk) {
+    const buff = BinaryBuffer.fromArrayBuffer(chunk.buffer);
+
+    const keyword = buff.readASCIICharacters(Number.POSITIVE_INFINITY, true);
+
+    const compression_flag = buff.readUint8();
+    const compression_method = buff.readUint8();
+    const language_tag = buff.readASCIICharacters(Number.POSITIVE_INFINITY, true);
+    const translated_keyword = buff.readUTF8String();
+
+    const separator = buff.readUint8();
+
+    if (separator !== 0) {
+        throw new Error('Expected Null Separator after Translated keyword');
+    }
+
+    const text = buff.readUTF8String();
+
+    this.png.text[keyword] = text;
+}
+
 /**
  * http://www.w3.org/TR/2003/REC-PNG-20031110/#11IHDR
  * http://www.libpng.org/pub/png/spec/1.2/png-1.2-pdg.html#C.IHDR

package/engine/ecs/terrain/tiles/TerrainTile.js

@@ -496,6 +496,8 @@ class TerrainTile {
             geometry_bb.x0, geometry_bb.y0, geometry_bb.z0,
             geometry_bb.x1, geometry_bb.y1, geometry_bb.z1
         );
+        // update changes up the tree
+        this.boundingBox.bubbleRefit();
     }
 
     /**

package/engine/graphics/render/forward_plus/LightManager.js

@@ -303,6 +303,31 @@ export class LightManager {
         this.__visible_bvh_needs_update = true;
     }
 
+    /**
+     * Please set this to false if you have a lot of overlapping decals in the scene
+     * Overlapping decals can provide filtering artifacts due to incorrect mipmap level detection by WebGL
+     * see article: https://0fps.net/2013/07/09/texture-atlases-wrapping-and-mip-mapping/
+     * NOTE: the technique mentioned in the article above is not implemented, as it would require significant increase in number of texture fetches
+     * @param {boolean} v
+     */
+    set decal_filtering_enabled(v) {
+        const t = this.__decal_atlas_texture;
+
+        if (t.generateMipmaps === v) {
+            return;
+        }
+
+        t.generateMipmaps = v;
+    }
+
+    /**
+     *
+     * @return {boolean}
+     */
+    get decal_filtering_enabled() {
+        return this.__decal_atlas_texture.generateMipmaps;
+    }
+
     __update_decal_atlas_texture() {
         const sampler = this.__decal_atlas.sampler;
 

package/engine/graphics/render/forward_plus/data/TextureBackedMemoryRegion.js

@@ -1,7 +1,9 @@
-import { DataTexture, NearestFilter, RedFormat, UnsignedByteType } from "three";
+import { ClampToEdgeWrapping, DataTexture, NearestFilter, RedFormat, UnsignedByteType } from "three";
 import { DataType } from "../../../../../core/collection/table/DataType.js";
 import { assert } from "../../../../../core/assert.js";
-import { DataType2TypedArrayConstructorMapping } from "../../../../../core/collection/table/DataType2TypedArrayConstructorMapping.js";
+import {
+    DataType2TypedArrayConstructorMapping
+} from "../../../../../core/collection/table/DataType2TypedArrayConstructorMapping.js";
 import { max2 } from "../../../../../core/math/max2.js";
 import { NumericType } from "./NumericType.js";
 import { computeDataType } from "./computeDataType.js";
@@ -63,6 +65,8 @@ export class TextureBackedMemoryRegion {
         this.__texture.format = RedFormat;
         this.__texture.magFilter = NearestFilter;
         this.__texture.minFilter = NearestFilter;
+        this.__texture.wrapS = ClampToEdgeWrapping;
+        this.__texture.wrapT = ClampToEdgeWrapping;
         this.__texture.generateMipmaps = false;
 
         /**

package/engine/graphics/render/forward_plus/materials/FP_SHADER_CHUNK_ACCUMULATION.js

@@ -53,30 +53,25 @@ export const FP_SHADER_CHUNK_ACCUMULATION = `
                    vec4 local_position = decal_transform_matrix*vec4(v_world_position, 1.0);
                    
                    if(max3(abs(local_position.xyz)) < 0.5){
-                          // material.diffuseColor = material.diffuseColor*(0.8) + (local_position.xyz + 0.5)*0.2; // display UV
-                          
+                   
                           // we're inside decal volume
                           vec4 light_data_4 = texelFetch(fp_t_light_data, address_to_data_texture_coordinates(light_address+4u), 0);
-
+        
                           // compute normal of the decal
                           vec4 decal_normal = normalize( viewMatrix*decal_transform_matrix*vec4(0.0, 0.0, 1.0, 0.0) );
                           float decal_surface_dot = dot(decal_normal.xyz, geometry.normal);
-
+        
                           // we fade out decals when the projection angle to the surface gets too steep
                           // 0.7 is cos(45deg) and 0.5 is cos(60deg), dot returns cos of angle between two normals
                           float decal_surface_angle_fade = smoothstep(-0.5,-0.7,decal_surface_dot);
-                          // float decal_surface_angle_fade = decal_surface_dot;
-
-
+                         
                           vec2 decal_uv = (local_position.xy + 0.5)*light_data_4.zw + light_data_4.xy;
                           
-                          //material.diffuseColor = material.diffuseColor*(0.8) + vec3(decal_uv + 0.5, 0.0)*0.2; // display UV
                           
-
                           vec4 decal_color = texture(fp_t_decal_atlas, decal_uv);
+                          
                           float decal_alpha = decal_color.a * decal_surface_angle_fade;
-                          // float decal_alpha = decal_color.a;
-
+        
                           material.diffuseColor = material.diffuseColor*(1.0-decal_alpha) + decal_color.xyz*decal_alpha;
 
                    } 

package/engine/graphics/render/forward_plus/prototype/prototypeLightManager.js

@@ -65,6 +65,7 @@ import { StaticKnowledgeDatabase } from "../../../../knowledge/database/StaticKn
 import { Localization } from "../../../../../core/Localization.js";
 import '../../../../../../../../css/game.scss'
 import { randomFromArray } from "../../../../../core/math/random/randomFromArray.js";
+import { debugAtlas } from "../../../particles/particular/engine/shader/debugAtlas.js";
 
 document.body.style.margin = 0;
 
@@ -871,6 +872,270 @@ data/textures/icons/sci-fi-nathan/v6/Proc normal_2.png`
     camera.position.set(0, 0, 10);
 }
 
+async function prepare_scene_decal_2() {
+
+    const am = new AssetManager(null);
+
+    await am.registerLoader("image", new ImageRGBADataLoader());
+
+
+    const decal_urls = `data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_13_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_01_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_02_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_03_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_04_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_05_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_06_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_07_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_08_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_09_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_10_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_11_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_12_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_13_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/artifact_14_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_01_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_02_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_03_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_04_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_05_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_06_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_07_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_08_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_09_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_10_b.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_11_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/bag_12_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_01_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_02_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_03_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_04_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_05_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_06_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_07_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_08_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_09_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_10_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_11_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_12_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_13_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_14_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_15_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_16_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/book_17_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_01_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_02_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_03_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_04_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_05_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_06_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_07_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_08_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_09_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_10_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_11_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/orb_12_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_01_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_02_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_03_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_04_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_05_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_06_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_07_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_08_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_09_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_10_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_11_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/potion_12_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_01_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_02_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_03_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_04_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_05_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_06_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_07_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_08_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_09_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_10_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_11_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/rune_12_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_01_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_02_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_03_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_04_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_05_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_06_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_07_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_08_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_09_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_10_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_11_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_12_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/scroll_13_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_01_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_02_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_03_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_04_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_05_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_06_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_07_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_08_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_09_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_10_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_11_t.png
+data/textures/icons/FantasyIconsMegaPack/MagicItems/MagicItems_png/transparent/x64/staff_12_t.png
+data/textures/icons/sci-fi-nathan/v6/Proc normal_3.png
+data/textures/icons/sci-fi-nathan/v6/Proc strong_1.png
+data/textures/icons/sci-fi-nathan/v6/Proc strong_2.png
+data/textures/icons/sci-fi-nathan/v6/Proc strong_3.png
+data/textures/icons/sci-fi-nathan/v6/Proc very strong_1.png
+data/textures/icons/sci-fi-nathan/v6/Proc very strong_2.png
+data/textures/icons/sci-fi-nathan/v6/Proc very strong_3.png
+data/textures/icons/sci-fi-nathan/v6/Proc very weak_1.png
+data/textures/icons/sci-fi-nathan/v6/Proc very weak_2.png
+data/textures/icons/sci-fi-nathan/v6/Proc very weak_3.png
+data/textures/icons/sci-fi-nathan/v6/Proc weak_1.png
+data/textures/icons/sci-fi-nathan/v6/Proc weak_2.png
+data/textures/icons/sci-fi-nathan/v6/Proc weak_3.png
+data/textures/icons/sci-fi-nathan/v6/Core normal_1.png
+data/textures/icons/sci-fi-nathan/v6/Core normal_2.png
+data/textures/icons/sci-fi-nathan/v6/Core normal_3.png
+data/textures/icons/sci-fi-nathan/v6/Core strong_1.png
+data/textures/icons/sci-fi-nathan/v6/Core strong_2.png
+data/textures/icons/sci-fi-nathan/v6/Core strong_3.png
+data/textures/icons/sci-fi-nathan/v6/Core very strong_1.png
+data/textures/icons/sci-fi-nathan/v6/Core very strong_2.png
+data/textures/icons/sci-fi-nathan/v6/Core very strong_3.png
+data/textures/icons/sci-fi-nathan/v6/Core very weak_1.png
+data/textures/icons/sci-fi-nathan/v6/Core very weak_2.png
+data/textures/icons/sci-fi-nathan/v6/Core very weak_3.png
+data/textures/icons/sci-fi-nathan/v6/Core weak_1.png
+data/textures/icons/sci-fi-nathan/v6/Core weak_2.png
+data/textures/icons/sci-fi-nathan/v6/Core weak_3.png
+data/textures/icons/sci-fi-nathan/v6/Memory normal_1.png
+data/textures/icons/sci-fi-nathan/v6/Memory normal_2.png
+data/textures/icons/sci-fi-nathan/v6/Memory normal_3.png
+data/textures/icons/sci-fi-nathan/v6/Memory strong_1.png
+data/textures/icons/sci-fi-nathan/v6/Memory strong_2.png
+data/textures/icons/sci-fi-nathan/v6/Memory strong_3.png
+data/textures/icons/sci-fi-nathan/v6/Memory very strong_1.png
+data/textures/icons/sci-fi-nathan/v6/Memory very strong_2.png
+data/textures/icons/sci-fi-nathan/v6/Memory very strong_3.png
+data/textures/icons/sci-fi-nathan/v6/Memory very weak_1.png
+data/textures/icons/sci-fi-nathan/v6/Memory very weak_2.png
+data/textures/icons/sci-fi-nathan/v6/Memory very weak_3.png
+data/textures/icons/sci-fi-nathan/v6/Memory weak_1.png
+data/textures/icons/sci-fi-nathan/v6/Memory weak_2.png
+data/textures/icons/sci-fi-nathan/v6/Memory weak_3.png
+data/textures/icons/sci-fi-nathan/v6/Module normal_1.png
+data/textures/icons/sci-fi-nathan/v6/Module normal_2.png
+data/textures/icons/sci-fi-nathan/v6/Module normal_3.png
+data/textures/icons/sci-fi-nathan/v6/Module strong_1.png
+data/textures/icons/sci-fi-nathan/v6/Module strong_2.png
+data/textures/icons/sci-fi-nathan/v6/Module strong_3.png
+data/textures/icons/sci-fi-nathan/v6/Module very strong_1.png
+data/textures/icons/sci-fi-nathan/v6/Module very strong_2.png
+data/textures/icons/sci-fi-nathan/v6/Module very strong_3.png
+data/textures/icons/sci-fi-nathan/v6/Module very weak_1.png
+data/textures/icons/sci-fi-nathan/v6/Module very weak_2.png
+data/textures/icons/sci-fi-nathan/v6/Module very weak_3.png
+data/textures/icons/sci-fi-nathan/v6/Module weak_1.png
+data/textures/icons/sci-fi-nathan/v6/Module weak_2.png
+data/textures/icons/sci-fi-nathan/v6/Module weak_3.png
+data/textures/icons/sci-fi-nathan/v6/Power normal_1.png
+data/textures/icons/sci-fi-nathan/v6/Power normal_2.png
+data/textures/icons/sci-fi-nathan/v6/Power normal_3.png
+data/textures/icons/sci-fi-nathan/v6/Power strong_1.png
+data/textures/icons/sci-fi-nathan/v6/Power strong_2.png
+data/textures/icons/sci-fi-nathan/v6/Power strong_3.png
+data/textures/icons/sci-fi-nathan/v6/Power very strong_1.png
+data/textures/icons/sci-fi-nathan/v6/Power very strong_2.png
+data/textures/icons/sci-fi-nathan/v6/Power very strong_3.png
+data/textures/icons/sci-fi-nathan/v6/Power very weak_1.png
+data/textures/icons/sci-fi-nathan/v6/Power very weak_2.png
+data/textures/icons/sci-fi-nathan/v6/Power very weak_3.png
+data/textures/icons/sci-fi-nathan/v6/Power weak_1.png
+data/textures/icons/sci-fi-nathan/v6/Power weak_2.png
+data/textures/icons/sci-fi-nathan/v6/Power weak_3.png
+data/textures/icons/sci-fi-nathan/v6/Proc normal_1.png
+data/textures/icons/sci-fi-nathan/v6/Proc normal_2.png
+data/textures/utility/sampling-test.png`
+        .split('\n')
+        .map(a => a.trim());
+
+    const samplers = [];
+    const promises = [];
+
+    for (let i = 0; i < decal_urls.length; i++) {
+        const promise = am.promise(decal_urls[i], 'image');
+        promises.push(promise);
+    }
+
+    const assets = await Promise.all(promises);
+
+    for (let i = 0; i < assets.length; i++) {
+        const asset = assets[i];
+
+        samplers[i] = asset.create();
+    }
+
+    const canvas_size = 5;
+
+    const random = seededRandom();
+
+    const COUNT = 1024;
+
+    const ROW_WIDTH = Math.ceil(Math.sqrt(COUNT));
+    const size = canvas_size / ROW_WIDTH;
+
+    for (let i = 0; i < COUNT; i++) {
+
+        const q = new Quaternion();
+        // q.fromEulerAnglesXYZ(0, (90 + randomFloatBetween(random, -60, 60)) * DEG2RAD, 0);
+        q.fromEulerAnglesXYZ(0, (-180) * DEG2RAD, 0);
+
+        const sampler = randomFromArray(random, samplers);
+        // const sampler = samplers[i % samplers.length];
+
+        // const size = randomFloatBetween(random, 1, 3);
+        //const size = 0.5;
+
+        // const position = [
+        //     randomFloatBetween(random, -canvas_size * 0.5, canvas_size * 0.5), randomFloatBetween(random, -canvas_size * 0.5, canvas_size * 0.5), -4
+        // ];
+
+        const x = ((i % ROW_WIDTH)) / ROW_WIDTH - 0.5 + 0.5 / ROW_WIDTH;
+        const y = Math.floor(i / ROW_WIDTH) / ROW_WIDTH - 0.5 + 0.5 / ROW_WIDTH;
+        const position = [
+            x * canvas_size, y * canvas_size, -4
+        ];
+
+        addDecal({
+            position: position,
+            scale: [
+                size, size, 1.5
+            ],
+            rotation: q,
+            sampler: sampler,
+            scene,
+            light_manager: lm
+        });
+
+    }
+
+    addBox([0, 0, -4], [canvas_size, canvas_size, 1], [0, 0, 0]);
+    //
+    // addKnot([0, 0, -4], 2, [0, 0, 0])
+
+    scene.add(new AmbientLight(0xFFFFFF, 0.8));
+
+    camera.near = 1;
+    camera.far = 30;
+
+    camera.lookAt(0, 0, -5);
+    camera.position.set(0, 0, 10);
+}
+
 
 async function prepare_scene_9() {
 
@@ -1295,7 +1560,8 @@ function draw_camera_view_planes() {
 
 // prepare_scene_2();
 // prepare_scene_decal_0();
-prepare_scene_decal_1();
+// prepare_scene_decal_1();
+prepare_scene_decal_2();
 // prepare_scene_9();
 // prepare_scene_2();
 // prepare_scene_0();
@@ -1353,7 +1619,7 @@ const debugger_button = new ButtonView({
     }
 });
 
-// debugAtlas(lm.__decal_atlas.atlas, { scale: new Vector2(0.125, 0.125) });
+debugAtlas(lm.__decal_atlas.atlas, { scale: new Vector2(0.125, 0.125) });
 
 debugger_button.link();
 

package/engine/graphics/texture/atlas/AtlasPatch.js

@@ -65,15 +65,21 @@ export class AtlasPatch {
      */
     updateUV(canvasWidth, canvasHeight) {
 
+        const position = this.position;
         const size = this.size;
+        const uv = this.uv;
 
-        const position = this.position;
+        const x0 = position.x;
+        const y0 = position.y;
+
+        const sx = size.x;
+        const sy = size.y;
 
-        this.uv.set(
-            position.x / canvasWidth,
-            position.y / canvasHeight,
-            size.x / canvasWidth,
-            size.y / canvasHeight
+        uv.set(
+            x0 / canvasWidth,
+            y0 / canvasHeight,
+            sx / canvasWidth,
+            sy / canvasHeight
         );
 
     }

package/engine/logging/ConsoleLoggerBackend.js

@@ -1,6 +1,8 @@
 import { LoggerBackend } from "./LoggerBackend.js";
 import { LogLevel } from "./LogLevel.js";
 
+let instance;
+
 export class ConsoleLoggerBackend extends LoggerBackend {
     log(level, message) {
         switch (level) {
@@ -19,4 +21,17 @@ export class ConsoleLoggerBackend extends LoggerBackend {
                 console.log(message);
         }
     }
+
+    /**
+     * Singleton instance
+     * NOTE: you can still create additional instances if you find that useful
+     * @return {ConsoleLoggerBackend}
+     */
+    static get INSTANCE() {
+        if (instance === undefined) {
+            instance = new ConsoleLoggerBackend();
+        }
+
+        return instance;
+    }
 }

package/engine/logging/Logger.js

@@ -12,11 +12,34 @@ export class Logger {
     }
 
     /**
-     *
+     * Add a logging backend, this is a structure that handles incoming log messages.
+     * There can be multiple backends registered at any given time or even none at all
      * @param {LoggerBackend} backend
+     * @returns {boolean} will return false if backend instance is already attached
      */
     addBackend(backend) {
+        if (this.backends.includes(backend)) {
+            // already registered
+            return false;
+        }
+
         this.backends.push(backend);
+        return true;
+    }
+
+    /**
+     * Remove backend instance, counterpart to {@link #addBackend} see {@link #addBackend} for more information
+     * @param {LoggerBackend} backend
+     * @return {boolean}
+     */
+    removeBackend(backend) {
+        const i = this.backends.indexOf(backend);
+        if (i === -1) {
+            return false;
+        } else {
+            this.backends.splice(i, 1);
+            return true;
+        }
     }
 
     /**

package/engine/logging/LoggerBackend.js

@@ -30,6 +30,7 @@ export class LoggerBackend {
      *
      * @param {LogLevel} level
      * @param {string} message
+     * @returns {void}
      */
     log(level, message) {
         throw new Error('Abstract class, method needs to be implemented in the subclass');

package/engine/physics/fluid/FluidField.js

@@ -0,0 +1,9 @@
+/**
+ * Represents a space where fluid simulation happens
+ *
+ * @see 2019 GDC talk by Runard Rupert "Wind Simulation in God of War" https://www.youtube.com/watch?v=dDgyBKkSf7A
+ * @see Inspired by GDC talk "Interactive Wind and Vegetation in 'God of War'" - https://www.youtube.com/watch?v=MKX45_riWQA
+ */
+export class FluidField{
+
+}

package/engine/physics/fluid/effector/AbstractFluidEffector.js

@@ -0,0 +1,6 @@
+/**
+ * Base interface for injecting external forces into the simulation
+ */
+export class AbstractFluidEffector {
+
+}

package/engine/physics/fluid/effector/GlobalFluidEffector.js

@@ -0,0 +1,12 @@
+import { AbstractFluidEffector } from "./AbstractFluidEffector.js";
+
+/**
+ * Affects fluid everywhere inside the field uniformly
+ */
+export class GlobalFluidEffector extends AbstractFluidEffector{
+    /**
+     * 3d force vector
+     * @type {number[]}
+     */
+    force = [0, 0, 0];
+}

package/engine/physics/fluid/effector/WakeFluidEffector.js

@@ -0,0 +1,8 @@
+import { AbstractFluidEffector } from "./AbstractFluidEffector.js";
+
+/**
+ * Creates force in its "wake" (behind it) as it travels
+ */
+export class WakeFluidEffector extends AbstractFluidEffector {
+
+}

package/package.json

@@ -5,7 +5,7 @@
   "productName": "Meep",
   "description": "production-ready JavaScript game engine based on Entity Component System Architecture",
   "author": "Alexander Goldring",
-  "version": "2.40.0",
+  "version": "2.40.1",
   "dependencies": {
     "gl-matrix": "3.4.3",
     "fast-levenshtein": "2.0.6",