Orkuncakilkaya
f25289db20
`Gl.*` binds the whole OpenGL 4.1 core API — every entry point of the platform gl3.h with every GL_* constant, generated by `ludic-dev glgen` with per-call ABI thunks. Windowed builds get an NSOpenGLContext on the existing window at Retina resolution; headless builds render into an offscreen CGL context, so a program that uses Gl.* renders and screenshots identically under the test harness. It links gl.ll, the thunks and OpenGL.framework only when used; every other build stays byte-identical. packages/ludic.render3d is a physically based renderer written on that surface: HDRI image-based lighting, GPU-generated terrain with scanned PBR materials, CDLOD, cascaded shadows, glTF with skinning, instanced vegetation with impostors, procedural grass, water, SSAO, and an HDR pipeline with bloom, auto-exposure and ACES. It also carries this session's work on it: the terrain at half its cost (10.3 -> 5.4 ms of frame), the streaming hitch that got worse the longer you played, a resize that emptied the world, and the packaging that lets a game use the renderer from its own repository — `ludic assets`, the material manifest shipping with the package, and shader lookup falling back to the install root. See changes/ for each, with its numbers. The camping game that drove all of it has moved out to its own repository, Maroon Lake; examples/rendering/smooth.ludic stays as the renderer's example here. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
36 lines
2.4 KiB
Markdown
36 lines
2.4 KiB
Markdown
bump: patch
|
|
type: perf
|
|
**Ground cover stops re-growing itself.** Walking a streamed world hitched, and the
|
|
hitch got worse the longer you played. Measured in the Maroon Lake game, with a new hitch
|
|
report rather than guessed at.
|
|
|
|
**The chunk cache had a cliff, not a slope.** A stream cached 4096 chunks and then
|
|
stopped remembering: past that the chunk was generated, used for one frame and thrown
|
|
away, so every ring walk regenerated it, for the rest of the session. It arrives after
|
|
enough of the map has been walked — six evictions' worth over seven kilometres, so an
|
|
ordinary session reaches it — and it is the point where cover starts visibly re-growing
|
|
as you turn. `stream_evict` now drops the half of the cache nobody has asked for in the
|
|
longest time (chunks carry the walk that last wanted them) and rebuilds the index over
|
|
what is left. Over a 7 km traversal: generation total **9073 ms → 2230 ms**, the worst
|
|
single frame's generation **11.4 ms → 3.1 ms**, median frame 10.8 → 9.0 ms. With a cache
|
|
deliberately sized to saturate early, the same run goes from 2748 frames generating to
|
|
1548, and from a 13.3 ms median to 9.2. `R3D_NOEVICT` restores the old behaviour for
|
|
comparison, `R3D_STREAM_CAP=<n>` sets the cache size.
|
|
|
|
The other half of that hitch was in the game's own cover generator, and went with it to
|
|
the Maroon Lake game's repository: its candidates were paying for a second noise field, four
|
|
height samples and a path distance before the drift field that rules out most of the
|
|
meadow — 2341 µs → 518 µs per chunk, bit-identical output. Worth repeating in any
|
|
generator: a `stream_fill` is called for tens of thousands of candidates per chunk, so
|
|
the order of its tests is most of its cost.
|
|
|
|
**The hitch report** (`R3D_PROF=1`) is what found both. It prints the slowest frames of
|
|
the run with what was in each: CPU versus GPU wait, cover generated, instance bytes
|
|
uploaded, the game's own tick, and the renderer phase that took longest. Alongside it,
|
|
per-chunk generation cost by stream and band, a census of what the caches hold, and a
|
|
stutter figure — the frame time a run spent beyond 1.2x its own median — because a mean
|
|
cannot show a hitch and a maximum is one unlucky frame.
|
|
|
|
It also found two content bugs in the game it was measured on, which is the report doing
|
|
its job: a cover stream whose placement rule never fires still pays full generation cost,
|
|
and the census makes that visible — 3364 cached chunks holding zero instances.
|