Struct DepthComposite 

pub struct DepthComposite { /* private fields */ }

Viewport-owned offscreen scene target + depth buffer + blit pipeline.

Created through DepthComposite::ensure (per viewport id), drawn into with DepthComposite::begin_scene, composited back with DepthComposite::blit. Textures recreate on format/sample/size change; buffer contents are per-frame and never retained.

Implementations

impl DepthComposite

pub fn get(resources: &mut CallbackResources) -> &mut Self

Fetch the composite store from callback resources (creating it on first use). One store per render pass; ids disambiguate viewports.

pub fn begin_frame(&mut self)

pub fn end_frame(&mut self)

pub fn ensure( &mut self, device: &Device, screen: &ScreenDescriptor, id: &str, w: u32, h: u32, ) -> Result<()>

Ensure the offscreen target for id at wxh (recreates on format/sample/size change, like every other viewport-owned target). Dimensions clamp to >= 1. Errors name the reason the target could not be allocated; the other viewports are left untouched.

pub fn begin_scene<'a>( &'a self, id: &str, encoder: &'a mut CommandEncoder, clear: [f32; 4], ) -> Option<RenderPass<'a>>

Begin the offscreen scene pass for id (clearing color to clear and depth to 1.0). The caller issues its depth-tested draws inside the returned pass, then ends it; blit composites in paint. Returns false when id has no target (call ensure first).

The depth and stencil attachments are discarded when the pass ends: blit only samples the color target, so nothing in this crate reads them afterwards. A caller that needs the depth buffer afterwards must keep its own copy.

clear uses straight (un-premultiplied) alpha, which the blit premultiplies before compositing.

pub fn depth_format(&self, id: &str) -> Option<TextureFormat>

Depth format backing the scene target (for caller pipelines).

pub fn blit<P: BlitRenderPass>(&self, id: &str, rpass: &mut P)

Composite the offscreen scene for id into the main pass. The renderer has already set the viewport to the callback rect, which matches the offscreen texture 1:1 (both come from the painted frame geometry). Composites over the UI already drawn this frame, so a transparent scene keeps it visible. No-op when id has no target.

pub fn blit_callback(&self, id: &str, rpass: &mut CallbackRenderPass<'_, '_>)

Trait Implementations

impl Default for DepthComposite

fn default() -> Self

Returns the “default value” for a type.