VertexEngine 1.9.4__tar.gz → 1.9.6__tar.gz

{vertexengine-1.9.4/src/VertexEngine.egg-info → vertexengine-1.9.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: VertexEngine
-Version: 1.9.4
+Version: 1.9.6
 Summary: A high-performance SDK for Python Development.
 Author-email: Tyrel Miguel <annbasilan0828@gmail.com>
 License: MIT
@@ -52,14 +52,18 @@ Dynamic: license-file
 VertexEngine is a GUI and Game Engine for python applications, it works best if you use py installer
 
 ## Official Extensions:
-- [VertexEngine-WebEngine](https://pypi.org/project/VertexEngine-WebEngine)
+- [VertexEngine-JSON](https://pypi.org/project/VertexEngine-json)
 - [VertexEngine-CLI](https://pypi.org/project/VertexEngine-CLI/1.0/)
 
 ## Help
 - The documentation is in the following link: [Documentation](https://vertexenginedocs.netlify.app/) for help.
 - Support Email: FinalFacility0828@gmail.com
 
-## Change Logs (1.7.0 - 1.9.4)
+## Change Logs (1.8rc1 - 1.9.6)
+### 1.9.6
+- Engine Optimizations
+### 1.9.5
+- Widget Fixes
 ### 1.9.4
 - NEW ENGINE FLAG: resizable (bool)
 ### 1.9.3
@@ -116,30 +120,16 @@ VertexEngine is a GUI and Game Engine for python applications, it works best if
 ### 1.8rc1
 - Patched some runtime errors
 - Added MATH! (from VertexEngine.math import *)
-### 1.7.3
-- Added new functions to collisions!
-### 1.7.2
-- Added HIGHLIGHTING to Ocean Code!**
-- Fixed a lot of bugs!
-- Fixed outdated URLs (2 day server shutdown)
-### 1.7.1
-- official VertexEngine Projects Browser! (RainExplorer)
-- Accounts Wiped soon.
-- Fixed a bit too many bugs.
-### 1.7.0
-- Fixed Collision not defined errors
-- Added an official3 Tutorial Video!
-- Accounts will be wiped soon.
-
-## How to install VertexEngine/Vertex:
-Step 1: Type in pip install VertexEngine
-
-Step 2: Wait a few min, don't worry if it takes 1 hr or more, it will finish
-
-Pygame or PyQt6 systems are compatible with Vertex so you can use pygame collision system or PyQt6's UI system in VertexEngine.
+
+## How to install VertexEngine:
+Step 1: Type in `pip install VertexEngine`
+
+Step 2: Wait a few minutes.
+
+Pygame or PyQt6 systems are compatible with VertexEngine so you can use pygame collision system or PyQt6's UI system in VertexEngine.
 
 ## Dependencies
-Vertex obviously has heavy dependencies since it's a game engine, the following requirements are:
+VertexEngine obviously has heavy dependencies since it's a game engine, the following requirements are:
 
 | Dependency       | Version                              |
 |------------------|--------------------------------------|
@@ -147,10 +137,10 @@ Vertex obviously has heavy dependencies since it's a game engine, the following
 | Pygame           | >=2.0                                |
 | Python           | >=3.10                               |
 
-## About Me ❔
+## About Me
 I’m a solo developer based in Quezon City, building tools and engines for both fun and serious projects.
 
-## 📄 License
+## License
 VertexEngine is licensed under the MIT License.
 
 You are free to use, modify, and distribute this project, as long as proper attribution is given. See the LICENSE file for details.

{vertexengine-1.9.4 → vertexengine-1.9.6}/README.md

@@ -17,14 +17,18 @@
 VertexEngine is a GUI and Game Engine for python applications, it works best if you use py installer
 
 ## Official Extensions:
-- [VertexEngine-WebEngine](https://pypi.org/project/VertexEngine-WebEngine)
+- [VertexEngine-JSON](https://pypi.org/project/VertexEngine-json)
 - [VertexEngine-CLI](https://pypi.org/project/VertexEngine-CLI/1.0/)
 
 ## Help
 - The documentation is in the following link: [Documentation](https://vertexenginedocs.netlify.app/) for help.
 - Support Email: FinalFacility0828@gmail.com
 
-## Change Logs (1.7.0 - 1.9.4)
+## Change Logs (1.8rc1 - 1.9.6)
+### 1.9.6
+- Engine Optimizations
+### 1.9.5
+- Widget Fixes
 ### 1.9.4
 - NEW ENGINE FLAG: resizable (bool)
 ### 1.9.3
@@ -81,30 +85,16 @@ VertexEngine is a GUI and Game Engine for python applications, it works best if
 ### 1.8rc1
 - Patched some runtime errors
 - Added MATH! (from VertexEngine.math import *)
-### 1.7.3
-- Added new functions to collisions!
-### 1.7.2
-- Added HIGHLIGHTING to Ocean Code!**
-- Fixed a lot of bugs!
-- Fixed outdated URLs (2 day server shutdown)
-### 1.7.1
-- official VertexEngine Projects Browser! (RainExplorer)
-- Accounts Wiped soon.
-- Fixed a bit too many bugs.
-### 1.7.0
-- Fixed Collision not defined errors
-- Added an official3 Tutorial Video!
-- Accounts will be wiped soon.
 
-## How to install VertexEngine/Vertex:
-Step 1: Type in pip install VertexEngine
+## How to install VertexEngine:
+Step 1: Type in `pip install VertexEngine`
 
-Step 2: Wait a few min, don't worry if it takes 1 hr or more, it will finish
+Step 2: Wait a few minutes.
 
-Pygame or PyQt6 systems are compatible with Vertex so you can use pygame collision system or PyQt6's UI system in VertexEngine.
+Pygame or PyQt6 systems are compatible with VertexEngine so you can use pygame collision system or PyQt6's UI system in VertexEngine.
 
 ## Dependencies
-Vertex obviously has heavy dependencies since it's a game engine, the following requirements are:
+VertexEngine obviously has heavy dependencies since it's a game engine, the following requirements are:
 
 | Dependency       | Version                              |
 |------------------|--------------------------------------|
@@ -112,10 +102,10 @@ Vertex obviously has heavy dependencies since it's a game engine, the following
 | Pygame           | >=2.0                                |
 | Python           | >=3.10                               |
 
-## About Me ❔
+## About Me
 I’m a solo developer based in Quezon City, building tools and engines for both fun and serious projects.
 
-## 📄 License
+## License
 VertexEngine is licensed under the MIT License.
 
 You are free to use, modify, and distribute this project, as long as proper attribution is given. See the LICENSE file for details.

{vertexengine-1.9.4 → vertexengine-1.9.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "VertexEngine"
-version = "1.9.4"
+version = "1.9.6"
 description = "A high-performance SDK for Python Development."
 authors = [
   { name = "Tyrel Miguel", email = "annbasilan0828@gmail.com" }

{vertexengine-1.9.4 → vertexengine-1.9.6}/src/VertexEngine/InputSystem/KeyInputs.py

@@ -160,6 +160,12 @@ class Input:
         cls._just_pressed.clear()
         cls._just_released.clear()
 
+    @classmethod
+    def clear(cls):
+        cls._pressed.clear()
+        cls._just_pressed.clear()
+        cls._just_released.clear()
+
     @classmethod
     def bind(cls, action, key):
         """Bind an action name to a key."""
@@ -195,15 +201,15 @@ class Input:
     # === Direct Key API ===
     @classmethod
     def is_pressed(cls, key):
-        return KEY_MAP[key] in cls._pressed
+        return KEY_MAP.get(key, key) in cls._pressed
 
     @classmethod
     def is_just_pressed(cls, key):
-        return KEY_MAP[key] in cls._just_pressed
+        return KEY_MAP.get(key, key) in cls._just_pressed
 
     @classmethod
     def is_released(cls, key):
-        return KEY_MAP[key] in cls._just_released
+        return KEY_MAP.get(key, key) in cls._just_released
 
     # === Action API ===
     @classmethod

{vertexengine-1.9.4 → vertexengine-1.9.6}/src/VertexEngine/VertexWidgets/PygameVWidgets/__init__.py

@@ -24,6 +24,19 @@ class Style:
         padding (int): Internal padding.
     """
 
+    _STYLE_ATTRS = (
+        "bg_color",
+        "hover_color",
+        "pressed_color",
+        "border_color",
+        "text_color",
+        "border_radius",
+        "border_width",
+        "font_name",
+        "font_size",
+        "padding",
+    )
+
     def __init__(
         self,
         bg_color=(70, 70, 90),
@@ -50,6 +63,20 @@ class Style:
         self.font_size = font_size
         self.padding = padding
 
+    @classmethod
+    def coerce(cls, style=None):
+        """Return a Style instance, even when a style-like object is passed."""
+        if style is None:
+            return cls()
+        if isinstance(style, cls):
+            return style
+
+        normalized = cls()
+        for attr in cls._STYLE_ATTRS:
+            if hasattr(style, attr):
+                setattr(normalized, attr, getattr(style, attr))
+        return normalized
+
 
 # =========================================================
 # BASE WIDGET
@@ -82,7 +109,7 @@ class Widget:
         self.visible = True
         self.parent = None
         self.children = []
-        self.style = style or Style()
+        self.style = Style.coerce(style)
 
         self._rect = pygame.Rect(x, y, width, height)
 
@@ -137,20 +164,42 @@ class Button(Widget):
         on_click (callable): Click callback.
         hovered (bool): Hover state.
         pressed (bool): Press state.
+        image (pygame.Surface | str | None): Optional button image.
     """
 
-    def __init__(self, x, y, width, height, text="", on_click=None, style=None):
+    def __init__(self, x, y, width, height, text="", on_click=None, style=None, image=None):
         super().__init__(x, y, width, height, style)
         self.text = text
         self.on_click = on_click
         self.hovered = False
         self.pressed = False
+        self.image = self._load_image(image)
 
         self.font = pygame.font.SysFont(
             self.style.font_name,
             self.style.font_size
         )
 
+    @staticmethod
+    def _load_image(image):
+        if image is None:
+            return None
+        if isinstance(image, str):
+            return pygame.image.load(image)
+        if isinstance(image, pygame.Surface):
+            return image
+        return None
+
+    def _tint_surface(self, image, tint_color, alpha=120):
+        if image is None:
+            return None
+
+        tinted = image.copy()
+        overlay = pygame.Surface(tinted.get_size(), pygame.SRCALPHA)
+        overlay.fill((tint_color[0], tint_color[1], tint_color[2], alpha))
+        tinted.blit(overlay, (0, 0), special_flags=pygame.BLEND_RGBA_MULT)
+        return tinted
+
     def update(self):
         """Updates hover state."""
         mouse = pygame.mouse.get_pos()
@@ -174,15 +223,28 @@ class Button(Widget):
         if not self.visible:
             return
 
-        color = self.style.bg_color
-        if self.pressed:
-            color = self.style.pressed_color
-        elif self.hovered:
-            color = self.style.hover_color
-
         rect = self.rect()
 
-        pygame.draw.rect(surface, color, rect, border_radius=self.style.border_radius)
+        if self.image:
+            image = pygame.transform.smoothscale(self.image, rect.size)
+            tint_color = None
+            if self.pressed:
+                tint_color = self.style.pressed_color
+            elif self.hovered:
+                tint_color = self.style.hover_color
+
+            if tint_color is not None:
+                image = self._tint_surface(image, tint_color, alpha=150)
+
+            surface.blit(image, rect.topleft)
+        else:
+            color = self.style.bg_color
+            if self.pressed:
+                color = self.style.pressed_color
+            elif self.hovered:
+                color = self.style.hover_color
+
+            pygame.draw.rect(surface, color, rect, border_radius=self.style.border_radius)
 
         if self.text:
             text = self.font.render(self.text, True, self.style.text_color)

{vertexengine-1.9.4 → vertexengine-1.9.6}/src/VertexEngine/assets.py

@@ -58,6 +58,10 @@ class AssetManager:
         try:
             surface = pygame.image.load(path)
             self.images[name] = surface
+            self._scaled_cache = {
+                key: value for key, value in self._scaled_cache.items()
+                if key[0] != name
+            }
             return surface
 
         except FileNotFoundError:
@@ -78,7 +82,7 @@ class AssetManager:
         """
         img = self.images.get(name)
 
-        if not img:
+        if img is None:
             print(f"[Warning] Image '{name}' not loaded!")
             return
 
@@ -88,6 +92,7 @@ class AssetManager:
             return
 
         # Use cache key
+        size = tuple(size)
         cache_key = (name, size)
 
         # Check if scaled version exists

{vertexengine-1.9.4 → vertexengine-1.9.6}/src/VertexEngine/audio.py

@@ -3,7 +3,8 @@ import pygame
 class AudioManager:
     """The `AudioManager` class allows you to play audio in your VertexEngine app. It has only 4 functions for sound and music."""
     def __init__(self):
-        pygame.mixer.init()
+        if not pygame.mixer.get_init():
+            pygame.mixer.init()
         self.sounds = {}
         self.music = None
 

{vertexengine-1.9.4 → vertexengine-1.9.6}/src/VertexEngine/engine.py

@@ -42,14 +42,14 @@ class GameEngine(QWidget):
         """Helper to sync the Pygame surface into a Qt-friendly image buffer."""
         # Always rebuild the image from the current frame so the Qt widget
         # doesn't keep rendering the stale black buffer created at startup.
-        raw = pygame.image.tobytes(self.screen, "RGB")
+        self._frame_bytes = pygame.image.tobytes(self.screen, "RGB")
         self.img = QImage(
-            raw,
+            self._frame_bytes,
             self.width,
             self.height,
             self.width * 3,
             QImage.Format.Format_RGB888
-        ).copy()
+        )
 
     # ---------------------- RENDER ----------------------
 
@@ -71,13 +71,14 @@ class GameEngine(QWidget):
 
     def _update_frame(self):
         if not self.hasFocus():
-            self.keys_down.clear()
+            Input.clear()
 
         # Optimized: Clear and draw into the pygame surface during the update step
         self.screen.fill(self.color)
         self.scene_manager._update()
         self.scene_manager.draw(self.screen)
         self._sync_qimage()
+        Input.input_update()
 
         # Schedule the visual swap
         self.update()

{vertexengine-1.9.4 → vertexengine-1.9.6}/src/VertexEngine/scenes.py

@@ -57,6 +57,8 @@ class SceneManager:
         self.current_scene = None
 
     def set_scene(self, scene):
+        if scene is self.current_scene:
+            return
         if self.current_scene:
             self.current_scene.on_exit()
             self.current_scene.hide()
@@ -66,13 +68,16 @@ class SceneManager:
         self.current_scene.on_enter()
 
     def _update(self):
-        if self.current_scene:
-            self.current_scene.update()
+        scene = self.current_scene
+        if scene is not None:
+            scene.update()
 
     def draw(self, surface):
-        if self.current_scene:
-            self.current_scene.draw(surface)
+        scene = self.current_scene
+        if scene is not None:
+            scene.draw(surface)
 
     def handle_event(self, event):
-        if self.current_scene:
-            self.current_scene.handle_event(event)
+        scene = self.current_scene
+        if scene is not None:
+            scene.handle_event(event)

{vertexengine-1.9.4 → vertexengine-1.9.6/src/VertexEngine.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: VertexEngine
-Version: 1.9.4
+Version: 1.9.6
 Summary: A high-performance SDK for Python Development.
 Author-email: Tyrel Miguel <annbasilan0828@gmail.com>
 License: MIT
@@ -52,14 +52,18 @@ Dynamic: license-file
 VertexEngine is a GUI and Game Engine for python applications, it works best if you use py installer
 
 ## Official Extensions:
-- [VertexEngine-WebEngine](https://pypi.org/project/VertexEngine-WebEngine)
+- [VertexEngine-JSON](https://pypi.org/project/VertexEngine-json)
 - [VertexEngine-CLI](https://pypi.org/project/VertexEngine-CLI/1.0/)
 
 ## Help
 - The documentation is in the following link: [Documentation](https://vertexenginedocs.netlify.app/) for help.
 - Support Email: FinalFacility0828@gmail.com
 
-## Change Logs (1.7.0 - 1.9.4)
+## Change Logs (1.8rc1 - 1.9.6)
+### 1.9.6
+- Engine Optimizations
+### 1.9.5
+- Widget Fixes
 ### 1.9.4
 - NEW ENGINE FLAG: resizable (bool)
 ### 1.9.3
@@ -116,30 +120,16 @@ VertexEngine is a GUI and Game Engine for python applications, it works best if
 ### 1.8rc1
 - Patched some runtime errors
 - Added MATH! (from VertexEngine.math import *)
-### 1.7.3
-- Added new functions to collisions!
-### 1.7.2
-- Added HIGHLIGHTING to Ocean Code!**
-- Fixed a lot of bugs!
-- Fixed outdated URLs (2 day server shutdown)
-### 1.7.1
-- official VertexEngine Projects Browser! (RainExplorer)
-- Accounts Wiped soon.
-- Fixed a bit too many bugs.
-### 1.7.0
-- Fixed Collision not defined errors
-- Added an official3 Tutorial Video!
-- Accounts will be wiped soon.
-
-## How to install VertexEngine/Vertex:
-Step 1: Type in pip install VertexEngine
-
-Step 2: Wait a few min, don't worry if it takes 1 hr or more, it will finish
-
-Pygame or PyQt6 systems are compatible with Vertex so you can use pygame collision system or PyQt6's UI system in VertexEngine.
+
+## How to install VertexEngine:
+Step 1: Type in `pip install VertexEngine`
+
+Step 2: Wait a few minutes.
+
+Pygame or PyQt6 systems are compatible with VertexEngine so you can use pygame collision system or PyQt6's UI system in VertexEngine.
 
 ## Dependencies
-Vertex obviously has heavy dependencies since it's a game engine, the following requirements are:
+VertexEngine obviously has heavy dependencies since it's a game engine, the following requirements are:
 
 | Dependency       | Version                              |
 |------------------|--------------------------------------|
@@ -147,10 +137,10 @@ Vertex obviously has heavy dependencies since it's a game engine, the following
 | Pygame           | >=2.0                                |
 | Python           | >=3.10                               |
 
-## About Me ❔
+## About Me
 I’m a solo developer based in Quezon City, building tools and engines for both fun and serious projects.
 
-## 📄 License
+## License
 VertexEngine is licensed under the MIT License.
 
 You are free to use, modify, and distribute this project, as long as proper attribution is given. See the LICENSE file for details.

{vertexengine-1.9.4 → vertexengine-1.9.6}/src/VertexEngine.egg-info/SOURCES.txt

@@ -40,4 +40,5 @@ src/VertexEngine/examples/test.py
 src/VertexEngine/examples/MajorSystemTest/Wangi.png
 src/VertexEngine/examples/MajorSystemTest/main.py
 src/VertexEngine/examples/MajorSystemTest/universfield-ui-button-click-147358.mp3
-src/VertexEngine/examples/games/snake/main.py
+src/VertexEngine/examples/games/snake/main.py
+tests/test_pygame_vwidgets_style.py