@adatechnology/game-destruction-three 0.2.0 → 0.3.0

package/README.md

@@ -111,6 +111,8 @@ loose meshes. An invalid range (outside the geometry or empty) throws from `bind
 | `leak` | stream of drops (or a faint puff for gas) from the hole while the part still has liters | |
 | `explode` | flash, fire, smoke, dust and sparks, a pooled `PointLight` pulse, impulses on pieces and fragments in range | `explode` |
 
+`world.explode` emits no event of its own (only a part with `explodes` does), so a host that detonates a grenade or rocket calls `renderer.explode(point, energy, radius)` next to it to get the same flash, fire, smoke, light, sound and shove.
+
 Pieces report hard landings: above 3 m/s the renderer calls `world.hit(id, { type: 'blunt', energy: 0.5 m v^2, radius: 0.08, direction: [0, -1, 0], source: 'fall' })`
 (throttled to once per 0.15 s per piece; the object's transform is synced to the world first, so the hit lands on the right spot), so a dropped glass
 pane shatters and a thrown chair can lose a leg. `Piece.localCenter` is the centre of mass relative to the root origin (it moves when a part breaks off).
@@ -142,7 +144,7 @@ heatColor(temperatureC: number): number // 0xRRGGBB, 0 below ~450 C, dark red ~5
 `RendererOptions`: `scene`, `world`, `quality`, `maxFragments`, `maxParticles`, `fragmentLife`, `groundAt`, `gravity`, `autoSplit`, `onPiece`, `onSound`,
 `explosionLight`, `pointScale` (point size in pixels per metre at 1 m; about `viewportHeight / (2 tan(fov / 2))`, default 700).
 
-`DestructionRenderer`: `bind`, `unbind`, `makePiece`, `pieces`, `piece`, `impulse`, `update`, `emit`, `clear`, `restore`, `stats`, `dispose`.
+`DestructionRenderer`: `bind`, `unbind`, `makePiece`, `pieces`, `piece`, `impulse`, `update`, `emit`, `explode`, `clear`, `restore`, `stats`, `dispose`.
 `clear()` removes fragments, decals, puddles and particles from the scene and restores every bound mesh; `dispose()` also unsubscribes from the world.
 
 ## Português

package/dist/index.d.ts

@@ -102,6 +102,8 @@ interface DestructionRenderer {
     update(dt: number): void;
     /** Emit particles directly (muzzle flashes, extinguisher foam, tool sparks). */
     emit(kind: DebrisKind | 'fire' | 'flash' | 'foam', point: Vec3, normal: Vec3, count: number, speed?: number): void;
+    /** Draw a blast that has no exploding part (a grenade, a rocket): flash, fire, smoke, light, sound and a shove on pieces in range. Call it next to `world.explode`, which emits no event of its own. */
+    explode(point: Vec3, energy: number, radius: number): void;
     /** Remove every fragment, decal and particle, restore every bound mesh to its original geometry and colours. */
     clear(): void;
     /** Restore one object (after `world.reset`). */

package/dist/index.global.js

@@ -440,6 +440,8 @@ void main() {
       __publicField(this, "alphaMul");
       __publicField(this, "tag");
       __publicField(this, "colorHex");
+      __publicField(this, "rgbStart");
+      __publicField(this, "rgbEnd");
       __publicField(this, "bounced");
       const n = Math.max(1, capacity);
       this.pos = new Float32Array(n * 3);
@@ -456,6 +458,8 @@ void main() {
       this.alphaMul = new Float32Array(n);
       this.tag = new Int32Array(n);
       this.colorHex = new Int32Array(n);
+      this.rgbStart = new Float32Array(n * 3);
+      this.rgbEnd = new Float32Array(n * 3);
       this.bounced = new Uint8Array(n);
       this.geometry = new THREE.BufferGeometry();
       const attr = (a, size) => {
@@ -503,6 +507,8 @@ void main() {
       this.alphaMul[i] = o?.alpha ?? 1;
       this.tag[i] = o?.tag ?? 0;
       this.colorHex[i] = o?.color ?? -1;
+      this.rgbStart.set(hexToRgb(o?.color ?? def.c0), i * 3);
+      this.rgbEnd.set(hexToRgb(o?.color ?? def.c1), i * 3);
       this.bounced[i] = 0;
       this.siz[i] = this.size0[i];
       this.alp[i] = 0;
@@ -596,13 +602,9 @@ void main() {
         this.pos[i3 + 1] = y;
         this.pos[i3 + 2] = z;
         this.siz[i] = this.size0[i] * lerp(1, def.grow, t);
-        const c0 = this.colorHex[i] >= 0 ? this.colorHex[i] : def.c0;
-        const c1 = this.colorHex[i] >= 0 ? this.colorHex[i] : def.c1;
-        const a = hexToRgb(c0);
-        const b = hexToRgb(c1);
-        this.col[i3] = lerp(a[0], b[0], t);
-        this.col[i3 + 1] = lerp(a[1], b[1], t);
-        this.col[i3 + 2] = lerp(a[2], b[2], t);
+        this.col[i3] = lerp(this.rgbStart[i3], this.rgbEnd[i3], t);
+        this.col[i3 + 1] = lerp(this.rgbStart[i3 + 1], this.rgbEnd[i3 + 1], t);
+        this.col[i3 + 2] = lerp(this.rgbStart[i3 + 2], this.rgbEnd[i3 + 2], t);
         let env = t < def.fadeIn ? t / def.fadeIn : 1 - (t - def.fadeIn) / (1 - def.fadeIn);
         if (def.flicker) env *= 1 - def.flicker * (0.5 + 0.5 * Math.sin(age * 38 + this.seed[i] * 50));
         this.alp[i] = clamp(env, 0, 1) * def.alpha * this.alphaMul[i];
@@ -3934,6 +3936,9 @@ void main() {
     emit(kind, point, normal, count, speed) {
       this.particles.burst(kind, point, normal, count, speed ?? DEFAULT_SPEED[kind] ?? 1, kind === "smoke" ? { color: SMOKE_TONES.grey } : void 0);
     }
+    explode(point, energy, radius) {
+      this.onExplode({ type: "explode", object: "", part: "", time: this.time, point, energy, radius });
+    }
     restore(objectId) {
       const homes = /* @__PURE__ */ new Set([objectId]);
       const self = this.bounds.get(objectId);