target_finder_toolkit.mouse_utils module

Utilities to manage system cursor visibility and mouse acceleration.

This module exposes a minimal, public helper API used by the two example interaction techniques (Bubble Cursor and Semantic Pointing):

  • hide_cursor_everywhere() / restore_default_cursors():

    Hide/show the system cursor globally (platform-specific).

  • disable_mouse_acceleration() / restore_mouse_acceleration():

    Disable/restore OS mouse acceleration (platform-specific).

Notes

  • Windows: uses User32 APIs to replace system cursors and writes registry keys to control acceleration.

  • Linux (X11): uses XFixes to hide/show the cursor and xinput to flip accel profiles (libinput/evdev). Wayland is not supported here.

  • macOS: currently no-op stubs (could be implemented via Quartz/Cocoa).

target_finder_toolkit.mouse_utils.create_blank_cursor()
target_finder_toolkit.mouse_utils.hide_cursor_everywhere()
target_finder_toolkit.mouse_utils.restore_default_cursors()
target_finder_toolkit.mouse_utils.disable_mouse_acceleration()
target_finder_toolkit.mouse_utils.restore_mouse_acceleration()