Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs(changelog): the CDLOD terrain and vertex-hook colours are noted

yhh8007e58d90ec
diff --git a/CHANGELOG.md b/CHANGELOG.md
index abb698df1..31fa4e843 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -21,6 +21,8 @@ published separately; it ships inside the editor.
- **Surf on the shore.** Waves run in toward every shore of a water zone, stand up as the water shoals, break white and run up the ground past the waterline before falling back. `WaterZone.surf` sets how high a breaker stands against its body's waves and `surfLength` the length of the surf's waves; a current carries none, and `Waters.sample` rides the same surf. The zone now measures the distance to the shore across the ground for every body, an ocean over a beach included, where an ocean used to measure its depth.
+- **Terrain without cracks, and without end.** The ground is now a CDLOD quadtree round the eye: every node is the same small patch drawn as instances of one mesh, its heights and normals read on the GPU from pages of a height atlas, and its vertices slide onto the coarser grid toward the end of their level's range, so levels meet without cracks or skirts and nothing pops as the camera moves. `Terrain.extent` Infinite makes ground that goes on for ever from seeded noise read anywhere (worn by the noise's own erosion), drawn out to `drawDistance`; `cellSize` is the finest cell near the eye. Pages are made a few a frame, coarse and near first, and shown as progress.
+- **A vertex hook can hand the fragment a colour.** What a material's vertex hook leaves in `es_vertexColor` is now the colour its fragment receives (times the instance's tint), on both backends.
- **Bakes run over frames, with progress.** Work that used to hold a frame until it was done (a terrain worn by rain, a water zone baked, terrain chunks built, plants grown) is now spread over frames within a budget, and listed with its progress in the new `Bakes` resource (`bakesOf(app).active`). The editor's status bar shows it as a bar, for the edit world and for the game running in Play, and a game can show it on a loading screen. Plants wait for the ground and the water they stand on instead of being grown twice.
- **Eroded and warped terrain.** `Terrain.erosion` wears the ground with rain (a heightmap's as well as the noise's): gullies down the slopes, sharper ridges, silt in the valleys, and dirt painted where the water ran; the same seed wears the same ground. `Terrain.warp` bends the noise by noise of its own for winding valleys and bent ridges. `erodeHeightfield` and `erosionJob` do the same for a tool.
- **A richer Terrain shader.** Layers meet by their relief (`u_heightBlend`), each is read twice and blended by slow noise so no repeat is seen (`u_antiTile`), every layer gets the broad variation, their brightness is drawn into the light as relief (`u_relief`), and ground below `u_wetLevel + u_wetBand` darkens and shines at the waterline.
@@ -30,6 +32,7 @@ published separately; it ships inside the editor.
### Changed
+- **`Terrain` is cut by its cell size.** Its `chunks`, `chunkCells` and `lodLevels` are gone: the quadtree's levels follow from `cellSize` and the area (or `drawDistance`), and `detail` sets how far the finest cells reach.
- **`WaterBody` keeps only what a body says.** Its `material`, `cellSize`, `cells`, `rings`, `waveLength`, `waveSpeed`, `waveDirection` and ripple fields have moved to the new `WaterZone`, which every body shares; `shoreWidth` now calms the waves toward the shore of an ocean and a river as well as a lake. A body of water is no longer tilted with its entity: it is turned about up only. `ShoreField`, `buildRectMesh`, `buildBoxMesh` and `buildRiverMesh` are gone from `esengine/water`.
### Fixed
diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjs
index d54e5e230..a91b1df25 100644
--- a/tools/releaseNotes.mjs
+++ b/tools/releaseNotes.mjs
@@ -2748,4 +2748,10 @@ export const NOTED = {
{"note":"Terrain skirts and surf films no longer show as streaks."},
"fix(examples): Terrain & Water's viewpoints look at the lake, the river mouths and the river in the hills":
{"internal":"An example's own camera poses."},
+ "feat(render): a material's vertex hook hands the fragment the colour it leaves":
+ {"note":"A vertex hook can hand the fragment a colour."},
+ "feat(terrain): the ground is a CDLOD quadtree of one instanced patch read from height pages, and can go on for ever":
+ {"note":"Terrain without cracks, and without end."},
+ "test(editor): the terrain, foliage and water checks cut the ground by its cell size":
+ {"internal":"Editor checks follow the Terrain fields that replaced chunks; they draw nothing new."},
};