Struct DepthTexture 

pub struct DepthTexture { /* private fields */ }

A depth texture with Arc-wrapped view for cheap, lifetime-free sharing.

The depth view is wrapped in an Arc to eliminate lifetime coupling when passing depth textures to render passes. This is safe because wgpu::TextureView is internally just an ID, so the Arc overhead is minimal.

Example

let mut depth = DepthTexture::new(device, 800, 600, DEFAULT_DEPTH_FORMAT);

// Cheap clone of the Arc
let depth_view = depth.view();

// Later, if window resizes:
if depth.needs_resize(new_width, new_height) {
    depth.resize(device, new_width, new_height);
}

Implementations

impl DepthTexture

pub fn new( device: &Device, width: u32, height: u32, format: TextureFormat, ) -> Self

Create a new depth texture with the given dimensions and format.

pub fn with_label( device: &Device, width: u32, height: u32, format: TextureFormat, label: &str, ) -> Self

Create a new depth texture with a debug label.

pub fn resize(&mut self, device: &Device, width: u32, height: u32)

Resize the depth texture if dimensions have changed.

This recreates the texture and view. The old Arc<TextureView> remains valid until all references are dropped, but any render passes using it should be completed before resize.

pub fn view(&self) -> Arc<TextureView>

Get a cheap clone of the depth view.

The Arc wrapper allows the view to be shared without lifetime constraints, making it easy to pass to closures and render passes.

pub fn view_ref(&self) -> &TextureView

Get a reference to the depth view (for cases where Arc is not needed).

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

Get the current size as (width, height).

pub fn width(&self) -> u32

Get the width in pixels.

pub fn height(&self) -> u32

Get the height in pixels.

pub fn needs_resize(&self, width: u32, height: u32) -> bool

Check if the depth texture needs to be resized for the given dimensions.

pub fn format(&self) -> TextureFormat

Get the depth format.

pub fn texture(&self) -> &Texture

Get the underlying wgpu texture.

Trait Implementations

impl Debug for DepthTexture

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

Formats the value using the given formatter.