e2D 1.4.12__py3-none-any.whl → 1.4.13__py3-none-any.whl

e2D/__init__.py

@@ -2,11 +2,12 @@ from __future__ import annotations
 
 import math as _mt
 import random as _rnd
+from typing import Any, Generator, Literal
 
 PI = _mt.pi
-HALF_PI = PI/2
-QUARTER_PI = PI/4
-DOUBLE_PI = PI*2
+PI_HALF = PI/2
+PI_QUARTER = PI/4
+PI_DOUBLE = PI*2
 
 sign = lambda val: -1 if val < 0 else (1 if val > 0 else 0)
 
@@ -51,6 +52,10 @@ class Vector2D:
     @property
     def length(self) -> float:
         return (self.x ** 2 + self.y ** 2) ** .5
+    
+    @property
+    def length_sqrd(self) -> float:
+        return self.x ** 2 + self.y ** 2
 
     def floor(self, n=1) -> "Vector2D":
         return self.__floor__(n)
@@ -356,6 +361,10 @@ class Vector2D:
         else:
             raise IndexError("V2 has only x,y...")
     
+    def __iter__(self) -> Generator[float, Any, None]:
+        yield self.x
+        yield self.y
+    
     @classmethod
     def __normalize__(cls, other) -> "Vector2D":
         if isinstance(other, Vector2D):
@@ -496,22 +505,22 @@ VECTORS_8_DIRECTIONS_NORM = (V2right, V2down_right_norm, V2down, V2down_left_nor
 def rgb(r:float, g:float, b:float) -> tuple[float, float, float]:
     return (r,g,b)
 
-# def color_lerp(current_c:list|tuple, final_c:list|tuple, step=.1) -> tuple[float, float, float]:
-#     return tuple(c + (final_c[i] - c) * step for i,c in enumerate(current_c)) #type: ignore
+def color_lerp(current_c:list|tuple, final_c:list|tuple, step=.1) -> tuple[float, float, float]:
+    return tuple(c + (final_c[i] - c) * step for i,c in enumerate(current_c)) #type: ignore
 
-# def color_fade(starting_c:list|tuple, final_c:list|tuple, index, max_index) -> tuple[float, float, float]:
-#     return tuple((starting_c[i] - final_c[i]) / max_index * (max_index - index) + final_c[i] for i in range(3)) #type: ignore
+def color_fade(starting_c:list|tuple, final_c:list|tuple, index, max_index) -> tuple[float, float, float]:
+    return tuple((starting_c[i] - final_c[i]) / max_index * (max_index - index) + final_c[i] for i in range(3)) #type: ignore
 
-# def weighted_color_fade(colors_dict:dict) -> tuple[float, float, float]:
-#     colors = colors_dict.keys()
-#     weights = colors_dict.values()
+def weighted_color_fade(colors_dict:dict) -> tuple[float, float, float]:
+    colors = colors_dict.keys()
+    weights = colors_dict.values()
 
-#     if float("inf") in weights: return list(colors)[list(weights).index(float("inf"))]
-#     return tuple(sum(n[i]*w for n,w in zip(colors, weights)) / sum(weights) for i in range(3)) #type: ignore
+    if float("inf") in weights: return list(colors)[list(weights).index(float("inf"))]
+    return tuple(sum(n[i]*w for n,w in zip(colors, weights)) / sum(weights) for i in range(3)) #type: ignore
 
-# def color_distance(starting_c:list|tuple, final_c:list|tuple, sqrd) -> float:
-#     distance = sum([(starting_c[i]-final_c[i])**2 for i in range(3)])
-#     return (distance ** .5) if sqrd else distance
+def color_distance(starting_c:list|tuple, final_c:list|tuple, sqrd) -> float:
+    distance = sum([(starting_c[i]-final_c[i])**2 for i in range(3)])
+    return (distance ** .5) if sqrd else distance
 
 def lerp(starting, ending, step=.1) -> float:
     return starting + (ending - starting) * step
@@ -522,7 +531,7 @@ def angular_interpolation(starting_angle, final_angle, step=.1) -> float:
     # return starting_angle + min((delta, delta - DOUBLE_PI, delta + DOUBLE_PI), key=abs) * step
     
     # math way
-    shortest_angle = ((((final_angle - starting_angle) % DOUBLE_PI) + DOUBLE_PI * 1.5) % DOUBLE_PI) - PI
+    shortest_angle = ((((final_angle - starting_angle) % PI_DOUBLE) + PI_DOUBLE * 1.5) % PI_DOUBLE) - PI
     return starting_angle + shortest_angle * step
 
 def bezier_cubic_interpolation(t, p0, p1) -> float:

e2D/__init__.pyi

@@ -1,10 +1,10 @@
 from __future__ import annotations
-from typing import Callable, Literal
+from typing import Any, Callable, Generator, Literal
 
 PI : float
-HALF_PI : float
-QUARTER_PI : float
-DOUBLE_PI : float
+PI_HALF : float
+PI_QUARTER : float
+PI_DOUBLE : float
 
 # regular expression to remove comments:
 # """([\s\S]*?)"""
@@ -246,6 +246,10 @@ class Vector2D:
     def length(self:"Vector2D") -> float:
         ...
 
+    @property
+    def length_sqrd(self:"Vector2D") -> float:
+        ...
+
     def floor(self:"Vector2D", n:"int|float|Vector2D"=1) -> "Vector2D":
         ...
 
@@ -664,7 +668,9 @@ class Vector2D:
 
     def __float__(self:"Vector2D") -> "Vector2D": ...
 
-    def __getitem__(self:"Vector2D", n) -> int|float: ...
+    def __getitem__(self:"Vector2D", n:Literal[0,1,"x","y"]) -> int|float: ...
+
+    def __iter__(self:"Vector2D") -> Generator[float, Any, None]: ...
     
     @classmethod
     def __normalize__(cls, other:"Vector2D|int|float|tuple|list") -> "Vector2D": ...
@@ -796,138 +802,133 @@ def rgb(r:float, g:float, b:float) -> tuple[float, float, float]:
 
 def lerp(starting: int|float, ending: int|float, step: int|float=.1) -> float: ...
 
-# def color_lerp(current_c: list|tuple, final_c: list|tuple, step: int|float=.1) -> tuple[float, float, float]:
-#     """
-#     # Linearly interpolate between two colors.
+def color_lerp(current_c: list|tuple, final_c: list|tuple, step: int|float=.1) -> tuple[float, float, float]:
+    """
+    # Linearly interpolate between two colors.
 
-#     ## Parameters:
-#         current_c (tuple or list): The RGB values of the current color as a tuple or list.
-#         final_c (tuple or list): The RGB values of the target color as a tuple or list.
-#         step (int or float): The interpolation step, ranging from 0.0 (current color) to 1.0 (target color).
+    ## Parameters:
+        current_c (tuple or list): The RGB values of the current color as a tuple or list.
+        final_c (tuple or list): The RGB values of the target color as a tuple or list.
+        step (int or float): The interpolation step, ranging from 0.0 (current color) to 1.0 (target color).
 
-#     ## Returns:
-#         tuple: The RGB values of the interpolated color as a tuple.
+    ## Returns:
+        tuple: The RGB values of the interpolated color as a tuple.
 
-#     ## Example:
-#         current_c = (255, 0, 0)
+    ## Example:
+        current_c = (255, 0, 0)
 
-#         final_c = (0, 0, 255)
+        final_c = (0, 0, 255)
 
-#         step = 0.5
+        step = 0.5
 
-#         interpolated_color = color_lerp(current_c, final_c, step)
+        interpolated_color = color_lerp(current_c, final_c, step)
 
-#         print(f"At step {step}: RGB {interpolated_color}")
+        print(f"At step {step}: RGB {interpolated_color}")
         
-#     This will calculate the color at an interpolation step of 0.5 between (255, 0, 0) and (0, 0, 255).
-#     """
-#     return tuple(c + (final_c[i] - c) * step for i,c in enumerate(current_c)) #type: ignore
+    This will calculate the color at an interpolation step of 0.5 between (255, 0, 0) and (0, 0, 255).
+    """
+    ...
 
-# def color_fade(starting_c: list|tuple, final_c: list|tuple, index: int|float, max_index: int|float) -> tuple[float, float, float]:
-#     """
-#     # Calculate the color at a specific index of a color fade between two given colors.
+def color_fade(starting_c: list|tuple, final_c: list|tuple, index: int|float, max_index: int|float) -> tuple[float, float, float]:
+    """
+    # Calculate the color at a specific index of a color fade between two given colors.
 
-#     ## Parameters:
-#         starting_c (tuple or list): The RGB values of the starting color as a tuple or list.
-#         final_c (tuple or list): The RGB values of the final color as a tuple or list.
-#         index (int or float): The current index of the color fade, representing a position
-#                               between the starting and final colors.
-#         max_index (int or float): The maximum index of the color fade, indicating the endpoint
-#                                   position between the starting and final colors.
+    ## Parameters:
+        starting_c (tuple or list): The RGB values of the starting color as a tuple or list.
+        final_c (tuple or list): The RGB values of the final color as a tuple or list.
+        index (int or float): The current index of the color fade, representing a position
+                              between the starting and final colors.
+        max_index (int or float): The maximum index of the color fade, indicating the endpoint
+                                  position between the starting and final colors.
 
-#     ## Returns:
-#         tuple: The RGB values of the color at the specified index as a tuple.
+    ## Returns:
+        tuple: The RGB values of the color at the specified index as a tuple.
 
-#     ## Example:
-#         starting_c = (255, 0, 0)
+    ## Example:
+        starting_c = (255, 0, 0)
 
-#         final_c = (0, 0, 255)
+        final_c = (0, 0, 255)
 
-#         max_index = 100
+        max_index = 100
 
-#         for i in range(max_index + 1):
+        for i in range(max_index + 1):
         
-#             color_at_index = color_fade(starting_c, final_c, i, max_index)
+            color_at_index = color_fade(starting_c, final_c, i, max_index)
 
-#             print(f"At index {i}: RGB {color_at_index}")
+            print(f"At index {i}: RGB {color_at_index}")
             
-#         This will print the colors transitioning from (255, 0, 0) to (0, 0, 255).
-#     """
-#     return tuple((starting_c[i] - final_c[i]) / max_index * (max_index - index) + final_c[i] for i in range(3)) #type: ignore
+        This will print the colors transitioning from (255, 0, 0) to (0, 0, 255).
+    """
+    ...
 
-# def weighted_color_fade(colors_dict:dict) -> tuple[float, float, float]:
-#     """
-#     # Calculate the weighted color based on a dictionary of colors and their corresponding weights.
+def weighted_color_fade(colors_dict:dict) -> tuple[float, float, float]:
+    """
+    # Calculate the weighted color based on a dictionary of colors and their corresponding weights.
 
-#     ## Parameters:
-#         colors_dict (dict): A dictionary where keys represent RGB color values as tuples,
-#                             and values represent the weights (floats) for each color.
+    ## Parameters:
+        colors_dict (dict): A dictionary where keys represent RGB color values as tuples,
+                            and values represent the weights (floats) for each color.
 
-#     ## Returns:
-#         tuple: The RGB values of the calculated weighted color as a tuple.
+    ## Returns:
+        tuple: The RGB values of the calculated weighted color as a tuple.
 
-#     ## Example:
-#         colors_dict = {
+    ## Example:
+        colors_dict = {
         
-#             (255, 255, 255): 0.1,
+            (255, 255, 255): 0.1,
 
-#             (0, 0, 0): 0.9,
+            (0, 0, 0): 0.9,
 
-#         }
+        }
 
-#         weighted_color = weighted_color_fade(colors_dict)
+        weighted_color = weighted_color_fade(colors_dict)
 
-#         print(f"Weighted color: RGB {weighted_color}")
+        print(f"Weighted color: RGB {weighted_color}")
 
-#         This will print the weighted color based on the provided dictionary.
-#     """
-#     colors = colors_dict.keys()
-#     weights = colors_dict.values()
-
-#     if float("inf") in weights: return list(colors)[list(weights).index(float("inf"))]
-#     return tuple(sum(n[i]*w for n,w in zip(colors, weights)) / sum(weights) for i in range(3)) #type: ignore
-
-# def color_distance(starting_c: list|tuple, final_c: list|tuple, sqrd:bool=True) -> float:
-#     """
-#     # Calculate the distance between two colors in RGB space.
+        This will print the weighted color based on the provided dictionary.
+    """
+    ...
 
-#     ## Parameters:
-#         starting_c (list or tuple): The RGB values of the starting color.
-#         final_c (list or tuple): The RGB values of the final color.
-#         sqrd (bool, optional): If True, return the squared distance. If False, return
-#                                the actual distance. Default is True.
+def color_distance(starting_c: list|tuple, final_c: list|tuple, sqrd:bool=True) -> float:
+    """
+    # Calculate the distance between two colors in RGB space.
 
-#     ## Returns:
-#         float: The squared distance between the two colors if `sqrd` is True, otherwise
-#                the actual distance.
+    ## Parameters:
+        starting_c (list or tuple): The RGB values of the starting color.
+        final_c (list or tuple): The RGB values of the final color.
+        sqrd (bool, optional): If True, return the squared distance. If False, return
+                               the actual distance. Default is True.
 
-#     ## Example:
-#         starting_c = [255, 0, 0]
+    ## Returns:
+        float: The squared distance between the two colors if `sqrd` is True, otherwise
+               the actual distance.
 
-#         final_c = [0, 255, 0]
+    ## Example:
+        starting_c = [255, 0, 0]
 
-#         squared_distance = color_distance(starting_c, final_c)
+        final_c = [0, 255, 0]
 
-#         print(f"Squared Distance: {squared_distance}")
+        squared_distance = color_distance(starting_c, final_c)
 
-#         distance = color_distance(starting_c, final_c, sqrd=False)
+        print(f"Squared Distance: {squared_distance}")
 
-#         print(f"Actual Distance: {distance}")
+        distance = color_distance(starting_c, final_c, sqrd=False)
 
-#         This will calculate the squared and actual distances between the colors.
+        print(f"Actual Distance: {distance}")
 
-#     ## Explanation:
-#         The function first calculates the squared distance between the two colors in RGB
-#         space. It does this by computing the sum of the squared differences of the RGB
-#         components for each color. The squared distance is obtained by taking the square
-#         root of this sum.
+        This will calculate the squared and actual distances between the colors.
 
-#         The `sqrd` parameter allows the user to choose between returning the squared
-#         distance or the actual distance. If `sqrd` is True, the function returns the
-#         squared distance, and if `sqrd` is False, it returns the actual distance.
-#     """
-#     distance = sum([(starting_c[i]-final_c[i])**2 for i in range(3)])
-#     return (distance ** .5) if sqrd else distance
+    ## Explanation:
+        The function first calculates the squared distance between the two colors in RGB
+        space. It does this by computing the sum of the squared differences of the RGB
+        components for each color. The squared distance is obtained by taking the square
+        root of this sum.
+
+        The `sqrd` parameter allows the user to choose between returning the squared
+        distance or the actual distance. If `sqrd` is True, the function returns the
+        squared distance, and if `sqrd` is False, it returns the actual distance.
+    """
+    ...
 
 def angular_interpolation(starting_angle: int|float, final_angle: int|float, step: int|float=.1) -> float:
     """

e2D/envs.py

@@ -41,13 +41,13 @@ class RootEnv:
                  show_fps = True,
                  quit_on_key_pressed : None|int = pg.K_x,
                  vsync : bool = True,
-                 window_flag : int = 0,
+                 window_flags : int = pg.DOUBLEBUF,
                  clear_screen_each_frame : bool = True) -> None:
         self.quit = False
         self.__screen_size__ :Vector2D= screen_size
 
         self.__vsync__ = vsync
-        self.__flags__ = window_flag
+        self.__flags__ = window_flags
         self.screen = pg.display.set_mode(self.__screen_size__(), vsync=self.__vsync__, flags=self.__flags__)
 
         self.clock = pg.time.Clock()
@@ -108,7 +108,7 @@ class RootEnv:
     
     @property
     def runtime_seconds(self) -> float:
-        return pg.time.get_ticks()
+        return pg.time.get_ticks() / 1e3
     
     def init(self, sub_env:DefEnv) -> None:
         self.env = sub_env
@@ -147,11 +147,12 @@ class RootEnv:
         self.clock.tick(self.target_fps)
         self.current_fps = self.clock.get_fps()
         if self.clear_screen_each_frame: self.clear()
-        if self.show_fps: self.print(str(round(self.current_fps,2)), self.screen_size * .01, bg_color=(0,0,0))
         
         self.env.draw()
         for util in self.utils.values(): util.draw()
-        pg.display.update()
+        
+        if self.show_fps: self.print(str(round(self.current_fps,2)), self.screen_size * .01, bg_color=(0,0,0))
+        pg.display.flip()
     
     def __update__(self) -> None:
         self.mouse.update()

{e2D-1.4.12.dist-info → e2D-1.4.13.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: e2D
-Version: 1.4.12
+Version: 1.4.13
 Summary: Python library for 2D games. Streamlines dev with keyboard/mouse input, vector calculations, color manipulation, and collision detection. Simplify game creation and unleash creativity!
 Home-page: https://github.com/marick-py/e2D
 Author: Riccardo Mariani

e2D-1.4.13.dist-info/RECORD

@@ -0,0 +1,12 @@
+e2D/__init__.py,sha256=0bgnk4XOipVE1FAeOSwkJ85I8sXzLPEj8TnrNXGP7bw,23188
+e2D/__init__.pyi,sha256=vJjIrU1F8qLyyL5OcFyW56reghTOu4qQ7xqwwYesBzA,47925
+e2D/cvb.py,sha256=xMpwUBE1G2TOdah-x62W_6yXZey-n1p0OkvfiijZfNY,37445
+e2D/envs.py,sha256=yh_NBLSgZFi3zwGbSzR7tZTRDn2hKzC-oQNTWQRS7VA,6292
+e2D/plots.py,sha256=qNQZTwpYqDyonXGv_cDt-R3nGvu3xR7RSFDRdJma4rA,36069
+e2D/utils.py,sha256=7SkfQj5Y6J3_pW9ssWMKVDSawrDANv3GtehGRVeH96k,14048
+e2D/winrec.py,sha256=QMcQrED4xC8o5KAHEbhOR03lJ_-XRNAtUI3y-cRHsck,1122
+e2D-1.4.13.dist-info/LICENSE,sha256=wymkNVDvj3qmjdO_rAhkRPM4t5y3_SqffGsFdgfvznU,1066
+e2D-1.4.13.dist-info/METADATA,sha256=1kkNPGcb63ZzfUf-HluW5dwHCkTAcSJ_NrmLT7brPV0,9611
+e2D-1.4.13.dist-info/WHEEL,sha256=a7TGlA-5DaHMRrarXjVbQagU3Man_dCnGIWMJr5kRWo,91
+e2D-1.4.13.dist-info/top_level.txt,sha256=3vKZ-CGzNlTCpzVMmM0Ht76krCofKw7hZ0wBf-dnKdM,4
+e2D-1.4.13.dist-info/RECORD,,

{e2D-1.4.12.dist-info → e2D-1.4.13.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.1.0)
+Generator: setuptools (75.4.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

e2D-1.4.12.dist-info/RECORD

@@ -1,12 +0,0 @@
-e2D/__init__.py,sha256=rHhqZG95FEZ8lkU8QRClAPcvgQeNqcKE_kszwCXAw3Y,22971
-e2D/__init__.pyi,sha256=U_mwTgruVO91O3y0CJxp9jJpO-ngcxbO9zREPo5U0xA,48495
-e2D/cvb.py,sha256=xMpwUBE1G2TOdah-x62W_6yXZey-n1p0OkvfiijZfNY,37445
-e2D/envs.py,sha256=dnve_1pmtN9P3tyXOc51yerI8GzP2pSkFsrsoKY62xk,6266
-e2D/plots.py,sha256=qNQZTwpYqDyonXGv_cDt-R3nGvu3xR7RSFDRdJma4rA,36069
-e2D/utils.py,sha256=7SkfQj5Y6J3_pW9ssWMKVDSawrDANv3GtehGRVeH96k,14048
-e2D/winrec.py,sha256=QMcQrED4xC8o5KAHEbhOR03lJ_-XRNAtUI3y-cRHsck,1122
-e2D-1.4.12.dist-info/LICENSE,sha256=wymkNVDvj3qmjdO_rAhkRPM4t5y3_SqffGsFdgfvznU,1066
-e2D-1.4.12.dist-info/METADATA,sha256=RPqIVVgTietngTbLEDXlPuz4Ry4eco4_0oiSvPnX13A,9611
-e2D-1.4.12.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-e2D-1.4.12.dist-info/top_level.txt,sha256=3vKZ-CGzNlTCpzVMmM0Ht76krCofKw7hZ0wBf-dnKdM,4
-e2D-1.4.12.dist-info/RECORD,,