crystalwindow 3.8.3__py3-none-any.whl → 3.8.5__py3-none-any.whl

crystalwindow/__init__.py

@@ -20,6 +20,8 @@ from .assets import (
     flip_image,
     flip_horizontal,
     flip_vertical,
+    LoopAnim,
+    loop_image,
 )
 from .animation import Animation
 
@@ -42,6 +44,7 @@ from .draw_tool import CrystalDraw
 # === Misc Helpers ===
 from .fun_helpers import random_name, DebugOverlay
 from .camera import Camera
+from .color_handler import Colors, Color
 
 # === 3D Engine ===
 from .crystal3d import CW3D
@@ -60,6 +63,8 @@ __all__ = [
     "flip_horizontal",
     "flip_vertical",
     "Animation",
+    "LoopAnim",
+    "loop_image",
 
     # --- Collision ---
     "check_collision", "resolve_collision",
@@ -77,7 +82,7 @@ __all__ = [
     "gradient_rect", "CameraShake", "DrawHelper", "DrawTextManager", "CrystalDraw",
 
     # --- Misc ---
-    "random_name", "DebugOverlay", "Camera",
+    "random_name", "DebugOverlay", "Camera", "Colors", "Color",
 
     # --- 3D ---
     "CW3D",

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

@@ -0,0 +1,123 @@
+# --------------------------------------
+# CrystalWindow Color System v2.0
+# --------------------------------------
+
+class Colors:
+    # BASIC COLORS
+    Black       = (0, 0, 0)
+    White       = (255, 255, 255)
+    Red         = (255, 0, 0)
+    Green       = (0, 255, 0)
+    Blue        = (0, 0, 255)
+    Yellow      = (255, 255, 0)
+    Cyan        = (0, 255, 255)
+    Magenta     = (255, 0, 255)
+    Gray        = (120, 120, 120)
+    DarkGray    = (40, 40, 40)
+
+    # CRYSTALWINDOW CUSTOM
+    CrystalBlue = (87, 199, 255)
+    Accent      = (87, 199, 255)
+    Success     = (76, 255, 111)
+    Error       = (255, 68, 68)
+    Transparent = (0, 0, 0, 0)  # full alpha
+
+
+class Color:
+    COLOR_NAMES = {name.lower(): value for name, value in Colors.__dict__.items()
+                   if not name.startswith("__")}
+
+    def __init__(self, r=None, g=None, b=None, a=255, hex_value=None):
+        # -------------------------------------------------
+        # 1) raw tuple variable: Color(Blue)
+        # -------------------------------------------------
+        if isinstance(r, (tuple, list)):
+            if len(r) == 3:    # rgb
+                self.r, self.g, self.b = r
+                self.a = a
+            elif len(r) == 4:  # rgba
+                self.r, self.g, self.b, self.a = r
+            return
+
+        # -------------------------------------------------
+        # 2) name string: Color("blue")
+        # -------------------------------------------------
+        if isinstance(r, str):
+            name = r.lower()
+            if name not in self.COLOR_NAMES:
+                raise ValueError(f"unknown color name: {r}")
+            data = self.COLOR_NAMES[name]
+            if len(data) == 4:
+                self.r, self.g, self.b, self.a = data
+            else:
+                self.r, self.g, self.b = data
+                self.a = a
+            return
+
+        # -------------------------------------------------
+        # 3) HEX input
+        # -------------------------------------------------
+        if hex_value is not None:
+            self.r, self.g, self.b, self.a = self.hex_to_rgba(hex_value)
+            return
+
+        # -------------------------------------------------
+        # 4) manual RGB
+        # -------------------------------------------------
+        self.r = r or 0
+        self.g = g or 0
+        self.b = b or 0
+        self.a = a
+
+    # convert hex -> rgba
+    @staticmethod
+    def hex_to_rgba(hex_value: str):
+        hex_value = hex_value.replace("#", "")
+        if len(hex_value) == 6:
+            r = int(hex_value[0:2], 16)
+            g = int(hex_value[2:4], 16)
+            b = int(hex_value[4:6], 16)
+            a = 255
+        elif len(hex_value) == 8:
+            r = int(hex_value[0:2], 16)
+            g = int(hex_value[2:4], 16)
+            b = int(hex_value[4:6], 16)
+            a = int(hex_value[6:8], 16)
+        else:
+            raise ValueError("bad hex bruh")
+        return r, g, b, a
+
+    # return pygame-friendly color tuple
+    def to_tuple(self):
+        return (self.r, self.g, self.b, self.a)
+
+    # rgba -> hex
+    def to_hex(self):
+        return "#{:02X}{:02X}{:02X}{:02X}".format(self.r, self.g, self.b, self.a)
+
+    # quick alpha edit
+    def set_alpha(self, a):
+        self.a = max(0, min(255, a))
+        return self
+
+    # color math
+    def brighten(self, amt=30):
+        self.r = min(255, self.r + amt)
+        self.g = min(255, self.g + amt)
+        self.b = min(255, self.b + amt)
+        return self
+
+    def darken(self, amt=30):
+        self.r = max(0, self.r - amt)
+        self.g = max(0, self.g - amt)
+        self.b = max(0, self.b - amt)
+        return self
+
+    @staticmethod
+    def lerp(c1, c2, t: float):
+        """blend between two colors"""
+        r = c1.r + (c2.r - c1.r) * t
+        g = c1.g + (c2.g - c1.g) * t
+        b = c1.b + (c2.b - c1.b) * t
+        a = c1.a + (c2.a - c1.a) * t
+        return Color(int(r), int(g), int(b), int(a))

crystalwindow/gui.py

@@ -9,10 +9,6 @@ def hex_to_rgb(hex_str):
     hex_str = hex_str.lstrip("#")
     return tuple(int(hex_str[i:i+2], 16) for i in (0, 2, 4))
 
-def random_color():
-    """Return a random RGB color"""
-    return (random.randint(0,255), random.randint(0,255), random.randint(0,255))
-
 def lerp_color(c1, c2, t):
     """Linearly interpolate between two colors"""
     return tuple(int(a + (b-a)*t) for a,b in zip(c1,c2))

crystalwindow/sprites.py

@@ -90,7 +90,7 @@ class Sprite:
             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
+        )  # returns tuple for consistency
 
     def set_image(self, img):
         """Update sprite's image at runtime (like flipping)"""

{crystalwindow-3.8.3.dist-info → crystalwindow-3.8.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 3.8.3
+Version: 3.8.5
 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.3.dist-info → crystalwindow-3.8.5.dist-info}/RECORD

@@ -1,10 +1,11 @@
 crystalwindow/FileHelper.py,sha256=aUnnRG7UwvzJt-idjWjmpwy3RM6nqLlC3-7Bae6Yb94,5471
-crystalwindow/__init__.py,sha256=1O0qUvD6dGRZEwCXZU5byqWQUdRNYhyUZ54SN_NM2Dk,2015
+crystalwindow/__init__.py,sha256=Ugp3GLsfYK_OAA8J9WnGc95P4Uev5fAePmzNNXmpSKQ,2144
 crystalwindow/animation.py,sha256=zHjrdBXQeyNaLAuaGPldJueX05OZ5j31YR8NizmR0uQ,427
-crystalwindow/assets.py,sha256=3FubtFHcemIFBiV5h79QyvKkHiLSUNBEPbGP4UyGRyI,3999
+crystalwindow/assets.py,sha256=2Cj0zdhMWo3mWjdr9KU5n-9_8iKj_fJ9uShMFA-27HU,5193
 crystalwindow/camera.py,sha256=tbn4X-jxMIszAUg3Iu-89gJN5nij0mjPMEzGotcLbJI,712
 crystalwindow/clock.py,sha256=iryeURnfXx6TIDyJhpxe0KkeSaHCdxrMckN6Tby00i0,461
 crystalwindow/collision.py,sha256=hpkHTp_KparghVK-itp_rxuYdd2GbQMxICHlUBv0rSw,472
+crystalwindow/color_handler.py,sha256=ZnXnz8552GPiRAnCkW_8wycwRRMAaFRFLlCcsrv0j2E,4071
 crystalwindow/crystal3d.py,sha256=-Te9IJgbtzl8Mpuc4BPi2bn2apnvBNTI2GwxSLd8sqg,2006
 crystalwindow/draw_helpers.py,sha256=HqjI5fTbdnA55g4LKYEuMUdIjrWaBm2U8RmeUXjcQGw,821
 crystalwindow/draw_rects.py,sha256=o7siET3y35N2LPeNBGe8QhsQbOH8J-xF6fOUz07rymU,1484
@@ -12,11 +13,11 @@ crystalwindow/draw_text_helper.py,sha256=qv5fFCuTCKWeGDk9Z_ZpOzrTFP8YYwlgQrrorwr
 crystalwindow/draw_tool.py,sha256=1YYEqjmgt4HpV3S15sTjCSmcqgHup4fD8gskTkxU0t4,1638
 crystalwindow/fun_helpers.py,sha256=fo5yTwGENltdtVIVwgITtUkvzpsImujOcqTxe8XPzR8,760
 crystalwindow/gravity.py,sha256=pZJykZzO-mKVBPsZRP55nnlvUoYQfR29wPgJcI4IbBs,2904
-crystalwindow/gui.py,sha256=D-El18XUaZQR-XZoOr28hnhO7EEoGuypCHxPbPR_yng,3680
+crystalwindow/gui.py,sha256=vqI2Qpus0RHEwEsef0gojXb54yOFo6p-9TnDF4bEnSg,3538
 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=V84FBsr4DJKLtart3OEb8lvLow20wZ6JuVZ5I4TRiFg,3412
+crystalwindow/sprites.py,sha256=2kYW4QfSnyUwRLedZCkb99wUSxn2a0JdWOHcfkxcG0U,3411
 crystalwindow/tilemap.py,sha256=PHoKL1eWuNeHIf0w-Jh5MGdQGEgklVsxqqJOS-GNMKI,322
 crystalwindow/ver_warner.py,sha256=qEN3ulc1NixBy15FFx2R3Zu0DhyJTVJwiESGAPwpynM,3373
 crystalwindow/window.py,sha256=e6C8yIdVdjOduIeU0ZmlrNn8GmyvHuzKs473pRggkz0,18180
@@ -31,8 +32,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.8.3.dist-info/licenses/LICENSE,sha256=7pvUgvRXL3ED5VVAZPH5oGn1CaIXcyoDC9gqox6sB0g,1079
-crystalwindow-3.8.3.dist-info/METADATA,sha256=h_abo60ExVg_jZNFt6rUHUUzAmx1MTDaDcxMJJ-v4CI,7340
-crystalwindow-3.8.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-crystalwindow-3.8.3.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
-crystalwindow-3.8.3.dist-info/RECORD,,
+crystalwindow-3.8.5.dist-info/licenses/LICENSE,sha256=Gt5cJRchdNt0guxyQMHKsATN5PM5mjuDhdO6Gzs9qQc,1096
+crystalwindow-3.8.5.dist-info/METADATA,sha256=8aRebxnTtseTd_BNHaPHtCzvs90NNM9S87WK1buHgYw,7340
+crystalwindow-3.8.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+crystalwindow-3.8.5.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
+crystalwindow-3.8.5.dist-info/RECORD,,

{crystalwindow-3.8.3.dist-info → crystalwindow-3.8.5.dist-info}/licenses/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