Struct GraphicsRenderer 

pub struct GraphicsRenderer { /* private fields */ }

Stateful image renderer used when the terminal supports Kitty or Sixel. The dashboard keeps the cell rasterizer as its portable fallback.

Implementations

impl GraphicsRenderer

pub fn probe() -> Self

pub fn secondary(&self) -> Self

Create an independent image slot that shares the terminal capability query with the primary renderer. The dashboard uses one slot for the map and one for popup charts so resizing or re-encoding one image does not invalidate the other.

pub fn supports_graphics(&self) -> bool

pub fn protocol(&self) -> ImageProtocol

pub fn filter_label(&self) -> &'static str

pub fn drawable_area(&self, area: Rect) -> Rect

Return the portion of a terminal area occupied by the proportional graphics image. Kitty, Sixel, and iTerm2 may letterbox an image rather than filling every cell in the panel; mouse mapping must use this same rectangle or point markers appear displaced from the click.

pub fn cycle_filter(&mut self) -> bool

pub fn reset_filter(&mut self)

Restore the configured initial interpolation mode and invalidate any cached raster/protocol image that used the previous mode.

pub fn mode_label(&self) -> &'static str

Human-readable renderer mode for the dashboard header. This makes it obvious when a terminal is using a graphics protocol versus the cell fallback.

pub fn render( &mut self, frame: &mut Frame<'_>, area: Rect, image: DynamicImage, ) -> bool

pub fn render_with_key<F>( &mut self, frame: &mut Frame<'_>, area: Rect, key: u64, make_image: F, ) -> bool

where F: FnOnce() -> DynamicImage,

Render a lazily-created image using a caller-owned visual-state key. The map can therefore retain its raster between UI redraws instead of hashing and rebuilding identical pixels on every input event.

pub fn has_pending_image(&self) -> bool

Whether a replacement image is being prepared. The event loop uses this to keep rendering while the old image remains on screen.

pub fn retire_overlay(&mut self)

Forget an overlay image when its popup closes. The next popup draw is encoded afresh, and Kitty virtual placements are removed as Ratatui replaces their placeholder cells with the map frame.

pub fn working_set_bytes(&self) -> usize

Bytes retained by the current encoded image and the replacement being prepared. The input raster is viewport-bounded, so this is the useful accounting boundary for rendered transport buffers.