Struct TextureView 

pub struct TextureView {
    view: TextureView,
    format: TextureFormat,
}

A texture view together with the format it views its texture as.

wgpu exposes no view format, and a view may be created with one besides its texture’s — an sRGB view over a non-sRGB swap-chain image, for example — so the format a view was created with is tracked next to it rather than assumed from the texture. This is the kind a ResHandle<TextureView> names, and TextureExt::create_view builds one from a descriptor, so the format and the view cannot disagree.

A view wgpu itself handed out states its format explicitly with TextureView::new: there is no way to recover it afterwards, which is exactly why this wrapper exists.

Fields

view: TextureView

The view.

format: TextureFormat

The format the view was created with.

Implementations

impl TextureView

pub fn new(view: TextureView, format: TextureFormat) -> Self

Pair view with the format it views its texture as.

pub fn view(&self) -> &TextureView

The view itself, for the wgpu calls that bind it.

pub fn texture(&self) -> &Texture

The texture the view views.

pub fn format(&self) -> TextureFormat

The format the view was created with.

Trait Implementations

impl Clone for TextureView

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 TextureView

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

Formats the value using the given formatter.

impl Eq for TextureView

impl From<TextureView> for TextureView

fn from(value: TextureView) -> Self

Converts to this type from the input type.

impl From<TextureView> for Resource

fn from(value: TextureView) -> Self

Converts to this type from the input type.

impl PartialEq for TextureView

Two views are equal when they are the same view of the same texture.

Written out rather than derived because the derive expands to a comparison of the bare [wgpu::TextureView] in generated code the struct’s own #[expect] does not cover. Going through TextureView::view and TextureView::format keeps the bare type named only in the wrapper, which is the whole point of it.

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

Equality operator ==.

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

Inequality operator !=.

impl ResourceKind for TextureView

fn borrow_from(resource: &Resource) -> Option<&Self>

Borrow this kind out of a stored Resource, or None when that resource is of another kind.

fn take_from(resource: Resource) -> Option<Self>

Take this kind out of a stored Resource, or None when that resource is of another kind.

fn into_resource(self) -> Resource

This value as a stored Resource.