add sensitivity property. add docstrings to more properties

Author: FoamyGuy

adafruit_usb_host_mouse.py

@@ -127,15 +127,27 @@ class BootMouse:
     :param endpoint_address: The address of the mouse endpoint
     :param tilegrid: The TileGrid that holds the visible mouse cursor
     :param was_attached: Whether the usb device was attached to the kernel
+    :param scale: The scale of the group that the Mouse TileGrid will be put into.
+      Needed in order to properly clamp the mouse to the display bounds
     """
 
     def __init__(self, device, endpoint_address, tilegrid, was_attached, scale=1):  # noqa: PLR0913, too many args
         self.device = device
+
         self.tilegrid = tilegrid
+        """TileGrid containing the Mouse cursor graphic."""
+
         self.endpoint = endpoint_address
         self.buffer = array.array("b", [0] * 4)
         self.was_attached = was_attached
+
         self.scale = scale
+        """The scale of the group that the Mouse TileGrid will be put into.
+Needed in order to properly clamp the mouse to the display bounds."""
+
+        self.sensitivity = 1
+        """The sensitivity of the mouse cursor. Larger values will make
+the mouse cursor move slower relative to physical mouse movement. Default is 1."""
 
         self.display_size = (supervisor.runtime.display.width, supervisor.runtime.display.height)
 
@@ -191,10 +203,18 @@ def update(self):
         # update the mouse tilegrid x and y coordinates
         # based on the delta values read from the mouse
         self.tilegrid.x = max(
-            0, min((self.display_size[0] // self.scale) - 1, self.tilegrid.x + self.buffer[1])
+            0,
+            min(
+                (self.display_size[0] // self.scale) - 1,
+                self.tilegrid.x + (self.buffer[1] // self.sensitivity),
+            ),
         )
         self.tilegrid.y = max(
-            0, min((self.display_size[1] // self.scale) - 1, self.tilegrid.y + self.buffer[2])
+            0,
+            min(
+                (self.display_size[1] // self.scale) - 1,
+                self.tilegrid.y + (self.buffer[2] // self.sensitivity),
+            ),
         )
 
         pressed_btns = []