Struct web_glitz::image::sampler::ShadowSampler

pub struct ShadowSampler { /* fields omitted */ }

Samples depth values and compares them to a reference value using a CompareFunction.

A shadow sampler can only be used with a texture that uses a depth format or a depth stencil stencil format. Rather than obtaining a (filtered) texel sample for certain texture coordinates like a normal Sampler, sampling with a ShadowSampler compares the depth texel values closest to the sampled coordinates to a reference value using a CompareFunction. The value returned is a floating point value in the range 0.0..=1.0 where the value signifies the proportion of the texels that passed the CompareFunction, for example: if no values passed, it returns 0.0; if all values passed it returns 1.0; if 1 out of 4 samples passed it returns 0.25.

See the documentation for each of the CompareFunction variants for descriptions of how each respective function decides whether or not a texel value passes.

See the documentation for RenderingContext::create_shadow_sampler for details on how to create a ShadowSampler.

Implementations

impl ShadowSampler

pub fn compare(&self) -> CompareFunction

The CompareFunction used by thisShadowSampler.

See type documentation for ShadowSampler and the documentation for CompareFunction for details.

pub fn wrap_s(&self) -> Wrap

The wrapping method that this ShadowSampler uses when sampling a value at coordinates outside the range 0.0..=1.0 in the S ("width") direction in texture space.

See Wrap for details.

pub fn wrap_t(&self) -> Wrap

The wrapping method that this ShadowSampler uses when sampling a value at coordinates outside the range 0.0..=1.0 in the T ("height") direction in texture space.

See Wrap for details.

pub fn wrap_r(&self) -> Wrap

The wrapping method that this ShadowSampler uses when sampling a value at coordinates outside the range 0.0..=1.0 in the R ("depth") direction in texture space.

See Wrap for details.

Trait Implementations

impl Hash for ShadowSampler

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<ShadowSampler> for ShadowSampler

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.