Struct Texture 

pub struct Texture { /* private fields */ }

A GPU-accessible texture.

May be converted from and dereferences to a wgpu Texture. Can be created via RenderDevice::create_texture.

Other options for storing GPU-accessible data are:

• BufferVec
• DynamicStorageBuffer
• DynamicUniformBuffer
• GpuArrayBuffer
• RawBufferVec
• StorageBuffer
• UniformBuffer

Implementations

impl Texture

pub fn id(&self) -> TextureId

Returns the TextureId.

pub fn create_view( &self, desc: &TextureViewDescriptor<Option<&str>>, ) -> TextureView

Creates a view of this texture.

Methods from Deref<Target = Texture>

pub unsafe fn as_hal<A>( &self, ) -> Option<impl Deref<Target = <A as Api>::Texture>>

where A: HalApi,

Get the wgpu_hal texture from this Texture.

Find the Api struct corresponding to the active backend in wgpu_hal::api, and pass that struct to the to the A type parameter.

Returns a guard that dereferences to the type of the hal backend which implements A::Texture.

Deadlocks

• The returned guard holds a read-lock on a device-local “destruction” lock, which will cause all calls to destroy to block until the guard is released.

Errors

This method will return None if:

• The texture is not from the backend specified by A.
• The texture is from the webgpu or custom backend.
• The texture has had Self::destroy() called on it.

Safety

• The returned resource must not be destroyed unless the guard is the last reference to it and it is not in use by the GPU. The guard and handle may be dropped at any time however.
• All the safety requirements of wgpu-hal must be upheld.

pub fn create_view( &self, desc: &TextureViewDescriptor<Option<&str>>, ) -> TextureView

Creates a view of this texture, specifying an interpretation of its texels and possibly a subset of its layers and mip levels.

Texture views are needed to use a texture as a binding in a BindGroup or as an attachment in a RenderPass.

pub fn destroy(&self)

Destroy the associated native resources as soon as possible.

pub fn as_image_copy(&self) -> TexelCopyTextureInfo<&Texture>

Make an TexelCopyTextureInfo representing the whole texture.

pub fn size(&self) -> Extent3d

Returns the size of this Texture.

This is always equal to the size that was specified when creating the texture.

pub fn width(&self) -> u32

Returns the width of this Texture.

This is always equal to the size.width that was specified when creating the texture.

pub fn height(&self) -> u32

Returns the height of this Texture.

This is always equal to the size.height that was specified when creating the texture.

pub fn depth_or_array_layers(&self) -> u32

Returns the depth or layer count of this Texture.

This is always equal to the size.depth_or_array_layers that was specified when creating the texture.

pub fn mip_level_count(&self) -> u32

Returns the mip_level_count of this Texture.

This is always equal to the mip_level_count that was specified when creating the texture.

pub fn sample_count(&self) -> u32

Returns the sample_count of this Texture.

This is always equal to the sample_count that was specified when creating the texture.

pub fn dimension(&self) -> TextureDimension

Returns the dimension of this Texture.

This is always equal to the dimension that was specified when creating the texture.

pub fn format(&self) -> TextureFormat

Returns the format of this Texture.

This is always equal to the format that was specified when creating the texture.

pub fn usage(&self) -> TextureUsages

Returns the allowed usages of this Texture.

This is always equal to the usage that was specified when creating the texture.

Trait Implementations

impl Clone for Texture

fn clone(&self) -> Texture

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Texture

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

Formats the value using the given formatter.

impl Deref for Texture

type Target = Texture

The resulting type after dereferencing.

fn deref(&self) -> &<Texture as Deref>::Target

Dereferences the value.

impl From<Texture> for Texture

fn from(value: Texture) -> Texture

Converts to this type from the input type.