Add draw.aapolygon

buildconfig/stubs/pygame/draw.pyi

@@ -21,6 +21,12 @@ def polygon(
     points: SequenceLike[Coordinate],
     width: int = 0,
 ) -> Rect: ...
+def aapolygon(
+    surface: Surface,
+    color: ColorLike,
+    points: SequenceLike[Coordinate],
+    filled: bool = True,
+) -> Rect: ...
 def circle(
     surface: Surface,
     color: ColorLike,

docs/reST/ref/code_examples/draw_module_example.py

@@ -65,9 +65,16 @@
     # Draw an solid ellipse, using a rectangle as the outside boundaries
     pygame.draw.ellipse(screen, "red", [300, 10, 50, 20])
 
-    # This draws a triangle using the polygon command
+    # Draw a triangle using the polygon command
     pygame.draw.polygon(screen, "black", [[100, 100], [0, 200], [200, 200]], 5)
 
+    # Draw an antialiased polygon
+    pygame.draw.aapolygon(
+        screen,
+        "black",
+        [[100, 40], [150, 75], [110, 60], [70, 70]]
+    )
+
     # Draw an arc as part of an ellipse.
     # Use radians to determine what angle to draw.
     pygame.draw.arc(screen, "black", [210, 75, 150, 125], 0, pi / 2, 2)

docs/reST/ref/draw.rst

@@ -147,6 +147,46 @@ object around the draw calls (see :func:`pygame.Surface.lock` and
 
    .. ## pygame.draw.polygon ##
 
+.. function:: aapolygon
+
+   | :sl:`draw an antialiased polygon`
+   | :sg:`aapolygon(surface, color, points) -> Rect`
+   | :sg:`aapolygon(surface, color, points, filled=True) -> Rect`
+
+   Draws an antialiased polygon on the given surface.
+
+   :param Surface surface: surface to draw on
+   :param color: color to draw with, the alpha value is optional if using a
+      tuple ``(RGB[A])``
+   :type color: Color or string (for :doc:`color_list`) or int or tuple(int, int, int, [int])
+   :param points: a sequence of 3 or more (x, y) coordinates that make up the
+      vertices of the polygon, each *coordinate* in the sequence must be a
+      tuple/list/:class:`pygame.math.Vector2` of 2 ints/floats,
+      e.g. ``[(x1, y1), (x2, y2), (x3, y3)]``
+   :type points: tuple(coordinate) or list(coordinate)
+   :param int filled: (optional) used to indicate that the polygon is to be filled
+
+         | if filled == True, (default) fill the polygon
+         | if filled == False, don't fill the polygon
+         |
+
+   :returns: a rect bounding the changed pixels, if nothing is drawn the
+      bounding rect's position will be the position of the first point in the
+      ``points`` parameter (float values will be truncated) and its width and
+      height will be 0
+   :rtype: Rect
+
+   :raises ValueError: if ``len(points) < 3`` (must have at least 3 points)
+   :raises TypeError: if ``points`` is not a sequence or ``points`` does not
+      contain number pairs
+
+   .. note::
+       For an aapolygon, use :func:`aalines()` with ``closed=True``.
+
+   .. versionadded:: 2.6.0
+
+   .. ## pygame.draw.aapolygon ##
+
 .. function:: circle
 
    | :sl:`draw a circle`

src_c/doc/draw_doc.h

@@ -2,6 +2,7 @@
 #define DOC_DRAW "pygame module for drawing shapes"
 #define DOC_DRAW_RECT "rect(surface, color, rect) -> Rect\nrect(surface, color, rect, width=0, border_radius=0, border_top_left_radius=-1, border_top_right_radius=-1, border_bottom_left_radius=-1, border_bottom_right_radius=-1) -> Rect\ndraw a rectangle"
 #define DOC_DRAW_POLYGON "polygon(surface, color, points) -> Rect\npolygon(surface, color, points, width=0) -> Rect\ndraw a polygon"
+#define DOC_DRAW_AAPOLYGON "aapolygon(surface, color, points) -> Rect\naapolygon(surface, color, points, filled=True) -> Rect\ndraw an antialiased polygon"
 #define DOC_DRAW_CIRCLE "circle(surface, color, center, radius) -> Rect\ncircle(surface, color, center, radius, width=0, draw_top_right=None, draw_top_left=None, draw_bottom_left=None, draw_bottom_right=None) -> Rect\ndraw a circle"
 #define DOC_DRAW_AACIRCLE "aacircle(surface, color, center, radius) -> Rect\naacircle(surface, color, center, radius, width=0, draw_top_right=None, draw_top_left=None, draw_bottom_left=None, draw_bottom_right=None) -> Rect\ndraw an antialiased circle"
 #define DOC_DRAW_ELLIPSE "ellipse(surface, color, rect) -> Rect\nellipse(surface, color, rect, width=0) -> Rect\ndraw an ellipse"