`simvx.core.ui.rich_text`¶

Rich text widgets — RichTextLabel, OutputPanel, ConsoleWidget.

RichTextLabel renders ANSI-styled text with coloured spans. OutputPanel wraps it with a header bar for command output display. ConsoleWidget adds an input line with command history.

Module Contents¶

Classes¶

`RichTextLabel`	Read-only text display that renders ANSI-styled text with coloured spans.
`OutputPanel`	Panel that displays command output with ANSI colour support.
`ConsoleWidget`	Interactive console with output display and input line.

Data¶

`log`
`__all__`

API¶

simvx.core.ui.rich_text.log[source]¶: ‘getLogger(…)’

simvx.core.ui.rich_text.__all__¶: [‘RichTextLabel’, ‘OutputPanel’, ‘ConsoleWidget’]

class simvx.core.ui.rich_text.RichTextLabel(text: str = '', **kwargs)[source]¶

Bases: simvx.core.ui.core.Control

Read-only text display that renders ANSI-styled text with coloured spans.

Supports multi-line text with per-span colouring from ANSI escape codes. Auto-scrolls to bottom when new text is appended. Scrollable via mouse wheel.

Example: label = RichTextLabel() label.text = “\033[32mSuccess\033[0m: operation completed” label.append(“\033[31mError\033[0m: file not found”)

Initialization

font_size¶: ‘Property(…)’

wrap¶: ‘Property(…)’

max_lines¶: ‘Property(…)’

text_colour¶: ‘ThemeColour(…)’

bg_colour¶: ‘ThemeColour(…)’

property text: str¶

append(text: str)[source]¶: Append text (with automatic newline between calls).

clear()[source]¶: Clear all text content.

line_height() → float[source]¶: Line height in pixels based on current font size.

property scroll_y: float¶: Vertical scroll offset in pixels.

property auto_scroll: bool¶: Whether new content auto-scrolls to bottom.

property rect_override: tuple[float, float, float, float] | None¶: Override rect for layout/drawing (x, y, w, h). None uses global rect.

draw(renderer)[source]¶

size_x¶: ‘Property(…)’

size_y¶: ‘Property(…)’

property size: simvx.core.math.types.Vec2¶

touch_mode: str¶: ‘mouse’

property theme: simvx.core.ui.types.Theme | None¶

property mouse_over: bool¶

property focused: bool¶

property disabled: bool¶

get_theme() → simvx.core.ui.types.Theme¶

queue_redraw()¶

get_minimum_size() → simvx.core.math.types.Vec2¶

get_rect() → tuple[float, float, float, float]¶

get_global_rect() → tuple[float, float, float, float]¶

is_point_inside(point) → bool¶

set_anchor_preset(preset: simvx.core.ui.enums.AnchorPreset)¶

set_focus()¶

grab_focus()¶

release_focus()¶

has_focus() → bool¶

focus_next_control()¶

focus_previous_control()¶

grab_mouse()¶

release_mouse()¶

set_drag_preview(control: simvx.core.ui.core.Control)¶

draw_popup(renderer)¶

is_popup_point_inside(point) → bool¶

popup_input(event)¶

dismiss_popup()¶

z_index¶: ‘Property(…)’

z_as_relative¶: ‘Property(…)’

render_layer¶: ‘Property(…)’

set_render_layer(index: int, enabled: bool = True) → None¶

is_on_render_layer(index: int) → bool¶

property absolute_z_index: int¶

property position: simvx.core.math.types.Vec2¶

property rotation: float¶

property rotation_degrees: float¶

property scale: simvx.core.math.types.Vec2¶

property world_position: simvx.core.math.types.Vec2¶

property world_rotation: float¶

property world_scale: simvx.core.math.types.Vec2¶

property forward: simvx.core.math.types.Vec2¶

property right: simvx.core.math.types.Vec2¶

translate(offset: tuple[float, float] | numpy.ndarray)¶

rotate(radians: float)¶

rotate_deg(degrees: float)¶

look_at(target: tuple[float, float] | numpy.ndarray)¶

transform_points(points: list[simvx.core.math.types.Vec2]) → list[simvx.core.math.types.Vec2]¶

draw_polygon(renderer, points: list[simvx.core.math.types.Vec2], closed=True, colour=None)¶

wrap_screen(margin: float = 20)¶

strict_errors: ClassVar[bool]¶: True

script_error_raised¶: ‘Signal(…)’

classmethod __init_subclass__(**kwargs)¶

property name: str¶

property process_mode: simvx.core.descriptors.ProcessMode¶

reset_error() → None¶

add_child(node: simvx.core.node.Node) → simvx.core.node.Node¶

remove_child(node: simvx.core.node.Node)¶

reparent(new_parent: simvx.core.node.Node)¶

get_node(path: str) → simvx.core.node.Node¶

find_child(name: str, recursive: bool = False) → simvx.core.node.Node | None¶

find(node_type: type, recursive: bool = True) → simvx.core.node.Node | None¶

find_all(node_type: type, recursive: bool = True) → list¶

property path: str¶

add_to_group(group: str)¶

remove_from_group(group: str)¶

is_in_group(group: str) → bool¶

ready() → None¶

enter_tree() → None¶

exit_tree() → None¶

process(dt: float) → None¶

physics_process(dt: float) → None¶

input_event(event: simvx.core.events.InputEvent) → None¶

input(event: simvx.core.events.TreeInputEvent) → None¶

unhandled_input(event: simvx.core.events.TreeInputEvent) → None¶

start_coroutine(gen: simvx.core.descriptors.Coroutine) → simvx.core.descriptors.CoroutineHandle¶

stop_coroutine(gen_or_handle)¶

clear_children()¶

destroy()¶

property app¶

property tree: simvx.core.scene_tree.SceneTree¶

get_tree() → simvx.core.scene_tree.SceneTree¶

__getitem__(key: str)¶

classmethod get_properties() → dict[str, simvx.core.descriptors.Property]¶

__repr__()¶

class simvx.core.ui.rich_text.OutputPanel(title: str = 'Output', **kwargs)[source]¶

Bases: simvx.core.ui.core.Control

Panel that displays command output with ANSI colour support.

Includes a header bar with title and clear button. Wraps a RichTextLabel for styled text rendering.

Example: panel = OutputPanel(title=”Build Output”) panel.write(“\033[32mCompiling…\033[0m”) panel.write(“\033[31mError: undefined reference\033[0m”)

Initialization

show_header¶: ‘Property(…)’

auto_scroll¶: ‘Property(…)’

bg_colour¶: ‘ThemeColour(…)’

header_bg_colour¶: ‘ThemeColour(…)’

header_text_colour¶: ‘ThemeColour(…)’

border_colour¶: ‘ThemeColour(…)’

property rect_override: tuple[float, float, float, float] | None¶: Override rect for layout/drawing (x, y, w, h). None uses global rect.

write(text: str)[source]¶: Append output text.

clear()[source]¶: Clear all output.

draw(renderer)[source]¶

size_x¶: ‘Property(…)’

size_y¶: ‘Property(…)’

property size: simvx.core.math.types.Vec2¶

touch_mode: str¶: ‘mouse’

property theme: simvx.core.ui.types.Theme | None¶

property mouse_over: bool¶

property focused: bool¶

property disabled: bool¶

get_theme() → simvx.core.ui.types.Theme¶

queue_redraw()¶

get_minimum_size() → simvx.core.math.types.Vec2¶

get_rect() → tuple[float, float, float, float]¶

get_global_rect() → tuple[float, float, float, float]¶

is_point_inside(point) → bool¶

set_anchor_preset(preset: simvx.core.ui.enums.AnchorPreset)¶

set_focus()¶

grab_focus()¶

release_focus()¶

has_focus() → bool¶

focus_next_control()¶

focus_previous_control()¶

grab_mouse()¶

release_mouse()¶

set_drag_preview(control: simvx.core.ui.core.Control)¶

draw_popup(renderer)¶

is_popup_point_inside(point) → bool¶

popup_input(event)¶

dismiss_popup()¶

z_index¶: ‘Property(…)’

z_as_relative¶: ‘Property(…)’

render_layer¶: ‘Property(…)’

set_render_layer(index: int, enabled: bool = True) → None¶

is_on_render_layer(index: int) → bool¶

property absolute_z_index: int¶

property position: simvx.core.math.types.Vec2¶

property rotation: float¶

property rotation_degrees: float¶

property scale: simvx.core.math.types.Vec2¶

property world_position: simvx.core.math.types.Vec2¶

property world_rotation: float¶

property world_scale: simvx.core.math.types.Vec2¶

property forward: simvx.core.math.types.Vec2¶

property right: simvx.core.math.types.Vec2¶

translate(offset: tuple[float, float] | numpy.ndarray)¶

rotate(radians: float)¶

rotate_deg(degrees: float)¶

look_at(target: tuple[float, float] | numpy.ndarray)¶

transform_points(points: list[simvx.core.math.types.Vec2]) → list[simvx.core.math.types.Vec2]¶

draw_polygon(renderer, points: list[simvx.core.math.types.Vec2], closed=True, colour=None)¶

wrap_screen(margin: float = 20)¶

strict_errors: ClassVar[bool]¶: True

script_error_raised¶: ‘Signal(…)’

classmethod __init_subclass__(**kwargs)¶

property name: str¶

property process_mode: simvx.core.descriptors.ProcessMode¶

reset_error() → None¶

add_child(node: simvx.core.node.Node) → simvx.core.node.Node¶

remove_child(node: simvx.core.node.Node)¶

reparent(new_parent: simvx.core.node.Node)¶

get_node(path: str) → simvx.core.node.Node¶

find_child(name: str, recursive: bool = False) → simvx.core.node.Node | None¶

find(node_type: type, recursive: bool = True) → simvx.core.node.Node | None¶

find_all(node_type: type, recursive: bool = True) → list¶

property path: str¶

add_to_group(group: str)¶

remove_from_group(group: str)¶

is_in_group(group: str) → bool¶

ready() → None¶

enter_tree() → None¶

exit_tree() → None¶

process(dt: float) → None¶

physics_process(dt: float) → None¶

input_event(event: simvx.core.events.InputEvent) → None¶

input(event: simvx.core.events.TreeInputEvent) → None¶

unhandled_input(event: simvx.core.events.TreeInputEvent) → None¶

start_coroutine(gen: simvx.core.descriptors.Coroutine) → simvx.core.descriptors.CoroutineHandle¶

stop_coroutine(gen_or_handle)¶

clear_children()¶

destroy()¶

property app¶

property tree: simvx.core.scene_tree.SceneTree¶

get_tree() → simvx.core.scene_tree.SceneTree¶

__getitem__(key: str)¶

classmethod get_properties() → dict[str, simvx.core.descriptors.Property]¶

__repr__()¶

class simvx.core.ui.rich_text.ConsoleWidget(**kwargs)[source]¶

Bases: simvx.core.ui.core.Control

Interactive console with output display and input line.

Displays command output in a RichTextLabel with ANSI colour support. Single-line input at the bottom with command history navigation.

Example: console = ConsoleWidget() console.command_entered.connect(lambda cmd: console.write(f”>>> {cmd}”)) console.write(“Welcome to SimVX console.”)

Initialization