The Rect, Pt. II: The Rect-oning and the Vec-oning

arcade/__init__.py

@@ -218,6 +218,8 @@ def configure_logging(level: Optional[int] = None):
 
 from .camera import Camera2D
 
+from .types.rect import Rect, LRBT, LBWH, XYWH
+
 # Module imports
 from arcade import color as color
 from arcade import csscolor as csscolor
@@ -231,6 +233,9 @@ def configure_logging(level: Optional[int] = None):
 from arcade import experimental as experimental
 from arcade.types import rect
 
+# For ease of access for beginners
+from pyglet.math import Vec2, Vec3, Vec4
+
 from .text import (
     draw_text,
     load_font,
@@ -261,6 +266,10 @@ def configure_logging(level: Optional[int] = None):
     'PymunkException',
     'PymunkPhysicsEngine',
     'PymunkPhysicsObject',
+    'Rect',
+    'LBWH',
+    'LRBT',
+    'XYWH',
     'Section',
     'SectionManager',
     'Scene',
@@ -280,6 +289,9 @@ def configure_logging(level: Optional[int] = None):
     'TextureAtlas',
     'TileMap',
     'VERSION',
+    'Vec2',
+    'Vec3',
+    'Vec4',
     'View',
     'Window',
     'astar_calculate_path',

arcade/application.py

@@ -22,6 +22,7 @@
 from arcade.context import ArcadeContext
 from arcade.types import Color, RGBOrA255, RGBANormalized
 from arcade import SectionManager
+from arcade.types.rect import LBWH, Rect
 from arcade.utils import is_raspberry_pi
 
 LOG = logging.getLogger(__name__)
@@ -315,6 +316,11 @@ def background_color(self) -> Color:
     def background_color(self, value: RGBOrA255):
         self._background_color = Color.from_iterable(value)
 
+    @property
+    def rect(self) -> Rect:
+        """Return a Rect describing the size of the window."""
+        return LBWH(0, 0, self.width, self.height)
+
     def run(self) -> None:
         """
         Run the main loop.

arcade/cache/hit_box.py

@@ -16,7 +16,7 @@
 from typing import Optional, Union, TYPE_CHECKING
 from collections import OrderedDict
 
-from arcade.types import PointList
+from arcade.types import Point2List
 from arcade.resources import resolve
 
 if TYPE_CHECKING:
@@ -36,15 +36,15 @@ class HitBoxCache:
     VERSION = 1
 
     def __init__(self):
-        self._entries: OrderedDict[str, PointList] = OrderedDict()
+        self._entries: OrderedDict[str, Point2List] = OrderedDict()
 
     def __len__(self) -> int:
         return len(self._entries)
 
     def __iter__(self):
         return iter(self._entries)
 
-    def get(self, name_or_texture: Union[str, "Texture"]) -> Optional[PointList]:
+    def get(self, name_or_texture: Union[str, "Texture"]) -> Optional[Point2List]:
         """
         Get the hit box points for a texture with a given hash
         and hit box algorithm.
@@ -68,7 +68,7 @@ def get(self, name_or_texture: Union[str, "Texture"]) -> Optional[PointList]:
         else:
             raise TypeError(f"Expected str or Texture: {name_or_texture}")
 
-    def put(self, name_or_texture: Union[str, "Texture"], points: PointList) -> None:
+    def put(self, name_or_texture: Union[str, "Texture"], points: Point2List) -> None:
         """
         Store hit box points for a texture.