crystalwindow 3.8.1__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

@@ -1,44 +1,55 @@
 # sprites.py
+import random
 from tkinter import PhotoImage
-from PIL import Image, ImageTk
 
+try:
+    from PIL import Image, ImageTk
+except ImportError:
+    Image = None
+    ImageTk = None
 
 class Sprite:
     def __init__(self, pos, size=None, image=None, color=(255, 0, 0)):
-        self.x, self.y = pos
+        """
+        pos: (x, y)
+        size: (w, h) optional
+        image: PhotoImage or PIL ImageTk.PhotoImage
+        color: fallback rectangle color
+        """
         self.pos = pos
-
-        self.image = None
+        self.x, self.y = pos
+        self.image = image
         self.color = color
 
-        # If fallback dict provided from assets
-        if isinstance(image, dict) and image.get("fallback"):
-            self.width, self.height = image["size"]
-            self.color = image["color"]
-
-        # Normal image
-        elif isinstance(image, PhotoImage):
-            self.set_image(image)
-
-        # Rectangle sprite
+        # Determine width/height
+        if image is not None:
+            try:
+                # Tkinter PhotoImage
+                self.width = image.width()
+                self.height = image.height()
+            except Exception:
+                try:
+                    # PIL ImageTk.PhotoImage
+                    self.width = image.width
+                    self.height = image.height
+                except Exception:
+                    raise ValueError("Sprite image has no size info")
         elif size is not None:
             self.width, self.height = size
-
         else:
             raise ValueError("Sprite needs 'size' or 'image'")
 
-        # Movement physics
+        # Optional velocity
         self.vel_x = 0
         self.vel_y = 0
 
-        # Optional direction flag
-        self.facing_left = False
-
-    # --------------------------------------
-    # Constructors
-    # --------------------------------------
+    # === CLASS METHODS ===
     @classmethod
     def image(cls, img, pos):
+        """
+        Create a sprite from an image.
+        Accepts fallback dict or actual PhotoImage.
+        """
         if isinstance(img, dict) and img.get("fallback"):
             w, h = img["size"]
             color = img["color"]
@@ -47,12 +58,12 @@ class Sprite:
 
     @classmethod
     def rect(cls, pos, w, h, color=(255, 0, 0)):
+        """Create sprite using a plain colored rectangle"""
         return cls(pos, size=(w, h), color=color)
 
-    # --------------------------------------
-    # Draw
-    # --------------------------------------
+    # === METHODS ===
     def draw(self, win, cam=None):
+        """Draw sprite on CrystalWindow / Tk canvas"""
         if cam:
             draw_x, draw_y = cam.apply(self)
         else:
@@ -63,9 +74,6 @@ class Sprite:
         else:
             win.draw_rect(self.color, (draw_x, draw_y, self.width, self.height))
 
-    # --------------------------------------
-    # Movement
-    # --------------------------------------
     def move(self, dx, dy):
         self.x += dx
         self.y += dy
@@ -76,40 +84,25 @@ class Sprite:
         self.y += self.vel_y * dt
         self.pos = (self.x, self.y)
 
-    # --------------------------------------
-    # Image setter
-    # --------------------------------------
-    def set_image(self, new_image):
-        """Set sprite image and update size."""
-        self.image = new_image
-        self.width = new_image.width()
-        self.height = new_image.height()
-
-    # --------------------------------------
-    # In-place flipping (optional)
-    # --------------------------------------
-    def flip_horizontal(self):
-        if not self.image:
-            return
-        pil = ImageTk.getimage(self.image)
-        flipped = pil.transpose(Image.FLIP_LEFT_RIGHT)
-        self.set_image(ImageTk.PhotoImage(flipped))
-        self.facing_left = not self.facing_left
-
-    def flip_vertical(self):
-        if not self.image:
-            return
-        pil = ImageTk.getimage(self.image)
-        flipped = pil.transpose(Image.FLIP_TOP_BOTTOM)
-        self.set_image(ImageTk.PhotoImage(flipped))
-
-    # --------------------------------------
-    # Collision
-    # --------------------------------------
     def colliderect(self, other):
         return (
-            self.x < other.x + other.width and
-            self.x + self.width > other.x and
-            self.y < other.y + other.height and
-            self.y + self.height > other.y
-        )
+            self.x < other.x + getattr(other, "width", 0) and
+            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
+
+    def set_image(self, img):
+        """Update sprite's image at runtime (like flipping)"""
+        self.image = img
+        # update width/height
+        if img is not None:
+            try:
+                self.width = img.width()
+                self.height = img.height()
+            except Exception:
+                try:
+                    self.width = img.width
+                    self.height = img.height
+                except:
+                    pass

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 3.8.1
+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.1.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=b_ErcbqoWduk4otxcETJhNsSNfpSUMmcjV4qL5gMf5g,3590
+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.1.dist-info/licenses/LICENSE,sha256=7pvUgvRXL3ED5VVAZPH5oGn1CaIXcyoDC9gqox6sB0g,1079
-crystalwindow-3.8.1.dist-info/METADATA,sha256=L7kncNlmZMHmJl0AeneiHfGYxt7UkJiYtBKeRXbVkhA,7340
-crystalwindow-3.8.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-crystalwindow-3.8.1.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
-crystalwindow-3.8.1.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.1.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