Port SDL3 texture scale mode

Author: HexDecimal

.vscode/settings.json

@@ -348,6 +348,7 @@
         "PERLIN",
         "PILCROW",
         "pilmode",
+        "PIXELART",
         "PIXELFORMAT",
         "PLUSMINUS",
         "pointsize",
@@ -401,6 +402,7 @@
         "rtype",
         "RWIN",
         "RWOPS",
+        "SCALEMODE",
         "scalex",
         "scaley",
         "Scancode",

CHANGELOG.md

@@ -6,6 +6,10 @@ This project adheres to [Semantic Versioning](https://semver.org/) since version
 
 ## [Unreleased]
 
+### Added
+
+- `tcod.sdl.render`: Added `ScaleMode` enum and `Texture.scale_mode` attribute.
+
 ## [19.2.0] - 2025-07-20
 
 ### Added

tcod/sdl/render.py

@@ -141,6 +141,19 @@ class BlendMode(enum.IntEnum):
     """"""
 
 
+class ScaleMode(enum.IntEnum):
+    """Texture scaling modes.
+
+    .. versionadded:: unreleased
+    """
+
+    NEAREST = lib.SDL_SCALEMODE_NEAREST
+    """Nearing neighbor."""
+    LINEAR = lib.SDL_SCALEMODE_LINEAR
+    """Linier filtering."""
+    # PIXELART = lib.SDL_SCALEMODE_PIXELART  # Needs SDL 3.4 # noqa: ERA001
+
+
 def compose_blend_mode(  # noqa: PLR0913
     source_color_factor: BlendFactor,
     dest_color_factor: BlendFactor,
@@ -254,6 +267,20 @@ def color_mod(self) -> tuple[int, int, int]:
     def color_mod(self, rgb: tuple[int, int, int]) -> None:
         _check(lib.SDL_SetTextureColorMod(self.p, rgb[0], rgb[1], rgb[2]))
 
+    @property
+    def scale_mode(self) -> ScaleMode:
+        """Get or set this textures :any:`ScaleMode`.
+
+        ..versionadded:: unreleased
+        """
+        mode = ffi.new("SDL_ScaleMode*")
+        _check(lib.SDL_GetTextureScaleMode(self.p, mode))
+        return ScaleMode(mode[0])
+
+    @scale_mode.setter
+    def scale_mode(self, value: ScaleMode, /) -> None:
+        _check(lib.SDL_SetTextureScaleMode(self.p, value))
+
 
 class _RestoreTargetContext:
     """A context manager which tracks the current render target and restores it on exiting."""

tests/test_sdl.py

@@ -70,6 +70,7 @@ def test_sdl_render(uses_window: None) -> None:
     rgb.alpha_mod = rgb.alpha_mod
     rgb.blend_mode = rgb.blend_mode
     rgb.color_mod = rgb.color_mod
+    rgb.scale_mode = rgb.scale_mode
     rgba = render.upload_texture(np.zeros((8, 8, 4), np.uint8), access=tcod.sdl.render.TextureAccess.TARGET)
     with render.set_render_target(rgba):
         render.copy(rgb)