MapDynamicLighting

Inheritance 2 ancestors · 15 siblings

• MapComponent
  • MapGraphicsFeature
    • 0x1c4bac51
    • 0x48486635
    • 0x49cb6889 (removed in patch 15.8)
    • 0x50db156b
    • 0x51b28927
    • 0x5d3f0253
    • 0xdffae8d9 (removed in patch 15.8)
    • MapAntiAliasing
    • MapClouds
    • MapDynamicLightingcurrent
    • MapGameplayTexture
    • MapLightRegions
    • MapLightingV2
    • MapSSAO
    • MapTerrainPaint
    • MapTransitionPositions1

Class Documentation

Edit documentation

The map feature that turns on dynamic lights. It is a component of the map's MapContainer, in its components list.

Light sources always register themselves with the renderer. Without this component they are never drawn: it is the only thing that creates the light grid, and the only thing that switches the map's shaders to their dynamic-light variant.

Light sources. Four classes feed the same light lists:

Source	Kind	Carried by
MapDynamicPointLight	point	a placed map object
MapDynamicSpotlight	spot	a placed map object
ParticlePointLightInfo	point	a particle system
VfxLightComponent	point	a shimmer emitter

Each frame the client keeps the lights that are inside the camera frustum, fits a grid of cells around them, and writes into each cell the list of lights that reach it. A pixel finds its cell from its world position and runs only that cell's lights. The grid is configured by the embedded ClusteredLightingInfo.

What is lit. Environment geometry and characters, with or without PBR materials. Characters here means every skinned mesh: champions, minions, monsters and structures. Particles are not lit, with one exception: materials built on the DefaultParticleLit shader.

Brightness. A point light falls off linearly, 1 - distance / radius, and reaches zero at its radius. On a non-PBR surface the light adds albedo * color * N.L * falloff, and the result is clamped. Only PBR-style shaders multiply the colour by the light's HdrScale.

Masks. Every light carries two bitmasks, and a surface takes the light only when both match:

• Its impact mask says which kind of surface it lights: bit 0x1 is environment, bit 0x2 is characters.
• Its light channels are compared with the light channels of the object being drawn. They must share at least one bit.

Light types. The type of a light selects how it is drawn:

Value	Meaning
0	Stationary. The light is multiplied by a baked mask, so it only shows where the map's baked data lets it through.
1	Dynamic, no shadow.
2	Dynamic with a shadow map, when the shadow quality setting allows it. Otherwise it is drawn like 1. For point lights only the first visible light of this type gets a shadow map.

A light whose colour is black is dropped before it reaches the renderer.

Notes

• No shipped map has this component, so no shipped light of any of the four kinds is visible.
• Adding the component to a map that ships without it is enough. Its settings can be left empty; the defaults work.
• The whole map pays for it: every environment and character pixel shader runs its light-loop variant while the component is present.

Properties

0x2451a0b

Bool = false

Documentation Edit documentation

Unknown bool. Purpose not yet identified.

0xb41ddb79

Bool = false

Documentation Edit documentation

Unknown bool. Purpose not yet identified.

0xbe053e8

Embed<ClusteredLightingInfo>

15.21

Default value

{
  "MaxNumClustersX": 32,
  "MaxNumClustersY": 2,
  "MaxNumClustersZ": 32,
  "MinClusterSize": [100, 100, 100],
  "0x8a0d61c2": 8192
}

Documentation Edit documentation

The size and resolution of the light grid. See ClusteredLightingInfo.

DynamicLightsEnabled

Bool = true

13.22

Documentation Edit documentation

Lets the map's environment and character shaders use their dynamic-light variant. When false the component still loads and builds its grid, but no shader reads it, so no light is drawn.

0x2451a0b

0xb41ddb79

0xbe053e8

DynamicLightsEnabled