crystalwindow 5.9__tar.gz → 6.0.1__tar.gz

{crystalwindow-5.9/crystalwindow.egg-info → crystalwindow-6.0.1}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 5.9
+Version: 6.0.1
 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.9 → crystalwindow-6.0.1}/crystalwindow/__init__.py

@@ -22,6 +22,7 @@ from .assets import (
     flip_vertical,
     LoopAnim,
     loop_images,
+    loop_imgs,
     load_file,
     Sound,
 )
@@ -70,6 +71,9 @@ from .System import System, Watchdog
 # === Score System ===
 from .scores import Score
 
+# === Spritesheets ===
+from .spritesheets import SpriteSheet
+
 __all__ = [
     # --- Core ---
     "Window", "Sprite", "TileMap", "Player", "Block", "Enemy", "Gravity", "FileHelper", "Mathematics",
@@ -85,6 +89,7 @@ __all__ = [
     "Animation",
     "LoopAnim",
     "loop_images",
+    "loop_imgs",
     "load_file",
     "Sound",
 
@@ -127,4 +132,7 @@ __all__ = [
 
     # --- Scores ---
     "Score",
+
+    # --- Spritesheets ---
+    "SpriteSheet",
 ]

{crystalwindow-5.9 → crystalwindow-6.0.1}/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-6.0.1/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-5.9 → crystalwindow-6.0.1/crystalwindow.egg-info}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 5.9
+Version: 6.0.1
 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.9 → crystalwindow-6.0.1}/crystalwindow.egg-info/SOURCES.txt

@@ -29,6 +29,7 @@ crystalwindow/messagebus.py
 crystalwindow/objects.py
 crystalwindow/scores.py
 crystalwindow/sprites.py
+crystalwindow/spritesheets.py
 crystalwindow/tilemap.py
 crystalwindow/ver_warner.py
 crystalwindow/websearch.py

{crystalwindow-5.9 → crystalwindow-6.0.1}/setup.py

@@ -7,7 +7,7 @@ with open("README.md", encoding="utf-8") as f:
 
 setup(
     name="crystalwindow",
-    version="5.9",  # Force metadata refresh
+    version="6.0.1",  # Force metadata refresh
     packages=find_packages(include=["crystalwindow", "crystalwindow.*"]),
 
     include_package_data=True,  # include package_data files
@@ -29,7 +29,7 @@ setup(
     url="https://pypi.org/project/crystalwindow/",
 
     project_urls={
-        "Homepage": "https://github.com/yourusername/crystalwindow",
+        "Homepage": "https://github.com/CrystalBallyHereXD/crystalwindow",
         "YouTube": "https://www.Youtube.com/@CrystalBallyHereXD",
         "PiWheels": "https://www.piwheels.org/project/crystalwindow/",
     },