Struct WgpuRenderer 

pub struct WgpuRenderer { /* private fields */ }

The live wgpu renderer: a Presenter, wrapped in WindowBackend to form a full Backend for the windowing loop.

It does not implement Input or Cursor itself: a GPU renderer cannot present without a live device, so there is no headless-with-input use for a bare Terminal<WgpuRenderer>. In windowed use WindowBackend owns the input queue (with its Mouse(Moved) coalescing) and the no-op cursor, so a duplicate queue here would only ever be dead. See the sub-cell offset note on Presenter for the shared rendering contract.

Build one with WgpuBackendBuilder. Before the windowing loop calls init_surface there is no device; drawing updates only the CPU-side instance arrays, and present is a no-op. Once the device exists, present uploads the frame and encodes one render pass.

Trait Implementations

impl Output for WgpuRenderer

type Error = Infallible

Error type returned by fallible operations.

fn draw_layers<'a, I>(&mut self, content: I) -> Result<(), Self::Error>

where I: Iterator<Item = DrawCell<'a>>,

Draw changed cells across all layers.

fn needs_full_frame(&self) -> bool

Returns true if the backend needs the entire frame (all cells on all layers) on every call to draw_layers, rather than just the changed cells.

fn composites_layers(&self) -> bool

Whether this backend composites layers itself (per pixel or quad), receiving the raw layered stream from draw_layers.

fn flush(&mut self) -> Result<(), Self::Error>

Flush buffered output to the display.

fn size(&self) -> Size

Return current display dimensions.

fn clear(&mut self) -> Result<(), Self::Error>

Clear the entire display.

fn resize(&mut self, size: Size)

Notify the backend of a resize to size, updating what size reports.

fn draw<'a, I>(&mut self, content: I) -> Result<(), Self::Error>

where I: Iterator<Item = DrawCell<'a>>,

Draw changed cells to the output surface, layer 0 only.

impl Presenter for WgpuRenderer

type SurfaceError = SurfaceError

Surface lifecycle error (context creation, buffer acquisition, present).

fn init_surface( &mut self, window: Arc<dyn WindowHandle>, ) -> Result<(), SurfaceError>

Initialize the window surface.

fn resize_surface(&mut self, width: u32, height: u32)

Resize the window surface to a new physical pixel size.

fn present(&mut self) -> Result<(), SurfaceError>

Present the rasterized frame to the window surface.

fn cell_size(&self) -> (u32, u32)

Cell size in physical pixels (width, height).

fn geometry(&self) -> CellGeometry

This presenter’s cell geometry, as a CellGeometry rather than the raw (width, height) pair cell_size returns.

fn scale_factor_changed(&mut self, _scale_factor: f64)

Notify the presenter that the window’s scale factor (DPI) changed.