PyScene 1.1.2__tar.gz → 1.1.4__tar.gz

{pyscene-1.1.2 → pyscene-1.1.4}/PKG-INFO

@@ -1,9 +1,10 @@
 Metadata-Version: 2.5
 Name: PyScene
-Version: 1.1.2
+Version: 1.1.4
 Summary: A python and pygame Game Engine
 Project-URL: Homepage, https://github.com/sfertig/PyScene
 Project-URL: Issues, https://github.com/sfertig/PyScene/issues
+Project-URL: GUI-editor, https://github.com/sfertig/PyScene-Studio
 Author-email: Sam Fertig <sfertig007@gmail.com>
 License-Expression: MIT
 License-File: LICENSE
@@ -16,8 +17,16 @@ Description-Content-Type: text/markdown
 
 PyScene is a custom python + pygame framework / engine developed to streamline 2d game development.
 This is not a pygame wrapper, as it goed beyons the basic helper features and dives into a mini engine / framework.
+There is also a GUI editor being developed alongside PyScene that can be veiwed at: https://github.com/sfertig/PyScene-Studio
 
 Please Note: This engine is still in development and many features, like tilemaps and audio, are a work in progress. It also lack any form of documentation, I ask for patience as docs will be rolled out once the core features are more solidified.
 
-PyScene is in developement and API's may change offten, a fully stable version should come with v2.0.0, currently on v1.1.2
+PyScene is in developement and API's may change offten, a fully stable version should come with v2.0.0, currently on v1.1.4
 
+Getting Started Basics:
+
+1. Use Game.init(...)
+2. Create custom Game Objects by inheriting GameObj
+3. Create a Scene by inheriting Scene
+4. Use Game.Run(...) #pass in True to have escape close the window
+Not: remenber to use super().__init__(...) is any inherited scene or Game object

{pyscene-1.1.2 → pyscene-1.1.4}/README.md

@@ -2,8 +2,16 @@
 
 PyScene is a custom python + pygame framework / engine developed to streamline 2d game development.
 This is not a pygame wrapper, as it goed beyons the basic helper features and dives into a mini engine / framework.
+There is also a GUI editor being developed alongside PyScene that can be veiwed at: https://github.com/sfertig/PyScene-Studio
 
 Please Note: This engine is still in development and many features, like tilemaps and audio, are a work in progress. It also lack any form of documentation, I ask for patience as docs will be rolled out once the core features are more solidified.
 
-PyScene is in developement and API's may change offten, a fully stable version should come with v2.0.0, currently on v1.1.2
+PyScene is in developement and API's may change offten, a fully stable version should come with v2.0.0, currently on v1.1.4
 
+Getting Started Basics:
+
+1. Use Game.init(...)
+2. Create custom Game Objects by inheriting GameObj
+3. Create a Scene by inheriting Scene
+4. Use Game.Run(...) #pass in True to have escape close the window
+Not: remenber to use super().__init__(...) is any inherited scene or Game object

{pyscene-1.1.2 → pyscene-1.1.4}/pyproject.toml

@@ -3,7 +3,7 @@ requires = ["hatchling >= 1.26"]
 build-backend = "hatchling.build"
 [project]
 name = "PyScene"
-version = "1.1.2"
+version = "1.1.4"
 authors = [
   { name="Sam Fertig", email="sfertig007@gmail.com" },
 ]
@@ -19,4 +19,5 @@ license-files = ["LICEN[CS]E*"]
 
 [project.urls]
 Homepage = "https://github.com/sfertig/PyScene"
-Issues = "https://github.com/sfertig/PyScene/issues"
+Issues = "https://github.com/sfertig/PyScene/issues"
+GUI-editor = "https://github.com/sfertig/PyScene-Studio"

{pyscene-1.1.2 → pyscene-1.1.4}/src/PyScene/Game.py

@@ -72,7 +72,7 @@ class _game:
         if self.active_scene is None: self.queue_creation.append(obj)
         else: self.active_scene._queue_add(obj)
     def _queue_remove(self, obj): 
-        if obj in self.objects: self.objects.remove(obj)
+        if obj in self.objects: self.queue_del.remove(obj)
         else: self.active_scene._queue_remove(obj)
     def _get_id(self):
         self.id += 1
@@ -190,7 +190,20 @@ class _game:
         self.queue_creation_coll = []
         self.queue_del_coll = []
         self._update_coll = False
-
+    def clear_global_objs(self):
+        self.objects = []
+        self.queue_creation = []
+        self.queue_del = []
+        self.render_queue = []
+    def clear_scene_objs(self):
+        if self.active_scene is not None: 
+            self.active_scene._objects = []
+            self.active_scene.queue_creation = []
+            self.active_scene.queue_del = []
+            self.active_scene._render_queue = []
+    def clear_all_objs(self):
+        self.clear_global_objs()
+        self.clear_scene_objs()
     def _set_scene(self, scene=None):
         if self.active_scene is not None: self.active_scene.destroy()
         self._clear_all_collisions_()

pyscene-1.1.4/src/PyScene/objs/GameObj.py

@@ -0,0 +1,46 @@
+import pygame
+from ..Math import Vector2D
+from ..Game import Game
+
+class GameObj: #this will be the base class of every game obj
+    def __init__(self, pos=Vector2D(0, 0), z_index=0, active=True, visible=True, Global=False):
+        self.pos: Vector2D = pos
+        self.vel: Vector2D = Vector2D(0, 0)
+        self.z_index = z_index
+        self.active = active
+        self.visible = visible
+        self._id = Game._get_id()
+
+        self.__parent: GameObj = None
+        self.__children: list[GameObj] = []
+
+        #add to creation
+        if Game.always_global: Global = True
+        if not Global: Game._queue_add(self)
+        else: Game.queue_creation.append(self) #if obj is just global anyway
+
+        self._global = Global
+
+    def child(self, obj): #obj is a game object 
+        self.__children.append(obj)
+        obj.parent(self)
+        return obj #QOF
+
+    def parent(self, obj):
+        # If we already have a parent, remove ourselves from its list first
+        if self.__parent and self in self.__parent.__children:
+            self.__parent.__children.remove(self)
+        self.__parent = obj
+
+    def update(self): pass
+    def render(self): pass
+    def destroy(self): 
+        Game._queue_remove(self)
+        for i in self.__children:
+            i.destroy()
+
+        if self.__parent: self.__parent.__children.remove(self)
+
+        self.__children = []
+        self.__parent = None
+

{pyscene-1.1.2 → pyscene-1.1.4}/src/PyScene/objs/Text.py

@@ -18,9 +18,28 @@ class Text(GameObj):
 
     def _update_surface(self):
         """Internal method to re-render surface only when text changes."""
-        self.surface = self.font.render(str(self.text), False, self.color)  # False for sharp pixel fonts!
-        # Dynamically set rect based on alignment (topleft, center, topright, etc.)
-        self.rect = self.surface.get_rect(**{self.align: self.pos.to_int()})
+        self.surface = self.font.render(str(self.text), False, self.color)
+        self._apply_alignment()
+
+    def _apply_alignment(self):
+        """Safely positions the rect based on single or multi-coordinate alignment."""
+        xy = self.pos.to_int()  # Assuming this returns (x, y)
+        
+        # Group single-coordinate attributes by which axis they care about
+        x_aligns = {"left", "right", "centerx", "x"}
+        y_aligns = {"top", "bottom", "centery", "y"}
+
+        if self.align in x_aligns:
+            # Create a default rect at (0,0), then assign the specific X coordinate
+            self.rect = self.surface.get_rect()
+            setattr(self.rect, self.align, xy[0])
+        elif self.align in y_aligns:
+            # Create a default rect at (0,0), then assign the specific Y coordinate
+            self.rect = self.surface.get_rect()
+            setattr(self.rect, self.align, xy[1])
+        else:
+            # Multi-coordinate alignments (center, topleft, etc.) safely accept the full tuple
+            self.rect = self.surface.get_rect(**{self.align: xy})
 
     def set_text(self, new_text, color=None):
         """Only call this when the string actually changes!"""
@@ -32,13 +51,15 @@ class Text(GameObj):
 
     def set_pos(self, new_pos: Vector2D):
         self.pos = new_pos
-        self.rect = self.surface.get_rect(**{self.align: self.pos.to_int()})
+        self._apply_alignment()
 
     def render(self):
         Game.cam.draw_text(self.surface, self.rect, self.offset)
+        
     def render_to(self, surface):
         surface.blit(self.surface, self.rect)
 
+
 class Image(GameObj):
     def __init__(self, image, pos=Vector2D(0, 0), z_index=0, active=True, visible=True, offset=True, Global=False):
         super().__init__(pos, z_index, active, visible, Global)

pyscene-1.1.2/src/PyScene/objs/GameObj.py

@@ -1,24 +0,0 @@
-import pygame
-from ..Math import Vector2D
-from ..Game import Game
-
-class GameObj: #this will be the base class of every game obj
-    def __init__(self, pos=Vector2D(0, 0), z_index=0, active=True, visible=True, Global=False):
-        self.pos: Vector2D = pos
-        self.vel: Vector2D = Vector2D(0, 0)
-        self.z_index = z_index
-        self.active = active
-        self.visible = visible
-        self._id = Game._get_id()
-
-        #add to creation
-        if Game.always_global: Global = True
-        if not Global: Game._queue_add(self)
-        else: Game.queue_creation.append(self) #if obj is just global anyway
-
-        self._global = Global
-
-    def update(self): pass
-    def render(self): pass
-    def destroy(self): Game._queue_remove(self)
-