crystalwindow 3.7.1b1__tar.gz → 3.8.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 3.7.1b1
+Version: 3.8.1
 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.1}/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.1/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.8.1/crystalwindow/sprites.py

@@ -0,0 +1,115 @@
+# 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
+        )

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 3.7.1b1
+Version: 3.8.1
 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.1}/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.1",  # 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")

crystalwindow-3.7.1b1/crystalwindow/sprites.py

@@ -1,78 +0,0 @@
-import random
-from tkinter import PhotoImage
-
-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
-        """
-        self.pos = pos
-        self.x, self.y = pos
-        self.image = image
-        self.color = color
-
-        if image is not None:
-            self.width = image.width()
-            self.height = image.height()
-        elif size is not None:
-            self.width, self.height = size
-        else:
-            raise ValueError("Sprite needs either 'size' or 'image'")
-
-        # optional velocity fields for physics
-        self.vel_x = 0
-        self.vel_y = 0
-
-    # === CLASS METHODS ===
-    @classmethod
-    def image(cls, img, pos):
-        # fallback if img is missing
-        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, 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 a CrystalWindow or Tkinter 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):
-        """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
-        )