simvx.editor.panels.properties

Inspector Panel: property editor for the selected node.

Reads Property descriptors from the selected node’s class hierarchy and creates appropriate editor widgets (Slider, SpinBox, CheckBox, DropDown, TextEdit, ColourPicker) for each property. All property changes go through the undo system via PropertyCommand.

Layout:

+---------------------------------------+
| TypeName  [ Convert to Custom Class ] |
| Name: [ editable name field         ] |
+---------------------------------------+
| v Class                               |
|   <module path>                       |
|   <file path:line>  [ Edit ]          |
+---------------------------------------+
| v Instance                            |
|   Visible  [x]                        |
|   Position X [  ] Y [  ] Z [  ]       |
|   speed   [=====|-------] 5.0         |
+---------------------------------------+

The Class section auto-collapses to a single “Built-in” line when the node’s class lives under simvx.core.* (the header’s “Convert to Custom Class” button carries the only actionable affordance in that case). For user-defined subclasses it surfaces an “Edit class file” button that calls state.workspace.open_file(path, line=...).

The Instance section header is suppressed when the underlying node has no displayable property groups (e.g. plain Node without any descriptors).

The section-building logic lives behind this facade in two private siblings: _properties_class_section (Class metadata + Convert-to-Custom-Class) and _properties_instance_section (per-node editable sections, property handlers, and section management). They are mixed into PropertiesPanel, so all methods remain on the class.

Module Contents

Classes

PropertiesPanel

Property editor panel for the currently selected node.

API

class simvx.editor.panels.properties.PropertiesPanel(editor_state=None, **kwargs)

Bases: simvx.editor.panels._properties_class_section._ClassSectionMixin, simvx.editor.panels._properties_instance_section._InstanceSectionMixin, simvx.core.Control

Property editor panel for the currently selected node.

Subscribes to state.selection_changed and rebuilds its contents whenever the selection changes. Each Property on the selected node is mapped to an appropriate editor widget. Property edits are pushed to the undo stack as PropertyCommand instances.

Args: editor_state: The central State instance.

Initialization

property_changed

‘Signal(…)’

size_x

‘Property(…)’

size_y

‘Property(…)’

on_ready()

Connect to editor state signals.

inspect(node: simvx.core.Node | None)

Public API: display properties for the given node (or clear if None).

mark_layout_dirty() → None

Flag the panel for reflow on the next SceneTree.flush_layout.

Mirrors Container’s contract so this custom-layout Control rides the one invalidation path (size on_change + flush) instead of a per-frame size poll.

on_draw(renderer)

min_size_x

‘Property(…)’

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

anchor

‘Property(…)’

inset

‘Property(…)’

dismiss_on_outside_click

‘Property(…)’

clip_contents

‘Property(…)’

focus_mode

‘Property(…)’

tooltip

‘Property(…)’

pointer_filter

‘Property(…)’

cursor_shape

‘Property(…)’

pointer_types: frozenset[simvx.core.input.enums.PointerType] | None

None

touch_target: bool

False

property wants_text_input: bool

size_flags_horizontal

‘Property(…)’

size_flags_vertical

‘Property(…)’

stretch_ratio

‘Property(…)’

max_size

‘Property(…)’

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

property min_size: simvx.core.math.types.Vec2

content_signature() → object

content_uses(chars: str) → bool

autosize_to_content() → None

accepts_pointers

‘Property(…)’

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

property mouse_over: bool

property disabled: bool

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

property viewport_size: simvx.core.math.types.Vec2

property viewport_insets: tuple[float, float, float, float]

queue_redraw()

size_floor() → tuple[float, float]

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

add_child(node: simvx.core.node.T) → simvx.core.node.T

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

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

property focus_rect: tuple[float, float, float, float] | None

is_point_inside(point) → bool

is_hit(event: simvx.core.input.events.PointerEvent) → bool

classmethod __init_subclass__(**kwargs)

activate() → bool

focus_next_control()

focus_previous_control()

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

property is_overlay_open: bool

show_overlay(modality: str = 'light', *, dim: bool | None = None, dismiss: bool | None = None, inert: bool | None = None, owner: simvx.core.ui.core.Control | None = None, initial_focus: simvx.core.ui.core.Control | None = None) → None

close_overlay() → None

position

‘_SpatialVecProperty(…)’

rotation

‘Property(…)’

scale

‘_SpatialVecProperty(…)’

top_level

‘Property(…)’

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 rotation_degrees: float

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

property world_rotation: float

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

property world_transform: tuple[simvx.core.math.types.Vec2, simvx.core.math.types.Vec2, float]

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)

to_global(point) → simvx.core.math.types.Vec2

to_local(point) → simvx.core.math.types.Vec2

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

wrap_screen(margin: float = 20)

post_processed

‘Property(…)’

property transform_render_dirty: bool

strict_errors: ClassVar[bool]

True

dev_checks: ClassVar[bool]

None

dev_warnings: ClassVar[bool]

None

freeze_check_interval: ClassVar[float]

1.0

dynamic: bool

False

visible

‘Property(…)’

update_mode

‘Property(…)’

drag_threshold

‘Property(…)’

focus_entered

‘Signal(…)’

focus_exited

‘Signal(…)’

__properties__: ClassVar[dict[str, simvx.core.descriptors.Property]]

None

property name: str

property visible_in_tree: bool

property input_player: simvx.core.input.players.InputPlayer

property input_context: simvx.core.input.contexts.InputContext | None

reset_error() → None

remove_child(node: simvx.core.node.Node) → None

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

node_at(path, default=_NO_DEFAULT)

find(target, *, direct: bool = False)

find_all(target, *, direct: bool = False)

expect(target, *, direct: bool = False)

ancestor(target)

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

property path: str

property is_scene_root: bool

add_to_group(group: str)

remove_from_group(group: str)

is_in_group(group: str) → bool

on_enter_tree() → None

on_exit_tree() → None

on_update(dt: float) → None

on_fixed_update(dt: float) → None

on_draw_3d(gizmos) → None

on_picked(event: simvx.core.input.events.PickEvent) → bool | None

on_gui_input(event: simvx.core.input.events.GuiInputEvent) → bool | None

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

stop_coroutine(gen_or_handle)

property focused: bool

drag_threshold_for(pointer_type: simvx.core.input.enums.PointerType | str) → float

grab_focus() → None

release_focus() → None

capture_pointer(pointer_id: int | None = None) → None

release_pointer(pointer_id: int | None = None) → None

property render_dirty: bool

clear_children()

destroy()

property destroying: bool

property destroyed: bool

call_deferred(method: collections.abc.Callable[..., Any], *args: Any) → None

property app

property tree: simvx.core.scene_tree.SceneTree

property physics

property physics_2d

__getitem__(key: str)

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

__repr__()