`simvx.core.ui.core`¶

Core UI types: Control, Theme, Colour, UIInputEvent, FocusMode, AnchorPreset, SizeFlags, DragData.

Module Contents¶

Classes¶

Control

Base class for all UI elements.

Data¶

`log`
`__all__`

API¶

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

simvx.core.ui.core.__all__¶: [‘Control’, ‘Theme’, ‘ThemeColour’, ‘ThemeSize’, ‘ThemeStyleBox’, ‘Colour’, ‘UIInputEvent’, ‘FocusMo…

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

Bases: simvx.core.nodes_2d.node2d.Node2D

Base class for all UI elements.

Supports anchors, margins, sizing, focus, drag-and-drop, and input handling. Widgets draw themselves using the renderer passed to draw().

Example: control = Control(name=”panel”) control.size = Vec2(200, 100) control.set_anchor_preset(AnchorPreset.FULL_RECT)

Initialization

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(…)’

dismiss_on_outside_click¶: ‘Property(…)’

property size: simvx.core.math.types.Vec2[source]¶: Size backed by size_x/size_y Properties (inspector-synced).

touch_mode: str¶: ‘mouse’

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

property mouse_over: bool[source]¶

property focused: bool[source]¶

property disabled: bool[source]¶

get_theme() → simvx.core.ui.types.Theme[source]¶: Get effective theme (own -> parent -> default).

queue_redraw()[source]¶

Mark this control as needing a redraw. Propagates upward to parent.

Extends :meth:Drawable2D.queue_redraw additively: it sets the item-pipeline render-dirty bit (read by the item RenderItemCache, P2) AND keeps the _draw_dirty/_DrawRecorder cache path (read by the Draw2D _draw_recursive walk the editor play-mode game viewport + web runtime still use).

get_minimum_size() → simvx.core.math.types.Vec2[source]¶: Minimum size needed to display content. Subclasses override.

get_rect() → tuple[float, float, float, float][source]¶: Get (x, y, width, height) in parent space.

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

Get (x, y, width, height) in screen space.

Uses axis-aligned position accumulation (no rotation/scale) since UI controls are always axis-aligned rectangles. Result is cached per-frame and auto-expires when the frame counter advances.

is_point_inside(point) → bool[source]¶: Check if point (screen coords) is inside this control.

place_bottom_strip(height: float) → None[source]¶

Anchor this control as a full-width horizontal strip at the bottom.

Equivalent to set_anchor_preset(AnchorPreset.BOTTOM_WIDE) plus margin_top = -height. The negative-margin convention is correct but surprising; this shortcut makes intent obvious.

place_top_strip(height: float) → None[source]¶: Anchor this control as a full-width horizontal strip at the top.

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

Set anchors from a preset.

Example: panel.set_anchor_preset(AnchorPreset.FULL_RECT) # fills parent label.set_anchor_preset(AnchorPreset.CENTER) # centered

set_focus()[source]¶: Request focus for this control.

grab_focus()[source]¶

Claim keyboard focus for this control.

Unfocuses the currently focused control (if any) and sets focus to this one. Respects focus_mode: NONE-mode controls cannot receive focus.

release_focus()[source]¶: Release focus from this control.

has_focus() → bool[source]¶: Return True if this control currently has keyboard focus.

focus_next_control()[source]¶: Move focus to next control in tab order.

focus_previous_control()[source]¶: Move focus to previous control in tab order.

grab_mouse()[source]¶: Capture mouse – all mouse events route to this control until released.

release_mouse()[source]¶: Release mouse capture.

set_drag_preview(control: simvx.core.ui.core.Control)[source]¶: Set a visual preview control for the current drag operation.

property is_overlay_open: bool[source]¶: True while this control is registered as an open overlay.

modality is one of "none" / "light" / "blocking" (design §0 preset table). dim / dismiss / inert (None = preset default) override individual flags. owner is the logical chain owner for whole-chain dismissal + input scope (e.g. a MenuBar for its dropdown + submenu overlays); defaults to self. initial_focus is the descendant to focus when the overlay is capturing (None = the first focusable descendant). Positioning is the widget’s own job: position first, then call show_overlay to register.

close_overlay() → None[source]¶

Pop this control (and its open chain) from the overlay registry. Idempotent.

Mirrors :meth:show_overlay, which sets visible = True: closing hides the control again so a persistent (non-freed) overlay – a reused title/menu screen – stops drawing over the scene once dismissed. A consumer that frees its overlay on close is unaffected (the hide is harmless); one that reuses it gets visible = True back on the next show_overlay.