@chromatic-coherence/generative-engine 1.2.0 → 1.4.0

package/dist/world.d.ts

@@ -91,6 +91,11 @@ export declare class World {
     private pFaceI;
     private pDepthI;
     private instanced;
+    /** W9 — the one wind that blows through every swaying instanced batch */
+    wind: {
+        dir: V3;
+        speed: number;
+    };
     private post;
     private ink;
     private bg;
@@ -243,7 +248,20 @@ export declare class World {
     /** W8 — GPU instancing: upload a Mesh ONCE and draw it at every given transform in a
      *  single instanced call (scene + shadow pass alike). A forest is one draw. Instances
      *  ride their group's fade / morph / transform like any other geometry. */
-    meshInstanced(geo: Mesh, instances: (M4 | TransformSpec)[], o: FaceOpts): void;
+    meshInstanced(geo: Mesh, instances: (M4 | TransformSpec)[], o: FaceOpts & {
+        /** W9 GPU wind: per-instance sway computed in the vertex stage (shadows included).
+         *  amp scales with vertex height; freq in rad/s; phases auto-scatter per instance. */
+        sway?: {
+            amp: number;
+            freq?: number;
+        };
+        /** W10 GPU flight: the batch IS a murmuration — per-bird orbit params generated
+         *  here, positions evaluated in the vertex stage from time alone. The instance
+         *  matrices become the shared flock frame (place / scale / steer the whole flock). */
+        flight?: boolean | {
+            lobes?: number;
+        };
+    }): void;
     grow(fn: GrowFn): void;
     drawLine(a: V3, b: V3, color: string, alpha: number, width?: number): void;
     drawPath(pts: {

package/dist/world.js

@@ -34,6 +34,8 @@ export class World {
     }
     constructor(o) {
         this.instanced = [];
+        /** W9 — the one wind that blows through every swaying instanced batch */
+        this.wind = { dir: v3(1, 0, 0.35), speed: 1 };
         this.ink = false;
         this.bg = [0.024, 0.016, 0.055];
         this.transparent = false;
@@ -392,15 +394,31 @@ export class World {
         for (let i = 0; i < P.length; i += 9) {
             this.pushFace(store, v3(P[i], P[i + 1], P[i + 2]), v3(P[i + 3], P[i + 4], P[i + 5]), v3(P[i + 6], P[i + 7], P[i + 8]), o, v3(N[i], N[i + 1], N[i + 2]), v3(N[i + 3], N[i + 4], N[i + 5]), v3(N[i + 6], N[i + 7], N[i + 8]));
         }
-        const mats = new Float32Array(instances.length * 16);
-        instances.forEach((m, i) => mats.set(m instanceof Float32Array ? m : mCompose(m), i * 16));
+        const mats = new Float32Array(instances.length * 20); // mat4 + sway vec4, one stride
+        const lobes = typeof o.flight === "object" ? (o.flight.lobes ?? 3) : 3;
+        instances.forEach((m, i) => {
+            mats.set(m instanceof Float32Array ? m : mCompose(m), i * 20);
+            const ph = ((i * 2654435761) % 6283) / 1000; // scattered phase
+            if (o.flight) { // aIP = (a0, r0, ph, lobe)
+                mats[i * 20 + 16] = ((i * 40503) % 6283) / 1000;
+                mats[i * 20 + 17] = 40 + ((i * 9973) % 1000) / 5;
+                mats[i * 20 + 18] = ph;
+                mats[i * 20 + 19] = i % lobes;
+            }
+            else {
+                mats[i * 20 + 16] = ph;
+                mats[i * 20 + 17] = (o.sway?.freq ?? 1.3) * (0.85 + ((i * 97) % 30) / 100);
+                mats[i * 20 + 18] = (o.sway?.amp ?? 0) * 0.01;
+                mats[i * 20 + 19] = 0;
+            }
+        });
         const vbuf = gl.createBuffer();
         gl.bindBuffer(gl.ARRAY_BUFFER, vbuf);
         gl.bufferData(gl.ARRAY_BUFFER, new Float32Array(store), gl.STATIC_DRAW);
         const ibuf = gl.createBuffer();
         gl.bindBuffer(gl.ARRAY_BUFFER, ibuf);
         gl.bufferData(gl.ARRAY_BUFFER, mats, gl.STATIC_DRAW);
-        this.instanced.push({ vbuf, ibuf, verts: store.length / FACE_STRIDE, count: instances.length });
+        this.instanced.push({ vbuf, ibuf, verts: store.length / FACE_STRIDE, count: instances.length, flight: !!o.flight });
     }
     grow(fn) { this.hooks.push(fn); }
     // ── the living verbs (gathered per frame) ──
@@ -602,6 +620,7 @@ export class World {
             return;
         const gl = this.gl;
         for (const rec of this.instanced) {
+            gl.uniform1f(p.u("uFlight"), rec.flight ? 1 : 0);
             gl.bindBuffer(gl.ARRAY_BUFFER, rec.vbuf);
             this.attrib(p, "aPos", 3, FACE_STRIDE, 0);
             if (!depthOnly) {
@@ -615,12 +634,12 @@ export class World {
                 this.attrib(p, "aNorm2", 3, FACE_STRIDE, 15);
             gl.bindBuffer(gl.ARRAY_BUFFER, rec.ibuf);
             const locs = [];
-            for (let k = 0; k < 4; k++) {
-                const loc = gl.getAttribLocation(p.prog, "aI" + k);
+            for (let k = 0; k < 5; k++) { // aI0..3 = the matrix, aIP = the sway params
+                const loc = gl.getAttribLocation(p.prog, k < 4 ? "aI" + k : "aIP");
                 if (loc < 0)
                     continue;
                 gl.enableVertexAttribArray(loc);
-                gl.vertexAttribPointer(loc, 4, gl.FLOAT, false, 64, k * 16);
+                gl.vertexAttribPointer(loc, 4, gl.FLOAT, false, 80, k * 16);
                 gl.vertexAttribDivisor(loc, 1);
                 locs.push(loc);
             }
@@ -716,6 +735,8 @@ export class World {
             if (this.instanced.length) {
                 this.pDepthI.use();
                 gl.uniformMatrix4fv(this.pDepthI.u("uVP"), false, this.svp);
+                gl.uniform1f(this.pDepthI.u("uT"), t * this.wind.speed);
+                gl.uniform3f(this.pDepthI.u("uWindDir"), this.wind.dir.x, this.wind.dir.y, this.wind.dir.z);
                 this.setGroups(this.pDepthI);
                 this.drawInstancedAll(this.pDepthI, true);
             }
@@ -747,6 +768,8 @@ export class World {
             this.pFaceI.use();
             this.setVP(this.pFaceI);
             this.setLights(this.pFaceI, fogK);
+            gl.uniform1f(this.pFaceI.u("uT"), t * this.wind.speed);
+            gl.uniform3f(this.pFaceI.u("uWindDir"), this.wind.dir.x, this.wind.dir.y, this.wind.dir.z);
             this.drawInstancedAll(this.pFaceI, false);
         }
         // the light — additive, depth-TESTED but not written (ink: normal alpha blend)

package/package.json

@@ -1,44 +1,44 @@
-{
-  "name": "@chromatic-coherence/generative-engine",
-  "version": "1.2.0",
-  "description": "THE THIRD ENGINE — a zero-dependency WebGL2 graphics engine grown from generative-charts-3d: HDR + bloom + SSAO post chain, hardware-PCF shadow maps, a geometry stdlib, ribbon strokes, group transforms and morph targets. The charts API rides on top unchanged.",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "sideEffects": false,
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "node test/run.mjs",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "3d",
-    "webgl2",
-    "engine",
-    "graphics",
-    "bloom",
-    "ssao",
-    "shadows",
-    "zero-dependency"
-  ],
-  "author": "Chromatic Coherence",
-  "license": "SEE LICENSE IN LICENSE",
-  "devDependencies": {
-    "typescript": "^5"
-  }
-}
+{
+  "name": "@chromatic-coherence/generative-engine",
+  "version": "1.4.0",
+  "description": "THE THIRD ENGINE — a zero-dependency WebGL2 graphics engine grown from generative-charts-3d: HDR + bloom + SSAO post chain, hardware-PCF shadow maps, a geometry stdlib, ribbon strokes, group transforms and morph targets. The charts API rides on top unchanged.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node test/run.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "3d",
+    "webgl2",
+    "engine",
+    "graphics",
+    "bloom",
+    "ssao",
+    "shadows",
+    "zero-dependency"
+  ],
+  "author": "Chromatic Coherence",
+  "license": "SEE LICENSE IN LICENSE",
+  "devDependencies": {
+    "typescript": "^5"
+  }
+}