Struct GlRenderer 

pub struct GlRenderer { /* private fields */ }

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

It does not implement Input or Cursor itself: a GL renderer cannot present without a live context, so there is no headless-with-input use for a bare Terminal<GlRenderer>. 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 GlBackendBuilder. Before the windowing loop calls init_surface there is no GL context; drawing updates only the CPU-side instance array, and present is a no-op. Once the surface exists, present uploads changed cells and issues the single instanced draw call.

Trait Implementations

impl Drop for GlRenderer

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Output for GlRenderer

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 GlRenderer

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.