simvx.graphics.text_renderer

Text rendering: font caching, vertex batching, and font fallback chain.

Module Contents

Classes

TextRenderer

Manages font atlases and batches text geometry for GPU submission.

Functions

get_shared_text_renderer

Return the module-level shared TextRenderer (lazy singleton).

Data

__all__
log

API

simvx.graphics.text_renderer.__all__

[‘TextRenderer’, ‘_find_font’, ‘_find_cjk_fonts’, ‘get_shared_text_renderer’]

simvx.graphics.text_renderer.log

‘getLogger(…)’

class simvx.graphics.text_renderer.TextRenderer(max_chars: int = 4096)

Manages font atlases and batches text geometry for GPU submission.

Supports a font fallback chain: when the primary font is missing a glyph (e.g. CJK characters), fallback fonts are tried in order. Fallback glyphs are packed into the primary atlas so the GPU sees a single texture.

Initialization

property fallback_fonts: list[simvx.core.text.Font]

The current fallback font chain.

set_font_fallbacks(paths: list[str], font_size: int = 64) → None

Set the font fallback chain (replaces auto-detected fallbacks).

Fonts are tried in order when the primary font is missing a glyph. Each path should be a .ttf or .ttc file.

get_atlas(font_path: str, font_size: int = 64) → simvx.core.text.MSDFAtlas

Get or create an MSDF atlas for the given font.

begin_frame() → None

Reset vertex batch for new frame.

draw_text(text: str, x: float, y: float, font_path: str | None = None, size: float = 24.0, colour: tuple[float, ...] = (1.0, 1.0, 1.0, 1.0), font_size: int = 48) → None

Append text quads to the per-frame vertex batch.

Args: text: String to render. x, y: Top-left position in pixel coordinates. font_path: Path to .ttf file (auto-detected if None). size: Display size in pixels. colour: RGBA colour tuple. font_size: Atlas generation size (higher = sharper base quality).

get_vertices() → numpy.ndarray

Get the vertex array for the current frame (trimmed to actual size).

get_indices() → numpy.ndarray

Get the index array for the current frame (trimmed to actual size).

property char_count: int

property has_text: bool

property atlas_version: int

simvx.graphics.text_renderer.get_shared_text_renderer() → simvx.graphics.text_renderer.TextRenderer

Return the module-level shared TextRenderer (lazy singleton).