@woosh/meep-engine 3.46.0 → 3.49.0

package/src/shade/playground/particle_ecs/effects/smoke.json

@@ -40,6 +40,10 @@
     {
       "name": "seed",
       "components": 1
+    },
+    {
+      "name": "orientation",
+      "components": 4
     }
   ],
   "groups": [],
@@ -597,6 +601,35 @@
         },
         "x": 455,
         "y": 2204.5
+      },
+      {
+        "id": 60,
+        "type": "const",
+        "parameters": {
+          "value": [
+            0,
+            0,
+            1
+          ]
+        },
+        "x": -45,
+        "y": 2415.5
+      },
+      {
+        "id": 61,
+        "type": "quatFromAxisAngle",
+        "parameters": {},
+        "x": 205,
+        "y": 2395.5
+      },
+      {
+        "id": 62,
+        "type": "setAttribute",
+        "parameters": {
+          "name": "orientation"
+        },
+        "x": 455,
+        "y": 2395.5
       }
     ],
     "connections": [
@@ -917,6 +950,24 @@
         "fromPort": "out",
         "to": 59,
         "toPort": "value"
+      },
+      {
+        "from": 60,
+        "fromPort": "out",
+        "to": 61,
+        "toPort": "axis"
+      },
+      {
+        "from": 46,
+        "fromPort": "out",
+        "to": 61,
+        "toPort": "angle"
+      },
+      {
+        "from": 61,
+        "fromPort": "quat",
+        "to": 62,
+        "toPort": "value"
       }
     ]
   },
@@ -1474,6 +1525,35 @@
         },
         "x": 955,
         "y": 742
+      },
+      {
+        "id": 56,
+        "type": "const",
+        "parameters": {
+          "value": [
+            0,
+            0,
+            1
+          ]
+        },
+        "x": -45,
+        "y": 1210
+      },
+      {
+        "id": 57,
+        "type": "quatFromAxisAngle",
+        "parameters": {},
+        "x": 205,
+        "y": 1190
+      },
+      {
+        "id": 58,
+        "type": "setAttribute",
+        "parameters": {
+          "name": "orientation"
+        },
+        "x": 455,
+        "y": 1190
       }
     ],
     "connections": [
@@ -1830,6 +1910,24 @@
         "fromPort": "out",
         "to": 55,
         "toPort": "value"
+      },
+      {
+        "from": 56,
+        "fromPort": "out",
+        "to": 57,
+        "toPort": "axis"
+      },
+      {
+        "from": 52,
+        "fromPort": "out",
+        "to": 57,
+        "toPort": "angle"
+      },
+      {
+        "from": 57,
+        "fromPort": "quat",
+        "to": 58,
+        "toPort": "value"
       }
     ]
   },
@@ -1851,7 +1949,7 @@
       "position": "position",
       "size": "size",
       "color": "color",
-      "rotation": "spin"
+      "orientation": "orientation"
     }
   },
   "source": "graph",

package/src/shade/playground/particle_ecs/effects/soot.json

@@ -30,16 +30,16 @@
       "components": 4
     },
     {
-      "name": "spin",
+      "name": "seed",
       "components": 1
     },
     {
-      "name": "spin_rate",
-      "components": 1
+      "name": "orientation",
+      "components": 4
     },
     {
-      "name": "seed",
-      "components": 1
+      "name": "tumble",
+      "components": 3
     }
   ],
   "groups": [],
@@ -301,53 +301,6 @@
         "x": 3.75,
         "y": 865.5
       },
-      {
-        "id": 45,
-        "type": "random",
-        "parameters": {
-          "components": 1
-        },
-        "x": 0,
-        "y": 1523.5
-      },
-      {
-        "id": 46,
-        "type": "mad",
-        "parameters": {},
-        "x": 220,
-        "y": 1640.5
-      },
-      {
-        "id": 47,
-        "type": "const",
-        "parameters": {
-          "value": [
-            6.28
-          ]
-        },
-        "x": 3.75,
-        "y": 1617.5
-      },
-      {
-        "id": 48,
-        "type": "const",
-        "parameters": {
-          "value": [
-            -3.14
-          ]
-        },
-        "x": 3.75,
-        "y": 1711.5
-      },
-      {
-        "id": 49,
-        "type": "setAttribute",
-        "parameters": {
-          "name": "spin"
-        },
-        "x": 455,
-        "y": 1640.5
-      },
       {
         "id": 50,
         "type": "random",
@@ -386,15 +339,6 @@
         "x": 3.75,
         "y": 1993.5
       },
-      {
-        "id": 54,
-        "type": "setAttribute",
-        "parameters": {
-          "name": "spin_rate"
-        },
-        "x": 455,
-        "y": 1922.5
-      },
       {
         "id": 55,
         "type": "random",
@@ -457,6 +401,63 @@
         },
         "x": 1288.9516890851849,
         "y": 82.30089373140704
+      },
+      {
+        "id": 62,
+        "type": "setAttribute",
+        "parameters": {
+          "name": "orientation"
+        },
+        "x": 455,
+        "y": 1640.5
+      },
+      {
+        "id": 63,
+        "type": "random",
+        "parameters": {
+          "components": 3
+        },
+        "x": -45,
+        "y": 1640.5
+      },
+      {
+        "id": 64,
+        "type": "sampleRotation",
+        "parameters": {},
+        "x": 205,
+        "y": 1640.5
+      },
+      {
+        "id": 65,
+        "type": "random",
+        "parameters": {
+          "components": 2
+        },
+        "x": -295,
+        "y": 2042.5
+      },
+      {
+        "id": 66,
+        "type": "sampleSphereSurface",
+        "parameters": {},
+        "x": -45,
+        "y": 2042.5
+      },
+      {
+        "id": 67,
+        "type": "scale",
+        "parameters": {},
+        "x": 205,
+        "y": 1922.5
+      },
+      {
+        "id": 68,
+        "type": "setAttribute",
+        "parameters": {
+          "name": "tumble"
+        },
+        "x": 455,
+        "y": 1922.5
       }
     ],
     "connections": [
@@ -586,30 +587,6 @@
         "to": 43,
         "toPort": "value"
       },
-      {
-        "from": 45,
-        "fromPort": "out",
-        "to": 46,
-        "toPort": "a"
-      },
-      {
-        "from": 47,
-        "fromPort": "out",
-        "to": 46,
-        "toPort": "b"
-      },
-      {
-        "from": 48,
-        "fromPort": "out",
-        "to": 46,
-        "toPort": "c"
-      },
-      {
-        "from": 46,
-        "fromPort": "out",
-        "to": 49,
-        "toPort": "value"
-      },
       {
         "from": 50,
         "fromPort": "out",
@@ -628,12 +605,6 @@
         "to": 51,
         "toPort": "c"
       },
-      {
-        "from": 51,
-        "fromPort": "out",
-        "to": 54,
-        "toPort": "value"
-      },
       {
         "from": 55,
         "fromPort": "out",
@@ -669,6 +640,42 @@
         "fromPort": "out",
         "to": 0,
         "toPort": "uvw"
+      },
+      {
+        "from": 63,
+        "fromPort": "out",
+        "to": 64,
+        "toPort": "uvw"
+      },
+      {
+        "from": 64,
+        "fromPort": "quat",
+        "to": 62,
+        "toPort": "value"
+      },
+      {
+        "from": 65,
+        "fromPort": "out",
+        "to": 66,
+        "toPort": "uv"
+      },
+      {
+        "from": 66,
+        "fromPort": "out",
+        "to": 67,
+        "toPort": "v"
+      },
+      {
+        "from": 51,
+        "fromPort": "out",
+        "to": 67,
+        "toPort": "s"
+      },
+      {
+        "from": 67,
+        "fromPort": "out",
+        "to": 68,
+        "toPort": "value"
       }
     ]
   },
@@ -1123,40 +1130,6 @@
         "x": 1661,
         "y": 1323
       },
-      {
-        "id": 50,
-        "type": "attribute",
-        "parameters": {
-          "name": "spin_rate"
-        },
-        "x": 12,
-        "y": 1465.5
-      },
-      {
-        "id": 51,
-        "type": "attribute",
-        "parameters": {
-          "name": "spin"
-        },
-        "x": 12,
-        "y": 1596.5
-      },
-      {
-        "id": 52,
-        "type": "mad",
-        "parameters": {},
-        "x": 327,
-        "y": 1514
-      },
-      {
-        "id": 53,
-        "type": "setAttribute",
-        "parameters": {
-          "name": "spin"
-        },
-        "x": 601,
-        "y": 1514
-      },
       {
         "id": 54,
         "type": "gradientRGBA",
@@ -1220,6 +1193,40 @@
         },
         "x": 1332.5,
         "y": 1840.75
+      },
+      {
+        "id": 58,
+        "type": "setAttribute",
+        "parameters": {
+          "name": "orientation"
+        },
+        "x": 601,
+        "y": 1514
+      },
+      {
+        "id": 59,
+        "type": "attribute",
+        "parameters": {
+          "name": "orientation"
+        },
+        "x": -149,
+        "y": 1454
+      },
+      {
+        "id": 60,
+        "type": "attribute",
+        "parameters": {
+          "name": "tumble"
+        },
+        "x": -149,
+        "y": 1554
+      },
+      {
+        "id": 61,
+        "type": "quatIntegrate",
+        "parameters": {},
+        "x": 301,
+        "y": 1514
       }
     ],
     "connections": [
@@ -1542,39 +1549,39 @@
         "toPort": "value"
       },
       {
-        "from": 50,
+        "from": 5,
         "fromPort": "out",
-        "to": 52,
-        "toPort": "a"
+        "to": 54,
+        "toPort": "t"
       },
       {
-        "from": 0,
+        "from": 54,
         "fromPort": "out",
-        "to": 52,
-        "toPort": "b"
+        "to": 55,
+        "toPort": "value"
       },
       {
-        "from": 51,
+        "from": 59,
         "fromPort": "out",
-        "to": 52,
-        "toPort": "c"
+        "to": 61,
+        "toPort": "quat"
       },
       {
-        "from": 52,
+        "from": 60,
         "fromPort": "out",
-        "to": 53,
-        "toPort": "value"
+        "to": 61,
+        "toPort": "omega"
       },
       {
-        "from": 5,
+        "from": 0,
         "fromPort": "out",
-        "to": 54,
-        "toPort": "t"
+        "to": 61,
+        "toPort": "dt"
       },
       {
-        "from": 54,
-        "fromPort": "out",
-        "to": 55,
+        "from": 61,
+        "fromPort": "quat",
+        "to": 58,
         "toPort": "value"
       }
     ]
@@ -1583,7 +1590,7 @@
     "spawn_rate": 75,
     "prewarm": 3,
     "blend": 0,
-    "projection": 0,
+    "projection": 4,
     "lighting": true,
     "soft_depth": true,
     "sort": false,
@@ -1597,7 +1604,7 @@
       "position": "position",
       "size": "size",
       "color": "color",
-      "rotation": "spin"
+      "orientation": "orientation"
     }
   },
   "source": "graph",

package/src/shade/playground/tonemap_sdr/README.md

@@ -0,0 +1,90 @@
+# Tone mapping: GT7 and PBR Neutral, SDR and HDR
+
+The renderer has three tone mapping modes, each one operator on every output (`ShadeToneMappingMode`):
+
+- `GT7`, the default;
+- `PBR_NEUTRAL`;
+- `NONE`.
+
+This page compares the two operators, and shows each one's HDR form beside its SDR form.
+
+The engine renders and tonemaps each frame as usual. Two extensions then redraw the canvas from the HDR colour the
+tonemapper was given:
+
+| | operator | source |
+|---|---|---|
+| 1 | GT7, Polyphony's sample | `chunk_tonemap_gt7_sdr_reference.js` beside this page: the sample code's `initializeAsSDR()`, SDR only |
+| 2 | GT7, engine | `tonemap_gt7(c, PAPER_WHITE_NITS · peak, PAPER_WHITE_NITS)`, what `ShadeToneMappingMode.GT7` runs |
+| 3 | PBR Neutral, engine | `tonemap_khronos_pbr(c, peak)`, what `ShadeToneMappingMode.PBR_NEUTRAL` runs; at peak 1 the Khronos specification |
+
+All of them see the same input. Exposure is the page's own and fixed per scene, with the engine's automatic exposure off.
+
+## Layouts and the peak
+
+- **GT7 | PBR Neutral** (`P`): the engine's two operators side by side, each the whole frame at half size.
+- **One operator** (`1`–`3`): full size.
+- **One operator, SDR | peak** (`S`): the SDR form on the left half and the form at the peak on the right. Where the
+  two agree, the seam is invisible.
+
+The peak is in units of SDR white. 1 is the SDR form. 4 is a 1000 cd/m² display under the 250 cd/m² paper white, which
+the renderer assumes for HDR. `H` steps it through 1, 2, 4 and 10. Operator 1 ignores it.
+
+The page draws to an SDR canvas, so at a peak above 1 it shows what an HDR display shows below SDR white: the HDR form
+clipped to 1.
+
+`HDR_TONE_MAPPING_FORMS_BRIEF_2026_10_16.md` and `SDR_TONE_MAPPING_BRIEF_2026_10_16.md`, in
+`src/shade/renderer/shader/chunk/color/tonemap/`, record how the operators were chosen. This page used to compare ACES,
+AgX and two prototypes of HDR forms as well. They went when the HDR forms brief's forks were taken.
+
+## What was checked, once, outside the repo
+
+- **GT7 port.** On the RTX 4090, the WGSL port matches Polyphony's compiled `gt7_tone_mapping.cpp` to 4.4e-4
+  (display-linear, 0–1) over 648 inputs: six hues, exposures from −10 to +10 EV, white.
+- **The engine's own output.**
+  - With `GT7`, on the sunlit exterior, the engine's canvas matched the GT7 engine view within the engine's own
+    frame-to-frame noise: a mean of 3.3 codes against 2.3–3.3.
+  - With `PBR_NEUTRAL`, the engine's SDR canvas equals the PBR Neutral view at peak 1 to the code, on the exterior
+    and the product shot, with TAA, SSAO and bloom off and the projection frozen.
+- **SDR against HDR.** At peak 4, across the four scenes, GT7 and PBR Neutral change no pixel at or under 0.5 by more
+  than 1 code. The HDR forms brief, §4, has the numbers.
+- **Colour management.** These values were written into a `display-p3` canvas and read back through a 2D sRGB canvas.
+  A Rec.709 value written as-is, as `shader_tonemap_LDR` did before the F1 fix of the SDR brief, shows more saturated
+  than intended:
+
+  | colour | intended | as-is |
+  |---|---|---|
+  | ACES red | 175,29,38 | 191,0,28 |
+  | Neutral red | 198,34,34 | 216,0,16 |
+  | canary yellow | 227,213,34 | 230,212,0 |
+
+  Converted to P3 first, each one reads back as intended. The page converts by default. Untick the box to see what the
+  engine showed before the fix.
+
+## Running it
+
+```bash
+npm run dev --workspace @woosh/meep-engine
+```
+
+Open `http://localhost:<port>/src/shade/playground/tonemap_sdr/` with the port vite prints.
+
+The exterior and the product shot light themselves with `test_assets/environments/octahedral/rustig_koppie_puresky_2k.hdr`
+and `blue_photo_studio_2k.hdr`. Without them each uses a flat sky, and the console says so. `test_assets/` is not in
+git: a worktree has none until they are copied in from the main checkout.
+
+URL parameters: `?scene=1..4&layout=pair|single|split&operator=0..2&headroom=1|2|4|10&ev=<offset>&match=1`.
+
+Keys: `1`–`3` show one operator, `P` the pair, `S` the SDR | peak split, `H` the next peak, `[` `]` change exposure by
+half a stop, `M` toggles mid-grey matching, `E` the engine's own output.
+
+## What to look at
+
+- **Fire and emitters, the pair.** In the back row each column is two stops brighter than the one before, from ¼ to
+  256. GT7 holds hue through the mid-tones and then whitens. PBR Neutral never moves hue and whitens through the
+  colour's own pink or pale tint.
+- **Sunlit exterior, the pair, then `M`.** With mid-grey matched, the pair compares curve shapes rather than
+  brightness: GT7 clips the sunlit wall from about 1.43× SDR white, and Neutral compresses it.
+- **Product shot, `3`.** Compare the spheres with the base colours in the note under the canvas: yellow 231,218,63,
+  red 203,63,63, mint 149,218,188.
+- **Any scene, `S` with peak 4,** for operators 2 and 3. The mid-tones carry across the seam; above SDR white, the
+  right half keeps what the left clips or compresses.