mini-arcade-native-backend 0.4.3__tar.gz → 0.4.4__tar.gz

{mini_arcade_native_backend-0.4.3 → mini_arcade_native_backend-0.4.4}/CHANGELOG.md

@@ -6,6 +6,17 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.4.4] - 2025-12-16
+
+### Added
+- add measure_text method to Engine and expose it in NativeBackend
+- add alpha handling methods and refactor color extraction in NativeBackend
+- update draw_rect and draw_text methods to support alpha channel in color
+
+### Other
+- Merge branch 'release/0.4' of https://github.com/alexsc6955/mini-arcade-native-backend into release/0.4
+- Merge branch 'release/0.4' of https://github.com/alexsc6955/mini-arcade-native-backend into release/0.4
+
 ## [0.4.3] - 2025-12-16
 
 ### Added

{mini_arcade_native_backend-0.4.3 → mini_arcade_native_backend-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: mini-arcade-native-backend
-Version: 0.4.3
+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.3 → mini_arcade_native_backend-0.4.4}/cpp/bindings.cpp

@@ -79,5 +79,11 @@ PYBIND11_MODULE(_native, m) {
         .def("poll_events", &mini::Engine::poll_events)
 
         .def("capture_frame", &mini::Engine::capture_frame,
-                py::arg("path"));
+                py::arg("path"))
+        .def(
+        "measure_text",
+                &mini::Engine::measure_text,
+                py::arg("text"),
+                py::arg("font_id") = -1
+        );
 }

{mini_arcade_native_backend-0.4.3 → mini_arcade_native_backend-0.4.4}/cpp/engine.cpp

@@ -2,6 +2,8 @@
 
 #include <stdexcept>
 #include <iostream>
+#include <utility>
+#include <cstring>
 
 namespace mini {
 
@@ -381,4 +383,26 @@ namespace mini {
         return events;
     }
 
+    std::pair<int, int> Engine::measure_text(const char* text, int font_id)
+    {
+        if (!initialized_) return {0, 0};
+
+        int idx = (font_id >= 0) ? font_id : default_font_id_;
+        if (idx < 0 || idx >= (int)fonts_.size() || fonts_[idx] == nullptr) return {0, 0};
+
+        if (text == nullptr || text[0] == '\0') return {0, 0};
+
+        int w = 0;
+        int h = 0;
+
+        // TTF_SizeUTF8 returns 0 on success, -1 on error
+        if (TTF_SizeUTF8(fonts_[idx], text, &w, &h) != 0) {
+            // Optional: log error
+            // std::cerr << "TTF_SizeUTF8 Error: " << TTF_GetError() << std::endl;
+            return {0, 0};
+        }
+
+        return {w, h};
+    }
+
 } // namespace mini

{mini_arcade_native_backend-0.4.3 → mini_arcade_native_backend-0.4.4}/cpp/engine.h

@@ -4,6 +4,7 @@
 #include <SDL_ttf.h>
 #include <vector>
 #include <string>
+#include <utility>
 
 // A minimal 2D graphics engine binding for Python using SDL.
 namespace mini {
@@ -89,6 +90,10 @@ namespace mini {
         // Returns true on success, false on failure.
         bool capture_frame(const char* path);
 
+        // Measure text (UTF-8) using a loaded font.
+        // Returns (width, height) in pixels. Returns (0,0) if no valid font or error.
+        std::pair<int, int> measure_text(const char* text, int font_id = -1);
+
     private:
         SDL_Window* window_; // The main application window.
         SDL_Renderer* renderer_; // The renderer for drawing.

{mini_arcade_native_backend-0.4.3 → mini_arcade_native_backend-0.4.4}/pyproject.toml

@@ -8,7 +8,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "mini-arcade-native-backend"
-version = "0.4.3"
+version = "0.4.4"
 description = "Native SDL2 backend for mini-arcade-core using SDL2 + pybind11."
 authors = [
   { name = "Santiago Rincon", email = "rincores@gmail.com" },

{mini_arcade_native_backend-0.4.3 → mini_arcade_native_backend-0.4.4}/src/mini_arcade_native_backend/__init__.py

@@ -324,3 +324,15 @@ class NativeBackend(Backend):
         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)