Struct TerminalRenderer 

pub struct TerminalRenderer {
    pub font_family: String,
    pub font_size: Pixels,
    pub cell_width: Pixels,
    pub cell_height: Pixels,
    pub line_height_multiplier: f32,
    pub palette: ColorPalette,
}

Terminal renderer with font settings and cell dimensions.

This struct manages the rendering of terminal content, including text, backgrounds, and cursor. It maintains font metrics and provides the paint method for drawing the terminal grid.

Font Metrics

Cell dimensions are calculated from actual font measurements via measure_cell. This ensures accurate character positioning regardless of the font used.

Usage

The renderer is typically used internally by TerminalView, but can also be used directly for custom rendering:

// Measure cell dimensions (call once per font change)
renderer.measure_cell(window);

// Paint the terminal grid
renderer.paint(bounds, padding, &term, window, cx);

Performance

For optimal performance:

• Call measure_cell only when font settings change
• The paint method is designed to be called every frame
• Background and text batching minimize GPU draw calls

Fields

font_family: String

Font family name (e.g., “Fira Code”, “Menlo”)

font_size: Pixels

Font size in pixels

cell_width: Pixels

Width of a single character cell

cell_height: Pixels

Height of a single character cell (line height)

line_height_multiplier: f32

Multiplier for line height to accommodate tall glyphs

palette: ColorPalette

Color palette for resolving terminal colors

Implementations

impl TerminalRenderer

pub fn new( font_family: String, font_size: Pixels, line_height_multiplier: f32, palette: ColorPalette, ) -> Self

Creates a new terminal renderer with the given font settings and color palette.

Arguments

• font_family - The name of the font family to use
• font_size - The font size in pixels
• line_height_multiplier - Multiplier for line height (e.g., 1.2 for 20% extra)
• palette - The color palette to use for terminal colors

Returns

A new TerminalRenderer instance with default cell dimensions.

Examples

use gpui::px;
use gpui_terminal::render::TerminalRenderer;
use gpui_terminal::ColorPalette;

let renderer = TerminalRenderer::new("Fira Code".to_string(), px(14.0), 1.2, ColorPalette::default());

pub fn measure_cell(&mut self, window: &mut Window)

Measure cell dimensions based on actual font metrics.

This method measures the actual width and height of characters using the GPUI text system.

Arguments

• window - The GPUI window for text system access

pub fn layout_row( &self, row: usize, cells: impl Iterator<Item = (usize, Cell)>, colors: &Colors, ) -> (Vec<BackgroundRect>, Vec<BatchedTextRun>)

Layout cells into batched text runs and background rects for a single row.

This method processes a row of terminal cells and groups adjacent cells with identical styling into batched runs. It also collects background rectangles that need to be painted.

Arguments

• row - The row number
• cells - Iterator over (column, Cell) pairs
• colors - Terminal color configuration

Returns

A tuple of (backgrounds, text_runs) where:

• backgrounds is a vector of merged background rectangles
• text_runs is a vector of batched text runs

pub fn paint( &self, bounds: Bounds<Pixels>, padding: Edges<Pixels>, term: &Term<GpuiEventProxy>, window: &mut Window, _cx: &mut App, )

Paint terminal content to the window.

This is the main rendering method that draws the terminal grid, including backgrounds, text, and cursor.

Arguments

• bounds - The bounding box to render within
• padding - Padding around the terminal content
• term - The terminal state
• window - The GPUI window
• cx - The application context

Trait Implementations

impl Clone for TerminalRenderer

fn clone(&self) -> TerminalRenderer

Returns a duplicate of the value.

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

Performs copy-assignment from source.