Skip to content

docs(book): the lighting page stops contradicting itself about shadows - #863

Merged
lobinuxsoft merged 2 commits into
developmentfrom
docs/lighting-refresh
Aug 17, 2026
Merged

docs(book): the lighting page stops contradicting itself about shadows#863
lobinuxsoft merged 2 commits into
developmentfrom
docs/lighting-refresh

Conversation

@lobinuxsoft

Copy link
Copy Markdown
Owner

788 lines, and the parts written before #777/#778/#780 were arguing with the parts written after.

  • 🔴 It said a punctual light needs a cube map "and neither exists yet" — then documented the cube map four hundred lines later. Both statements were on the page. Now: cascades are for the first directional light, spots cast through their own map, points through a cube, both cast_shadows: true by default and both limited to four.
  • Clustering is no longer written in the future tense ("when clustering lands its input is…").
  • Exposure and ambient are no longer "a control not in your hands"feat(render,ecs): render settings as a project asset, with defaults #744 made them a .rendersettings asset. Documents why an asset and not a panel: bespoke settings panels do not get built, and this setting had none for as long as it existed.
  • New section: what does not work — cutting the froxel list by count (❌ Sample the tile's lights instead of walking all of them — refuted #826). RIS over a cell's lights is the obvious next idea, it was built and removed, and the reason is structural: it breaks the grid's continuity property and the froxels become visible. With the histogram, and the LDS hypothesis that died with it.
  • The tonemap is inline on the fragment path and its own pass on the compute one.

Third page of the pass over the book. Docs only.

lobinuxsoft and others added 2 commits August 17, 2026 04:48
It said punctual lights cannot cast and then documented, four hundred
lines later, that spots cast since #777 and points since #778. It also
still spoke of clustering as something that would land.

Adds the #826 refutation, because cutting a froxel's light list by count
is the obvious next idea and it is wrong for a structural reason worth
writing down once.
@lobinuxsoft
lobinuxsoft merged commit 568edea into development Aug 17, 2026
@lobinuxsoft
lobinuxsoft deleted the docs/lighting-refresh branch August 17, 2026 07:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant