simvx.core.ui.advanced

Advanced widgets – CheckBox, SpinBox, DropDown.

Module Contents

Classes

CheckBox

Toggle control with a check box and label text.

SpinBox

Numeric input with increment/decrement buttons.

DropDown

Drop-down selection from a list of items.

Data

__all__

API

simvx.core.ui.advanced.__all__

[‘CheckBox’, ‘SpinBox’, ‘DropDown’]

class simvx.core.ui.advanced.CheckBox(text: str = '', checked: bool = False, on_toggle=None, **kwargs)

Bases: simvx.core.ui.core.Control

Toggle control with a check box and label text.

Example: cb = CheckBox(“Enable Feature”, checked=True) cb.toggled.connect(lambda on: print(“Checked:”, on))

Initialization

text

‘Property(…)’

text_color

‘ThemeColour(…)’

check_color

‘ThemeColour(…)’

box_color

‘ThemeColour(…)’

hover_color

‘ThemeColour(…)’

draw(renderer)
size_x

‘Property(…)’

size_y

‘Property(…)’

property size: simvx.core.math.types.Vec2
get_theme() → simvx.core.ui.core.Theme
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.core.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(…)’

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 global_position: simvx.core.math.types.Vec2
property global_rotation: float
property global_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, color=None)
wrap_screen(margin: float = 20)
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) → 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)
destroy()
queue_free

None

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]
get_settings

None

__repr__()
class simvx.core.ui.advanced.SpinBox(min_val: float = 0, max_val: float = 100, value: float = 0, step: float = 1, **kwargs)

Bases: simvx.core.ui.core.Control

Numeric input with increment/decrement buttons.

Example: spin = SpinBox(min_val=0, max_val=100, value=50, step=5) spin.value_changed.connect(lambda v: print(“Value:”, v))

Initialization

min_value

‘Property(…)’

max_value

‘Property(…)’

value

‘Property(…)’

text_color

‘ThemeColour(…)’

bg_color

‘ThemeColour(…)’

border_color

‘ThemeColour(…)’

button_color

‘ThemeColour(…)’

button_hover_color

‘ThemeColour(…)’

arrow_color

‘ThemeColour(…)’

focus_color

‘ThemeColour(…)’

draw(renderer)
size_x

‘Property(…)’

size_y

‘Property(…)’

property size: simvx.core.math.types.Vec2
get_theme() → simvx.core.ui.core.Theme
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.core.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(…)’

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 global_position: simvx.core.math.types.Vec2
property global_rotation: float
property global_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, color=None)
wrap_screen(margin: float = 20)
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) → 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)
destroy()
queue_free

None

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]
get_settings

None

__repr__()
class simvx.core.ui.advanced.DropDown(items: list[str] = None, selected: int = 0, **kwargs)

Bases: simvx.core.ui.core.Control

Drop-down selection from a list of items.

Example: dd = DropDown(items=[“Low”, “Medium”, “High”], selected=1) dd.item_selected.connect(lambda idx: print(“Selected:”, idx))

Initialization

text_color

‘ThemeColour(…)’

bg_color

‘ThemeColour(…)’

hover_color

‘ThemeColour(…)’

border_color

‘ThemeColour(…)’

item_bg_color

‘ThemeColour(…)’

item_hover_color

‘ThemeColour(…)’

arrow_color

‘ThemeColour(…)’

property selected_text: str

Currently selected item text.

is_popup_point_inside(point) → bool
popup_input(event)
dismiss_popup()
draw(renderer)
draw_popup(renderer)

Draw the dropdown list as an overlay (on top of everything).

size_x

‘Property(…)’

size_y

‘Property(…)’

property size: simvx.core.math.types.Vec2
get_theme() → simvx.core.ui.core.Theme
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.core.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)
z_index

‘Property(…)’

z_as_relative

‘Property(…)’

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 global_position: simvx.core.math.types.Vec2
property global_rotation: float
property global_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, color=None)
wrap_screen(margin: float = 20)
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) → 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)
destroy()
queue_free

None

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]
get_settings

None

__repr__()