crystalwindow 3.7.1b1__py3-none-any.whl → 3.8.1__py3-none-any.whl

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/assets.py

@@ -1,28 +1,79 @@
+# assets.py
 import os
 import random
 from tkinter import PhotoImage
 
 try:
-    from PIL import Image
-except:
+    from PIL import Image, ImageTk
+except ImportError:
     Image = None
+    ImageTk = None
 
-ASSETS = {}
+ASSETS = {}  # cache for all loaded images
 
-def load_image(path):
-    # try normal load
-    if os.path.exists(path):
+
+# --------------------------------------------------------
+# 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[path] = img
+            ASSETS[key] = img
             return img
         except:
-            print(f"⚠️ Ops!, could not load img: {path}")
-    else:
-        print(f"⚠️ Ops!, file not found: {path}")
+            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),
+    )
 
-    # fallback: get natural size using PIL if possible
-    if Image is not None:
+    if Image:
         try:
             pil_img = Image.open(path)
             w, h = pil_img.size
@@ -31,13 +82,6 @@ def load_image(path):
     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),
@@ -45,28 +89,62 @@ def load_image(path):
     }
 
 
+# --------------------------------------------------------
+# 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"⚠️ Ops!, folder not found: {folder}")
+        print(f"⚠️ Folder not found: {folder}")
         return {}
 
     result = {}
     for item in os.listdir(folder):
-        full_path = os.path.join(folder, item)
+        full = os.path.join(folder, item)
 
-        if os.path.isdir(full_path) and nested:
-            result[item] = load_folder_images(full_path, nested=True)
+        if os.path.isdir(full) and nested:
+            result[item] = load_folder_images(full)
 
         elif item.lower().endswith((".png", ".gif")):
-            result[item] = load_image(full_path)
+            result[item] = load_image(full)
 
     return result
 
 
+# --------------------------------------------------------
+# MUSIC PLACEHOLDER
+# --------------------------------------------------------
 def load_music(path):
-    print(f"[assets] Music loading not supported in this crystalwindow ver, sorry! ~Crystal: {path}")
-    return None
-
+    print(f"[assets] Music load not supported: {path}")
 
 def play_music(loop=-1):
-    print("[assets] Music playback not supported in this ver sorry! ~Crystal")
+    print("[assets] Music playback not supported.")

crystalwindow/sprites.py

@@ -1,50 +1,58 @@
-import random
+# 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)):
-        """
-        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.pos = pos
+
+        self.image = None
         self.color = color
 
-        if image is not None:
-            self.width = image.width()
-            self.height = image.height()
+        # 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 either 'size' or 'image'")
+            raise ValueError("Sprite needs 'size' or 'image'")
 
-        # optional velocity fields for physics
+        # Movement physics
         self.vel_x = 0
         self.vel_y = 0
 
-    # === CLASS METHODS ===
+        # Optional direction flag
+        self.facing_left = False
+
+    # --------------------------------------
+    # Constructors
+    # --------------------------------------
     @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, 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 ===
+    # --------------------------------------
+    # Draw
+    # --------------------------------------
     def draw(self, win, cam=None):
-        """Draw sprite on a CrystalWindow or Tkinter canvas"""
         if cam:
             draw_x, draw_y = cam.apply(self)
         else:
@@ -55,24 +63,53 @@ class Sprite:
         else:
             win.draw_rect(self.color, (draw_x, draw_y, self.width, self.height))
 
+    # --------------------------------------
+    # Movement
+    # --------------------------------------
     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 ===
+    # --------------------------------------
+    # 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):
-        """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
+            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.dist-info → crystalwindow-3.8.1.dist-info}/METADATA

@@ -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.dist-info → crystalwindow-3.8.1.dist-info}/RECORD

@@ -1,7 +1,7 @@
 crystalwindow/FileHelper.py,sha256=aUnnRG7UwvzJt-idjWjmpwy3RM6nqLlC3-7Bae6Yb94,5471
-crystalwindow/__init__.py,sha256=SAXfSxPb-In3ZlYDQ0itMIJGDWSexBmqO39Kkh-FDtU,1911
+crystalwindow/__init__.py,sha256=1O0qUvD6dGRZEwCXZU5byqWQUdRNYhyUZ54SN_NM2Dk,2015
 crystalwindow/animation.py,sha256=zHjrdBXQeyNaLAuaGPldJueX05OZ5j31YR8NizmR0uQ,427
-crystalwindow/assets.py,sha256=X99Laop5BREE4y7MGaMbWJLaz-q_HGNgNLcXe1yNMdY,1770
+crystalwindow/assets.py,sha256=3FubtFHcemIFBiV5h79QyvKkHiLSUNBEPbGP4UyGRyI,3999
 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=YVoLnpLsCHlHmTahk8hwWnUtkcI-FC_w4OjZN4YtmLs,2569
+crystalwindow/sprites.py,sha256=b_ErcbqoWduk4otxcETJhNsSNfpSUMmcjV4qL5gMf5g,3590
 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.7.1b1.dist-info/licenses/LICENSE,sha256=7pvUgvRXL3ED5VVAZPH5oGn1CaIXcyoDC9gqox6sB0g,1079
-crystalwindow-3.7.1b1.dist-info/METADATA,sha256=nI18W8lMDTpZBJiMOjQhUKOq1S8LQ-S0dUi_PuaCAA0,7342
-crystalwindow-3.7.1b1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-crystalwindow-3.7.1b1.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
-crystalwindow-3.7.1b1.dist-info/RECORD,,
+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,,