Back to Filament

cascadeSplitPositions

docs/android/dokka/filament-android/com.google.android.filament/-light-manager/-shadow-options/cascade-split-positions.md

1.75.01.3 KB
Original Source

//filament-android/com.google.android.filament/LightManager/ShadowOptions/cascadeSplitPositions

cascadeSplitPositions

[main]
open var cascadeSplitPositions: Array<Float>

The split positions for shadow cascades.

Cascaded shadow mapping (CSM) partitions the camera frustum into cascades. These values determine the planes along the camera's Z axis to split the frustum. The camera near plane is represented by 0.0f and the far plane represented by 1.0f.

For example, if using 4 cascades, these values would set a uniform split scheme: { 0.25f, 0.50f, 0.75f }

For N cascades, N - 1 split positions will be read from this array.

Filament provides utility methods inside ShadowCascades to help set these values. For example, to use a uniform split scheme:

kotlin
LightManager.ShadowCascades.computeUniformSplits(options.cascadeSplitPositions, 4);

See also

LightManager.ShadowCascades