@woosh/meep-engine 2.40.0 → 2.41.0

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/render/visibility/hiz/buildCanvasViewFromTexture.js

@@ -11,6 +11,9 @@ import {
 } from "three";
 import CheckersTexture from "../../../texture/CheckersTexture.js";
 import { FULL_SCREEN_TRIANGLE_GEOMETRY } from "../../../geometry/FULL_SCREEN_TRIANGLE_GEOMETRY.js";
+import { formatToChannelCount } from "../../../texture/formatToChannelCount.js";
+import { glsl_gen_swizzled_read } from "../../../shaders/glsl_gen_swizzled_read.js";
+import { assert } from "../../../../../core/assert.js";
 
 
 /**
@@ -44,8 +47,19 @@ function sampleTexel(texture, name, uv) {
 /**
  *
  * @param {THREE.Texture} texture
+ * @param {number} [alpha_override] will force specified alpha value in output, useful for cases where alpha would be 0 otherwise
+ * @param {(string|number)[]} swizzle allows us to re-arrange pixels as they are being written out
  */
-function makeShader(texture) {
+function makeShader({ texture, alpha_override, swizzle }) {
+    let _swizzle = swizzle.slice();
+
+    const texture_channel_count = formatToChannelCount(texture.format);
+
+    if (texture_channel_count < 4) {
+        // no override specified, and alpha would be 0, force it to one to make image visible
+        _swizzle[4] = 1;
+    }
+
     return new ShaderMaterial({
 
         vertexShader: /* glsl */`
@@ -68,11 +82,7 @@ function makeShader(texture) {
 		void main() {
 
 			vec4 texel = ${sampleTexel(texture, 'tDiffuse', 'vUv')};
-			gl_FragColor = texel;
-			
-			gl_FragColor.a = 1.0;
-			// gl_FragColor.r *= 255.0;
-
+			gl_FragColor = ${glsl_gen_swizzled_read('texel', swizzle)};
 		}`,
         uniforms: {
 
@@ -88,7 +98,8 @@ function makeShader(texture) {
  * @param {number} width
  * @param {THREE.Texture} texture
  * @param {THREE.WebGLRenderer} renderer
- * @param flipY
+ * @param {boolean} [flipY]
+ * @param {(string|number)[]} [swizzle]
  * @return {{view: View, render: function}}
  */
 export function buildCanvasViewFromTexture({
@@ -96,9 +107,18 @@ export function buildCanvasViewFromTexture({
                                                width = texture.image.width,
                                                height = texture.image.height,
                                                renderer,
-                                               flipY = true
+                                               flipY = true,
+                                               swizzle = ['r', 'g', 'b', 'a']
                                            }) {
+
+    assert.isArray(swizzle, 'swizzle');
+
     const canvasView = new CanvasView();
+    canvasView.css({
+        position: 'absolute',
+        left: 0,
+        top: 0
+    });
     canvasView.size.set(width, height);
 
     const ctx = canvasView.context2d;
@@ -137,7 +157,7 @@ export function buildCanvasViewFromTexture({
      */
     function getShader() {
         if (__texture_cached !== texture || copyShader === null) {
-            copyShader = makeShader(texture);
+            copyShader = makeShader({ texture: texture, swizzle });
 
             copyShader.side = DoubleSide;
             copyShader.uniforms.tDiffuse.value = texture;
@@ -154,6 +174,8 @@ export function buildCanvasViewFromTexture({
 
         getShader().uniforms.tDiffuse.value = texture;
 
+        const _rt = renderer.getRenderTarget();
+
         renderer.setRenderTarget(renderTarget);
 
         renderer.render(scene, camera);
@@ -163,7 +185,7 @@ export function buildCanvasViewFromTexture({
 
         ctx.putImageData(imageData, 0, 0)
 
-        renderer.setRenderTarget(null);
+        renderer.setRenderTarget(_rt);
     };
 
     return {

package/engine/graphics/shaders/ScreenSpaceQuadShader.js

@@ -1,3 +1,5 @@
+import { glsl_gen_swizzled_read } from "./glsl_gen_swizzled_read.js";
+
 function vertexShader() {
     return `
                 varying vec2 vUv;
@@ -11,25 +13,13 @@ function vertexShader() {
         `;
 }
 
+
 /**
  *
  * @param {string[]} [swizzle] what to read from the texture
  * @returns {string}
  */
 function fragmentShader(swizzle = ['r', 'g', 'b', 'a']) {
-    const swizzle_read = [];
-    const n = swizzle.length;
-    for (let i = 0; i < n; i++) {
-        const token = swizzle[i];
-
-        if (typeof token === "string") {
-            swizzle_read[i] = `texel.${token}`;
-        } else if (typeof token === "number") {
-            swizzle_read[i] = Number(token).toFixed(4);
-        } else {
-            throw new Error(`Unsupported swizzle token '${token}'`);
-        }
-    }
 
     return `
                 uniform sampler2D tTexture;
@@ -37,7 +27,7 @@ function fragmentShader(swizzle = ['r', 'g', 'b', 'a']) {
                             
                 void main(){
                     vec4 texel = texture2D( tTexture, vUv );
-                    gl_FragColor = vec4(${swizzle_read.join(',')});
+                    gl_FragColor = ${glsl_gen_swizzled_read('texel', swizzle)};
                 }
         `;
 }

package/engine/graphics/shaders/glsl_gen_swizzled_read.js

@@ -0,0 +1,39 @@
+/**
+ *
+ * @param {string} input name of the variable on which components are being accessed
+ * @param {(string|number)[]} swizzle
+ * @returns {string} swizzled vector
+ */
+export function glsl_gen_swizzled_read(input, swizzle) {
+    const swizzle_read = [];
+    const n = swizzle.length;
+    for (let i = 0; i < n; i++) {
+        const token = swizzle[i];
+
+        if (typeof token === "string") {
+            swizzle_read[i] = `${input}.${token}`;
+        } else if (typeof token === "number") {
+            swizzle_read[i] = Number(token).toFixed(4);
+        } else {
+            throw new Error(`Unsupported swizzle token '${token}'`);
+        }
+    }
+
+    const arg_string = swizzle_read.join(', ');
+
+    const ctors = [
+        undefined,
+        'float',
+        'vec2',
+        'vec3',
+        'vec4'
+    ];
+
+    const ctor = ctors[swizzle.length];
+
+    if (ctor === undefined) {
+        throw new Error(`No constructor for input length ${swizzle.length}`);
+    }
+
+    return `${ctor}(${arg_string})`;
+}

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/engine/ui/GUIEngine.js

@@ -103,7 +103,14 @@ function GUIEngine() {
         }
     });
 
-    this.view = new EmptyView({ classList: ['gui-engine-root'] });
+    this.view = new EmptyView({
+        classList: ['gui-engine-root'],
+        css: {
+            position: "absolute",
+            left: "0",
+            top: "0"
+        }
+    });
 
     /**
      *

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.41.0",
   "dependencies": {
     "gl-matrix": "3.4.3",
     "fast-levenshtein": "2.0.6",