mini-arcade-native-backend 0.4.2__cp39-cp39-win_amd64.whl → 0.4.4__cp39-cp39-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 ------------------
 
@@ -48,6 +49,7 @@ from . import _native as native
 
 __all__ = ["NativeBackend", "native"]
 
+Alpha = Union[float, int]
 
 _NATIVE_TO_CORE = {
     native.EventType.Unknown: EventType.UNKNOWN,
@@ -208,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,
@@ -235,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
 
@@ -271,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:
         """
@@ -289,4 +321,18 @@ 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)
+
+    def measure_text(self, text: str) -> tuple[int, int]:
+        """
+        Measure text size (width, height) in pixels for the active font.
+
+        Returns (0,0) if no font is loaded (matches draw_text no-op behavior).
+        """
+        font_id = (
+            self._default_font_id if self._default_font_id is not None else -1
+        )
+        w, h = self._engine.measure_text(text, font_id)
+        return int(w), int(h)

{mini_arcade_native_backend-0.4.2.dist-info → mini_arcade_native_backend-0.4.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: mini-arcade-native-backend
-Version: 0.4.2
+Version: 0.4.4
 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.4.dist-info/RECORD

@@ -0,0 +1,6 @@
+mini_arcade_native_backend/__init__.py,sha256=F7grqK1WRo-Of-hW7AJBXSTt0U_omah_13NtPBymE5s,11101
+mini_arcade_native_backend/_native.cp39-win_amd64.pyd,sha256=qDg6KhKHBXoIFUY0y6TUBfE9TJnNO5CmXgvTxdDAsvo,225280
+mini_arcade_native_backend-0.4.4.dist-info/METADATA,sha256=X2xdVGJhP3bTdpchuZuW_kNtRQQF583oTECtJ2OJ34A,10517
+mini_arcade_native_backend-0.4.4.dist-info/WHEEL,sha256=9tsL4JT94eZPTkcS3bNng2riasYJMxXndrO9CxUfJHs,104
+mini_arcade_native_backend-0.4.4.dist-info/licenses/LICENSE,sha256=cZRgTdRJ3YASekMxkGAvylB2nROh4ov228DxAogK3yY,1115
+mini_arcade_native_backend-0.4.4.dist-info/RECORD,,

mini_arcade_native_backend-0.4.2.dist-info/RECORD

@@ -1,6 +0,0 @@
-mini_arcade_native_backend/__init__.py,sha256=R6N7QYH4Ez6mmZOtdJd3UcPqo4obAW9um7w9Hjsrv6o,9609
-mini_arcade_native_backend/_native.cp39-win_amd64.pyd,sha256=JLEP6P9GwAN5bAqZELyb564bdKecAfhtAS_G4ExEsPg,224768
-mini_arcade_native_backend-0.4.2.dist-info/METADATA,sha256=9xVRtkbI96F7nljlKYgChuP6Au-z1jA6-pAhteCitOk,10517
-mini_arcade_native_backend-0.4.2.dist-info/WHEEL,sha256=9tsL4JT94eZPTkcS3bNng2riasYJMxXndrO9CxUfJHs,104
-mini_arcade_native_backend-0.4.2.dist-info/licenses/LICENSE,sha256=cZRgTdRJ3YASekMxkGAvylB2nROh4ov228DxAogK3yY,1115
-mini_arcade_native_backend-0.4.2.dist-info/RECORD,,