Mouse

Functions for handling mouse input and cursor state.

Get Pos


get_pos() → tuple[float, float]

Get the current position of the mouse cursor.

Returns

tuple[float, float] : The current mouse position as (x, y) coordinates.

Get Rel


get_rel() → tuple[float, float]

Get the relative mouse movement since the last frame.

Returns

tuple[float, float] : The relative movement of the mouse as (dx, dy).

Is Pressed


is_pressed(button: MouseButton) → bool

Check if a mouse button is currently pressed.

Parameters

  • button : The mouse button to check.

Returns

bool : True if the button is currently pressed.

Is Just Pressed


is_just_pressed(button: MouseButton) → bool

Check if a mouse button was pressed this frame.

Parameters

  • button : The mouse button to check.

Returns

bool : True if the button was just pressed.

Is Just Released


is_just_released(button: MouseButton) → bool

Check if a mouse button was released this frame.

Parameters

  • button : The mouse button to check.

Returns

bool : True if the button is currently pressed.

Lock


lock() → None

Lock the mouse to the center of the window.

Useful for first-person controls where you want to capture mouse movement without letting the cursor leave the window area.

Unlock


unlock() → None

Unlock the mouse from the window, allowing it to move freely.

Is Locked


is_locked() → bool

Check if the mouse is currently locked to the window.

Returns

bool : True if the mouse is locked.

Hide


hide() → None

Hide the mouse cursor from view.

The cursor will be invisible but mouse input will still be tracked.

Show


show() → None

Show the mouse cursor if it was hidden.

Is Hidden


is_hidden() → bool

Check if the mouse cursor is currently hidden.

Returns

bool : True if the cursor is hidden.