Log inGet started
World

Builtin Library

Branchmain
Branchesmainpublish
Commit15ce14a4c1

README.md

overheadCover

The overhead cover map: the highest surface over each point of the ground around the camera, drawn each render from every opaque mesh the renderer holds, entity-owned and instanced alike. A render feature that lights the air reads it to know how much of the sky a point sees past what stands over it.

local OverheadCover = require("@builtin::systems.skyVisibility.overheadCover")

OverheadCover.enqueue(ctx)          -- in render(ctx): draws the map at afterLighting
OverheadCover.target()              -- the map's target guid, bound as `overhead_map`
OverheadCover.release()             -- in teardown: frees the map and its material

The map is 256 by 256 texels of 1 world unit, centred on the camera being drawn and moved in whole texels. A texel holds the height of the highest surface over it, measured from the camera's height, in .r and 1 in .g, and 0 in both where nothing stands over it. A pass reads it through @builtin::systems.skyVisibility.overhead_openness.