@woosh/meep-engine 2.36.28 → 2.37.0

package/editor/view/ecs/components/color/GaugeView.js

@@ -1,9 +1,9 @@
-import { clamp } from "../../../../../core/math/clamp.js";
 import GuiControl from "../../../../../view/controller/controls/GuiControl.js";
 import EmptyView from "../../../../../view/elements/EmptyView.js";
 import LabelView from "../../../../../view/common/LabelView.js";
 import { PointerDevice } from "../../../../../engine/input/devices/PointerDevice.js";
 import { AutoCanvasView } from "../common/AutoCanvasView.js";
+import { clamp01 } from "../../../../../core/math/clamp01.js";
 
 export class GaugeView extends GuiControl {
     /**
@@ -80,7 +80,7 @@ export class GaugeView extends GuiControl {
                 return;
             }
 
-            model.set(clamp(v, 0, 1));
+            model.set(clamp01(v));
         }
 
         function setValueFromMouseEvent(event) {

package/editor/view/ecs/components/particles/ColorParameterLUTController.js

@@ -1,4 +1,3 @@
-import { clamp } from "../../../../../core/math/clamp.js";
 import GuiControl from "../../../../../view/controller/controls/GuiControl.js";
 import View from "../../../../../view/View.js";
 import { PointerDevice } from "../../../../../engine/input/devices/PointerDevice.js";
@@ -7,10 +6,13 @@ import ObservedValue from "../../../../../core/model/ObservedValue.js";
 import { ColorPickerView } from "../../../../../view/elements/ColorPickerView.js";
 import Vector1 from "../../../../../core/geom/Vector1.js";
 import Vector4 from "../../../../../core/geom/Vector4.js";
-import { ParameterLookupTableFlags } from "../../../../../engine/graphics/particles/particular/engine/parameter/ParameterLookupTableFlags.js";
+import {
+    ParameterLookupTableFlags
+} from "../../../../../engine/graphics/particles/particular/engine/parameter/ParameterLookupTableFlags.js";
 import { DomSizeObserver } from "../../../../../view/util/DomSizeObserver.js";
 import { AutoCanvasView } from "../common/AutoCanvasView.js";
 import EmptyView from "../../../../../view/elements/EmptyView.js";
+import { clamp01 } from "../../../../../core/math/clamp01.js";
 
 
 class MarkerView extends View {
@@ -31,7 +33,6 @@ class MarkerView extends View {
 }
 
 
-
 /**
  *
  * @param {Array.<MarkerView>} markers
@@ -74,7 +75,7 @@ function buildMarker(markers, model, update, canvas, selection) {
 
         const positionDelta = delta.x / canvas.width;
 
-        const newPosition = clamp(oldPosition + positionDelta, 0, 1);
+        const newPosition = clamp01(oldPosition + positionDelta);
 
         lut.positions[markerIndex] = newPosition;
 

package/editor/view/ecs/components/particles/ScalarParameterLUTController.js

@@ -1,11 +1,13 @@
-import { clamp } from "../../../../../core/math/clamp.js";
 import GuiControl from "../../../../../view/controller/controls/GuiControl.js";
 import View from "../../../../../view/View.js";
 import { PointerDevice } from "../../../../../engine/input/devices/PointerDevice.js";
 import Vector2 from "../../../../../core/geom/Vector2.js";
-import { ParameterLookupTableFlags } from "../../../../../engine/graphics/particles/particular/engine/parameter/ParameterLookupTableFlags.js";
+import {
+    ParameterLookupTableFlags
+} from "../../../../../engine/graphics/particles/particular/engine/parameter/ParameterLookupTableFlags.js";
 import LabelView from "../../../../../view/common/LabelView.js";
 import Vector1 from "../../../../../core/geom/Vector1.js";
+import { clamp01 } from "../../../../../core/math/clamp01.js";
 
 
 function computeVerticalValuePosition(v, min, max, height, lineWidth) {
@@ -151,7 +153,7 @@ function buildMarker(markers, model, update, canvas) {
 
         const valueDelta = valueDeltaNormalized * dragScale;
 
-        const newPosition = clamp(oldPosition + positionDelta, 0, 1);
+        const newPosition = clamp01(oldPosition + positionDelta);
 
         lut.positions[markerIndex] = newPosition;
 

package/engine/Clock.js

@@ -83,6 +83,10 @@ class Clock {
         this.__isRunning = true;
     }
 
+    stop() {
+        this.__isRunning = false;
+    }
+
     pause() {
         this.__isRunning = false;
         //update time

package/engine/UserController.js

@@ -5,6 +5,7 @@ import Vector3 from "../core/geom/Vector3.js";
 import { Transform } from './ecs/transform/Transform.js';
 import Hammer from 'Hammer';
 import { Euler as ThreeEuler, Vector2 as ThreeVector2, Vector3 as ThreeVector3 } from 'three';
+import { DEG_TO_RAD } from "../core/math/DEG_TO_RAD.js";
 
 const keyboardRotationSpeed = 1.2;
 
@@ -37,7 +38,7 @@ function panUp(distance, object, result) {
 // right and down are positive
 function pan(delta, object, element, targetDistance, fov, result) {
     // half of the fov is center to top of screen
-    targetDistance *= Math.tan((fov / 2) * Math.PI / 180.0);
+    targetDistance *= Math.tan((fov / 2) * DEG_TO_RAD);
     // we actually don't use screenWidth, since perspective camera is fixed to screen height
     panLeft(2 * delta.x * targetDistance / element.clientHeight, object, result);
     panUp(2 * delta.y * targetDistance / element.clientHeight, object, result);

package/engine/animation/behavior/animateProperty.js

@@ -1,10 +1,13 @@
-import { TransitionPropertyVectorXBehavior } from "../../../../model/game/story/behaviors/generic/TransitionPropertyVectorXBehavior.js";
+import {
+    TransitionPropertyVectorXBehavior
+} from "../../../../model/game/story/behaviors/generic/TransitionPropertyVectorXBehavior.js";
 import EntityBuilder from "../../ecs/EntityBuilder.js";
 import { BehaviorComponent } from "../../intelligence/behavior/ecs/BehaviorComponent.js";
 import { SequenceBehavior } from "../../intelligence/behavior/composite/SequenceBehavior.js";
 import { DieBehavior } from "../../intelligence/behavior/ecs/DieBehavior.js";
 import { SendEventBehavior } from "../../../../model/game/util/behavior/SendEventBehavior.js";
 import { SerializationMetadata } from "../../ecs/components/SerializationMetadata.js";
+import { assert } from "../../../core/assert.js";
 
 /**
  *
@@ -18,6 +21,8 @@ import { SerializationMetadata } from "../../ecs/components/SerializationMetadat
  */
 export async function animateProperty(ecd, entity, component, property, target, time) {
 
+    assert.ok(ecd.entityExists(entity), `entity ${entity} doesn't exist`);
+
     const builder = new EntityBuilder()
         .add(SerializationMetadata.Transient)
         .add(BehaviorComponent.fromOne(SequenceBehavior.from([

package/engine/animation/keyed2/behavior/AnimationBehavior.js

@@ -29,6 +29,5 @@ export class AnimationBehavior extends Behavior {
 
     initialize() {
         this.animation.setPosition(this.animation.track.timeStart);
-        this.__status = BehaviorStatus.Running;
     }
 }

package/engine/ecs/EntityBuilder.js

@@ -226,7 +226,18 @@ class EntityBuilder {
      */
     promiseEvent(eventName) {
         return new Promise((resolve, reject) => {
-            this.addEventListener(eventName, resolve);
+
+            const handle_event = () => {
+
+                this.removeEventListener(eventName, handle_event);
+                this.removeEventListener(EventType.EntityRemoved, reject);
+
+                resolve();
+            }
+
+
+            this.addEventListener(eventName, handle_event);
+            this.removeEventListener(EventType.EntityRemoved, reject);
         });
     }
 

package/engine/ecs/animation/OneBoneSurfaceAlignmentSolver.js

@@ -8,6 +8,7 @@ import { SurfacePoint3 } from "../../../core/geom/3d/SurfacePoint3.js";
 import { v3_computeOffsetVector } from "./IKMath.js";
 import { v3_dot } from "../../../core/geom/v3_dot.js";
 import { v3_length } from "../../../core/geom/v3_length.js";
+import { clamp01 } from "../../../core/math/clamp01.js";
 
 const boneWorldPosition = new Vector3();
 const boneWorldRotation = new Quaternion();
@@ -141,7 +142,7 @@ export class OneBoneSurfaceAlignmentSolver extends IKSolver {
             //no penetration, hovering case, use hover distance for influence
             const normalized_effector_distance = inverseLerp(0, bone_scale, delta_contact_c_length);
 
-            influence = 1 - clamp(constraint.distance.normalizeValue(normalized_effector_distance), 0, 1);
+            influence = 1 - clamp01(constraint.distance.normalizeValue(normalized_effector_distance));
         }
 
         if (influence <= 0) {

package/engine/ecs/animation/TwoBoneInverseKinematicsSolver.js

@@ -9,6 +9,7 @@ import { IKSolver } from "./IKSolver.js";
 import { v3_computeOffsetVector } from "./IKMath.js";
 import { v3_dot } from "../../../core/geom/v3_dot.js";
 import { v3_length } from "../../../core/geom/v3_length.js";
+import { clamp01 } from "../../../core/math/clamp01.js";
 
 const boneWorldPositionC = new Vector3();
 const boneWorldPositionB = new Vector3();
@@ -280,7 +281,7 @@ export class TwoBoneInverseKinematicsSolver extends IKSolver {
             //no penetration, hovering case, use hover distance for influence
             const normalized_effector_distance = inverseLerp(0, limbLength, delta_contact_c_length);
 
-            influence = 1 - clamp(constraint.distance.normalizeValue(normalized_effector_distance), 0, 1);
+            influence = 1 - clamp01(constraint.distance.normalizeValue(normalized_effector_distance));
         }
 
         if (influence <= 0) {

package/engine/ecs/fow/shader/screenSpaceFogOfWarShader.js

@@ -25,8 +25,8 @@ export function buildScreenSpaceFogOfWarShader() {
         
         varying vec2 vUv;
         
-        const float   c_samplesX    = 7.0;
-        const float   c_samplesY    = 7.0;
+        const float   c_samplesX    = 5.0;
+        const float   c_samplesY    = 5.0;
 
         const float   c_halfSamplesX = c_samplesX / 2.0;
         const float   c_halfSamplesY = c_samplesY / 2.0;
@@ -95,15 +95,15 @@ export function buildScreenSpaceFogOfWarShader() {
 	     }
 	     	        
         void main(){
-                //get world fragment position
-                vec3 worldPosition = computeWorldPosition();
-                
-                vec2 fogUv = worldPosition.xz * uFogUvTransform.zw + uFogUvTransform.xy;
-                
-                float fogValue = getFog( fogUv );
-                
-                gl_FragColor = uColor;
-                gl_FragColor.a *= fogValue;
+            //get world fragment position
+            vec3 worldPosition = computeWorldPosition();
+            
+            vec2 fogUv = worldPosition.xz * uFogUvTransform.zw + uFogUvTransform.xy;
+            
+            float fogValue = getFog( fogUv );
+            
+            gl_FragColor = uColor;
+            gl_FragColor.a *= fogValue;
         }
         `;
     }
@@ -127,6 +127,9 @@ export function buildScreenSpaceFogOfWarShader() {
         uProjectionInverse: { type: 'm4', value: new Matrix4() },
         uColor: { type: 'c', value: new Vector4(0, 0, 0, 1) },
         uFogUvTransform: { type: 'v4', value: new Vector4(0, 0, 1, 1) },
+        /**
+         * Fog texture resolution
+         */
         uResolution: { type: 'v2', value: new Vector2(0, 0) }
     };
 

package/engine/ecs/systems/AimControllerSystem.js

@@ -7,6 +7,7 @@ import { System } from '../System.js';
 import AimController from '../components/AimController.js';
 import CharacterController from '../components/CharacterController.js';
 import { Transform } from '../transform/Transform.js';
+import { DEG_TO_RAD } from "../../../core/math/DEG_TO_RAD.js";
 
 
 class AimControllerSystem extends System {
@@ -14,7 +15,7 @@ class AimControllerSystem extends System {
         super();
         this.dependencies = [AimController];
 
-        this.sensitivity = 5 * Math.PI / 180;
+        this.sensitivity = 5 * DEG_TO_RAD;
     }
 
     add(component, entity) {
@@ -31,7 +32,7 @@ class AimControllerSystem extends System {
             updateController(aimController, sensitivity);
             //rotate player
             const quaternion = new THREE.Quaternion();
-            quaternion.setFromAxisAngle(new THREE.Vector3(0, 1, 0), -aimController.lon * (Math.PI / 180));
+            quaternion.setFromAxisAngle(new THREE.Vector3(0, 1, 0), -aimController.lon * DEG_TO_RAD);
             transform.rotation.copy(quaternion);
             //rotate aim transform
             const aimTransform = character.aim;

package/engine/ecs/systems/RangedAttackSystem.js

@@ -34,11 +34,12 @@ const intercept = (function () {
         const c = toTarget.dot(toTarget);
 
         // Solve quadratic
-        const ts = solveQuadratic(a, b, c); // See quad(), below
+        const ts = [];
+        const root_count = solveQuadratic(ts, 0, a, b, c); // See quad(), below
 
         // Find smallest positive solution
         let sol = null;
-        if (ts) {
+        if (root_count > 0) {
             const t0 = ts[0], t1 = ts[1];
             let t = Math.min(t0, t1);
             if (t < 0) t = Math.max(t0, t1);

package/engine/ecs/systems/SteeringSystem.js

@@ -39,11 +39,11 @@ function computeInterceptPoint(result, source, target, targetVelocity, sourceSpe
     );
 
     // Solve quadratic
-    const ts = solveQuadratic(a, b, c); // See quad(), below
+    const ts = [];
+    const root_count = solveQuadratic(ts, 0, a, b, c); // See quad(), below
 
     // Find smallest positive solution
-    let sol = null;
-    if (ts) {
+    if (root_count > 0) {
         const t0 = ts[0], t1 = ts[1];
         let t = Math.min(t0, t1);
         if (t < 0) t = Math.max(t0, t1);

package/engine/ecs/terrain/ecs/ClingToTerrainSystem.js

@@ -1,7 +1,6 @@
 /**
  * Created by Alex on 13/05/2016.
  */
-import { clamp } from "../../../../core/math/clamp.js";
 import { min2 } from "../../../../core/math/min2.js";
 import { System } from '../../System.js';
 import { Transform } from '../../transform/Transform.js';
@@ -16,6 +15,7 @@ import { assert } from "../../../../core/assert.js";
 import { SurfacePoint3 } from "../../../../core/geom/3d/SurfacePoint3.js";
 import { Deque } from "../../../../core/collection/queue/Deque.js";
 import { obtainTerrain } from "../util/obtainTerrain.js";
+import { clamp01 } from "../../../../core/math/clamp01.js";
 
 
 /**
@@ -235,7 +235,7 @@ export function alignToVector(rotation, direction, angularLimit, up = Vector3.up
         return;
     }
 
-    const t = clamp(angularLimit / angle, 0, 1);
+    const t = clamp01(angularLimit / angle);
 
     // TODO Consider replacing this with slerp
     rotation.lerp(q_temp, t);

package/engine/ecs/terrain/util/paintTerrainOverlayViaLookupTable.js

@@ -1,7 +1,7 @@
-import { clamp } from "../../../../core/math/clamp.js";
 import { Sampler2D } from "../../../graphics/texture/sampler/Sampler2D.js";
 import { ParameterLookupTable } from "../../../graphics/particles/particular/engine/parameter/ParameterLookupTable.js";
 import { passThrough } from "../../../../core/function/Functions.js";
+import { clamp01 } from "../../../../core/math/clamp01.js";
 
 
 const heatmap_lut = new ParameterLookupTable(4);
@@ -48,7 +48,7 @@ export function paintTerrainOverlayViaLookupTable({ overlay, sampler, lut = heat
 
             const scaledPosition = lookupScaleFunction(p);
 
-            const position = clamp(range.normalizeValue(scaledPosition), 0, 1);
+            const position = clamp01(range.normalizeValue(scaledPosition));
 
             lut.sample(position, colorSample);
 

package/engine/graphics/GraphicsEngine.js

@@ -39,6 +39,7 @@ import { CameraViewManager } from "./render/view/CameraViewManager.js";
 import { StandardFrameBuffers } from "./StandardFrameBuffers.js";
 import { load_environment_map } from "./texture/cubemap/load_environment_map.js";
 import { CompositingStages } from "./composit/CompositingStages.js";
+import { DEG_TO_RAD } from "../../core/math/DEG_TO_RAD.js";
 
 /**
  *
@@ -493,7 +494,7 @@ GraphicsEngine.prototype.normalizeViewportPoint = function (input, result) {
  */
 GraphicsEngine.prototype.viewportWorldSize = function (camera, zDistance, result) {
     const size = this.viewport.size;
-    const angleY = camera.fov * (Math.PI / 180);
+    const angleY = camera.fov * DEG_TO_RAD;
     const cameraZ = camera.position.z;
     const distFromCamToPlane = Math.abs(cameraZ) + zDistance;
 

package/engine/graphics/camera/CameraShake.js

@@ -1,12 +1,12 @@
 import Vector3 from "../../../core/geom/Vector3.js";
 
 import SimplexNoise from 'simplex-noise';
-import { clamp } from "../../../core/math/clamp.js";
-import { makeCubicCurve} from "../../../core/math/MathUtils.js";
+import { makeCubicCurve } from "../../../core/math/MathUtils.js";
 import { seededRandom } from "../../../core/math/random/seededRandom.js";
 import { Behavior } from "../../intelligence/behavior/Behavior.js";
 import { BehaviorStatus } from "../../intelligence/behavior/BehaviorStatus.js";
 import Quaternion from "../../../core/geom/Quaternion.js";
+import { clamp01 } from "../../../core/math/clamp01.js";
 
 export class CameraShakeTraumaBehavior extends Behavior {
 
@@ -31,9 +31,9 @@ export class CameraShakeTraumaBehavior extends Behavior {
     }
 
     tick(timeDelta) {
-        const shake = this.formula(clamp(this.trauma, 0, 1));
+        const shake = this.formula(clamp01(this.trauma));
 
-        this.trauma = clamp(this.trauma - timeDelta * this.decay, 0, 1);
+        this.trauma = clamp01(this.trauma - timeDelta * this.decay);
 
 
         this.shakeBehavior.strength = shake;

package/engine/graphics/ecs/animation/animator/graph/AnimationTransition.js

@@ -1,6 +1,6 @@
-import { clamp } from "../../../../../../core/math/clamp.js";
 import { lerp } from "../../../../../../core/math/lerp.js";
 import { BlendStateMatrix } from "../blending/BlendStateMatrix.js";
+import { clamp01 } from "../../../../../../core/math/clamp01.js";
 
 export class AnimationTransition {
     constructor() {
@@ -90,7 +90,7 @@ export class AnimationTransition {
     }
 
     updateBlendsState() {
-        const t = clamp(this.computeNormalizedTime(), 0, 1);
+        const t = clamp01(this.computeNormalizedTime());
 
         BlendStateMatrix.lerp(this.blendState, this.source.blendState, this.target.blendState, t);
     }

package/engine/graphics/ecs/camera/TiltCameraController.js

@@ -5,13 +5,14 @@ import { Object3D, Vector3 as ThreeVector3 } from 'three';
 
 import Vector3 from "../../../../core/geom/Vector3.js";
 import Vector2 from '../../../../core/geom/Vector2.js';
+import { DEG_TO_RAD } from "../../../../core/math/DEG_TO_RAD.js";
 
 const CC = function () {
     this.target = new Vector3();
     this.rotationAxis = new Vector3(0, 1, 0);
-    this.rotationAngle = (Math.PI / 180) * 0;
+    this.rotationAngle = DEG_TO_RAD * 0;
     //angle between rotation axis and vector from target to position
-    this.tiltAngle = (Math.PI / 180) * 10;
+    this.tiltAngle = DEG_TO_RAD * 10;
 
     this.distance = 100;
     this.position = new Vector3();

package/engine/graphics/ecs/compileAllMaterials.js

@@ -1,8 +1,8 @@
 import { Mesh, PlaneBufferGeometry } from "three";
-import { clamp } from "../../../core/math/clamp.js";
 import Task from "../../../core/process/task/Task.js";
 import TaskSignal from "../../../core/process/task/TaskSignal.js";
 import { collectIteratorValueToArray } from "../../../core/collection/IteratorUtils.js";
+import { clamp01 } from "../../../core/math/clamp01.js";
 
 /**
  * Compile all materials found in the dataset
@@ -100,7 +100,7 @@ export function compileAllMaterials({ graphics, timeout = 0, includeHiddenLayers
 
                 const f = index / n;
 
-                return clamp(f, 0, 1);
+                return clamp01(f);
 
             }
         },

package/engine/graphics/ecs/highlight/renderer/OutlineRenderer.js

@@ -93,26 +93,25 @@ const object_id_cache = new WeakMap();
  * @param {Mesh|SkinnedMesh} object
  */
 function obtain_id_mesh(object) {
-    const existing = object_id_cache.get(object);
+    let mesh = object_id_cache.get(object);
 
-    if (existing !== undefined) {
-        return existing;
+    if (mesh === undefined) {
+
+        if (object.isSkinnedMesh) {
+            mesh = new SkinnedMesh(object.geometry, makeIdMaterialSkinned());
+        } else {
+            mesh = new Mesh(object.geometry, makeIdMaterialStatic());
+        }
+
+        object_id_cache.set(object, mesh);
     }
 
-    let material, mesh;
     if (object.isSkinnedMesh) {
-        material = makeIdMaterialSkinned();
-        mesh = new SkinnedMesh(object.geometry, material);
         mesh.bindMatrix.copy(object.bindMatrix);
         mesh.bindMatrixInverse.copy(object.bindMatrixInverse);
         mesh.skeleton = object.skeleton;
-    } else {
-        material = makeIdMaterialStatic();
-        mesh = new Mesh(object.geometry, material);
     }
 
-    object_id_cache.set(object, mesh);
-
     return mesh;
 }
 

package/engine/graphics/ecs/mesh/createTaskWaitForMeshesToLoad.js

@@ -1,4 +1,3 @@
-import { clamp } from "../../../../core/math/clamp.js";
 import { max2 } from "../../../../core/math/max2.js";
 import Mesh from "./Mesh.js";
 import Task from "../../../../core/process/task/Task.js";
@@ -6,6 +5,7 @@ import TaskSignal from "../../../../core/process/task/TaskSignal.js";
 import { assert } from "../../../../core/assert.js";
 import { assetTypeByPath } from "./assetTypeByPath.js";
 import { collectIteratorValueToArray } from "../../../../core/collection/IteratorUtils.js";
+import { clamp01 } from "../../../../core/math/clamp01.js";
 
 /**
  * Produces a task that will wait for all existing Meshes of a dataset to be loaded, will fail upon timeout being reached
@@ -96,7 +96,7 @@ export function createTaskWaitForMeshesToLoad(ecd, engine, timeout) {
 
             const p = max2(progress, relativeExpiredTime);
 
-            return clamp(p, 0, 1);
+            return clamp01(p);
         },
         cycleFunction() {
             currentTime = performance.now();

package/engine/graphics/ecs/mesh-v2/ShadedGeometrySystem.d.ts

@@ -20,4 +20,10 @@ export class ShadedGeometrySystem extends System<ShadedGeometry> {
         filter_function?: (entity: number, mesh: ShadedGeometry) => boolean,
         filter_function_context?: any
     ): { entity: number, mesh: ShadedGeometry, contact: SurfacePoint3 }[]
+
+    queryOverlapFrustum(
+        result: ArrayLike<number>,
+        result_offset: number,
+        planes: ArrayLike<number>
+    ): number
 }

package/engine/graphics/ecs/mesh-v2/ShadedGeometrySystem.js

@@ -19,6 +19,9 @@ import Task from "../../../../core/process/task/Task.js";
 import { RuntimeDrawMethodOptimizer } from "./render/optimization/RuntimeDrawMethodOptimizer.js";
 import TaskSignal from "../../../../core/process/task/TaskSignal.js";
 import TaskState from "../../../../core/process/task/TaskState.js";
+import {
+    bvh_query_user_data_overlaps_frustum
+} from "../../../../core/bvh2/bvh3/bvh_query_user_data_overlaps_frustum.js";
 
 
 /**
@@ -308,6 +311,21 @@ export class ShadedGeometrySystem extends System {
         }
     }
 
+    /**
+     *
+     * @param {number[]} result entity IDs
+     * @param {number} result_offset offset into result array where to write first result into
+     * @param {number[]|ArrayLike<number>} planes
+     * @returns {number} number of results
+     */
+    queryOverlapFrustum(
+        result,
+        result_offset,
+        planes
+    ) {
+        return bvh_query_user_data_overlaps_frustum(result, result_offset, this.__bvh_binary, planes);
+    }
+
     /**
      *
      * @param {number} origin_x
@@ -393,6 +411,7 @@ export class ShadedGeometrySystem extends System {
         return result;
     }
 
+
     /**
      *
      * @param {SurfacePoint3} contact

package/engine/graphics/ecs/mesh-v2/render/ShadedGeometryRendererContext.js

@@ -3,7 +3,9 @@ import { InstancedRendererAdapter } from "./adapters/InstancedRendererAdapter.js
 import { GenericRendererAdapter } from "./adapters/GenericRendererAdapter.js";
 import { assert } from "../../../../../core/assert.js";
 import { ShadedGeometry } from "../ShadedGeometry.js";
-import { bvh_query_user_data_by_frustum } from "../../../../../core/bvh2/bvh3/bvh_query_user_data_by_frustum.js";
+import {
+    bvh_query_user_data_overlaps_frustum
+} from "../../../../../core/bvh2/bvh3/bvh_query_user_data_overlaps_frustum.js";
 
 /**
  *
@@ -89,7 +91,7 @@ export class ShadedGeometryRendererContext {
 
 
         // get all meshes
-        const intersection_count = bvh_query_user_data_by_frustum(collection_array, 0, bvh, view.frustum);
+        const intersection_count = bvh_query_user_data_overlaps_frustum(collection_array, 0, bvh, view.frustum);
 
         const sg_component_index = ecd.computeComponentTypeIndex(ShadedGeometry);
 

package/engine/graphics/ecs/mesh-v2/render/optimization/RuntimeDrawMethodOptimizer.js

@@ -54,6 +54,12 @@ export class RuntimeDrawMethodOptimizer {
 
         const entity = next.value;
 
+        if (!ecd.entityExists(entity)) {
+            // seems that iterator is stale, reset iterator
+            this.__entity_iterator = null;
+            return false;
+        }
+
         /**
          *
          * @type {ShadedGeometry}

package/engine/graphics/geometry/instancing/InstancedMeshGroup.js

@@ -78,6 +78,22 @@ export class InstancedMeshGroup {
          */
         this.__attributeTransformArray = null;
 
+
+        /**
+         *
+         * TODO implement usage
+         * @type {InstancedBufferAttribute}
+         * @private
+         */
+        this.__attributeColor = null;
+
+        /**
+         * TODO implement usage
+         * @type {Uint8Array}
+         * @private
+         */
+        this.__attributeColorArray = null;
+
         /**
          *
          * @type {Usage}
@@ -409,4 +425,19 @@ export class InstancedMeshGroup {
 
         this.mesh.geometry = geometry;
     }
+
+    /**
+     *
+     * @param {THREE.BufferGeometry} geometry
+     * @param {Material} material
+     * @returns {InstancedMeshGroup}
+     */
+    static from(geometry, material) {
+        const r = new InstancedMeshGroup();
+
+        r.setGeometry(geometry);
+        r.setMaterial(material);
+
+        return r;
+    }
 }