Struct SamplerDescriptor 

pub struct SamplerDescriptor {
    pub filter: FilterMode,
    pub mipmap_filter: MipmapFilter,
    pub address_mode_u: AddressMode,
    pub address_mode_v: AddressMode,
    pub address_mode_w: AddressMode,
    pub compare: Option<CompareFunction>,
}

A strongly-typed sampler descriptor for create_sampler.

Replaces the historical GpuSamplerDescriptor, which spelled the filter and address modes as six independent &'static str fields plus a compare: bool. The new layout keeps the same information but as three orthogonal decisions — how to interpolate, how to blend mip levels, how to wrap — so the combinations the old fields allowed but the renderer could not express (a Nearest magnification filter with a Linear minification filter, a comparison other than the hardcoded one) are now expressible, and an invalid value is a compile error rather than a silently rejected createSampler call.

Fields

filter: FilterMode

How texels are interpolated within one mip level. Applied to both the magnification and the minification filter.

mipmap_filter: MipmapFilter

How results from adjacent mip levels are blended together.

address_mode_u: AddressMode

What sampling does with U coordinates outside [0, 1].

address_mode_v: AddressMode

What sampling does with V coordinates outside [0, 1].

address_mode_w: AddressMode

What sampling does with W coordinates outside [0, 1]. Only meaningful for 3D textures.

compare: Option<CompareFunction>

The depth comparison to apply, or None for a plain filtering sampler that performs no comparison. Strictly more expressive than the old compare: bool, which could only mean “compare with the single hardcoded comparison”.

Implementations

impl SamplerDescriptor

Named constructors for the pipeline state structs.

pub fn nearest_clamp() -> Self

The cheapest sampler: nearest filtering on every axis with clamp-to-edge addressing and no comparison.

Returns

• Self - The assembled sampler descriptor.

impl SamplerDescriptor

pub fn get_filter(&self) -> FilterMode

pub fn set_filter(&mut self, val: FilterMode) -> &mut Self

pub fn get_mipmap_filter(&self) -> MipmapFilter

pub fn set_mipmap_filter(&mut self, val: MipmapFilter) -> &mut Self

pub fn get_address_mode_u(&self) -> AddressMode

pub fn set_address_mode_u(&mut self, val: AddressMode) -> &mut Self

pub fn get_address_mode_v(&self) -> AddressMode

pub fn get_address_mode_w(&self) -> AddressMode

pub fn get_compare(&self) -> Option<CompareFunction>

pub fn try_get_compare(&self) -> Option<CompareFunction>

impl SamplerDescriptor

pub fn new() -> Self

Trait Implementations

impl Clone for SamplerDescriptor

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 SamplerDescriptor

impl Debug for SamplerDescriptor

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

Formats the value using the given formatter.