Final exam version

venv/lib/python3.12/site-packages/pygame/surface.pyi

@@ -0,0 +1,149 @@
+from typing import Any, List, Optional, Sequence, Tuple, Union, overload
+
+from pygame.bufferproxy import BufferProxy
+from pygame.color import Color
+from pygame.rect import Rect
+
+from ._common import ColorValue, Coordinate, Literal, RectValue, RGBAOutput
+
+_ViewKind = Literal[
+    "0",
+    "1",
+    "2",
+    "3",
+    b"0",
+    b"1",
+    b"2",
+    b"3",
+    "r",
+    "g",
+    "b",
+    "a",
+    "R",
+    "G",
+    "B",
+    "A",
+    b"r",
+    b"g",
+    b"b",
+    b"a",
+    b"R",
+    b"G",
+    b"B",
+    b"A",
+]
+
+class Surface:
+    _pixels_address: int
+    @overload
+    def __init__(
+        self,
+        size: Coordinate,
+        flags: int = 0,
+        depth: int = 0,
+        masks: Optional[ColorValue] = None,
+    ) -> None: ...
+    @overload
+    def __init__(
+        self,
+        size: Coordinate,
+        flags: int = 0,
+        surface: Surface = ...,
+    ) -> None: ...
+    def __copy__(self) -> Surface: ...
+    copy = __copy__
+    def blit(
+        self,
+        source: Surface,
+        dest: Union[Coordinate, RectValue],
+        area: Optional[RectValue] = None,
+        special_flags: int = 0,
+    ) -> Rect: ...
+    def blits(
+        self,
+        blit_sequence: Sequence[
+            Union[
+                Tuple[Surface, Union[Coordinate, RectValue]],
+                Tuple[Surface, Union[Coordinate, RectValue], Union[RectValue, int]],
+                Tuple[Surface, Union[Coordinate, RectValue], RectValue, int],
+            ]
+        ],
+        doreturn: Union[int, bool] = 1,
+    ) -> Union[List[Rect], None]: ...
+    @overload
+    def convert(self, surface: Surface) -> Surface: ...
+    @overload
+    def convert(self, depth: int, flags: int = 0) -> Surface: ...
+    @overload
+    def convert(self, masks: ColorValue, flags: int = 0) -> Surface: ...
+    @overload
+    def convert(self) -> Surface: ...
+    @overload
+    def convert_alpha(self, surface: Surface) -> Surface: ...
+    @overload
+    def convert_alpha(self) -> Surface: ...
+    def fill(
+        self,
+        color: ColorValue,
+        rect: Optional[RectValue] = None,
+        special_flags: int = 0,
+    ) -> Rect: ...
+    def scroll(self, dx: int = 0, dy: int = 0) -> None: ...
+    @overload
+    def set_colorkey(self, color: ColorValue, flags: int = 0) -> None: ...
+    @overload
+    def set_colorkey(self, color: None) -> None: ...
+    def get_colorkey(self) -> Optional[RGBAOutput]: ...
+    @overload
+    def set_alpha(self, value: int, flags: int = 0) -> None: ...
+    @overload
+    def set_alpha(self, value: None) -> None: ...
+    def get_alpha(self) -> Optional[int]: ...
+    def lock(self) -> None: ...
+    def unlock(self) -> None: ...
+    def mustlock(self) -> bool: ...
+    def get_locked(self) -> bool: ...
+    def get_locks(self) -> Tuple[Any, ...]: ...
+    def get_at(self, x_y: Sequence[int]) -> Color: ...
+    def set_at(self, x_y: Sequence[int], color: ColorValue) -> None: ...
+    def get_at_mapped(self, x_y: Sequence[int]) -> int: ...
+    def get_palette(self) -> List[Color]: ...
+    def get_palette_at(self, index: int) -> Color: ...
+    def set_palette(self, palette: Sequence[ColorValue]) -> None: ...
+    def set_palette_at(self, index: int, color: ColorValue) -> None: ...
+    def map_rgb(self, color: ColorValue) -> int: ...
+    def unmap_rgb(self, mapped_int: int) -> Color: ...
+    def set_clip(self, rect: Optional[RectValue]) -> None: ...
+    def get_clip(self) -> Rect: ...
+    @overload
+    def subsurface(self, rect: RectValue) -> Surface: ...
+    @overload
+    def subsurface(self, left_top: Coordinate, width_height: Coordinate) -> Surface: ...
+    @overload
+    def subsurface(
+        self, left: float, top: float, width: float, height: float
+    ) -> Surface: ...
+    def get_parent(self) -> Surface: ...
+    def get_abs_parent(self) -> Surface: ...
+    def get_offset(self) -> Tuple[int, int]: ...
+    def get_abs_offset(self) -> Tuple[int, int]: ...
+    def get_size(self) -> Tuple[int, int]: ...
+    def get_width(self) -> int: ...
+    def get_height(self) -> int: ...
+    def get_rect(self, **kwargs: Any) -> Rect: ...
+    def get_bitsize(self) -> int: ...
+    def get_bytesize(self) -> int: ...
+    def get_flags(self) -> int: ...
+    def get_pitch(self) -> int: ...
+    def get_masks(self) -> RGBAOutput: ...
+    def set_masks(self, color: ColorValue) -> None: ...
+    def get_shifts(self) -> RGBAOutput: ...
+    def set_shifts(self, color: ColorValue) -> None: ...
+    def get_losses(self) -> RGBAOutput: ...
+    def get_bounding_rect(self, min_alpha: int = 1) -> Rect: ...
+    def get_view(self, kind: _ViewKind = "2") -> BufferProxy: ...
+    def get_buffer(self) -> BufferProxy: ...
+    def get_blendmode(self) -> int: ...
+    def premul_alpha(self) -> Surface: ...
+
+SurfaceType = Surface