`simvx.editor.panels.project_settings`¶

Project Settings Panel – Editor UI for project configuration.

Provides a categorized settings dialog that reads and writes project configuration to project.simvx (JSON format). Covers display, input mapping, physics, rendering, and autoload settings.

Layout: +———————————————+ | Project Settings [Save] [Revert] | |———————————————| | v Display | | Resolution W [1280] H [ 720] | | Fullscreen [ ] VSync [x] | | MSAA [4x v] | |———————————————| | v Input Map | | move_left [A] [+] [-] | | move_right [D] [+] [-] | | jump [Space] [+] [-] | | [+ Add Action] | |———————————————| | v Physics | | Gravity [===|——-] 9.8 | | Physics FPS [=|——–] 60 | |———————————————| | v Rendering | | Bloom [ ] Shadows [x] | | Shadow Res [1024 v] | |———————————————| | v Autoload | | GlobalAudio res://audio_manager.py [x] | | [+ Add Autoload] [Up] [Down] | +———————————————+

Module Contents¶

Classes¶

`InputAction`	A single input action with bound keys/buttons.
`AutoloadEntry`	An autoload script entry.
`ProjectConfig`	Full project configuration stored in project.simvx (JSON).
`ProjectSettingsPanel`	Project settings editor panel.

Data¶

`log`
`__all__`

API¶

simvx.editor.panels.project_settings.log¶: ‘getLogger(…)’

simvx.editor.panels.project_settings.__all__¶: [‘ProjectSettingsPanel’, ‘ProjectConfig’]

class simvx.editor.panels.project_settings.InputAction¶

A single input action with bound keys/buttons.

name: str¶: None

keys: list[str]¶: ‘field(…)’

to_dict() → dict¶

classmethod from_dict(data: dict) → simvx.editor.panels.project_settings.InputAction¶

class simvx.editor.panels.project_settings.AutoloadEntry¶

An autoload script entry.

name: str¶: None

path: str¶: None

enabled: bool¶: True

to_dict() → dict¶

classmethod from_dict(data: dict) → simvx.editor.panels.project_settings.AutoloadEntry¶

class simvx.editor.panels.project_settings.ProjectConfig¶

Full project configuration stored in project.simvx (JSON).

window_width: int¶: 1280

window_height: int¶: 720

fullscreen: bool¶: False

vsync: bool¶: True

msaa: int¶: 4

gravity: float¶: 9.8

physics_fps: int¶: 60

bloom_enabled: bool¶: False

shadows_enabled: bool¶: True

shadow_resolution: int¶: 1024

input_actions: list[simvx.editor.panels.project_settings.InputAction]¶: ‘field(…)’

autoloads: list[simvx.editor.panels.project_settings.AutoloadEntry]¶: ‘field(…)’

project_name: str¶: ‘Untitled’

default_scene: str = <Multiline-String>¶

to_dict() → dict¶

classmethod from_dict(data: dict) → simvx.editor.panels.project_settings.ProjectConfig¶

save(path: str | pathlib.Path) → bool¶: Write config to a JSON file.

classmethod load(path: str | pathlib.Path) → simvx.editor.panels.project_settings.ProjectConfig | None¶: Load config from a JSON file.

class simvx.editor.panels.project_settings.ProjectSettingsPanel(editor_state=None, config: simvx.editor.panels.project_settings.ProjectConfig | None = None, **kwargs)¶

Bases: simvx.core.Control

Project settings editor panel.

Reads/writes project configuration to project.simvx (JSON format). Categories: Display, Input Map, Physics, Rendering, Autoload.

Args: editor_state: The central EditorState (optional). config: An existing ProjectConfig to edit (creates new if None).

Initialization

mark_dirty()¶

revert()¶: Revert to the last saved state.

save(path: str | pathlib.Path)¶: Save settings to disk.

load(path: str | pathlib.Path) → bool¶: Load settings from disk.

add_input_action(name: str) → simvx.editor.panels.project_settings.InputAction¶: Add a new input action.

remove_input_action(name: str) → bool¶: Remove an input action by name.

bind_key(action_name: str, key: str) → bool¶: Bind a key to an input action.

unbind_key(action_name: str, key: str) → bool¶: Unbind a key from an input action.

add_autoload(name: str, path: str) → simvx.editor.panels.project_settings.AutoloadEntry¶: Add an autoload entry.

remove_autoload(name: str) → bool¶: Remove an autoload by name.

reorder_autoload(name: str, direction: int) → bool¶: Move an autoload up (-1) or down (+1).

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__()¶