mini-arcade-native-backend 0.4.1__cp310-cp310-win_amd64.whl → 0.4.3__cp310-cp310-win_amd64.whl

mini_arcade_native_backend/__init__.py

@@ -7,6 +7,7 @@ from __future__ import annotations
 import os
 import sys
 from pathlib import Path
+from typing import Union
 
 # --- 1) Make sure Windows can find SDL2.dll when using vcpkg ------------------
 
@@ -37,6 +38,7 @@ if sys.platform == "win32":
 # Justification: Need to import core after setting DLL path on Windows
 # pylint: disable=wrong-import-position
 from mini_arcade_core import Backend, Event, EventType
+from mini_arcade_core.keymaps.sdl import SDL_KEYCODE_TO_KEY
 
 # Justification: Importing the native extension module
 # pylint: disable=import-self,no-name-in-module
@@ -47,6 +49,7 @@ from . import _native as native
 
 __all__ = ["NativeBackend", "native"]
 
+Alpha = Union[float, int]
 
 _NATIVE_TO_CORE = {
     native.EventType.Unknown: EventType.UNKNOWN,
@@ -127,34 +130,64 @@ class NativeBackend(Backend):
         for ev in self._engine.poll_events():
             etype = _NATIVE_TO_CORE.get(ev.type, EventType.UNKNOWN)
 
-            # "0 means not present" convention from C++ side
-            key = ev.key if getattr(ev, "key", 0) != 0 else None
+            key = None
+            key_code = None
+            scancode = None
+            mod = None
+            repeat = None
+
+            x = y = dx = dy = None
+            button = None
+            wheel = None
+            size = None
+            text = None
+
+            if etype in (EventType.KEYDOWN, EventType.KEYUP):
+                raw_key = int(getattr(ev, "key", 0) or 0)
+                key_code = raw_key if raw_key != 0 else None
+                key = SDL_KEYCODE_TO_KEY.get(raw_key) if raw_key != 0 else None
+
+                scancode = (
+                    int(ev.scancode) if getattr(ev, "scancode", 0) else None
+                )
+                mod = int(ev.mod) if getattr(ev, "mod", 0) else None
+
+                rep = int(getattr(ev, "repeat", 0) or 0)
+                repeat = bool(rep) if etype == EventType.KEYDOWN else None
 
-            x = getattr(ev, "x", 0) or None
-            y = getattr(ev, "y", 0) or None
-            dx = getattr(ev, "dx", 0) or None
-            dy = getattr(ev, "dy", 0) or None
-            button = getattr(ev, "button", 0) or None
+            elif etype == EventType.MOUSEMOTION:
+                x = int(ev.x)
+                y = int(ev.y)
+                dx = int(ev.dx)
+                dy = int(ev.dy)
 
-            wheel_x = getattr(ev, "wheel_x", 0)
-            wheel_y = getattr(ev, "wheel_y", 0)
-            wheel = (wheel_x, wheel_y) if (wheel_x or wheel_y) else None
+            elif etype in (EventType.MOUSEBUTTONDOWN, EventType.MOUSEBUTTONUP):
+                button = int(ev.button) if ev.button else None
+                x = int(ev.x)
+                y = int(ev.y)
 
-            w = getattr(ev, "width", 0)
-            h = getattr(ev, "height", 0)
-            size = (w, h) if (w and h) else None
+            elif etype == EventType.MOUSEWHEEL:
+                wx = int(ev.wheel_x)
+                wy = int(ev.wheel_y)
+                wheel = (wx, wy) if (wx or wy) else None
 
-            text = getattr(ev, "text", "") or None
+            elif etype == EventType.WINDOWRESIZED:
+                w = int(ev.width)
+                h = int(ev.height)
+                size = (w, h) if (w and h) else None
 
-            scancode = getattr(ev, "scancode", 0) or None
-            mod = getattr(ev, "mod", 0) or None
-            repeat_raw = getattr(ev, "repeat", 0)
-            repeat = bool(repeat_raw) if repeat_raw else None
+            elif etype == EventType.TEXTINPUT:
+                t = getattr(ev, "text", "")
+                text = t if t else None
 
             out.append(
                 Event(
                     type=etype,
                     key=key,
+                    key_code=key_code,
+                    scancode=scancode,
+                    mod=mod,
+                    repeat=repeat,
                     x=x,
                     y=y,
                     dx=dx,
@@ -163,9 +196,6 @@ class NativeBackend(Backend):
                     wheel=wheel,
                     size=size,
                     text=text,
-                    scancode=scancode,
-                    mod=mod,
-                    repeat=repeat,
                 )
             )
         return out
@@ -180,6 +210,43 @@ class NativeBackend(Backend):
         """End the current frame for rendering."""
         self._engine.end_frame()
 
+    @staticmethod
+    def _alpha_to_u8(alpha: Alpha | None) -> int:
+        """Convert CSS-like alpha (0..1) to uint8 (0..255)."""
+        if alpha is None:
+            return 255
+
+        # disallow booleans (since bool is a subclass of int)
+        if isinstance(alpha, bool):
+            raise TypeError("alpha must be a float in [0,1], not bool")
+
+        a = float(alpha)
+
+        # Enforce “percentage only”
+        if a < 0.0 or a > 1.0:
+            raise ValueError(f"alpha must be in [0, 1], got {alpha!r}")
+
+        return int(round(a * 255))
+
+    @staticmethod
+    def _get_color_values(color: tuple[int, ...]) -> int:
+        """
+        Extract alpha value from color tuple (r,g,b) or (r,g,b,a).
+        If missing, returns default.
+        """
+        if len(color) == 3:
+            r, g, b = color
+            a_u8 = 255
+        elif len(color) == 4:
+            r, g, b, a = color
+            a_u8 = NativeBackend._alpha_to_u8(a)
+        else:
+            raise ValueError(
+                f"Color must be (r,g,b) or (r,g,b,a), got {color!r}"
+            )
+
+        return (int(r), int(g), int(b), a_u8)
+
     # pylint: disable=too-many-arguments,too-many-positional-arguments
     def draw_rect(
         self,
@@ -207,16 +274,8 @@ class NativeBackend(Backend):
         :param color: Color of the rectangle as (r, g, b) or (r, g, b, a).
         :type color: tuple[int, ...]
         """
-        if len(color) == 3:
-            r, g, b = color
-            self._engine.draw_rect(x, y, w, h, r, g, b)
-        elif len(color) == 4:
-            r, g, b, a = color
-            self._engine.draw_rect_rgba(x, y, w, h, r, g, b, a)
-        else:
-            raise ValueError(
-                f"Color must be (r,g,b) or (r,g,b,a), got {color!r}"
-            )
+        r, g, b, a = self._get_color_values(color)
+        self._engine.draw_rect(x, y, w, h, r, g, b, a)
 
     # pylint: enable=too-many-arguments,too-many-positional-arguments
 
@@ -243,12 +302,13 @@ class NativeBackend(Backend):
         :param color: Color of the text as (r, g, b).
         :type color: tuple[int, int, int]
         """
-        # We rely on C++ side to no-op if font is missing
-        r, g, b = color
+        r, g, b, a = self._get_color_values(color)
         font_id = (
             self._default_font_id if self._default_font_id is not None else -1
         )
-        self._engine.draw_text(text, x, y, int(r), int(g), int(b), font_id)
+        self._engine.draw_text(
+            text, x, y, int(r), int(g), int(b), int(a), font_id
+        )
 
     def capture_frame(self, path: str | None = None) -> bool:
         """
@@ -261,4 +321,6 @@ class NativeBackend(Backend):
             False otherwise.
         :rtype: bool
         """
+        if path is None:
+            raise ValueError("Path must be provided to capture frame.")
         return self._engine.capture_frame(path)

{mini_arcade_native_backend-0.4.1.dist-info → mini_arcade_native_backend-0.4.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: mini-arcade-native-backend
-Version: 0.4.1
+Version: 0.4.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

mini_arcade_native_backend-0.4.3.dist-info/RECORD

@@ -0,0 +1,6 @@
+mini_arcade_native_backend/__init__.py,sha256=WqN_5T1kSebFrH3JXrx1JjXO0xxRNOA_kHZjddpfuEs,10658
+mini_arcade_native_backend/_native.cp310-win_amd64.pyd,sha256=VZQ6leqH1y066D63lyu8ibxxlbXhSZ_As_BMBjvI4A0,210944
+mini_arcade_native_backend-0.4.3.dist-info/METADATA,sha256=QyzQk63DFSOd3Bf1HVqVJHx40JnJFB1OlYIxsL9y2PA,10517
+mini_arcade_native_backend-0.4.3.dist-info/WHEEL,sha256=hrGeChGtn46HBGmzasO9QQDSLelRN-tUarBSv4gFcsI,106
+mini_arcade_native_backend-0.4.3.dist-info/licenses/LICENSE,sha256=cZRgTdRJ3YASekMxkGAvylB2nROh4ov228DxAogK3yY,1115
+mini_arcade_native_backend-0.4.3.dist-info/RECORD,,

mini_arcade_native_backend-0.4.1.dist-info/RECORD

@@ -1,6 +0,0 @@
-mini_arcade_native_backend/__init__.py,sha256=CISb6F09IyBc8xg5gEoiG5hUgBjCSOtkw-4SNNzQMLM,8699
-mini_arcade_native_backend/_native.cp310-win_amd64.pyd,sha256=K4A__UwqSLkrx7YRmE3mw2xMgfYZlZBwbucB9ypPmVg,212480
-mini_arcade_native_backend-0.4.1.dist-info/METADATA,sha256=Ar02qqV_fKEgajUC3fF4DNOU2_xhRf8ZqiaNEDukyN8,10517
-mini_arcade_native_backend-0.4.1.dist-info/WHEEL,sha256=hrGeChGtn46HBGmzasO9QQDSLelRN-tUarBSv4gFcsI,106
-mini_arcade_native_backend-0.4.1.dist-info/licenses/LICENSE,sha256=cZRgTdRJ3YASekMxkGAvylB2nROh4ov228DxAogK3yY,1115
-mini_arcade_native_backend-0.4.1.dist-info/RECORD,,