target_finder_toolkit.bubblecursor module¶
Bubble Cursor Demo¶
This module demonstrates the Bubble Cursor interaction technique using the TargetFinder toolkit.
Notes
This script is for demonstration purposes only.
It is not part of the core TargetFinder API, but shows how the toolkit can be used for novel interaction techniques.
- target_finder_toolkit.bubblecursor.bubble_cursor(detector)¶
Launch the Bubble Cursor overlay.
This replaces the system cursor with a dynamic “bubble” that expands to always contain the closest widget detected by
TargetFinder.- Parameters:
detector (TargetFinder) – Initialized detector (YOLO model loaded).
- Returns:
Blocks until the Qt application is closed.
- Return type:
None
- target_finder_toolkit.bubblecursor.main()¶
Command-line entry point for the Bubble Cursor demo.
- CLI arguments:
- -model-path (str, optional): Path to YOLO .pt weights.
Defaults to
best.ptin the package.
- -change-thresh (int, optional): Threshold for screen change detection.
Higher = less sensitive. Default =
100.
- -capture-interval (float, optional): Delay in seconds between captures.
Lower = higher refresh rate, more CPU/GPU usage. Default =
1/30.
- -confidence (float, optional): YOLO confidence threshold in
[0, 1]. Default =
0.28.
- -confidence (float, optional): YOLO confidence threshold in
- -iou (float, optional): IoU threshold for YOLO NMS in
[0, 1]. Controls overlap merging. Default =
0.3.
- -iou (float, optional): IoU threshold for YOLO NMS in
- Keyboard shortcuts:
b: Toggle between the Bubble Cursor and the normal system cursor.
q: Quit the program.
Example:
bubblecursor --change-thresh 200 --confidence 0.3 --iou 0.4- Returns:
Starts the Qt event loop until exit.