crystalwindow 5.8__py3-none-any.whl → 6.0__py3-none-any.whl

crystalwindow/__init__.py

@@ -22,6 +22,7 @@ from .assets import (
     flip_vertical,
     LoopAnim,
     loop_images,
+    loop_imgs,
     load_file,
     Sound,
 )
@@ -85,6 +86,7 @@ __all__ = [
     "Animation",
     "LoopAnim",
     "loop_images",
+    "loop_imgs",
     "load_file",
     "Sound",
 

crystalwindow/assets.py

@@ -1,6 +1,7 @@
 import os
 import random, json, pickle
 from tkinter import PhotoImage
+import time
 
 try:
     from PIL import Image, ImageTk
@@ -159,34 +160,86 @@ def flip_vertical(img):
 # LOOPING ANIMATIONS / IMAGES
 # --------------------------------------------------------
 class LoopAnim:
-    def __init__(self, frames, speed=0.2):
-        self.frames = frames
-        self.i = 0
-        self.speed = speed
+    """
+    Flexible looping animation.
+
+    Usage patterns:
+      - time-based using FPS:
+          anim = LoopAnim(frames, fps=12)
+          frame = anim.next()           # auto uses time delta internally
+      - manual dt-based (e.g., game loop provides dt):
+          anim = LoopAnim(frames, fps=24)
+          frame = anim.next(dt)         # dt in seconds
+      - legacy speed-based (per-call increment):
+          anim = LoopAnim(frames, speed=0.2)
+          frame = anim.next()           # increments by 'speed' each call
+
+    Notes:
+      - `frames` may be any iterable (list/tuple/set); it will be converted to a list.
+      - If frames is empty, returns None from `next()`.
+    """
+
+    def __init__(self, frames, fps=None, speed=None):
+        self.frames = [f for f in frames if f is not None]
+        self.length = len(self.frames)
+        self._index = 0
+
+        # time-based mode
+        self.fps = float(fps) if fps else None
+        self.frame_duration = (1.0 / self.fps) if self.fps and self.fps > 0 else None
+        self._acc = 0.0
+        self._last_time = time.time()
+
+        # legacy speed (per-call fractional index)
+        self.speed = float(speed) if speed else None
+        self._float_index = 0.0
 
-    def next(self):
-        """Return next frame automatically looping."""
+    def next(self, dt=None):
+        """Return next frame. If dt (seconds) provided, uses it; otherwise uses internal clock."""
         if not self.frames:
             return None
 
-        self.i += self.speed
-        if self.i >= len(self.frames):
-            self.i = 0
-
-        return self.frames[int(self.i)]
+        # Time-based FPS mode (preferred)
+        if self.frame_duration:
+            if dt is None:
+                now = time.time()
+                dt = now - self._last_time
+                self._last_time = now
+            self._acc += dt
+            advance = int(self._acc / self.frame_duration)
+            if advance > 0:
+                self._acc -= advance * self.frame_duration
+                self._index = (self._index + advance) % self.length
+            return self.frames[self._index]
+
+        # Legacy speed-per-call mode
+        if self.speed:
+            self._float_index += self.speed
+            if self._float_index >= self.length:
+                self._float_index = self._float_index % self.length
+            return self.frames[int(self._float_index)]
+
+        # Default: simple step each call
+        self._index = (self._index + 1) % self.length
+        return self.frames[self._index]
 
 
 def loop_images(*imgs, speed=0.2):
     """
-    Usage:
-        anim = loop_image(img1, img2, img3)
-        anim = loop_image(load_image("p1.png"), load_image("p2.png"))
+    Backwards-compatible wrapper.
+    Accepts varargs like loop_images(img1, img2, ...) or a single iterable:
+      loop_images([img1, img2], speed=0.2)
+
+    This returns a LoopAnim that uses legacy per-call `speed`.
     """
-    frames = [x for x in imgs if x is not None]
+    frames = []
+    if len(imgs) == 1 and hasattr(imgs[0], "__iter__") and not isinstance(imgs[0], (str, bytes)):
+        frames = [x for x in imgs[0] if x is not None]
+    else:
+        frames = [x for x in imgs if x is not None]
 
-    # If nothing was passed → fallback
     if not frames:
-        print("⚠️ loop_image() got no frames.")
+        print("⚠️ loop_images() got no frames.")
         fb = load_image("fallback.png") if os.path.exists("fallback.png") else None
         if fb is None:
             return LoopAnim([None], speed=speed)
@@ -195,6 +248,31 @@ def loop_images(*imgs, speed=0.2):
     return LoopAnim(frames, speed=speed)
 
 
+def loop_imgs(*imgs, framerate=None, speed=None):
+    """
+    New helper supporting a single iterable or varargs and an explicit framerate (FPS).
+    Usage:
+      idle = [idle1, idle2, idle3]
+      idles = loop_imgs(idle, framerate=24)      # time-based, 24 FPS
+      idles = loop_imgs(idle1, idle2, framerate=12)
+      idles = loop_imgs(idle, speed=0.2)         # fallback to legacy speed-per-call
+    """
+    frames = []
+    if len(imgs) == 1 and hasattr(imgs[0], "__iter__") and not isinstance(imgs[0], (str, bytes)):
+        frames = [x for x in imgs[0] if x is not None]
+    else:
+        frames = [x for x in imgs if x is not None]
+
+    if not frames:
+        print("⚠️ loop_imgs() got no frames.")
+        fb = load_image("fallback.png") if os.path.exists("fallback.png") else None
+        if fb is None:
+            return LoopAnim([None], fps=framerate, speed=speed)
+        return LoopAnim([fb], fps=framerate, speed=speed)
+
+    return LoopAnim(frames, fps=framerate, speed=speed)
+
+
 # --------------------------------------------------------
 # FOLDER LOADING
 # --------------------------------------------------------

crystalwindow/sprites.py

@@ -72,6 +72,10 @@ class Sprite:
         """Create sprite using a simple rectangle"""
         return cls(pos, size=(w, h), color=color)
 
+    @classmethod
+    def group(cls, *sprites):
+        """Create a list of sprites"""
+        return list(sprites)
 
     # === MOVE / DRAW ===
     def draw(self, win, cam=None):

crystalwindow/spritesheets.py

@@ -0,0 +1,26 @@
+from PIL import Image, ImageTk
+import xml.etree.ElementTree as ET
+
+class SpriteSheet:
+    def __init__(self, image_path, xml_path):
+        self.pil_image = Image.open(image_path).convert("RGBA")
+        self.frames = {}
+
+        tree = ET.parse(xml_path)
+        root = tree.getroot()
+
+        for sub in root.iter("SubTexture"):
+            name = sub.attrib["name"]
+            x = int(sub.attrib["x"])
+            y = int(sub.attrib["y"])
+            w = int(sub.attrib["width"])
+            h = int(sub.attrib["height"])
+
+            self.frames[name] = (x, y, w, h)
+
+    def get_pil(self, name):
+        x, y, w, h = self.frames[name]
+        return self.pil_image.crop((x, y, x + w, y + h))
+
+    def get_tk(self, name):
+        return ImageTk.PhotoImage(self.get_pil(name))

crystalwindow/window.py

@@ -218,6 +218,14 @@ class Window:
         
         return False
 
+    def keys_combined(self, *keys):
+        for key in keys:
+            if isinstance(key, str):
+                key = self.KEY_MAP.get(key, key)
+            if not self.keys.get(key, False):
+                return False
+        return True
+
     def key_held(self, key):
         if isinstance(key, str):
             key = self.KEY_MAP.get(key, key)
@@ -533,6 +541,14 @@ class Window:
         bold = kwargs.pop("bold", False)
         italic = kwargs.pop("italic", False)
 
+        pil_font = None
+
+        if hasattr(font, "font"):
+            pil_font = font.font
+            font_name = font.font_name
+        else:
+            font_name = font    
+
         # scale
         scaled_size = size
 
@@ -549,9 +565,9 @@ class Window:
 
         # tkinter font tuple
         if style:
-            font_tuple = (font, scaled_size, style)
+            font_tuple = (font_name, scaled_size, style)
         else:
-            font_tuple = (font, scaled_size)
+            font_tuple = (font_name, scaled_size)
 
         # ---------------- NORMAL COLOR TEXT ----------------
         if mode != "texture":
@@ -579,10 +595,19 @@ class Window:
         from PIL import Image, ImageDraw, ImageFont, ImageTk
 
         # try load font with style
-        try:
-            fnt = ImageFont.truetype(font + ".ttf", scaled_size)
-        except:
-            fnt = ImageFont.load_default()
+        # choose correct PIL font
+        if pil_font and hasattr(font, "font_path") and font.font_path:
+            try:
+                fnt = ImageFont.truetype(font.font_path, scaled_size)
+            except:
+                fnt = ImageFont.load_default()
+        elif pil_font:
+            fnt = pil_font
+        else:
+            try:
+                fnt = ImageFont.truetype(font_name + ".ttf", scaled_size)
+            except:
+                fnt = ImageFont.load_default()
 
         # measure text
         temp = Image.new("L", (1, 1), 0)

{crystalwindow-5.8.dist-info → crystalwindow-6.0.dist-info}/METADATA

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 5.8
+Version: 6.0
 Summary: A Tkinter powered window + GUI toolkit made by Crystal (ME)! Easier apps, smoother UI and all-in-one helpers!, Gui, Buttons, FileHelper, Sprites, Animations, Colors, Math, Gravity, Camera, 3D and more!
 Home-page: https://pypi.org/project/crystalwindow/
 Author: CrystalBallyHereXD
 Author-email: mavilla.519@gmail.com
-Project-URL: Homepage, https://github.com/yourusername/crystalwindow
+Project-URL: Homepage, https://github.com/CrystalBallyHereXD/crystalwindow
 Project-URL: YouTube, https://www.Youtube.com/@CrystalBallyHereXD
 Project-URL: PiWheels, https://www.piwheels.org/project/crystalwindow/
 Keywords: tkinter gui window toolkit easy crystalwindow crystal cw player moveable easygui python py file math gravity hex color

{crystalwindow-5.8.dist-info → crystalwindow-6.0.dist-info}/RECORD

@@ -1,11 +1,11 @@
 crystalwindow/FileHelper.py,sha256=U20iwND4jX1y91TOK46e8MPH8xyw7GOrZ697nPEnOPk,10706
 crystalwindow/Fonts.py,sha256=XGqmM3GaauM5a74BtqhKk9zzKgQPcHyN3vcOP1TeoOs,954
 crystalwindow/System.py,sha256=-ecjzVlTH4ncNnZ_SDNfvqoQLeh8Zefy9laojpQKUUk,4045
-crystalwindow/__init__.py,sha256=whd-PzhvfO-6ALR7OpaomH0PDhfVjTP90I35DmoeYTk,3353
+crystalwindow/__init__.py,sha256=C2euU6HIqgx9a6tH0FP7Rt5Uj2Je99dxYP1P5jAtkXI,3387
 crystalwindow/ai.py,sha256=YIt6dNe1QljSAlNECCVa3DMUSIqQEJRIAAbQpYqFNNo,11525
 crystalwindow/animation.py,sha256=zHjrdBXQeyNaLAuaGPldJueX05OZ5j31YR8NizmR0uQ,427
 crystalwindow/apphelper.py,sha256=CAcX5n0Jq7zdBMFZkwbMt3_M0mBVVZRoXldOcXsZan4,2924
-crystalwindow/assets.py,sha256=qboSNaWY3fWfnQWRZCkVzpAn1aZYmSgQWVxaE2CNXGY,11406
+crystalwindow/assets.py,sha256=DkTPlywZFTgjWzxsy_byt28KYU4DYfdU_FS83akh3es,14673
 crystalwindow/camera.py,sha256=fe0DXIcZ-TSVPPHxRptFufadnkhysWRZDTJxjxf6SEo,1606
 crystalwindow/chatvpn.py,sha256=Ij3wRNrMbPINO-SX9vx8xlrKRLvG7zJgzAN2T0jzSz8,2477
 crystalwindow/clock.py,sha256=M7oMjnGNkFOcchqtQn_voWao4kFtxXpTJe2VUjqvGKQ,5041
@@ -24,11 +24,12 @@ crystalwindow/math.py,sha256=AGhLGkPWozNOMlSieF5u8jSDY0qakOPJIi5aWI9P91o,1598
 crystalwindow/messagebus.py,sha256=9K2P_TkdQ1rt-oouIkRg_XHwMTwykttBt-9gFYaItyI,696
 crystalwindow/objects.py,sha256=BWqjlxOXpaCGeaAocFL5L9Qh-a_MRjbN6Qb-Vd7R0K8,6262
 crystalwindow/scores.py,sha256=O5E-rceNEaRpsC3XZ2PpE5gsLvJk86f4ChA5UNdd4b0,1069
-crystalwindow/sprites.py,sha256=IADCQetFDQoat3qGpKkH93TdtqqgldfHl4N0HKX1Ajc,7480
+crystalwindow/sprites.py,sha256=REkKkKi1oDQBjnjM7fX-49_zsJmTlwpDpoX8PlTohtQ,7599
+crystalwindow/spritesheets.py,sha256=M_KTBAXPaM3liHf9-2rsQtXUB9GSQUkb07JS6S4-4iI,807
 crystalwindow/tilemap.py,sha256=endJ8KcbP9EjPvL9qWsOpV4jc_Re1yH080aUyDkwufA,3378
 crystalwindow/ver_warner.py,sha256=qEN3ulc1NixBy15FFx2R3Zu0DhyJTVJwiESGAPwpynM,3373
 crystalwindow/websearch.py,sha256=IgsoKt27yCBHeq8yFVfSq_8sEj5KP6mqn2yNRTsRw1A,5161
-crystalwindow/window.py,sha256=i9VRJyVVMQoLzaHbOuZHsdmtmwXRA9h-pL_Tc8Kb5XY,32327
+crystalwindow/window.py,sha256=yo_Onk0RYEjUMhzKsNXJDBlYYFF9l9Nhbxiza3wf4UY,33128
 crystalwindow/Icons/default_icon.png,sha256=Loq27Pxb8Wb3Sz-XwtNF1RmlLNxR4TcfOWfK-1lWcII,7724
 crystalwindow/Icons/file_icons.png,sha256=kqjvz3gMaIbepW4XGrLZOjDYu-yhFbVxjvylS-0RO4U,5659
 crystalwindow/gametests/3dsquare.py,sha256=MM_RRx1mz_NeBhTAoNomzn_IAbbN4ZnQZWA9VAFL8mY,821
@@ -40,8 +41,8 @@ crystalwindow/gametests/sandbox.py,sha256=Oo2tU2N0y3BPVa6T5vs_h9N6islhQrjSrr_78X
 crystalwindow/gametests/squaremove.py,sha256=ei6DMnvcgpOhmxbGv-Yqmx5EqiZjKbVlZhI7YbT2hY8,643
 crystalwindow/gametests/testtttagain.py,sha256=oIhK9MGgMVly_W2lRwD9Hn9WyPdd8JnX2HGrLTGZdxY,373
 crystalwindow/gametests/windowtesting.py,sha256=_9X6wnV1-_X_PtNS-0zu-k209NtFIwAc4vpxLPp7V2o,97
-crystalwindow-5.8.dist-info/licenses/LICENSE,sha256=Gt5cJRchdNt0guxyQMHKsATN5PM5mjuDhdO6Gzs9qQc,1096
-crystalwindow-5.8.dist-info/METADATA,sha256=Dmffz8ly1Vcfaowu4Hj7IsXF4071v5H-tgxZKV7t-fQ,7523
-crystalwindow-5.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-crystalwindow-5.8.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
-crystalwindow-5.8.dist-info/RECORD,,
+crystalwindow-6.0.dist-info/licenses/LICENSE,sha256=Gt5cJRchdNt0guxyQMHKsATN5PM5mjuDhdO6Gzs9qQc,1096
+crystalwindow-6.0.dist-info/METADATA,sha256=0LMK1XhmvQ2yKbO-ouU5m43xp-MFo2SsEM7VBmG_IfA,7529
+crystalwindow-6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+crystalwindow-6.0.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
+crystalwindow-6.0.dist-info/RECORD,,