`simvx.core.ui.widgets`¶

Widgets — Label, Button, Panel, TextEdit, Slider, ProgressBar.

All widgets draw themselves via the renderer passed to draw(). The renderer is Draw2D (class with classmethods), called directly without hasattr guards. Colours are float tuples (0-1).

Module Contents¶

Classes¶

`Label`	Text display widget.
`Button`	Clickable button with hover/press states.
`Panel`	Background panel with optional border.
`TextEdit`	Single-line text input.
`Slider`	Horizontal slider for numeric input.
`ProgressBar`	Progress bar display.

Data¶

`log`
`__all__`

API¶

simvx.core.ui.widgets.log¶: ‘getLogger(…)’

simvx.core.ui.widgets.__all__¶: [‘Label’, ‘Button’, ‘Panel’, ‘TextEdit’, ‘Slider’, ‘ProgressBar’]

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

Bases: simvx.core.ui.core.Control

Text display widget.

Example: label = Label(“Hello World”) label.text_colour = Colour.YELLOW label.alignment = “center”

Initialization

text¶: ‘Property(…)’

font_size¶: ‘Property(…)’

text_colour¶: ‘ThemeColour(…)’

bg_colour¶: ‘Colour(…)’

alignment¶: ‘Property(…)’

get_minimum_size() → simvx.core.math.types.Vec2[source]¶

draw(renderer)[source]¶

size_x¶: ‘Property(…)’

size_y¶: ‘Property(…)’

anchor_left¶: ‘Property(…)’

anchor_top¶: ‘Property(…)’

anchor_right¶: ‘Property(…)’

anchor_bottom¶: ‘Property(…)’

margin_left¶: ‘Property(…)’

margin_top¶: ‘Property(…)’

margin_right¶: ‘Property(…)’

margin_bottom¶: ‘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_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¶

property visible: bool¶

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¶

walk(*, include_self: bool = True) → collections.abc.Iterator[simvx.core.node.Node]¶

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¶

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

handle_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¶

__getitem__(key: str)¶

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

__repr__()¶

class simvx.core.ui.widgets.Button(text: str = 'Button', on_press=None, **kwargs)[source]¶

Bases: simvx.core.ui.core.Control

Clickable button with hover/press states.

Example: button = Button(“Click Me”, on_press=my_handler) button.pressed.connect(another_handler)

Initialization

class VisualState[source]¶

Bases: enum.StrEnum

Canonical Button visual states for theme resolution and overrides.

Initialization

Initialize self. See help(type(self)) for accurate signature.

NORMAL¶: ‘normal’

HOVER¶: ‘hover’

PRESSED¶: ‘pressed’

DISABLED¶: ‘disabled’

FOCUSED¶: ‘focused’

__new__(*values)¶

__add__()¶

__contains__()¶

__delattr__()¶

__dir__()¶

__eq__()¶

__format__()¶

__ge__()¶

__getattribute__()¶

__getitem__()¶

__getnewargs__()¶

__getstate__()¶

__gt__()¶

__hash__()¶

__iter__()¶

__le__()¶

__len__()¶

__lt__()¶

__mod__()¶

__mul__()¶

__ne__()¶

__reduce__()¶

__reduce_ex__()¶

__repr__()¶

__rmod__()¶

__rmul__()¶

__setattr__()¶

__sizeof__()¶

__str__()¶

__subclasshook__()¶

capitalize()¶

casefold()¶

center()¶

count()¶

encode()¶

endswith()¶

expandtabs()¶

find()¶

format()¶

format_map()¶

index()¶

isalnum()¶

isalpha()¶

isascii()¶

isdecimal()¶

isdigit()¶

isidentifier()¶

islower()¶

isnumeric()¶

isprintable()¶

isspace()¶

istitle()¶

isupper()¶

join()¶

ljust()¶

lower()¶

lstrip()¶

partition()¶

removeprefix()¶

removesuffix()¶

replace()¶

rfind()¶

rindex()¶

rjust()¶

rpartition()¶

rsplit()¶

rstrip()¶

split()¶

splitlines()¶

startswith()¶

strip()¶

swapcase()¶

title()¶

translate()¶

upper()¶

zfill()¶

__deepcopy__(memo)¶

__copy__()¶

name()¶

value()¶

text¶: ‘Property(…)’

font_size¶: ‘Property(…)’

style_normal¶: ‘ThemeStyleBox(…)’

style_hover¶: ‘ThemeStyleBox(…)’

style_pressed¶: ‘ThemeStyleBox(…)’

style_disabled¶: ‘ThemeStyleBox(…)’

style_focused¶: ‘ThemeStyleBox(…)’

text_colour¶: ‘ThemeColour(…)’

text_disabled_colour¶: ‘ThemeColour(…)’

bg_colour¶: ‘ThemeColour(…)’

hover_colour¶: ‘ThemeColour(…)’

pressed_colour¶: ‘ThemeColour(…)’

border_colour¶: ‘ThemeColour(…)’

property border_width[source]¶

property is_pressed: bool[source]¶: Whether the button is currently held down (mouse or touch).

property visual_state_override: simvx.core.ui.widgets.Button | None[source]¶: The forced visual state, or None if the button reflects its actual state.

set_visual_state_override(state: simvx.core.ui.widgets.Button | str | None) → None[source]¶

Force a specific visual state for theme/screenshot purposes.

Accepts a VisualState enum, the matching string (“normal”, “hover”, “pressed”, “disabled”, “focused”), or None to clear the override and revert to the actual interaction state.