crystalwindow 3.7.1b1__tar.gz → 3.8.3__tar.gz

{crystalwindow-3.7.1b1/crystalwindow.egg-info → crystalwindow-3.8.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 3.7.1b1
+Version: 3.8.3
 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.7.1b1 → crystalwindow-3.8.3}/crystalwindow/__init__.py

@@ -12,7 +12,15 @@ from .FileHelper import FileHelper
 from .math import Mathematics
 
 # === Assets & Animation ===
-from .assets import load_image, load_folder_images, load_music, play_music
+from .assets import (
+    load_image,
+    load_folder_images,
+    load_music,
+    play_music,
+    flip_image,
+    flip_horizontal,
+    flip_vertical,
+)
 from .animation import Animation
 
 # === Collision ===
@@ -23,7 +31,7 @@ from .gui import Button, Label, GUIManager, random_color, hex_to_rgb, Fade
 from .gui_ext import Toggle, Slider
 
 # === Time ===
-from .clock import Clock  # ⏰ for frame timing / tick control
+from .clock import Clock
 
 # === Drawing Helpers ===
 from .draw_helpers import gradient_rect, CameraShake
@@ -36,14 +44,22 @@ from .fun_helpers import random_name, DebugOverlay
 from .camera import Camera
 
 # === 3D Engine ===
-from .crystal3d import CW3D  # 🧊 brand new 3D handler!
+from .crystal3d import CW3D
+
 
 __all__ = [
     # --- Core ---
     "Window", "Sprite", "TileMap", "Player", "Gravity", "FileHelper", "Mathematics",
 
     # --- Assets & Animation ---
-    "load_image", "load_folder_images", "load_music", "play_music", "Animation",
+    "load_image",
+    "load_folder_images",
+    "load_music",
+    "play_music",
+    "flip_image",
+    "flip_horizontal",
+    "flip_vertical",
+    "Animation",
 
     # --- Collision ---
     "check_collision", "resolve_collision",
@@ -64,5 +80,5 @@ __all__ = [
     "random_name", "DebugOverlay", "Camera",
 
     # --- 3D ---
-    "CW3D"
+    "CW3D",
 ]

crystalwindow-3.8.3/crystalwindow/assets.py

@@ -0,0 +1,150 @@
+# assets.py
+import os
+import random
+from tkinter import PhotoImage
+
+try:
+    from PIL import Image, ImageTk
+except ImportError:
+    Image = None
+    ImageTk = None
+
+ASSETS = {}  # cache for all loaded images
+
+
+# --------------------------------------------------------
+# MAIN IMAGE LOADER
+# --------------------------------------------------------
+def load_image(path, flip_h=False, flip_v=False):
+    """
+    Loads an image and returns a Tk PhotoImage.
+    Supports flipping using Pillow.
+    """
+
+    key = f"{path}|h={flip_h}|v={flip_v}"
+    if key in ASSETS:
+        return ASSETS[key]
+
+    if not os.path.exists(path):
+        print(f"⚠️ Missing file: {path}")
+        img = generate_fallback(path)
+        ASSETS[key] = img
+        return img
+
+    # If Pillow is missing → load normal image
+    if Image is None or ImageTk is None:
+        try:
+            img = PhotoImage(file=path)
+            ASSETS[key] = img
+            return img
+        except:
+            fb = generate_fallback(path)
+            ASSETS[key] = fb
+            return fb
+
+    # Load with PIL to allow flipping
+    try:
+        pil_img = Image.open(path)
+
+        if flip_h:
+            pil_img = pil_img.transpose(Image.FLIP_LEFT_RIGHT)
+        if flip_v:
+            pil_img = pil_img.transpose(Image.FLIP_TOP_BOTTOM)
+
+        tk_img = ImageTk.PhotoImage(pil_img)
+        ASSETS[key] = tk_img
+        return tk_img
+
+    except Exception as e:
+        print(f"⚠️ Error loading {path}: {e}")
+        fb = generate_fallback(path)
+        ASSETS[key] = fb
+        return fb
+
+
+# --------------------------------------------------------
+# FALLBACK NODE
+# --------------------------------------------------------
+def generate_fallback(path):
+    """Fallback colored block used when an image is missing."""
+    rand_color = (
+        random.randint(50, 255),
+        random.randint(50, 255),
+        random.randint(50, 255),
+    )
+
+    if Image:
+        try:
+            pil_img = Image.open(path)
+            w, h = pil_img.size
+        except:
+            w, h = 64, 64
+    else:
+        w, h = 64, 64
+
+    return {
+        "fallback": True,
+        "size": (w, h),
+        "color": rand_color
+    }
+
+
+# --------------------------------------------------------
+# PYGAME-STYLE FLIP HELPERS
+# --------------------------------------------------------
+def flip_image(img, flip_h=False, flip_v=False):
+    """
+    Returns a NEW flipped PhotoImage.
+    Like pygame.transform.flip().
+    """
+    if Image is None or ImageTk is None:
+        print("⚠️ Pillow not installed; cannot flip images.")
+        return img
+
+    pil_img = ImageTk.getimage(img)
+
+    if flip_h:
+        pil_img = pil_img.transpose(Image.FLIP_LEFT_RIGHT)
+    if flip_v:
+        pil_img = pil_img.transpose(Image.FLIP_TOP_BOTTOM)
+
+    return ImageTk.PhotoImage(pil_img)
+
+
+def flip_horizontal(img):
+    return flip_image(img, flip_h=True)
+
+
+def flip_vertical(img):
+    return flip_image(img, flip_v=True)
+
+
+# --------------------------------------------------------
+# FOLDER LOADING
+# --------------------------------------------------------
+def load_folder_images(folder, nested=True):
+    if not os.path.exists(folder):
+        print(f"⚠️ Folder not found: {folder}")
+        return {}
+
+    result = {}
+    for item in os.listdir(folder):
+        full = os.path.join(folder, item)
+
+        if os.path.isdir(full) and nested:
+            result[item] = load_folder_images(full)
+
+        elif item.lower().endswith((".png", ".gif")):
+            result[item] = load_image(full)
+
+    return result
+
+
+# --------------------------------------------------------
+# MUSIC PLACEHOLDER
+# --------------------------------------------------------
+def load_music(path):
+    print(f"[assets] Music load not supported: {path}")
+
+def play_music(loop=-1):
+    print("[assets] Music playback not supported.")

{crystalwindow-3.7.1b1 → crystalwindow-3.8.3}/crystalwindow/sprites.py

@@ -1,40 +1,59 @@
+# 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 (Tkinter)
-        color: fill color if no image
+        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:
-            self.width = image.width()
-            self.height = image.height()
+            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 either 'size' or 'image'")
+            raise ValueError("Sprite needs 'size' or 'image'")
 
-        # optional velocity fields for physics
+        # Optional velocity
         self.vel_x = 0
         self.vel_y = 0
 
     # === CLASS METHODS ===
     @classmethod
     def image(cls, img, pos):
-        # fallback if img is missing
+        """
+        Create a sprite from an image.
+        Accepts fallback dict or actual PhotoImage.
+        """
         if isinstance(img, dict) and img.get("fallback"):
-            print("⚠️ Missing image, making RANDOM rect fallback.")
             w, h = img["size"]
             color = img["color"]
-            return cls.rect(pos, w, h, color=color)
+            return cls(pos, size=(w, h), color=color)
         return cls(pos, image=img)
 
     @classmethod
@@ -44,7 +63,7 @@ class Sprite:
 
     # === METHODS ===
     def draw(self, win, cam=None):
-        """Draw sprite on a CrystalWindow or Tkinter canvas"""
+        """Draw sprite on CrystalWindow / Tk canvas"""
         if cam:
             draw_x, draw_y = cam.apply(self)
         else:
@@ -56,23 +75,34 @@ class Sprite:
             win.draw_rect(self.color, (draw_x, draw_y, self.width, self.height))
 
     def move(self, dx, dy):
-        """Move sprite manually by dx/dy"""
         self.x += dx
         self.y += dy
         self.pos = (self.x, self.y)
 
     def apply_velocity(self, dt=1):
-        """Apply vel_x/vel_y to x/y for physics"""
         self.x += self.vel_x * dt
         self.y += self.vel_y * dt
         self.pos = (self.x, self.y)
 
-    # === COLLISION ===
     def colliderect(self, other):
-        """Check if self collides with another sprite"""
         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.7.1b1 → crystalwindow-3.8.3/crystalwindow.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 3.7.1b1
+Version: 3.8.3
 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.7.1b1 → crystalwindow-3.8.3}/setup.py

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

crystalwindow-3.7.1b1/crystalwindow/assets.py

@@ -1,72 +0,0 @@
-import os
-import random
-from tkinter import PhotoImage
-
-try:
-    from PIL import Image
-except:
-    Image = None
-
-ASSETS = {}
-
-def load_image(path):
-    # try normal load
-    if os.path.exists(path):
-        try:
-            img = PhotoImage(file=path)
-            ASSETS[path] = img
-            return img
-        except:
-            print(f"⚠️ Ops!, could not load img: {path}")
-    else:
-        print(f"⚠️ Ops!, file not found: {path}")
-
-    # fallback: get natural size using PIL if possible
-    if Image is not None:
-        try:
-            pil_img = Image.open(path)
-            w, h = pil_img.size
-        except:
-            w, h = 64, 64
-    else:
-        w, h = 64, 64
-
-    # RANDOM COLOR FALLBACK (chaos energy)
-    rand_color = (
-        random.randint(0, 255),
-        random.randint(0, 255),
-        random.randint(0, 255)
-    )
-
-    return {
-        "fallback": True,
-        "size": (w, h),
-        "color": rand_color
-    }
-
-
-def load_folder_images(folder, nested=True):
-    if not os.path.exists(folder):
-        print(f"⚠️ Ops!, folder not found: {folder}")
-        return {}
-
-    result = {}
-    for item in os.listdir(folder):
-        full_path = os.path.join(folder, item)
-
-        if os.path.isdir(full_path) and nested:
-            result[item] = load_folder_images(full_path, nested=True)
-
-        elif item.lower().endswith((".png", ".gif")):
-            result[item] = load_image(full_path)
-
-    return result
-
-
-def load_music(path):
-    print(f"[assets] Music loading not supported in this crystalwindow ver, sorry! ~Crystal: {path}")
-    return None
-
-
-def play_music(loop=-1):
-    print("[assets] Music playback not supported in this ver sorry! ~Crystal")