Back to Filament

penumbraRatioScale

docs/android/dokka/filament-android/com.google.android.filament/-view/-soft-shadow-options/penumbra-ratio-scale.md

1.75.01.2 KB
Original Source

//filament-android/com.google.android.filament/View/SoftShadowOptions/penumbraRatioScale

penumbraRatioScale

[main]
open var penumbraRatioScale: Float

Sets a global scale factor applied to the PCSS geometric ratio before failsafe clamping. This parameter controls the "contact shadow contrast" or the rate at which shadows transition from sharp to soft. By scaling the geometric ratio, you can create highly dramatic, cinematic shadows that blur rapidly as they move away from the contact point, completely independently of the light's overall physical size. - Values >1.0 cause the shadow to accelerate toward its maximum softness faster. - Values <1.0 cause the shadow to stay sharper for a longer distance. The final ratio scale applied is calculated by modulating this global value with the light's individual penumbraRatioScale (global * local). The global penumbra ratio scale multiplier. Default is 1.0.

See also

LightManager::ShadowOptions::penumbraRatioScale