pybevy 0.2.1

PyBevy: A Python Real-Time Engine Built on Bevy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

"""Demonstrates how to grab and hide the mouse cursor.

Demonstrates:
- Querying CursorOptions component from window
- Setting cursor visibility
- Cursor grab modes (None, Confined, Locked)
- Mouse button input handling
- Typical FPS-style mouse capture

This system grabs the mouse when the left mouse button is pressed
and releases it when the escape key is pressed.
"""

from pybevy.input import MouseInput
from pybevy.prelude import *
from pybevy.window import CursorGrabMode, CursorOptions


def grab_mouse(
    cursor_options: Single[Mut[CursorOptions]],
    mouse: Res[MouseInput],
    key: Res[ButtonInput],
) -> None:
    """Grab mouse on left click, release on Escape."""
    for opts in cursor_options:
        if mouse.just_pressed(MouseButton.Left()):
            opts.visible = False
            opts.grab_mode = CursorGrabMode.Locked

        if key.just_pressed(KeyCode.Escape):
            opts.visible = True
            # Note: Use getattr because 'None' is a Python keyword
            opts.grab_mode = getattr(CursorGrabMode, 'None')


@entrypoint
def main(app: App) -> App:
    return app.add_plugins(DefaultPlugins).add_systems(Update, grab_mouse)


if __name__ == "__main__":
    main().run()