batframework 0.1.13__py3-none-any.whl → 1.0.1__py3-none-any.whl

batFramework/__init__.py

@@ -1,67 +1,62 @@
 import pygame
+import batFramework as bf
+import sys
 from .constants import Constants as const
-import os
-import json
-initialized = False
-
-def init(
-    resolution:tuple[int,int],
-    flags:int=0,
-    vsync:int = 0,
-    default_text_size=None,
-    default_font=None,
-    resource_path:str|None=None,
-    window_title:str="BatFramework Project",
-    fps_limit : int = 0
-    ):
-    global initialized
-    if not initialized:
-        pygame.init()
-        pygame.display.set_caption(window_title)
-
-        # Initialize display
-        const.init_screen(resolution,flags,vsync)
-        const.set_fps_limit(fps_limit)
-
-        # Initialize default text size
-        if default_text_size: const.set_default_text_size(default_text_size)
-        # Initialize resource path for game data
-        if resource_path: const.set_resource_path(resource_path)
-
-        # Initialize default font cache
-        from .utils import Utils
-        if default_font is None or isinstance(default_font,str):
-            Utils.init_font(default_font)
-        else:
-            raise ValueError(f"default_font '{default_font}' can be either string or None")
-        
-        f = list(Utils.FONTS[None].values())[0]
-        print(f"Set default font to : {f.name} {'' if default_font is not None else '(default value)'}")
-        initialized = True
-
 from .constants import Colors as color
-from .constants import Axis as axis
 from .utils import Singleton
+from .enums import *
+from .resourceManager import ResourceManager
+from .fontManager import FontManager
+# if const.BF_INITIALIZED:     
 from .utils import Utils as utils
 from .tileset import Tileset
-from .time import Time, Timer
-from .cutscene import Cutscene,CutsceneManager
+from .time import TimeManager, Timer
+from .cutscene import Cutscene, CutsceneManager
 from .cutsceneBlocks import *
 from .easing import Easing, EasingAnimation
 from .audioManager import AudioManager
-from .utils import Layout, Alignment, Direction
-from .transition import *
+# import batFramework.transition as transition
 from .action import Action
-from .actionContainer import ActionContainer
+from .actionContainer import *
 from .camera import Camera
 from .entity import Entity
 from .dynamicEntity import DynamicEntity
+from .sprite import Sprite
 from .animatedSprite import AnimatedSprite, AnimState
 from .stateMachine import State, StateMachine
-from .particles import Particle, ParticleManager
 # from .debugger import Debugger
 from .scene import Scene
 from .gui import * 
 from .sceneManager import SceneManager
 from .manager import Manager
 
+            
+def init_screen(resolution: tuple[int, int], flags: int = 0, vsync: int = 0):
+    const.RESOLUTION = resolution
+    const.FLAGS = flags
+    const.VSYNC = vsync
+    const.SCREEN = pygame.display.set_mode(
+        const.RESOLUTION,const.FLAGS, vsync=const.VSYNC
+    )
+    print(
+        f"Window : {resolution[0]}x{resolution[1]} [vsync:{pygame.display.is_vsync()}]"
+    )
+
+def init(
+    resolution: tuple[int, int],
+    flags: int = 0,
+    vsync: int = 0,
+    default_text_size=None,
+    default_font=None,
+    resource_path: str | None = None,
+    window_title: str = "BatFramework Project",
+    fps_limit: int = 0):
+        pygame.display.set_caption(window_title)
+        init_screen(resolution,flags,vsync)
+        
+        ResourceManager().set_resource_path(resource_path if resource_path is not None else ".")
+        ResourceManager().load_dir(ResourceManager().RESOURCE_PATH)
+        if default_text_size is not None : FontManager().set_default_text_size(default_text_size)
+        FontManager().init_font(default_font)
+        const.BF_INITIALIZED = True
+        const.set_fps_limit(fps_limit)

batFramework/action.py

@@ -12,20 +12,21 @@ class Action:
         Args:
             name (str): The name of the action.
         """
-        self._name = name
-        self._active = False
-        self._type = ActionType.INSTANTANEOUS
-        self._key_control = set()
-        self._mouse_control = set()
-        self._gamepad_button_control = set()
-        self._gamepad_axis_control = set()
+        self._name :str= name
+        self._active :bool= False
+        self._type :ActionType = ActionType.INSTANTANEOUS
+        self._key_control : set= set()       
+        self._mouse_control :set = set()
+        self._gamepad_button_control :set = set()
+        self._gamepad_axis_control :set = set()
         self._holding = set()
         self._unique = True
-        self.data : Any = None
+        self.data: Any = None
 
     def set_unique(self, val: bool) -> None:
         """
         Set whether this action is unique (exclusive).
+        When in an action Container, unique actions -when active - break the propagation of their event to other actions.
 
         Args:
             val (bool): True if the action is unique, False otherwise.
@@ -51,7 +52,7 @@ class Action:
         self._active = value
         self._holding = set()
 
-    def add_key_control(self, *keys) -> 'Action':
+    def add_key_control(self, *keys) -> "Action":
         """
         Add key controls to the action.
 
@@ -64,7 +65,26 @@ class Action:
         self._key_control.update(keys)
         return self
 
-    def add_mouse_control(self, *mouse_buttons) -> 'Action':
+    def remove_key_control(self, *keys:int) -> "Action":
+        """
+        Remove key controls to the action.
+
+        Args:
+            *keys (int): Key codes to control this action.
+
+        Returns:
+            Action: The updated Action object for method chaining.
+        """
+        self._key_control = self._key_control - set(keys)
+        return self
+
+    def replace_key_control(self, key, new_key) -> "Action":
+        if not key in self._key_control : return self
+        self.remove_key_control(key)
+        self.add_key_control(new_key)
+        return self
+
+    def add_mouse_control(self, *mouse_buttons:int) -> "Action":
         """
         Add mouse control to the action.
 
@@ -86,7 +106,7 @@ class Action:
         """
         return self._name
 
-    def set_continuous(self) -> 'Action':
+    def set_continuous(self) -> "Action":
         """
         Set the action type to continuous.
 
@@ -106,7 +126,7 @@ class Action:
         """
         return self._type == ActionType.CONTINUOUS
 
-    def set_instantaneous(self) -> 'Action':
+    def set_instantaneous(self) -> "Action":
         """
         Set the action type to instantaneous.
 
@@ -126,7 +146,7 @@ class Action:
         """
         return self._type == ActionType.INSTANTANEOUS
 
-    def set_holding(self) -> 'Action':
+    def set_holding(self) -> "Action":
         """
         Set the action type to holding.
 
@@ -145,9 +165,14 @@ class Action:
         """
         return self._type == ActionType.HOLDING
 
-    def process_update(self,event:pygame.Event)->None:
-        if self.is_active() and event.type == pygame.MOUSEMOTION and  self.is_holding_type() and pygame.MOUSEMOTION in self._mouse_control:
-            self.data = {"pos":event.pos,"rel":event.rel}
+    def process_update(self, event: pygame.Event) -> None:
+        if (
+            self.is_active()
+            and event.type == pygame.MOUSEMOTION
+            and self.is_holding_type()
+            and pygame.MOUSEMOTION in self._mouse_control
+        ):
+            self.data = {"pos": event.pos, "rel": event.rel}
 
     def process_activate(self, event: pygame.event.Event) -> bool:
         """
@@ -205,10 +230,7 @@ class Action:
                 if not self._holding:
                     self._active = False
                     return True
-            elif (
-                event.type == pygame.MOUSEMOTION
-                and event.type in self._mouse_control
-            ):
+            elif event.type == pygame.MOUSEMOTION and event.type in self._mouse_control:
                 self.value = None
                 if event.type in self._holding:
                     self._holding.remove(event.type)

batFramework/actionContainer.py

@@ -1,4 +1,5 @@
 import batFramework as bf
+import pygame
 
 
 class ActionContainer:
@@ -14,14 +15,20 @@ class ActionContainer:
         for action in actions:
             self._actions[action.get_name()] = action
 
-    def get(self,name:str)->bf.Action:
+    def get(self, name: str) -> bf.Action:
         return self._actions.get(name)
 
-    def has_action(self, name:str):
+    def has_action(self, name: str):
         return name in self._actions
 
-    def is_active(self, *names:str)->bool:
-        return all(self._actions.get(name).is_active() if name in self._actions else False for name in names)
+    def get_all(self) -> list[bf.Action]:
+        return self._actions
+
+    def is_active(self, *names: str) -> bool:
+        return all(
+            self._actions.get(name).is_active() if name in self._actions else False
+            for name in names
+        )
 
     def process_event(self, event):
         for action in self._actions.values():
@@ -36,3 +43,35 @@ class ActionContainer:
     def hard_reset(self):
         for action in self._actions.values():
             action.hard_reset()
+
+
+class DirectionalKeyControls(ActionContainer):
+    def __init__(self):
+        super().__init__(
+            bf.Action("up").add_key_control(pygame.K_UP).set_holding(),
+            bf.Action("down").add_key_control(pygame.K_DOWN).set_holding(),
+            bf.Action("left").add_key_control(pygame.K_LEFT).set_holding(),
+            bf.Action("right").add_key_control(pygame.K_RIGHT).set_holding(),
+        )
+
+
+class WASDControls(ActionContainer):
+    def __init__(self):
+        super().__init__(
+            bf.Action("up").add_key_control(pygame.K_w).set_holding(),
+            bf.Action("down").add_key_control(pygame.K_s).set_holding(),
+            bf.Action("left").add_key_control(pygame.K_a).set_holding(),
+            bf.Action("right").add_key_control(pygame.K_d).set_holding(),
+        )
+
+
+class HybridControls(ActionContainer):
+    def __init__(self):
+        super().__init__(
+            bf.Action("up").add_key_control(pygame.K_UP, pygame.K_w).set_holding(),
+            bf.Action("down").add_key_control(pygame.K_DOWN, pygame.K_s).set_holding(),
+            bf.Action("left").add_key_control(pygame.K_LEFT, pygame.K_a).set_holding(),
+            bf.Action("right")
+            .add_key_control(pygame.K_RIGHT, pygame.K_r)
+            .set_holding(),
+        )

batFramework/animatedSprite.py

@@ -2,7 +2,6 @@ import batFramework as bf
 import pygame
 
 
-
 def search_index(target, lst):
     cumulative_sum = 0
     for index, value in enumerate(lst):
@@ -13,12 +12,14 @@ def search_index(target, lst):
 
 
 class AnimState:
-    def __init__(self,name:str, file, width, height, frame_length_list:list|int) -> None:
+    def __init__(
+        self, name: str, file, width, height, frame_length_list: list | int
+    ) -> None:
         self.frames: list[pygame.Surface] = bf.utils.img_slice(file, width, height)
         self.frames_flipX: list[pygame.Surface] = bf.utils.img_slice(
             file, width, height, True
         )
-        self.name= name
+        self.name = name
         self.frame_length_list = []
         self.ffl_length = 0
         self.set_frame_length_list(frame_length_list)
@@ -26,34 +27,33 @@ class AnimState:
     def __repr__(self):
         return f"AnimState({self.name})"
 
-    def get_frame_index(self, counter:float|int):
+    def get_frame_index(self, counter: float | int):
         return search_index(int(counter % self.ffl_length), self.frame_length_list)
 
     def get_frame(self, counter, flip):
         i = self.get_frame_index(counter)
         return self.frames_flipX[i] if flip else self.frames[i]
 
-    def set_frame_length_list(self,frame_length_list:list[int]|int):
-        if isinstance(frame_length_list,int):
+    def set_frame_length_list(self, frame_length_list: list[int] | int):
+        if isinstance(frame_length_list, int):
             frame_length_list = [frame_length_list] * len(self.frames)
-        if len(frame_length_list) != len(self.frames) : 
+        if len(frame_length_list) != len(self.frames):
             raise ValueError("frame_length_list should have values for all frames")
         self.frame_length_list = frame_length_list
         self.ffl_length = sum(self.frame_length_list)
-        
+
 
 class AnimatedSprite(bf.DynamicEntity):
     def __init__(self, size=None) -> None:
         super().__init__(size, no_surface=True)
         self.float_counter = 0
         self.animStates: dict[str, AnimState] = {}
-        self.current_animState :str = ""
+        self.current_animState: str = ""
         self.flipX = False
         self._locked = False
 
-    def set_counter(self,value:float):
+    def set_counter(self, value: float):
         self.float_counter = value
-        
 
     def lock_animState(self):
         self._locked = True
@@ -64,20 +64,25 @@ class AnimatedSprite(bf.DynamicEntity):
     def set_flipX(self, value):
         self.flipX = value
 
-    def remove_animState(self, name:str):
-        if not name in self.animStates :return
-        self.animStates.pop(name) 
-        if self.current_animState == name : self.current_animState = list(self.animStates.keys())[0] if self.animStates else "" 
+    def remove_animState(self, name: str):
+        if not name in self.animStates:
+            return
+        self.animStates.pop(name)
+        if self.current_animState == name:
+            self.current_animState = (
+                list(self.animStates.keys())[0] if self.animStates else ""
+            )
 
     def add_animState(
         self, name: str, file: str, size: tuple[int, int], frame_length_list: list[int]
     ):
         if name in self.animStates:
             return
-        self.animStates[name] = AnimState(name,file, *size, frame_length_list)
-        if len(self.animStates) == 1 : self.set_animState(name)
+        self.animStates[name] = AnimState(name, file, *size, frame_length_list)
+        if len(self.animStates) == 1:
+            self.set_animState(name)
 
-    def set_animState(self, state:str, reset_counter=True, lock=False):
+    def set_animState(self, state: str, reset_counter=True, lock=False):
         if state not in self.animStates or self._locked:
             return False
         self.current_animState = state
@@ -95,7 +100,7 @@ class AnimatedSprite(bf.DynamicEntity):
         return True
 
     def get_state(self):
-        return self.animStates.get(self.current_animState,None)
+        return self.animStates.get(self.current_animState, None)
 
     def get_frame_index(self):
         return self.animStates[self.current_animState].get_frame_index(
@@ -103,7 +108,8 @@ class AnimatedSprite(bf.DynamicEntity):
         )
 
     def update(self, dt: float):
-        if not self.animStates : return
+        if not self.animStates:
+            return
         self.float_counter += 60 * dt
         if self.float_counter > self.get_state().ffl_length:
             self.float_counter = 0