CanopyOptions

A texture laid over the world from above that says how closed the canopy is over each spot and how high its top stands, and the light the canopy passes down under it: the sun’s light, scattered by the leaves above, which every surface under the top takes from every side, as an ambient light gives, more the deeper it stands under the top. Every lit material takes it, the crowns’ lower tiers, the trunks, the floor and the characters, so a grove’s shade reads lit rather than black, while a crown’s sunlit top keeps its own shading.

Properties

Property	Type	Default value	Description
center?	readonly [number, number]	[0, 0]	The point on the ground under the texture’s middle.
color?	ColorRepresentation	"#e6f2c4", the pale green of light through leaves	The colour of that light, multiplying the sun’s: a light’s colour, pale, since the surfaces it falls on keep their own.
depth?	number	6	Metres down from the canopy’s top over which its light grows from none to all of intensity, and the open sky’s reflection fades from whole to none: a crown’s sunlit top takes no canopy light, its lower tiers some, and the floor depth or more under the top all of it. About a crown’s depth, from its top to where its tiers close; for a canopy lower than 6 m over its floor, such as an orchard, its height over the floor. Above 0. The top is a half float, so it steps by a metre above 1,024 m.
intensity?	number	0.1	The share of the sun’s light on open ground a closed canopy passes down, measured against the sun, not as an ambient light’s absolute intensity: 0.1 lights a surface under a closed crown from every side with a tenth of what the sun gives the open ground beside it, so it follows the hour and the sun’s height and is gone at night. 0 or more.
size	readonly [number, number]	undefined	Metres the texture spans along x and along z.
texture	Texture	undefined	Read from above, a HalfFloatType texture with a green channel, such as RGFormat: its red channel is how closed the canopy is over each spot, 0 open sky to 1 a closed crown, and its green is the height of the canopy’s top there, in metres in the world, times the red, so a texel at a crown’s edge filters to its crown’s top rather than toward 0. The top is the crowns’ upper surface over each spot, a cone’s slope rather than its apex over its whole skirt. Its u runs along +x and its v along +z, as a light mask’s does, and its colour space stays NoColorSpace. Past its edge no canopy stands. Write it as the game runs and set its needsUpdate.