Struct DepthTexture

pub struct DepthTexture { /* private fields */ }

A depth texture.

Implementations

impl DepthTexture

pub fn new( runtime: impl AsRef<WgpuRuntime>, texture: impl Into<Arc<Texture>>, ) -> Self

pub fn try_new_from( runtime: impl AsRef<WgpuRuntime>, value: Texture, ) -> Result<Self, TextureError>

pub async fn read_image(&self) -> Result<Option<GrayImage>, TextureError>

Converts the depth texture into an image.

Assumes the format is single channel 32bit.

Panics

This may panic if the depth texture has a multisample count greater than 1.

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 Deref for DepthTexture

type Target = Texture

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.