Enum ShadowFilter 

pub enum ShadowFilter {
    None,
    Pcf4,
}

Shadow edge filtering (Godot Light2D.ShadowFilter).

The filter is angular: the silhouette is re-derived for ShadowFilter::tap_count rotations around the light, spaced over the penumbra and each weighted 1 / taps, so the penumbra width in world units is Light2d::shadow_softness at every occluder distance instead of a screen-space blur.

Within one tap the edges of a solid occluder overlap, and the shadow there is their union (a point is shadowed when the ray to the light crosses any edge); only the taps themselves sum, as the average over the rotations. The mask pass in lightpass implements exactly that: one channel per tap, combined with max blending, summed by the light shader.

Each edge spaces its taps from its own midpoint’s distance to the light, not from one rotation for the whole occluder, so on a solid body two silhouette edges’ bands overlap and the union can reach full cover a few pixels sooner on the shadow side than a lone edge would. The penumbra’s mid level still sits on the silhouette: the closed-polygon golden measures it 1.5 px from the geometric edge, against a 3 px tolerance.

Variants

None

One hard edge.

Pcf4

Four taps: a stepped penumbra, the cheapest soft edge.

Implementations

impl ShadowFilter

pub fn tap_count(self) -> u32

Number of geometry copies drawn per silhouette edge.

pub fn tap_weight(self) -> f32

Weight of one tap: taps sum to 1, so a fully covered fragment is fully shadowed.

Trait Implementations

impl Clone for ShadowFilter

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ShadowFilter

impl Debug for ShadowFilter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ShadowFilter

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ShadowFilter

impl PartialEq for ShadowFilter

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ShadowFilter