crystalwindow 3.8.1__tar.gz → 3.8.4__tar.gz

{crystalwindow-3.8.1 → crystalwindow-3.8.4}/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

{crystalwindow-3.8.1/crystalwindow.egg-info → crystalwindow-3.8.4}/PKG-INFO

@@ -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 → crystalwindow-3.8.4}/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-3.8.1 → crystalwindow-3.8.4}/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-3.8.4/crystalwindow/sprites.py

@@ -0,0 +1,108 @@
+# sprites.py
+import random
+from tkinter import PhotoImage
+
+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)):
+        """
+        pos: (x, y)
+        size: (w, h) optional
+        image: PhotoImage or PIL ImageTk.PhotoImage
+        color: fallback rectangle color
+        """
+        self.pos = pos
+        self.x, self.y = pos
+        self.image = image
+        self.color = color
+
+        # 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'")
+
+        # Optional velocity
+        self.vel_x = 0
+        self.vel_y = 0
+
+    # === 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"]
+            return cls(pos, size=(w, h), color=color)
+        return cls(pos, image=img)
+
+    @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)
+
+    # === METHODS ===
+    def draw(self, win, cam=None):
+        """Draw sprite on CrystalWindow / Tk canvas"""
+        if cam:
+            draw_x, draw_y = cam.apply(self)
+        else:
+            draw_x, draw_y = self.x, self.y
+
+        if self.image:
+            win.canvas.create_image(draw_x, draw_y, anchor="nw", image=self.image)
+        else:
+            win.draw_rect(self.color, (draw_x, draw_y, self.width, self.height))
+
+    def move(self, dx, dy):
+        self.x += dx
+        self.y += dy
+        self.pos = (self.x, self.y)
+
+    def apply_velocity(self, dt=1):
+        self.x += self.vel_x * dt
+        self.y += self.vel_y * dt
+        self.pos = (self.x, self.y)
+
+    def colliderect(self, other):
+        return (
+            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 → crystalwindow-3.8.4/crystalwindow.egg-info}/PKG-INFO

@@ -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 → crystalwindow-3.8.4}/setup.py

@@ -7,7 +7,7 @@ with open("README.md", encoding="utf-8") as f:
 
 setup(
     name="crystalwindow",
-    version="3.8.1",  # Force metadata refresh
+    version="3.8.4",  # Force metadata refresh
     packages=find_packages(include=["crystalwindow", "crystalwindow.*"]),
 
     include_package_data=True,  # include package_data files

crystalwindow-3.8.1/crystalwindow/sprites.py

@@ -1,115 +0,0 @@
-# sprites.py
-from tkinter import PhotoImage
-from PIL import Image, ImageTk
-
-
-class Sprite:
-    def __init__(self, pos, size=None, image=None, color=(255, 0, 0)):
-        self.x, self.y = pos
-        self.pos = pos
-
-        self.image = None
-        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
-        elif size is not None:
-            self.width, self.height = size
-
-        else:
-            raise ValueError("Sprite needs 'size' or 'image'")
-
-        # Movement physics
-        self.vel_x = 0
-        self.vel_y = 0
-
-        # Optional direction flag
-        self.facing_left = False
-
-    # --------------------------------------
-    # Constructors
-    # --------------------------------------
-    @classmethod
-    def image(cls, img, pos):
-        if isinstance(img, dict) and img.get("fallback"):
-            w, h = img["size"]
-            color = img["color"]
-            return cls(pos, size=(w, h), color=color)
-        return cls(pos, image=img)
-
-    @classmethod
-    def rect(cls, pos, w, h, color=(255, 0, 0)):
-        return cls(pos, size=(w, h), color=color)
-
-    # --------------------------------------
-    # Draw
-    # --------------------------------------
-    def draw(self, win, cam=None):
-        if cam:
-            draw_x, draw_y = cam.apply(self)
-        else:
-            draw_x, draw_y = self.x, self.y
-
-        if self.image:
-            win.canvas.create_image(draw_x, draw_y, anchor="nw", image=self.image)
-        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
-        self.pos = (self.x, self.y)
-
-    def apply_velocity(self, dt=1):
-        self.x += self.vel_x * dt
-        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
-        )