crystalwindow 3.8.4__py3-none-any.whl → 3.8.6__py3-none-any.whl

crystalwindow/__init__.py

@@ -44,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
@@ -81,7 +82,7 @@ __all__ = [
     "gradient_rect", "CameraShake", "DrawHelper", "DrawTextManager", "CrystalDraw",
 
     # --- Misc ---
-    "random_name", "DebugOverlay", "Camera",
+    "random_name", "DebugOverlay", "Camera", "Colors", "Color",
 
     # --- 3D ---
     "CW3D",

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

@@ -3,35 +3,48 @@ from .window import Window
 from .assets import load_image
 from .sprites import Sprite
 from .gui import Button
+from .color_handler import Colors, Color
+
+def parse_color(c):
+    if isinstance(c, tuple):
+        return c
+    if isinstance(c, Color):
+        return c.to_tuple()
+    if isinstance(c, str):
+        if hasattr(Colors, c):
+            return getattr(Colors, c).to_tuple()
+        return (255,255,255)
+    return (255,255,255)
 
 class Toggle:
-    def __init__(self, rect, value=False, color=(200,200,200), hover_color=(255,255,255), cooldown=0.1):
-        # rect = (x, y, w, h)
+    def __init__(self, rect, value=False, color="gray", hover_color="white", cooldown=0.1):
         self.rect = rect
         self.value = value
-        self.color = color
-        self.hover_color = hover_color
+
+        self.color = parse_color(color)
+        self.hover_color = parse_color(hover_color)
+
         self.hovered = False
         self.cooldown = cooldown
-        self._last_toggle = 0  # last time it was toggled
+        self._last_toggle = 0
 
     def update(self, win: Window):
         mx, my = win.mouse_pos
         x, y, w, h = self.rect
         self.hovered = x <= mx <= x + w and y <= my <= y + h
 
-        # check cooldown timer
         now = time.time()
         can_toggle = now - self._last_toggle >= self.cooldown
 
         if self.hovered and win.mouse_pressed(1) and can_toggle:
             self.value = not self.value
-            self._last_toggle = now  # reset cooldown timer
+            self._last_toggle = now
 
     def draw(self, win: Window):
         draw_color = self.hover_color if self.hovered else self.color
         win.draw_rect(draw_color, self.rect)
-        # lil inner "ON" glow thingy
+
+        # ON glow
         if self.value:
             inner = (
                 self.rect[0] + 4,
@@ -43,13 +56,15 @@ class Toggle:
 
 
 class Slider:
-    def __init__(self, rect, min_val=0, max_val=100, value=50, color=(150,150,150), handle_radius=10):
-        # rect = (x, y, w, h)
+    def __init__(self, rect, min_val=0, max_val=100, value=50, color="lightgray", handle_color="red", handle_radius=10):
         self.rect = rect
         self.min_val = min_val
         self.max_val = max_val
         self.value = value
-        self.color = color
+
+        self.color = parse_color(color)
+        self.handle_color = parse_color(handle_color)
+
         self.handle_radius = handle_radius
         self.dragging = False
 
@@ -60,21 +75,24 @@ class Slider:
         handle_x = x + ((self.value - self.min_val) / (self.max_val - self.min_val)) * w
         handle_y = y + h // 2
 
-        # start drag if mouse clicks inside slider bar area
         if win.mouse_pressed(1):
             if not self.dragging and (x <= mx <= x+w and y <= my <= y+h):
                 self.dragging = True
         else:
-            self.dragging = False  # stop drag when released
+            self.dragging = False
 
-        # update value while dragging
         if self.dragging:
-            rel_x = max(0, min(mx - x, w))  # clamp
+            rel_x = max(0, min(mx - x, w))
             self.value = self.min_val + (rel_x / w) * (self.max_val - self.min_val)
 
     def draw(self, win: Window):
         x, y, w, h = self.rect
+
+        # bar
         win.draw_rect(self.color, (x, y + h//2 - 2, w, 4))
+
+        # handle
         handle_x = x + ((self.value - self.min_val) / (self.max_val - self.min_val)) * w
         handle_y = y + h // 2
-        win.draw_circle((255, 0, 0), (int(handle_x), int(handle_y)), self.handle_radius)
+
+        win.draw_circle(self.handle_color, (int(handle_x), int(handle_y)), self.handle_radius)

{crystalwindow-3.8.4.dist-info → crystalwindow-3.8.6.dist-info}/METADATA

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

@@ -1,10 +1,11 @@
 crystalwindow/FileHelper.py,sha256=aUnnRG7UwvzJt-idjWjmpwy3RM6nqLlC3-7Bae6Yb94,5471
-crystalwindow/__init__.py,sha256=c8-c4hLW3AhIN9J8uNVGSTz6Navsfs7FGexV55lkP6g,2083
+crystalwindow/__init__.py,sha256=Ugp3GLsfYK_OAA8J9WnGc95P4Uev5fAePmzNNXmpSKQ,2144
 crystalwindow/animation.py,sha256=zHjrdBXQeyNaLAuaGPldJueX05OZ5j31YR8NizmR0uQ,427
 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,8 +13,8 @@ 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_ext.py,sha256=ZhNgc5eK6Vzj-jUNeFzimuEbLnTmM7Bx594Z34_N0oM,2856
+crystalwindow/gui.py,sha256=vqI2Qpus0RHEwEsef0gojXb54yOFo6p-9TnDF4bEnSg,3538
+crystalwindow/gui_ext.py,sha256=aOZ5Fa0VoBJd3SiEW2zgH2Sw1NwnK2mW1YtGdJijDVg,3045
 crystalwindow/math.py,sha256=slOY3KQZ99VDMUMxsSJabMyRtJcwVzEyxR2RoXspHho,963
 crystalwindow/player.py,sha256=4wpIdUZLTlRXV8fDRQ11yVJRbx_cv8Ekpn2y7pQGgAQ,3442
 crystalwindow/sprites.py,sha256=2kYW4QfSnyUwRLedZCkb99wUSxn2a0JdWOHcfkxcG0U,3411
@@ -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.4.dist-info/licenses/LICENSE,sha256=Gt5cJRchdNt0guxyQMHKsATN5PM5mjuDhdO6Gzs9qQc,1096
-crystalwindow-3.8.4.dist-info/METADATA,sha256=sNkJRxTwkTfPeCtzmhkyLMV0FA8NDjLKxgZ5GTVmxv4,7340
-crystalwindow-3.8.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-crystalwindow-3.8.4.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
-crystalwindow-3.8.4.dist-info/RECORD,,
+crystalwindow-3.8.6.dist-info/licenses/LICENSE,sha256=Gt5cJRchdNt0guxyQMHKsATN5PM5mjuDhdO6Gzs9qQc,1096
+crystalwindow-3.8.6.dist-info/METADATA,sha256=VooxfUadE7ciIboTfZUUwY0N8FVaaLX5pm7pg3kivlo,7340
+crystalwindow-3.8.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+crystalwindow-3.8.6.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
+crystalwindow-3.8.6.dist-info/RECORD,,