@adatechnology/game-weather-three 0.3.3 → 0.4.0

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { WorkshopEngine, VfxWorld, Puddle } from '@adatechnology/game-vfx';
 import { WeatherSample, WeatherVisualFactory } from '@adatechnology/game-weather';
 
 /** The only three.js members the renderer needs at runtime. Pass your own `THREE` instance (the whole namespace works). */
-type ThreeLib = Pick<typeof THREE_NS, 'AdditiveBlending' | 'BoxGeometry' | 'BufferAttribute' | 'BufferGeometry' | 'Color' | 'ConeGeometry' | 'DoubleSide' | 'Fog' | 'FogExp2' | 'Group' | 'HemisphereLight' | 'Mesh' | 'MeshBasicMaterial' | 'Object3D' | 'PlaneGeometry' | 'Points' | 'ShaderMaterial' | 'SpotLight' | 'Vector3'>;
+type ThreeLib = Pick<typeof THREE_NS, 'AdditiveBlending' | 'Box3' | 'BoxGeometry' | 'BufferAttribute' | 'BufferGeometry' | 'Color' | 'ConeGeometry' | 'DoubleSide' | 'Fog' | 'FogExp2' | 'Group' | 'HemisphereLight' | 'Mesh' | 'Matrix4' | 'MeshBasicMaterial' | 'Object3D' | 'PlaneGeometry' | 'Points' | 'ShaderMaterial' | 'SpotLight' | 'Vector3'>;
 /** What the renderer reads of a weather world: its sample. A `createWeather` world fits. */
 type WeatherSource = {
     sample(): WeatherSample;
@@ -320,6 +320,11 @@ type WeatherVisualOptions = Pick<WeatherRendererOptions, 'profile' | 'random' |
     readonly vehicles?: (THREE: ThreeLib) => RigVehicles;
     /** Fleet id of the rig's car (default `midsize_sedan`). */
     readonly rigVehicle?: string;
+    /**
+     * The rig's car as an item of the host's catalogue (`sedan` of the vehicles test module): the host puts it in its world (`ModuleHost.addObject`), so shots, blows, blasts and fire damage it, it
+     * blocks the player and its doors open, and the lamps go on its nose. Wins over `vehicles` when the host can place it; until a loaded module has the item the rig has only the lamps.
+     */
+    readonly rigItem?: string;
     /** Which layers start on (all do by default); the room that is not about weather starts the sky and the fog off to keep its own look. */
     readonly layers?: Partial<Record<WeatherLayerId, boolean>>;
 };

package/dist/index.global.js

@@ -2415,7 +2415,8 @@ var GameWeatherThree = (() => {
           ...options.headlights ? { headlights: options.headlights } : {},
           ...options.layers ? { layers: options.layers } : {}
         });
-        return attachRig(THREE, host, renderer, options.rig === void 0 ? RIG_DEFAULT : options.rig, options.vehicles?.(THREE), options.rigVehicle ?? RIG_VEHICLE);
+        const item = options.rigItem && host.addObject ? options.rigItem : void 0;
+        return attachRig(THREE, host, renderer, options.rig === void 0 ? RIG_DEFAULT : options.rig, item ? void 0 : options.vehicles?.(THREE), options.rigVehicle ?? RIG_VEHICLE, item);
       }
     };
   }
@@ -2424,7 +2425,22 @@ var GameWeatherThree = (() => {
     const z = car.group.position.z;
     return { minX: -car.width / 2, maxX: car.width / 2, minZ: z - car.length / 2, maxZ: z + car.length / 2 };
   }
-  function attachRig(THREE, host, renderer, place, vehicles, key) {
+  function lengthOf(THREE, root) {
+    root.updateMatrixWorld(true);
+    const inverse = new THREE.Matrix4().copy(root.matrixWorld).invert();
+    const box = new THREE.Box3();
+    const piece = new THREE.Box3();
+    const matrix = new THREE.Matrix4();
+    root.traverse((mesh2) => {
+      const m = mesh2;
+      if (!m.isMesh || !m.geometry) return;
+      if (!m.geometry.boundingBox) m.geometry.computeBoundingBox();
+      piece.copy(m.geometry.boundingBox).applyMatrix4(matrix.multiplyMatrices(inverse, m.matrixWorld));
+      box.union(piece);
+    });
+    return box.isEmpty() ? 0 : box.max.z - box.min.z;
+  }
+  function attachRig(THREE, host, renderer, place, vehicles, key, item) {
     const scene = host.scene;
     const rig = place === false ? void 0 : buildRig(THREE, vehicles, key);
     let detach;
@@ -2436,6 +2452,22 @@ var GameWeatherThree = (() => {
       detach = renderer.headlights.attach(rig.group);
       if (rig.footprint) unblock = host.addBlocker?.(footprintBlocker(rig.group, rig.footprint));
     }
+    let car = null;
+    let stopWaiting;
+    if (item && place) {
+      const tryPlace = () => {
+        if (car || !host.addObject) return;
+        const placed = host.addObject(item, { position: [place[0], 0, place[1]], rotationY: place[2] });
+        if (!placed) return;
+        car = placed;
+        stopWaiting?.();
+        stopWaiting = void 0;
+        const ahead = lengthOf(THREE, placed.root) / 2 - HEADLIGHTS.lamp[2] - 0.1;
+        rig.group.position.set(place[0] + Math.sin(place[2]) * ahead, 0, place[1] + Math.cos(place[2]) * ahead);
+      };
+      tryPlace();
+      if (!car) stopWaiting = host.onFrame(tryPlace);
+    }
     return {
       update: (dt) => renderer.update(dt),
       setLayer(id, on) {
@@ -2444,6 +2476,8 @@ var GameWeatherThree = (() => {
       dispose() {
         detach?.();
         unblock?.();
+        stopWaiting?.();
+        car?.remove();
         if (rig) {
           scene.remove(rig.group);
           rig.dispose();