/** * Canvas Renderer for Terminal Display * * High-performance canvas-based renderer that draws the terminal using * Ghostty's WASM terminal emulator. Features: * - Font metrics measurement with DPI scaling * - Full color support (256-color palette + RGB) * - All text styles (bold, italic, underline, strikethrough, etc.) * - Multiple cursor styles (block, underline, bar) * - Dirty line optimization for 60 FPS */ import type { ITheme } from './interfaces'; import type { SelectionManager } from './selection-manager'; import type { GhosttyCell } from './types'; import { CellFlags } from './types'; // Interface for objects that can be rendered export interface IRenderable { getLine(y: number): GhosttyCell[] | null; getCursor(): { x: number; y: number; visible: boolean }; getDimensions(): { cols: number; rows: number }; isRowDirty(y: number): boolean; clearDirty(): void; } // ============================================================================ // Type Definitions // ============================================================================ export interface RendererOptions { fontSize?: number; // Default: 15 fontFamily?: string; // Default: 'monospace' cursorStyle?: 'block' | 'underline' | 'bar'; // Default: 'block' cursorBlink?: boolean; // Default: false theme?: ITheme; devicePixelRatio?: number; // Default: window.devicePixelRatio } export interface FontMetrics { width: number; // Character cell width in CSS pixels height: number; // Character cell height in CSS pixels baseline: number; // Distance from top to text baseline } // ============================================================================ // Default Theme // ============================================================================ export const DEFAULT_THEME: Required = { foreground: '#d4d4d4', background: '#1e1e1e', cursor: '#ffffff', cursorAccent: '#1e1e1e', selectionBackground: '#264f78', selectionForeground: '#d4d4d4', black: '#000000', red: '#cd3131', green: '#0dbc79', yellow: '#e5e510', blue: '#2472c8', magenta: '#bc3fbc', cyan: '#11a8cd', white: '#e5e5e5', brightBlack: '#666666', brightRed: '#f14c4c', brightGreen: '#23d18b', brightYellow: '#f5f543', brightBlue: '#3b8eea', brightMagenta: '#d670d6', brightCyan: '#29b8db', brightWhite: '#ffffff', }; // ============================================================================ // CanvasRenderer Class // ============================================================================ export class CanvasRenderer { private canvas: HTMLCanvasElement; private ctx: CanvasRenderingContext2D; private fontSize: number; private fontFamily: string; private cursorStyle: 'block' | 'underline' | 'bar'; private cursorBlink: boolean; private theme: Required; private devicePixelRatio: number; private metrics: FontMetrics; private palette: string[]; // Cursor blinking state private cursorVisible: boolean = true; private cursorBlinkInterval?: number; private lastCursorPosition: { x: number; y: number } = { x: 0, y: 0 }; // Selection manager (for rendering selection overlay) private selectionManager?: SelectionManager; constructor(canvas: HTMLCanvasElement, options: RendererOptions = {}) { this.canvas = canvas; const ctx = canvas.getContext('2d', { alpha: false }); if (!ctx) { throw new Error('Failed to get 2D rendering context'); } this.ctx = ctx; // Apply options this.fontSize = options.fontSize ?? 15; this.fontFamily = options.fontFamily ?? 'monospace'; this.cursorStyle = options.cursorStyle ?? 'block'; this.cursorBlink = options.cursorBlink ?? false; this.theme = { ...DEFAULT_THEME, ...options.theme }; this.devicePixelRatio = options.devicePixelRatio ?? window.devicePixelRatio ?? 1; // Build color palette (16 ANSI colors) this.palette = [ this.theme.black, this.theme.red, this.theme.green, this.theme.yellow, this.theme.blue, this.theme.magenta, this.theme.cyan, this.theme.white, this.theme.brightBlack, this.theme.brightRed, this.theme.brightGreen, this.theme.brightYellow, this.theme.brightBlue, this.theme.brightMagenta, this.theme.brightCyan, this.theme.brightWhite, ]; // Measure font metrics this.metrics = this.measureFont(); // Setup cursor blinking if enabled if (this.cursorBlink) { this.startCursorBlink(); } } // ========================================================================== // Font Metrics Measurement // ========================================================================== private measureFont(): FontMetrics { // Use an offscreen canvas for measurement const canvas = document.createElement('canvas'); const ctx = canvas.getContext('2d')!; // Set font (use actual pixel size for accurate measurement) ctx.font = `${this.fontSize}px ${this.fontFamily}`; // Measure width using 'M' (typically widest character) const widthMetrics = ctx.measureText('M'); const width = Math.ceil(widthMetrics.width); // Measure height using ascent + descent with padding for glyph overflow const ascent = widthMetrics.actualBoundingBoxAscent || this.fontSize * 0.8; const descent = widthMetrics.actualBoundingBoxDescent || this.fontSize * 0.2; // Add 2px padding to height to account for glyphs that overflow (like 'f', 'd', 'g', 'p') // and anti-aliasing pixels const height = Math.ceil(ascent + descent) + 2; const baseline = Math.ceil(ascent) + 1; // Offset baseline by half the padding return { width, height, baseline }; } /** * Remeasure font metrics (call after font loads or changes) */ public remeasureFont(): void { this.metrics = this.measureFont(); } // ========================================================================== // Color Conversion // ========================================================================== private rgbToCSS(r: number, g: number, b: number): string { return `rgb(${r}, ${g}, ${b})`; } // ========================================================================== // Canvas Sizing // ========================================================================== /** * Resize canvas to fit terminal dimensions */ public resize(cols: number, rows: number): void { const cssWidth = cols * this.metrics.width; const cssHeight = rows * this.metrics.height; // Set CSS size (what user sees) this.canvas.style.width = `${cssWidth}px`; this.canvas.style.height = `${cssHeight}px`; // Set actual canvas size (scaled for DPI) this.canvas.width = cssWidth * this.devicePixelRatio; this.canvas.height = cssHeight * this.devicePixelRatio; // Scale context to match DPI (setting canvas.width/height resets the context) this.ctx.scale(this.devicePixelRatio, this.devicePixelRatio); // Set text rendering properties for crisp text this.ctx.textBaseline = 'alphabetic'; this.ctx.textAlign = 'left'; // Fill background after resize this.ctx.fillStyle = this.theme.background; this.ctx.fillRect(0, 0, cssWidth, cssHeight); } // ========================================================================== // Main Rendering // ========================================================================== /** * Render the terminal buffer to canvas */ public render(buffer: IRenderable, forceAll: boolean = false): void { const cursor = buffer.getCursor(); const dims = buffer.getDimensions(); // Resize canvas if dimensions changed const needsResize = this.canvas.width !== dims.cols * this.metrics.width * this.devicePixelRatio || this.canvas.height !== dims.rows * this.metrics.height * this.devicePixelRatio; if (needsResize) { this.resize(dims.cols, dims.rows); forceAll = true; // Force full render after resize } // Check if cursor position changed or if blinking (need to redraw cursor line) const cursorMoved = cursor.x !== this.lastCursorPosition.x || cursor.y !== this.lastCursorPosition.y; if (cursorMoved || this.cursorBlink) { // Mark cursor lines as needing redraw if (!forceAll && !buffer.isRowDirty(cursor.y)) { // Need to redraw cursor line const line = buffer.getLine(cursor.y); if (line) { this.renderLine(line, cursor.y, dims.cols); } } if (cursorMoved && this.lastCursorPosition.y !== cursor.y) { // Also redraw old cursor line if cursor moved to different line if (!forceAll && !buffer.isRowDirty(this.lastCursorPosition.y)) { const line = buffer.getLine(this.lastCursorPosition.y); if (line) { this.renderLine(line, this.lastCursorPosition.y, dims.cols); } } } } // Check if we need to redraw selection-related lines // Only force redraws when actively selecting or clearing selection const hasSelection = this.selectionManager && this.selectionManager.hasSelection(); const isActivelySelecting = this.selectionManager && this.selectionManager.isActivelySelecting(); const selectionRows = new Set(); // Mark selection rows for redraw ONLY when actively selecting (mouse is down) // This prevents slowdown when just typing with a static selection if (hasSelection && isActivelySelecting) { const coords = this.selectionManager!.getSelectionCoords(); if (coords) { for (let row = coords.startRow; row <= coords.endRow; row++) { selectionRows.add(row); } } } // Always mark previous selection rows for redraw (to clear old overlay) if (this.selectionManager) { const prevCoords = this.selectionManager.getPreviousSelectionCoords(); if (prevCoords) { for (let row = prevCoords.startRow; row <= prevCoords.endRow; row++) { selectionRows.add(row); } // Clear the previous selection tracking after marking for redraw this.selectionManager.clearPreviousSelection(); } } // Track if anything was actually rendered let anyLinesRendered = false; // Render each line for (let y = 0; y < dims.rows; y++) { // Render if forcing all, or if dirty, or if it has selection const needsRender = forceAll || buffer.isRowDirty(y) || selectionRows.has(y); if (!needsRender) { continue; } anyLinesRendered = true; const line = buffer.getLine(y); if (line) { this.renderLine(line, y, dims.cols); } } // Render selection highlight AFTER all text (so it overlays) // Only render if we actually rendered some lines if (hasSelection && anyLinesRendered) { // Draw selection overlay - only when we've redrawn the underlying text this.renderSelection(dims.cols); } // Render cursor if (cursor.visible && this.cursorVisible) { this.renderCursor(cursor.x, cursor.y); } // Update last cursor position this.lastCursorPosition = { x: cursor.x, y: cursor.y }; // Clear dirty flags after rendering if (!forceAll) { buffer.clearDirty(); } } /** * Render a single line */ private renderLine(line: GhosttyCell[], y: number, cols: number): void { const lineY = y * this.metrics.height; // Clear line background this.ctx.fillStyle = this.theme.background; this.ctx.fillRect(0, lineY, cols * this.metrics.width, this.metrics.height); // Render each cell for (let x = 0; x < line.length; x++) { const cell = line[x]; // Skip padding cells for wide characters if (cell.width === 0) { continue; } this.renderCell(cell, x, y); } } /** * Render a single cell */ private renderCell(cell: GhosttyCell, x: number, y: number): void { const cellX = x * this.metrics.width; const cellY = y * this.metrics.height; const cellWidth = this.metrics.width * cell.width; // Handle wide chars (width=2) // Extract colors and handle inverse let fg_r = cell.fg_r, fg_g = cell.fg_g, fg_b = cell.fg_b; let bg_r = cell.bg_r, bg_g = cell.bg_g, bg_b = cell.bg_b; if (cell.flags & CellFlags.INVERSE) { [fg_r, fg_g, fg_b, bg_r, bg_g, bg_b] = [bg_r, bg_g, bg_b, fg_r, fg_g, fg_b]; } // Always draw background to clear previous character this.ctx.fillStyle = this.rgbToCSS(bg_r, bg_g, bg_b); this.ctx.fillRect(cellX, cellY, cellWidth, this.metrics.height); // Skip rendering if invisible if (cell.flags & CellFlags.INVISIBLE) { return; } // Set text style let fontStyle = ''; if (cell.flags & CellFlags.ITALIC) fontStyle += 'italic '; if (cell.flags & CellFlags.BOLD) fontStyle += 'bold '; this.ctx.font = `${fontStyle}${this.fontSize}px ${this.fontFamily}`; // Set text color this.ctx.fillStyle = this.rgbToCSS(fg_r, fg_g, fg_b); // Apply faint effect if (cell.flags & CellFlags.FAINT) { this.ctx.globalAlpha = 0.5; } // Draw text const textX = cellX; const textY = cellY + this.metrics.baseline; const char = String.fromCodePoint(cell.codepoint || 32); // Default to space if null this.ctx.fillText(char, textX, textY); // Reset alpha if (cell.flags & CellFlags.FAINT) { this.ctx.globalAlpha = 1.0; } // Draw underline if (cell.flags & CellFlags.UNDERLINE) { const underlineY = cellY + this.metrics.baseline + 2; this.ctx.strokeStyle = this.ctx.fillStyle; this.ctx.lineWidth = 1; this.ctx.beginPath(); this.ctx.moveTo(cellX, underlineY); this.ctx.lineTo(cellX + cellWidth, underlineY); this.ctx.stroke(); } // Draw strikethrough if (cell.flags & CellFlags.STRIKETHROUGH) { const strikeY = cellY + this.metrics.height / 2; this.ctx.strokeStyle = this.ctx.fillStyle; this.ctx.lineWidth = 1; this.ctx.beginPath(); this.ctx.moveTo(cellX, strikeY); this.ctx.lineTo(cellX + cellWidth, strikeY); this.ctx.stroke(); } } /** * Render cursor */ private renderCursor(x: number, y: number): void { const cursorX = x * this.metrics.width; const cursorY = y * this.metrics.height; this.ctx.fillStyle = this.theme.cursor; switch (this.cursorStyle) { case 'block': // Full cell block this.ctx.fillRect(cursorX, cursorY, this.metrics.width, this.metrics.height); break; case 'underline': // Underline at bottom of cell const underlineHeight = Math.max(2, Math.floor(this.metrics.height * 0.15)); this.ctx.fillRect( cursorX, cursorY + this.metrics.height - underlineHeight, this.metrics.width, underlineHeight ); break; case 'bar': // Vertical bar at left of cell const barWidth = Math.max(2, Math.floor(this.metrics.width * 0.15)); this.ctx.fillRect(cursorX, cursorY, barWidth, this.metrics.height); break; } } // ========================================================================== // Cursor Blinking // ========================================================================== private startCursorBlink(): void { // xterm.js uses ~530ms blink interval this.cursorBlinkInterval = window.setInterval(() => { this.cursorVisible = !this.cursorVisible; // Note: Render loop should redraw cursor line automatically }, 530); } private stopCursorBlink(): void { if (this.cursorBlinkInterval !== undefined) { clearInterval(this.cursorBlinkInterval); this.cursorBlinkInterval = undefined; } this.cursorVisible = true; } // ========================================================================== // Public API // ========================================================================== /** * Update theme colors */ public setTheme(theme: ITheme): void { this.theme = { ...DEFAULT_THEME, ...theme }; // Rebuild palette this.palette = [ this.theme.black, this.theme.red, this.theme.green, this.theme.yellow, this.theme.blue, this.theme.magenta, this.theme.cyan, this.theme.white, this.theme.brightBlack, this.theme.brightRed, this.theme.brightGreen, this.theme.brightYellow, this.theme.brightBlue, this.theme.brightMagenta, this.theme.brightCyan, this.theme.brightWhite, ]; } /** * Update font size */ public setFontSize(size: number): void { this.fontSize = size; this.metrics = this.measureFont(); } /** * Update font family */ public setFontFamily(family: string): void { this.fontFamily = family; this.metrics = this.measureFont(); } /** * Update cursor style */ public setCursorStyle(style: 'block' | 'underline' | 'bar'): void { this.cursorStyle = style; } /** * Enable/disable cursor blinking */ public setCursorBlink(enabled: boolean): void { if (enabled && !this.cursorBlink) { this.cursorBlink = true; this.startCursorBlink(); } else if (!enabled && this.cursorBlink) { this.cursorBlink = false; this.stopCursorBlink(); } } /** * Get current font metrics */ public getMetrics(): FontMetrics { return { ...this.metrics }; } /** * Get canvas element (needed by SelectionManager) */ public getCanvas(): HTMLCanvasElement { return this.canvas; } /** * Set selection manager (for rendering selection overlay) */ public setSelectionManager(manager: SelectionManager): void { this.selectionManager = manager; } /** * Clear entire canvas */ public clear(): void { this.ctx.fillStyle = this.theme.background; this.ctx.fillRect(0, 0, this.canvas.width, this.canvas.height); } /** * Render selection overlay */ private renderSelection(cols: number): void { const coords = this.selectionManager!.getSelectionCoords(); if (!coords) return; const { startCol, startRow, endCol, endRow } = coords; // Use semi-transparent fill for selection this.ctx.save(); this.ctx.fillStyle = this.theme.selectionBackground; this.ctx.globalAlpha = 0.5; // Make it semi-transparent so text is visible for (let row = startRow; row <= endRow; row++) { const colStart = row === startRow ? startCol : 0; const colEnd = row === endRow ? endCol : cols - 1; const x = colStart * this.metrics.width; const y = row * this.metrics.height; const width = (colEnd - colStart + 1) * this.metrics.width; const height = this.metrics.height; this.ctx.fillRect(x, y, width, height); } this.ctx.restore(); } /** * Cleanup resources */ public dispose(): void { this.stopCursorBlink(); } }