fix: improve mouse movement.

upon start of the program, move the mouse cursor to the center of the screen because the it give a better refrence for the mouse movements.

Author: Ahwar

.vscode/launch.json

@@ -13,7 +13,8 @@
  "python": "D:/ahar/Computer-Pointer-Controller-with-Eyes/.venv/Scripts/python.exe",
  "args": [
  "-i",
- "bin/face.png",
+ // "bin/face.png", // for single image
+ "CAM",
  "-ftm",
  "bin/models/face-detection-retail-0004.xml",
  "-ldm",

lib/mouse_controller.py

@@ -1,11 +1,32 @@
 """
-This is a sample class that you can use to control the mouse pointer.
-It uses the pyautogui library. You can set the precision for mouse movement
-(how much the mouse moves) and the speed (how fast it moves) by changing
-precision_dict and speed_dict.
-Calling the move function with the x and y output of the gaze estimation model
-will move the pointer.
-This class is provided to help get you started; you can choose whether you want to use it or create your own from scratch.
+Mouse controller utilities built on top of pyautogui.
+
+Provides a lightweight MouseController class to drive the system pointer using
+relative movements that are scaled by a precision factor and animated over a
+configurable duration. This is useful for driving the pointer from gaze- or
+pose-estimation outputs where you receive small x, y offsets.
+
+Constructor presets (string keys accepted):
+- precision: "high" (100), "medium" (500), "low" (1000)
+- speed: "fast" (1), "medium" (5), "slow" (10)
+
+API summary:
+- MouseController.move(x, y)
+ Move the pointer by (x * precision, -y * precision). Note the y value is
+ negated internally to accommodate screen coordinate orientation.
+- MouseController.move_to_center()
+ Move the pointer to the center of the primary screen using the same scaling.
+
+Notes and requirements:
+- This module disables pyautogui.FAILSAFE by default. Re-enable it if you want
+ the corner-escape behavior.
+- Install pyautogui before use.
+- Interpret x and y according to your gaze model (e.g., normalized offsets,
+ pixel deltas, etc.) and tune precision/speed presets accordingly.
+
+Example:
+ mc = MouseController(precision="medium", speed="fast")
+ mc.move(0.1, -0.05) # relative movement scaled by precision
 """
 
 import pyautogui
@@ -25,3 +46,16 @@ def move(self, x, y):
  pyautogui.moveRel(
  x * self.precision, -1 * y * self.precision, duration=self.speed
  )
+
+ def move_to_center(self):
+ w, h = pyautogui.size()
+ cx, cy = w // 2, h // 2
+ cur_x, cur_y = pyautogui.position()
+
+ # required inputs for mc.move
+ dx = (cx - cur_x) / self.precision
+ dy = (
+ cur_y - cy
+ ) / self.precision # invert because MouseController.move negates y internally
+
+ self.move(dx, dy)

main.py

@@ -260,7 +260,6 @@ def rectange_eyes(frame, face_coords, eye_coords):
 
  print("New mouse coordinates: {}\n\n".format(mouse_coords))
  ### Move Mouse
- mouse_controler = MouseController("medium", "fast")
  mouse_controler.move(mouse_coords[0], mouse_coords[1])
  # go to next frame