@woosh/meep-engine 3.60.5 → 3.60.7

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## Unreleased
 
+### Probe clipmap GI: virtual geometry has cards, through a proxy
+
+- **Added:** `VirtualGeometry.get_proxy()`: an ordinary geometry standing in for a virtual one, cut from its
+  container (`vgeo_to_proxy_mesh`) at `vgeo_proxy_triangle_limit(source_triangles)`, clamp(1%, 128, 64,000), through
+  a reader of its own. A container is expected to be delivered with its proxy, baked offline; until then the proxy is
+  cut at load.
+- **Changed:** a virtual geometry's geometry cache and cards are its proxy's. The GI's rays now see virtual geometry's
+  materials instead of black: on Zorah, cards serve 82% of front-face hits (none before) and the frame's mean luma
+  goes 50.83 → 58.14. The proxy's detail is its own, so the field and the cards are coarser than the asset. Zorah's
+  1,012 proxies are 3.18M triangles and take the geometry manager's device memory from 406 MB to 743–780 MB.
+- **Changed:** `GPUGeometrySDFManager.alias(clone, source)` moves the clone's holders to the source and sends
+  `onBaked` with the clone when the source's cache turns resident; card sets of an aliased geometry capture its
+  source's layout (`GPUMeshCardSets.alias` / `unalias`). New `GPUGeometrySDFManager.onForgotten`.
+- **Breaking:** `GPUGeometrySDFManager.adopt`, `add_source`, `remove_source` and the `MeshSDFSource` typedef are
+  gone, as are the GPU extraction (`shader_vgeo_sdf_collect`, `shader_vgeo_sdf_traverse`, `shader_vgeo_sdf_decode`,
+  `VGEO_SDF.js`). `VGeoSDFProxies` takes `{ geometries }` alone; its `cut`, `job_count`, `requested_count`,
+  `extracted_count`, `adopted_count`, `triangles_extracted` and `cluster_capacity` are replaced by `pending_count`,
+  `applied_count`, `failed_count` and `proxy_of(record)`.
+
 ### Virtual geometry: proxy meshes, offline
 
 - **Added:** `vgeo_to_proxy_mesh(reader, triangle_limit)` (`geometry/virtual/proxy/`) turns an open