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 Debug for WgpuRenderer

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

Formats the value using the given formatter.

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 compositing(&self) -> Compositing

How this backend wants layers handed to 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 geometry(&self) -> CellGeometry

This presenter’s cell geometry: glyph size and integer scale.

fn scale_factor_changed(&mut self, _scale_factor: f64)

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

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

Cell size in physical pixels (width, height): geometry’s cell_size.