Mouse

Mouse state singleton for position and button state.

Overview

Mouse is a singleton object that provides real-time access to mouse state including position, button states, and cursor properties. Use it to poll mouse state outside of event callbacks or to control cursor visibility and grabbing.

Quick Reference

# Check mouse position
x, y = mcrfpy.Mouse.pos
print(f"Mouse at ({x}, {y})")

# Check button states
if mcrfpy.Mouse.left:
    print("Left button is held")

# Hide cursor for custom cursor sprite
mcrfpy.Mouse.visible = False

# Grab mouse for camera control
mcrfpy.Mouse.grabbed = True

Properties

Position

Property	Type	Description
`pos`	tuple[int, int]	Current mouse position (x, y) (read-only)
`x`	int	Current mouse X position (read-only)
`y`	int	Current mouse Y position (read-only)

Button States

Property	Type	Description
`left`	bool	True if left button is held (read-only)
`middle`	bool	True if middle button is held (read-only)
`right`	bool	True if right button is held (read-only)

Cursor Control

Property	Type	Description
`visible`	bool	Show/hide system cursor (read-write)
`grabbed`	bool	Lock cursor to window (read-write)

Usage Patterns

Custom Cursor

# Create a custom cursor sprite
cursor = mcrfpy.Sprite(texture=cursor_texture)
scene.children.append(cursor)

# Hide system cursor
mcrfpy.Mouse.visible = False

# Update cursor position each frame
def update(dt):
    cursor.x, cursor.y = mcrfpy.Mouse.pos

First-Person Camera

# Grab mouse for FPS-style camera
mcrfpy.Mouse.grabbed = True
mcrfpy.Mouse.visible = False

def handle_mouse_move(x, y, dx, dy):
    camera.rotate(dx * sensitivity, dy * sensitivity)

Drag Detection

drag_start = None

def on_mouse(button, state, x, y):
    global drag_start
    if button == mcrfpy.MouseButton.LEFT:
        if state == mcrfpy.InputState.PRESSED:
            drag_start = (x, y)
        else:
            if drag_start:
                print(f"Dragged from {drag_start} to ({x}, {y})")
            drag_start = None