controller.py

lunaengine/backend/controller.py

Advanced game controller support with hot‑plug, multiple controllers,
gyro, touchpad, mouse emulation, and input source detection.

class ControllerType

Description

No documentation

Attributes
XBOX: Any = auto()
PLAYSTATION: Any = auto()
NINTENDO_SWITCH: Any = auto()
GENERIC: Any = auto()
Methods

No methods defined.

class ConnectionType

Description

No documentation

Attributes
USB: Any = auto()
BLUETOOTH: Any = auto()
WIRELESS_DONGLE: Any = auto()
UNKNOWN: Any = auto()
Methods

No methods defined.

class JButton

Description

No documentation

Attributes
A: Any = auto()
B: Any = auto()
X: Any = auto()
Y: Any = auto()
BACK: Any = auto()
GUIDE: Any = auto()
START: Any = auto()
LEFT_STICK: Any = auto()
RIGHT_STICK: Any = auto()
LEFT_BUMPER: Any = auto()
RIGHT_BUMPER: Any = auto()
DPAD_UP: Any = auto()
DPAD_DOWN: Any = auto()
DPAD_LEFT: Any = auto()
DPAD_RIGHT: Any = auto()
CROSS: Any = A
CIRCLE: Any = B
SQUARE: Any = X
TRIANGLE: Any = Y
SHARE: Any = BACK
OPTIONS: Any = START
TOUCHPAD: Any = auto()
Methods

No methods defined.

class Axis

Description

No documentation

Attributes
LEFT_X: Any = auto()
LEFT_Y: Any = auto()
RIGHT_X: Any = auto()
RIGHT_Y: Any = auto()
LEFT_TRIGGER: Any = auto()
RIGHT_TRIGGER: Any = auto()
GYRO_X: Any = auto()
GYRO_Y: Any = auto()
GYRO_Z: Any = auto()
ACCEL_X: Any = auto()
ACCEL_Y: Any = auto()
ACCEL_Z: Any = auto()
Methods

No methods defined.

class TouchPoint

Description

No documentation

Attributes
x: float = None
y: float = None
pressure: float = None
finger_id: int = None
Methods

No methods defined.

class ControllerState

Description

No documentation

Attributes
buttons: Dict[JButton, bool] = field(default_factory=dict)
axes: Dict[Axis, float] = field(default_factory=dict)
hat: Tuple[float, float] = (0.0, 0.0)
touch_points: List[TouchPoint] = field(default_factory=list)
gyro: Tuple[float, float, float] = (0.0, 0.0, 0.0)
accelerometer: Tuple[float, float, float] = (0.0, 0.0, 0.0)
last_button_time: Dict[JButton, float] = field(default_factory=dict)
Methods

No methods defined.

class Controller

Description

No documentation

Attributes
_XBOX_IDS: Any = {'xbox', 'x-box', 'microsoft', 'xinput'}
_PS_IDS: Any = {'playstation', 'ps4', 'ps5', 'sony', 'dualshock', 'dualsense', 'wireless controller'}
_NINTENDO_IDS: Any = {'nintendo', 'switch', 'pro controller'}
Methods
def __init__(self: Any, joystick_id: int, manager: 'ControllerManager') -> Any
No documentation
def _open(self: Any) -> Any
No documentation
def _detect_type(self: Any) -> Any
No documentation
def _guess_connection_type(self: Any) -> Any
No documentation
def _build_default_maps(self: Any) -> Any
Build button and axis maps based on detected controller type.
def _build_xbox_map(self: Any) -> Any
No documentation
def _build_playstation_map(self: Any) -> Any
No documentation
def _build_switch_map(self: Any) -> Any
No documentation
def _build_generic_map(self: Any) -> Any
No documentation
def _detect_touchpad(self: Any) -> Any
For PlayStation controllers, try to find a second joystick that handles touchpad.
def _check_rumble(self: Any) -> Any
No documentation
def update(self: Any, events: List[pygame.event.Event]) -> Any
No documentation
def _handle_axis_event(self: Any, event: Any) -> Any
No documentation
def _handle_button_event(self: Any, event: Any, pressed: Any) -> Any
No documentation
def _handle_hat_event(self: Any, event: Any) -> Any
No documentation
def _poll_axes(self: Any) -> Any
No documentation
def _apply_deadzone(self: Any) -> Any
No documentation
def _update_mouse_emulation(self: Any) -> Any
No documentation
def remap_button(self: Any, logical: JButton, raw_index: int) -> Any
No documentation
def remap_axis(self: Any, logical: Axis, raw_index: int, invert: bool = False) -> Any
No documentation
def set_deadzone(self: Any, value: float) -> Any
No documentation
def rumble(self: Any, low: float, high: float, duration_ms: int) -> bool
No documentation
def stop_rumble(self: Any) -> Any
No documentation
def get_guid(self: Any) -> str
No documentation
def get_name(self: Any) -> str
No documentation
def is_connected(self: Any) -> bool
No documentation
def close(self: Any) -> Any
No documentation
def get_button_pressed(self: Any, button: JButton) -> bool
No documentation
def get_axis(self: Any, axis: Axis) -> float
No documentation
def get_hat(self: Any) -> Tuple[float, float]
No documentation
def get_touch_points(self: Any) -> List[TouchPoint]
Read touch points from the touchpad joystick (if any).
def __repr__(self: Any) -> Any
No documentation

class ControllerManager

Description

Manages multiple controllers, detects hot‑plug events, and tracks
which input device (keyboard/mouse vs. controller) was last used.

Methods
def __init__(self: Any, engine: Optional['LunaEngine'] = None) -> Any
No documentation
def scan_controllers(self: Any) -> Any
No documentation
def handle_events(self: Any, events: List[pygame.event.Event]) -> Any
Process device events and update controllers.
Also tracks last input time for source detection.
def get_active_source(self: Any) -> str
Return 'keyboard', 'mouse', or 'controller'.
def is_using_controller(self: Any) -> bool
Convenience: whether a controller was used recently.
def get_controller(self: Any, index: int) -> Optional[Controller]
No documentation
def get_controllers_by_type(self: Any, ctype: ControllerType) -> List[Controller]
No documentation
def get_all_controllers(self: Any) -> List[Controller]
No documentation
def get_first_connected(self: Any) -> Optional[Controller]
Return the first (lowest index) connected controller.
def set_mouse_emulation(self: Any, enabled: bool, controller_index: Optional[int] = None) -> Any
No documentation
def shutdown(self: Any) -> Any
No documentation
def __len__(self: Any) -> int
No documentation
Back to Backend Module