Implement draw_triangle and draw_quad in pygame._sdl2

Author: avaxar

buildconfig/stubs/pygame/_sdl2/video.pyi

@@ -96,6 +96,33 @@ class Texture:
         flip_x: bool = False,
         flip_y: bool = False,
     ) -> None: ...
+    def draw_triangle(
+        self,
+        p1_xy,
+        p2_xy,
+        p3_xy,
+        p1_uv=(0.0, 0.0),
+        p2_uv=(1.0, 1.0),
+        p3_uv=(0.0, 1.0),
+        p1_mod=(255, 255, 255, 255),
+        p2_mod=(255, 255, 255, 255),
+        p3_mod=(255, 255, 255, 255),
+    ) -> None: ...
+    def draw_quad(
+        self,
+        p1_xy,
+        p2_xy,
+        p3_xy,
+        p4_xy,
+        p1_uv=(0.0, 0.0),
+        p2_uv=(1.0, 0.0),
+        p3_uv=(1.0, 1.0),
+        p4_uv=(0.0, 1.0),
+        p1_mod=(255, 255, 255, 255),
+        p2_mod=(255, 255, 255, 255),
+        p3_mod=(255, 255, 255, 255),
+        p4_mod=(255, 255, 255, 255),
+    ) -> None: ...
     def update(self, surface: Surface, area: Optional[RectValue] = None) -> None: ...
 
 class Image:
@@ -149,6 +176,18 @@ class Renderer:
     def draw_point(self, point: Iterable[int]) -> None: ...
     def draw_rect(self, rect: RectValue) -> None: ...
     def fill_rect(self, rect: RectValue) -> None: ...
+    def draw_triangle(
+        self, p1: Iterable[int], p2: Iterable[int], p3: Iterable[int]
+    ) -> None: ...
+    def fill_triangle(
+        self, p1: Iterable[int], p2: Iterable[int], p3: Iterable[int]
+    ) -> None: ...
+    def draw_quad(
+        self, p1: Iterable[int], p2: Iterable[int], p3: Iterable[int], p4: Iterable[int]
+    ) -> None: ...
+    def fill_quad(
+        self, p1: Iterable[int], p2: Iterable[int], p3: Iterable[int], p4: Iterable[int]
+    ) -> None: ...
     def to_surface(
         self, surface: Optional[Surface] = None, area: Optional[RectValue] = None
     ) -> Surface: ...

docs/reST/ref/sdl2_video.rst

@@ -178,6 +178,16 @@
       | :sl:`Copy a portion of the texture to the rendering target.`
       | :sg:`draw(srcrect=None, dstrect=None, angle=0, origin=None, flip_x=False, flip_y=False) -> None`
 
+   .. method:: draw_triangle
+
+      | :sl:`Copy a triangle portion of the texture to the rendering target by vertices coordinates.`
+      | :sg:`draw_triangle(p1_xy, p2_xy, p3_xy, p1_uv=(0.0, 0.0), p2_uv=(1.0, 1.0), p3_uv=(0.0, 1.0), p1_mod=(255, 255, 255, 255), p2_mod=(255, 255, 255, 255), p3_mod=(255, 255, 255, 255)) -> None`
+
+   .. method:: draw_quad
+
+      | :sl:`Copy a quad portion of the texture to the rendering target by vertices coordinates.`
+      | :sg:`draw_quad(p1_xy, p2_xy, p3_xy, p4_xy, p1_uv=(0.0, 0.0), p2_uv=(1.0, 0.0), p3_uv=(1.0, 1.0), p4_uv=(0.0, 1.0), p1_mod=(255, 255, 255, 255), p2_mod=(255, 255, 255, 255), p3_mod=(255, 255, 255, 255), p4_mod=(255, 255, 255, 255)) -> None`
+
    .. method:: update
 
       | :sl:`Update the texture with a Surface. WARNING: Slow operation, use sparingly.`
@@ -326,4 +336,24 @@
    .. method:: to_surface
 
       | :sl:`Read pixels from current render target and create a pygame.Surface. WARNING: Slow operation, use sparingly.`
-      | :sg:`to_surface(surface=None, area=None)-> Surface`
+      | :sg:`to_surface(surface=None, area=None)-> Surface`
+
+   .. method:: draw_triangle
+
+      | :sl:`Draws a triangle.`
+      | :sg:`draw_triangle(p1, p2, p3) -> None`
+
+   .. method:: fill_triangle
+
+      | :sl:`Fills a triangle.`
+      | :sg:`fill_triangle(p1, p2, p3) -> None`
+
+   .. method:: draw_quad
+
+      | :sl:`Draws a quad.`
+      | :sg:`draw_quad(p1, p2, p3, p4) -> None`
+
+   .. method:: fill_quad
+
+      | :sl:`Fills a quad.`
+      | :sg:`fill_quad(p1, p2, p3, p4) -> None`