crystalwindow 3.8.3__py3-none-any.whl → 3.8.4__py3-none-any.whl

crystalwindow/__init__.py

@@ -20,6 +20,8 @@ from .assets import (
     flip_image,
     flip_horizontal,
     flip_vertical,
+    LoopAnim,
+    loop_image,
 )
 from .animation import Animation
 
@@ -60,6 +62,8 @@ __all__ = [
     "flip_horizontal",
     "flip_vertical",
     "Animation",
+    "LoopAnim",
+    "loop_image",
 
     # --- Collision ---
     "check_collision", "resolve_collision",

crystalwindow/assets.py

@@ -118,6 +118,47 @@ def flip_horizontal(img):
 def flip_vertical(img):
     return flip_image(img, flip_v=True)
 
+# --------------------------------------------------------
+# LOOPING ANIMAITONS/IMAGES
+# --------------------------------------------------------
+class LoopAnim:
+    def __init__(self, frames, speed=0.2):
+        self.frames = frames
+        self.i = 0
+        self.speed = speed
+
+    def next(self):
+        """Return next frame automatically looping."""
+        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)]
+
+
+def loop_image(*imgs, speed=0.2):
+    """
+    Usage:
+        anim = loop_image(img1, img2, img3)
+        anim = loop_image(load_image("p1.png"), load_image("p2.png"))
+
+    Returns a LoopAnim object.
+    """
+    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.")
+        fb = load_image("fallback.png") if os.path.exists("fallback.png") else None
+        if fb is None:
+            return LoopAnim([None], speed=speed)
+        return LoopAnim([fb], speed=speed)
+
+    return LoopAnim(frames, speed=speed)
+
 
 # --------------------------------------------------------
 # FOLDER LOADING

crystalwindow/sprites.py

@@ -90,7 +90,7 @@ class Sprite:
             self.x + getattr(self, "width", 0) > other.x and
             self.y < other.y + getattr(other, "height", 0) and
             self.y + getattr(self, "height", 0) > other.y
-        ),  # returns tuple for consistency
+        )  # returns tuple for consistency
 
     def set_image(self, img):
         """Update sprite's image at runtime (like flipping)"""

{crystalwindow-3.8.3.dist-info → crystalwindow-3.8.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 3.8.3
+Version: 3.8.4
 Summary: A Tkinter powered window + GUI toolkit made by Crystal (MEEEEEE)! Easier apps, smoother UI and all-in-one helpers!
 Home-page: https://pypi.org/project/crystalwindow/
 Author: CrystalBallyHereXD

{crystalwindow-3.8.3.dist-info → crystalwindow-3.8.4.dist-info}/RECORD

@@ -1,7 +1,7 @@
 crystalwindow/FileHelper.py,sha256=aUnnRG7UwvzJt-idjWjmpwy3RM6nqLlC3-7Bae6Yb94,5471
-crystalwindow/__init__.py,sha256=1O0qUvD6dGRZEwCXZU5byqWQUdRNYhyUZ54SN_NM2Dk,2015
+crystalwindow/__init__.py,sha256=c8-c4hLW3AhIN9J8uNVGSTz6Navsfs7FGexV55lkP6g,2083
 crystalwindow/animation.py,sha256=zHjrdBXQeyNaLAuaGPldJueX05OZ5j31YR8NizmR0uQ,427
-crystalwindow/assets.py,sha256=3FubtFHcemIFBiV5h79QyvKkHiLSUNBEPbGP4UyGRyI,3999
+crystalwindow/assets.py,sha256=2Cj0zdhMWo3mWjdr9KU5n-9_8iKj_fJ9uShMFA-27HU,5193
 crystalwindow/camera.py,sha256=tbn4X-jxMIszAUg3Iu-89gJN5nij0mjPMEzGotcLbJI,712
 crystalwindow/clock.py,sha256=iryeURnfXx6TIDyJhpxe0KkeSaHCdxrMckN6Tby00i0,461
 crystalwindow/collision.py,sha256=hpkHTp_KparghVK-itp_rxuYdd2GbQMxICHlUBv0rSw,472
@@ -16,7 +16,7 @@ crystalwindow/gui.py,sha256=D-El18XUaZQR-XZoOr28hnhO7EEoGuypCHxPbPR_yng,3680
 crystalwindow/gui_ext.py,sha256=ZhNgc5eK6Vzj-jUNeFzimuEbLnTmM7Bx594Z34_N0oM,2856
 crystalwindow/math.py,sha256=slOY3KQZ99VDMUMxsSJabMyRtJcwVzEyxR2RoXspHho,963
 crystalwindow/player.py,sha256=4wpIdUZLTlRXV8fDRQ11yVJRbx_cv8Ekpn2y7pQGgAQ,3442
-crystalwindow/sprites.py,sha256=V84FBsr4DJKLtart3OEb8lvLow20wZ6JuVZ5I4TRiFg,3412
+crystalwindow/sprites.py,sha256=2kYW4QfSnyUwRLedZCkb99wUSxn2a0JdWOHcfkxcG0U,3411
 crystalwindow/tilemap.py,sha256=PHoKL1eWuNeHIf0w-Jh5MGdQGEgklVsxqqJOS-GNMKI,322
 crystalwindow/ver_warner.py,sha256=qEN3ulc1NixBy15FFx2R3Zu0DhyJTVJwiESGAPwpynM,3373
 crystalwindow/window.py,sha256=e6C8yIdVdjOduIeU0ZmlrNn8GmyvHuzKs473pRggkz0,18180
@@ -31,8 +31,8 @@ crystalwindow/gametests/guitesting.py,sha256=SrOssY5peCQEV6TQ1AiOWtjb9phVGdRzW-Q
 crystalwindow/gametests/sandbox.py,sha256=Oo2tU2N0y3BPVa6T5vs_h9N6islhQrjSrr_78XLut5I,1007
 crystalwindow/gametests/squaremove.py,sha256=poP2Zjl2oc2HVvIAgIK34H2jVj6otL4jEdvAOR6L9sI,572
 crystalwindow/gametests/windowtesting.py,sha256=_9X6wnV1-_X_PtNS-0zu-k209NtFIwAc4vpxLPp7V2o,97
-crystalwindow-3.8.3.dist-info/licenses/LICENSE,sha256=7pvUgvRXL3ED5VVAZPH5oGn1CaIXcyoDC9gqox6sB0g,1079
-crystalwindow-3.8.3.dist-info/METADATA,sha256=h_abo60ExVg_jZNFt6rUHUUzAmx1MTDaDcxMJJ-v4CI,7340
-crystalwindow-3.8.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-crystalwindow-3.8.3.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
-crystalwindow-3.8.3.dist-info/RECORD,,
+crystalwindow-3.8.4.dist-info/licenses/LICENSE,sha256=Gt5cJRchdNt0guxyQMHKsATN5PM5mjuDhdO6Gzs9qQc,1096
+crystalwindow-3.8.4.dist-info/METADATA,sha256=sNkJRxTwkTfPeCtzmhkyLMV0FA8NDjLKxgZ5GTVmxv4,7340
+crystalwindow-3.8.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+crystalwindow-3.8.4.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
+crystalwindow-3.8.4.dist-info/RECORD,,

{crystalwindow-3.8.3.dist-info → crystalwindow-3.8.4.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 C
+Copyright (c) 2025 CrystalBallyHereXD
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal