Skip to main content

PooledTexture

Struct PooledTexture 

Source
pub struct PooledTexture<T = Texture, V = TextureView> { /* private fields */ }
Expand description

A texture checked out of a TexturePool, the key it returns under, and the frame clock it ages against.

Held by value while in use — the pool retains only free entries — so a caller that forgets to TexturePool::release it simply drops it, at worst losing the reuse rather than leaking a slot.

Implementations§

Source§

impl<T, V> PooledTexture<T, V>

Source

pub fn texture(&self) -> &Texture<T, V>

The pooled texture itself, carrying the TextureDesc it was created from (the quantized extent) and its crate::texture::SceneTextureId.

Source

pub fn view(&self) -> &V

The texture’s full-extent view.

Source

pub fn size(&self) -> (u32, u32)

The quantized (width, height) this texture was allocated at — at least Self::requested_size in both axes.

Source

pub fn requested_size(&self) -> (u32, u32)

The (width, height) the current holder asked for, which is what it should render into: the allocation is quantized up, so the rest of the texture is slack the caller must not treat as part of its image.

Source

pub fn key(&self) -> PoolKey

The configuration this entry returns to the pool under.

Source

pub fn last_used_frame(&self) -> u64

The frame this entry was last acquired for — the clock TexturePool::age measures disuse against.

Source§

impl PooledTexture<Texture, TextureView>

Source

pub fn color_attachment(&self, clear: Color) -> ColorAttachment<'_>

A color attachment targeting this texture, clearing to clear and discarding at pass end.

The ops are not a parameter on purpose. A recycled texture holds whatever its previous holder left there, so loading it would sample another pass’s image; and StoreOp::Discard is required outright once effective_usage has added wgpu::TextureUsages::TRANSIENT_ATTACHMENT. A caller that needs its own contents back across passes wants a texture it owns, not a pooled intermediate.

Trait Implementations§

Source§

impl<T: Clone, V: Clone> Clone for PooledTexture<T, V>

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T: Debug, V: Debug> Debug for PooledTexture<T, V>

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<T, V> Freeze for PooledTexture<T, V>
where Texture<T, V>: Freeze,

§

impl<T, V> RefUnwindSafe for PooledTexture<T, V>
where Texture<T, V>: RefUnwindSafe,

§

impl<T, V> Send for PooledTexture<T, V>
where Texture<T, V>: Send,

§

impl<T, V> Sync for PooledTexture<T, V>
where Texture<T, V>: Sync,

§

impl<T, V> Unpin for PooledTexture<T, V>
where Texture<T, V>: Unpin,

§

impl<T, V> UnsafeUnpin for PooledTexture<T, V>
where Texture<T, V>: UnsafeUnpin,

§

impl<T, V> UnwindSafe for PooledTexture<T, V>
where Texture<T, V>: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WasmNotSend for T
where T: Send,

Source§

impl<T> WasmNotSendSync for T

Source§

impl<T> WasmNotSync for T
where T: Sync,