Struct BorrowedRenderTarget

pub struct BorrowedRenderTarget<'a> {
    pub view: &'a TextureView,
    pub texture: Option<&'a Texture>,
    pub size: PhysicalExtent,
    pub format: TextureFormat,
}

A host-owned, single-sampled color target borrowed for UI recording.

Use this with crate::Renderer::record_layered_to_target_scaled when the application already owns the image and command encoder. Unlike RenderFrame, this descriptor transfers no ownership and carries no presentation callback. The host acquires, submits, and presents the image itself.

Attachment contract

• The view and encoder belong to crate::Renderer::device.
• The view is D2, covers mip zero only and array layer zero only, and uses a single-sampled color texture with RENDER_ATTACHMENT usage.
• size is the full physical-pixel extent, not a logical size or a crop. Both axes are nonzero and within the device’s max_texture_dimension_2d.
• format matches the renderer’s pipeline format. Format reinterpretation through a differently formatted view is not supported by this contract.
• If supplied, texture backs exactly this view, with matching dimensions and format. It is a single-layer D2 image, not a multisampled attachment.

Wgpu 0.20 does not expose a view’s descriptor or backing texture for inspection. The caller must attest the view metadata and identity. The recorder checks the supplied extent, format and texture descriptor, but cannot prove that the view refers to that texture or that all handles share a device. Wgpu validates invalid GPU bindings separately; such failures are not typed recorder errors.

Examples

use ailloli_ui_render_wgpu::{BorrowedRenderTarget, PhysicalExtent};
fn describe<'a>(
    texture: &'a wgpu::Texture,
    view: &'a wgpu::TextureView,
) -> BorrowedRenderTarget<'a> {
    BorrowedRenderTarget {
        view,
        texture: Some(texture),
        size: PhysicalExtent::new(texture.width(), texture.height()),
        format: texture.format(),
    }
}

Fields

view: &'a TextureView

Full-size destination color view, on the renderer’s device.

texture: Option<&'a Texture>

Optional backing image for destination-dependent effects.

None is sufficient for ordinary UI and foreground blur. Backdrop blur, Multiply, and Screen blends require Some with COPY_SRC usage. The recorder never acquires, owns, or presents this texture.

size: PhysicalExtent

Full physical dimensions; both axes must be nonzero.

format: TextureFormat

Attachment format, exactly matching the renderer’s pipeline format.

Trait Implementations

impl<'a> Clone for BorrowedRenderTarget<'a>

fn clone(&self) -> BorrowedRenderTarget<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for BorrowedRenderTarget<'a>

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

Formats the value using the given formatter.

impl<'a> Copy for BorrowedRenderTarget<'a>