filament/io.github.erkko68.filament/SoftShadowOptions

SoftShadowOptions

class SoftShadowOptions

View-level options for DPCF and PCSS (soft) shadowing.

Warning: This API is still experimental and subject to change.

Constructors

SoftShadowOptions

constructor()

Properties

maxPenumbraRatio

var maxPenumbraRatio: Float

Caps the penumbra ratio used by PCSS contact hardening, applied as a smooth asymptotic squash rather than a hard clamp. Limits how soft a shadow can get as the occluder moves away from the receiver. Default: 10.0.

maxSearchRadius

var maxSearchRadius: Float

Limits the physical footprint, in world units, of the PCSS blocker search. Acts as a global ceiling on the per-light LightManager.ShadowOptions.maxSearchRadius. Default: 1.0.

penumbraRatioScale

var penumbraRatioScale: Float

Globally scales the computed penumbra ratio of all DPCF and PCSS shadows. This effectively controls the strength of contact hardening effect and is useful for artistic purposes. Higher values make the shadows become softer faster. Acceptable values are equal to or greater than 1. Default: 1.0.

penumbraScale

var penumbraScale: Float

Globally scales the penumbra of all DPCF and PCSS shadows. Acceptable values are greater than 0. Default: 1.0.