mini-arcade-native-backend 0.4.6__cp310-cp310-win_amd64.whl → 0.5.3__cp310-cp310-win_amd64.whl

mini_arcade_native_backend/__init__.py

@@ -6,8 +6,9 @@ from __future__ import annotations
 
 import os
 import sys
+from dataclasses import dataclass
 from pathlib import Path
-from typing import Union
+from typing import Optional, Union
 
 # --- 1) Make sure Windows can find SDL2.dll when using vcpkg ------------------
 
@@ -37,13 +38,28 @@ if sys.platform == "win32":
 
 # Justification: Need to import core after setting DLL path on Windows
 # pylint: disable=wrong-import-position
-from mini_arcade_core.backend import Backend, Event, EventType
-from mini_arcade_core.keymaps.sdl import SDL_KEYCODE_TO_KEY
+# Justification: When mini-arcade-core is installed in editable mode, import-error
+# false positive can occur.
+# pylint: disable=import-error
+from mini_arcade_core.backend import (  # pyright: ignore[reportMissingImports]
+    Backend,
+    WindowSettings,
+)
+from mini_arcade_core.backend.events import (  # pyright: ignore[reportMissingImports]
+    Event,
+    EventType,
+)
+from mini_arcade_core.backend.sdl_map import (  # pyright: ignore[reportMissingImports]
+    SDL_KEYCODE_TO_KEY,
+)
 
 # Justification: Importing the native extension module
 # pylint: disable=import-self,no-name-in-module
 from . import _native as native
 
+# pylint: enable=import-error
+
+
 # --- 2) Now import core + define NativeBackend as before ---
 
 
@@ -65,23 +81,49 @@ _NATIVE_TO_CORE = {
 }
 
 
+@dataclass
+class BackendSettings:
+    """
+    Settings for the NativeBackend.
+
+    :ivar font_path (Optional[str]): Optional path to a TTF font file to load.
+    :ivar font_size (int): Font size in points to use when loading the font.
+    :ivar sounds (Optional[dict[str, str]]): Optional dictionary mapping sound IDs to file paths.
+    """
+
+    font_path: Optional[str] = None
+    font_size: int = 24
+    sounds: Optional[dict[str, str]] = None  # sound_id -> path
+
+
+# TODO: Refactor backend interface into smaller protocols?
+# Justification: Many public methods needed for backend interface
+# pylint: disable=too-many-public-methods,too-many-instance-attributes
 class NativeBackend(Backend):
     """Adapter that makes the C++ Engine usable as a mini-arcade backend."""
 
-    def __init__(self, font_path: str | None = None, font_size: int = 24):
+    def __init__(self, backend_settings: BackendSettings | None = None):
         """
-        :param font_path: Optional path to a TTF font file to load.
-        :type font_path: str | None
-
-        :param font_size: Font size in points to use when loading the font.
-        :type font_size: int
+        :param backend_settings: Optional settings for the backend.
+        :type backend_settings: BackendSettings | None
         """
         self._engine = native.Engine()
-        self._font_path = font_path
-        self._font_size = font_size
+
+        self._font_path = (
+            backend_settings.font_path if backend_settings else None
+        )
+        self._font_size = (
+            backend_settings.font_size if backend_settings else 24
+        )
         self._default_font_id: int | None = None
         self._fonts_by_size: dict[int, int] = {}
 
+        self._sounds = backend_settings.sounds if backend_settings else None
+
+        self._vp_offset_x = 0
+        self._vp_offset_y = 0
+        self._vp_scale = 1.0
+
     def _get_font_id(self, font_size: int | None) -> int:
         # No font loaded -> keep current “no-op” behavior
         if self._font_path is None:
@@ -108,20 +150,15 @@ class NativeBackend(Backend):
         self._fonts_by_size[font_size] = font_id
         return font_id
 
-    def init(self, width: int, height: int, title: str):
+    def init(self, window_settings: WindowSettings):
         """
         Initialize the backend with a window of given width, height, and title.
 
-        :param width: Width of the window in pixels.
-        :type width: int
-
-        :param height: Height of the window in pixels.
-        :type height: int
-
-        :param title: Title of the window.
-        :type title: str
+        :param window_settings: Settings for the backend window.
+        :type window_settings: WindowSettings
         """
-        self._engine.init(width, height, title)
+        title = ""
+        self._engine.init(window_settings.width, window_settings.height, title)
 
         # Load font if provided
         if self._font_path is not None:
@@ -130,6 +167,20 @@ class NativeBackend(Backend):
             )
             self._fonts_by_size[self._font_size] = self._default_font_id
 
+        # Load sounds if provided
+        if self._sounds is not None:
+            for sound_id, path in self._sounds.items():
+                self.load_sound(sound_id, path)
+
+    def set_window_title(self, title: str):
+        """
+        Set the window title.
+
+        :param title: Title of the window.
+        :type title: str
+        """
+        self._engine.set_window_title(title)
+
     def set_clear_color(self, r: int, g: int, b: int):
         """
         Set the background/clear color used by begin_frame.
@@ -303,7 +354,12 @@ class NativeBackend(Backend):
         :type color: tuple[int, ...]
         """
         r, g, b, a = self._get_color_values(color)
-        self._engine.draw_rect(x, y, w, h, r, g, b, a)
+        sx = int(round(self._vp_offset_x + x * self._vp_scale))  # top-left x
+        sy = int(round(self._vp_offset_y + y * self._vp_scale))  # top-left y
+        sw = int(round(w * self._vp_scale))  # width
+        sh = int(round(h * self._vp_scale))  # height
+        self._engine.draw_rect(sx, sy, sw, sh, r, g, b, a)
+        # self._engine.draw_rect(x, y, w, h, r, g, b, a)
 
     def draw_text(
         self,
@@ -331,9 +387,22 @@ class NativeBackend(Backend):
         """
         r, g, b, a = self._get_color_values(color)
         font_id = self._get_font_id(font_size)
+        sx = int(round(self._vp_offset_x + x * self._vp_scale))
+        sy = int(round(self._vp_offset_y + y * self._vp_scale))
+
+        # optional but recommended: scale font size too
+        if font_size is not None:
+            scaled = max(8, int(round(font_size * self._vp_scale)))
+        else:
+            scaled = None
+
+        font_id = self._get_font_id(scaled)
         self._engine.draw_text(
-            text, x, y, int(r), int(g), int(b), int(a), font_id
+            text, sx, sy, int(r), int(g), int(b), int(a), font_id
         )
+        # self._engine.draw_text(
+        #     text, x, y, int(r), int(g), int(b), int(a), font_id
+        # )
 
     # pylint: enable=too-many-arguments,too-many-positional-arguments
 
@@ -363,3 +432,73 @@ class NativeBackend(Backend):
         font_id = self._get_font_id(font_size)
         w, h = self._engine.measure_text(text, font_id)
         return int(w), int(h)
+
+    def init_audio(
+        self, frequency: int = 44100, channels: int = 2, chunk_size: int = 2048
+    ):
+        """Initialize SDL_mixer audio."""
+        self._engine.init_audio(int(frequency), int(channels), int(chunk_size))
+
+    def shutdown_audio(self):
+        """Shutdown SDL_mixer audio and free loaded sounds."""
+        self._engine.shutdown_audio()
+
+    def load_sound(self, sound_id: str, path: str):
+        """
+        Load a WAV sound and store it by ID.
+        Example: backend.load_sound("hit", "assets/sfx/hit.wav")
+        """
+        if not sound_id:
+            raise ValueError("sound_id cannot be empty")
+
+        p = Path(path)
+        if not p.exists():
+            raise FileNotFoundError(f"Sound file not found: {p}")
+
+        self._engine.load_sound(sound_id, str(p))
+
+    def play_sound(self, sound_id: str, loops: int = 0):
+        """
+        Play a loaded sound.
+        loops=0 => play once
+        loops=-1 => infinite loop
+        loops=1 => play twice (SDL convention)
+        """
+        self._engine.play_sound(sound_id, int(loops))
+
+    def set_master_volume(self, volume: int):
+        """
+        Master volume: 0..128
+        """
+        self._engine.set_master_volume(int(volume))
+
+    def set_sound_volume(self, sound_id: str, volume: int):
+        """
+        Per-sound volume: 0..128
+        """
+        self._engine.set_sound_volume(sound_id, int(volume))
+
+    def stop_all_sounds(self):
+        """Stop all channels."""
+        self._engine.stop_all_sounds()
+
+    def set_viewport_transform(
+        self, offset_x: int, offset_y: int, scale: float
+    ) -> None:
+        self._vp_offset_x = int(offset_x)
+        self._vp_offset_y = int(offset_y)
+        self._vp_scale = float(scale)
+
+    def clear_viewport_transform(self) -> None:
+        self._vp_offset_x = 0
+        self._vp_offset_y = 0
+        self._vp_scale = 1.0
+
+    def resize_window(self, width: int, height: int) -> None:
+        self._engine.resize_window(int(width), int(height))
+
+    def set_clip_rect(self, x: int, y: int, w: int, h: int) -> None:
+        self._engine.set_clip_rect(int(x), int(y), int(w), int(h))
+
+    def clear_clip_rect(self) -> None:
+        self._engine.clear_clip_rect()

{mini_arcade_native_backend-0.4.6.dist-info → mini_arcade_native_backend-0.5.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: mini-arcade-native-backend
-Version: 0.4.6
+Version: 0.5.3
 Summary: Native SDL2 backend for mini-arcade-core using SDL2 + pybind11.
 Author-Email: Santiago Rincon <rincores@gmail.com>
 License: Copyright (c) 2025 Santiago Rincón
@@ -24,7 +24,7 @@ License: Copyright (c) 2025 Santiago Rincón
            SOFTWARE.
          
 Requires-Python: <3.12,>=3.9
-Requires-Dist: mini-arcade-core~=0.10
+Requires-Dist: mini-arcade-core~=1.0
 Provides-Extra: dev
 Requires-Dist: pytest~=8.3; extra == "dev"
 Requires-Dist: pytest-cov~=6.0; extra == "dev"

mini_arcade_native_backend-0.5.3.dist-info/RECORD

@@ -0,0 +1,6 @@
+mini_arcade_native_backend/__init__.py,sha256=eguv2ESm07S1h8beSRfKKhMFBywfpsUlo-3forhhCoc,16809
+mini_arcade_native_backend/_native.cp310-win_amd64.pyd,sha256=RdVjaGR589_NHqKLYkwZvhO0FU7iME3OB7dH1o_Uckk,227328
+mini_arcade_native_backend-0.5.3.dist-info/METADATA,sha256=Br3ckI1QZuE2tgZ7eKIgkQf_g8z-b69kdcQIe8k4SSs,10517
+mini_arcade_native_backend-0.5.3.dist-info/WHEEL,sha256=hrGeChGtn46HBGmzasO9QQDSLelRN-tUarBSv4gFcsI,106
+mini_arcade_native_backend-0.5.3.dist-info/licenses/LICENSE,sha256=cZRgTdRJ3YASekMxkGAvylB2nROh4ov228DxAogK3yY,1115
+mini_arcade_native_backend-0.5.3.dist-info/RECORD,,

mini_arcade_native_backend-0.4.6.dist-info/RECORD

@@ -1,6 +0,0 @@
-mini_arcade_native_backend/__init__.py,sha256=dUcIJJBR6TLFvhjQdNoA-CoT3l6nntrxzhwYvGOkg40,12005
-mini_arcade_native_backend/_native.cp310-win_amd64.pyd,sha256=wGkC8dY6iEGXZOgFdSesFiRAPnZOQ1LX7oW18cZXbPA,212992
-mini_arcade_native_backend-0.4.6.dist-info/METADATA,sha256=rBo0xnG-rqR-gnANDoASoZq5rsZzaWv6SDoBYACXB9Q,10518
-mini_arcade_native_backend-0.4.6.dist-info/WHEEL,sha256=hrGeChGtn46HBGmzasO9QQDSLelRN-tUarBSv4gFcsI,106
-mini_arcade_native_backend-0.4.6.dist-info/licenses/LICENSE,sha256=cZRgTdRJ3YASekMxkGAvylB2nROh4ov228DxAogK3yY,1115
-mini_arcade_native_backend-0.4.6.dist-info/RECORD,,