Struct SampledTexture 

pub struct SampledTexture { /* private fields */ }

A texture the executor samples (see the module documentation).

Implementations

impl SampledTexture

pub fn new( levels: Levels, transfer: Transfer, sampler: SamplerUse, filtering: Filtering, ) -> Result<SampledTexture, String>

levels (at least one), read through transfer, sampled as sampler and filtering say; a sampler bias, border colour or level range that isn’t finite, a reversed range, and a border axis with no colour are refused.

pub fn with_footprintless_level( self, level: f32, ) -> Result<SampledTexture, String>

The same texture with level the level of detail of an implicit-level sample that has no quad footprint (an evaluation one pixel at a time): the caller’s stated assumption, which it reports. A level that isn’t finite is refused.

pub fn footprintless_level(&self) -> Option<f32>

The level an implicit-level sample without a footprint takes, if the caller stated one.

pub fn levels(&self) -> &Levels

The stored levels.

pub fn transfer(&self) -> Transfer

The transfer function the texels are decoded with.

pub fn sampler(&self) -> SamplerUse

The sampler state the texture is sampled with.

pub fn address(&self) -> [Address; 2]

The addressing along u and v.

pub fn filtering(&self) -> Filtering

The filtering policy.

pub fn dimensions(&self) -> [usize; 2]

The base level’s width and height.

pub fn decoded_bytes(&self) -> usize

The bytes it holds: the stored levels and the texels decoded for filtering.

pub fn unhonoured(&self) -> Option<&'static str>

What of its sampler this sampling does not apply, for the caller to report: under Filtering::BaseBilinear, which reads the base level whatever the level of detail, a stated bias, and a stated level range that excludes the base level.

Trait Implementations

impl Clone for SampledTexture

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SampledTexture

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

Formats the value using the given formatter.

impl Image for SampledTexture

fn sample(&self, uv: [f32; 2], lod: Lod) -> Result<[f32; 4], String>

The texel at uv at level of detail lod, or an error that stops the evaluation.