X-Git-Url: https://git.ayoreis.com/hackapet/Adafruit_Blinka_Displayio.git/blobdiff_plain/03b2e1008f33585652fad5ecedad65d44694b2bc..0d243252f0fb3a3e200df404884e3cc7d872ee13:/displayio/_area.py

diff --git a/displayio/_area.py b/displayio/_area.py
index 8e50c85..5b96e93 100644
--- a/displayio/_area.py
+++ b/displayio/_area.py
@@ -20,11 +20,14 @@ Area for Blinka Displayio
 
 from __future__ import annotations
 
-__version__ = "0.0.0-auto.0"
+__version__ = "0.0.0+auto.0"
 __repo__ = "https://github.com/adafruit/Adafruit_Blinka_Displayio.git"
 
+
 class Area:
-    # pylint: disable=invalid-name,missing-function-docstring
+    """Area Class to represent an area to be updated."""
+
+    # pylint: disable=invalid-name
     def __init__(self, x1: int = 0, y1: int = 0, x2: int = 0, y2: int = 0):
         self.x1 = x1
         self.y1 = y1
@@ -53,7 +56,8 @@ class Area:
         self.x2 += dx
         self.y2 += dy
 
-    def _compute_overlap(self, other, overlap) -> bool:
+    def compute_overlap(self, other, overlap) -> bool:
+        """Compute the overlap between two areas. Returns True if there is an overlap."""
         a = self
         overlap.x1 = max(a.x1, other.x1)
         overlap.x2 = min(a.x2, other.x2)
@@ -76,12 +80,11 @@ class Area:
             self.y1, self.y2 = self.y2, self.y1
 
     def _union(self, other, union):
-        # pylint: disable=protected-access
         if self._empty():
             self._copy_into(union)
             return
-        if other._empty():
-            other._copy_into(union)
+        if other._empty():  # pylint: disable=protected-access
+            other._copy_into(union)  # pylint: disable=protected-access
             return
 
         union.x1 = min(self.x1, other.x1)
@@ -90,12 +93,15 @@ class Area:
         union.y2 = max(self.y2, other.y2)
 
     def width(self) -> int:
+        """Return the width of the area."""
         return self.x2 - self.x1
 
     def height(self) -> int:
+        """Return the height of the area."""
         return self.y2 - self.y1
 
     def size(self) -> int:
+        """Return the size of the area."""
         return self.width() * self.height()
 
     def __eq__(self, other):
@@ -110,7 +116,7 @@ class Area:
         )
 
     @staticmethod
-    def _transform_within(
+    def transform_within(
         mirror_x: bool,
         mirror_y: bool,
         transpose_xy: bool,
@@ -118,6 +124,7 @@ class Area:
         whole: Area,
         transformed: Area,
     ):
+        """Transform an area within a larger area."""
         # pylint: disable=too-many-arguments
         # Original and whole must be in the same coordinate space.
         if mirror_x: