crystalwindow 4.9__py3-none-any.whl → 5.1__py3-none-any.whl

crystalwindow/__init__.py

@@ -44,7 +44,7 @@ from .draw_text_helper import DrawTextManager
 from .draw_tool import CrystalDraw
 
 # === Misc Helpers ===
-from .fun_helpers import random_name, DebugOverlay, random_color, random_palette, lerp, random_number
+from .fun_helpers import random_name, DebugOverlay, random_color, random_palette, lerp, random_number, random_pos, random_bool, random_choice_weighted, difference
 from .camera import Camera
 from .color_handler import Colors, Color
 from .websearch import SearchResult, WebBrowse
@@ -93,7 +93,7 @@ __all__ = [
 
     # --- Misc ---
     "random_name", "DebugOverlay", "Camera", "Colors", "Color",
-    "random_palette", "lerp", "SearchResult", "WebBrowse", "random_number",
+    "random_palette", "lerp", "SearchResult", "WebBrowse", "random_number", "random_pos", "random_bool", "random_choice_weighted", "difference",
 
     # --- 3D ---
     "CW3DShape", "CW3D",

crystalwindow/camera.py

@@ -5,7 +5,7 @@ class Camera:
         self.offset_y = 0
         self.speed = speed  # smoothness
 
-    def update(self, win_width, win_height):
+    def update(self, win_width, win_height, dt):
         # camera aims for target center
         target_x = self.target.x - win_width // 2
         target_y = self.target.y - win_height // 2
@@ -14,6 +14,29 @@ class Camera:
         self.offset_x += (target_x - self.offset_x) * self.speed
         self.offset_y += (target_y - self.offset_y) * self.speed
 
+        if hasattr(self, "shake"):
+            self.shake.update(dt)
+
     def apply(self, obj):
         # shift object's draw position by camera offset
-        return obj.x - self.offset_x, obj.y - self.offset_y
+        sx, sy = (0, 0)
+        if hasattr(self, "shake"):
+            sx, sy = self.shake.offset
+
+        return (
+            obj.x -self.offset_x + sx,
+            obj.y -self.offset_y + sy
+        )    
+
+    def shake_scrn(self, intensity=5, secs=1):
+        # the shake screen effect shakes the screen for an ammount of time/secs
+        from .draw_helpers import CameraShake
+        self.shake = CameraShake(intensity, secs)
+
+    def move_to(self, x, y):
+        self.offset_x = x
+        self.offset_y = y
+
+    def reset_pos(self):
+        self.offset_x = 0
+        self.offset_y = 0

crystalwindow/clock.py

@@ -78,9 +78,6 @@ class Clock:
         self.delta = raw_delta
         self.frame_times.append(raw_delta)
 
-        # Scheduler update
-        self.scheduler.run_pending()
-
         return self.delta
 
     def get_fps(self):

crystalwindow/draw_helpers.py

@@ -13,11 +13,18 @@ def gradient_rect(win, rect, color_start, color_end, vertical=True):
             win.draw_rect((r,g,b), (x+i,y,1,h))
 
 class CameraShake:
-    def __init__(self, intensity=5):
+    def __init__(self, intensity=5, duration=1):
         self.intensity = intensity
-        self.offset = (0,0)
+        self.time_left = duration
+        self.offset = (0, 0)
 
-    def update(self):
+    def update(self, dt):
         import random
-        self.offset = (random.randint(-self.intensity,self.intensity),
-                       random.randint(-self.intensity,self.intensity))
+        if self.time_left > 0:
+            self.time_left -= dt
+            self.offset = (
+                random.randint(-self.intensity, self.intensity),
+                random.randint(-self.intensity, self.intensity)
+            )
+        else:
+            self.offset = (0, 0)

crystalwindow/fun_helpers.py

@@ -1,32 +1,197 @@
 import random
+import time
+
+# ============================================================
+# RANDOM HELPERS
+# ============================================================
 
-# random color helpers
 def random_color():
-    return (random.randint(0,255), random.randint(0,255), random.randint(0,255))
+    return (
+        random.randint(0, 255),
+        random.randint(0, 255),
+        random.randint(0, 255)
+    )
 
 def random_palette(n=5):
     return [random_color() for _ in range(n)]
 
-# random name generator
-def random_name():
-    syllables = ["ka","zi","lo","ra","mi","to","na","ve"]
-    return "".join(random.choice(syllables) for _ in range(3))
+def random_pastel():
+    return (
+        random.randint(150, 255),
+        random.randint(150, 255),
+        random.randint(150, 255)
+    )
+
+def random_bool(chance=0.5):
+    return random.random() < chance
 
-#Choose a random number
 def random_number(min_val, max_val):
     return random.randint(min_val, max_val)
 
-# tween helper
+def random_pos(w, h):
+    return (
+        random.randint(0, w),
+        random.randint(0, h)
+    )
+
+def random_choice_weighted(items, weights):
+    return random.choices(items, weights=weights, k=1)[0]
+
+
+# ============================================================
+# NAME / TEXT HELPERS
+# ============================================================
+
+def random_name(syllables=3):
+    pool = ["ka","zi","lo","ra","mi","to","na","ve","xo","qu"]
+    return "".join(random.choice(pool) for _ in range(syllables))
+
+
+# ============================================================
+# DIFFERENCE TELLER
+# ============================================================
+class difference:
+    @staticmethod
+    def tell(obj1, obj2):
+        diffs = {}
+
+        for attr in vars(obj1):
+            if hasattr(obj2, attr):
+                v1 = getattr(obj1, attr)
+                v2 = getattr(obj2, attr)
+
+                if v1 != v2:
+                    diffs[attr] = difference._distance(v1, v2)
+
+        return diffs
+
+    @staticmethod
+    def _distance(a, b):
+        if isinstance(a, (int, float)) and isinstance(b, (int, float)):
+            return abs(b - a)
+
+        if isinstance(a, tuple) and isinstance(b, tuple):
+            return sum(abs(b[i] - a[i]) for i in range(min(len(a), len(b))))
+
+        return 1
+
+    @staticmethod
+    def _get_name(obj):
+        # priority: explicit name attr
+        if hasattr(obj, "name"):
+            return obj.name
+
+        # fallback: class name
+        return obj.__class__.__name__
+
+    @staticmethod
+    def score(obj1, obj2):
+        name1 = difference._get_name(obj1)
+        name2 = difference._get_name(obj2)
+
+        diffs = difference.tell(obj1, obj2)
+
+        if not diffs:
+            print(f"The Difference of '{name1}' and '{name2}' are: 0%")
+            return 0
+
+        max_score = len(diffs) * 100
+        raw_score = sum(min(v, 100) for v in diffs.values())
+        percent = int((raw_score / max_score) * 100)
+
+        print(f"The Difference of '{name1}' and '{name2}' are: {percent}%")
+        return percent
+
+
+# ============================================================
+# MATH / TWEEN HELPERS
+# ============================================================
+
 def lerp(a, b, t):
     return a + (b - a) * t
 
-# debug overlay
+def clamp(val, minv=0, maxv=255):
+    return max(minv, min(maxv, val))
+
+def clamp01(t):
+    return max(0.0, min(1.0, t))
+
+def smoothstep(a, b, t):
+    t = clamp01(t)
+    t = t * t * (3 - 2 * t)
+    return a + (b - a) * t
+
+def approach(current, target, speed):
+    if current < target:
+        return min(current + speed, target)
+    return max(current - speed, target)
+
+def sign(x):
+    return -1 if x < 0 else (1 if x > 0 else 0)
+
+
+# ============================================================
+# COLOR MODIFIERS
+# ============================================================
+
+def lighten(color, amount=30):
+    r, g, b = color
+    return (
+        clamp(r + amount),
+        clamp(g + amount),
+        clamp(b + amount)
+    )
+
+def darken(color, amount=30):
+    r, g, b = color
+    return (
+        clamp(r - amount),
+        clamp(g - amount),
+        clamp(b - amount)
+    )
+
+
+# ============================================================
+# TIME HELPERS
+# ============================================================
+
+def timer_passed(start_time, duration):
+    return (time.perf_counter() - start_time) >= duration
+
+
+# ============================================================
+# DEBUG OVERLAY
+# ============================================================
+
 class DebugOverlay:
     def __init__(self):
         self.active = True
+        self.lines = []
+
+    def toggle(self):
+        self.active = not self.active
+
+    def log(self, text):
+        self.lines.append(str(text))
+        if len(self.lines) > 6:
+            self.lines.pop(0)
+
+    def clear(self):
+        self.lines.clear()
+
+    def draw(self, win, fps=0):
+        if not self.active:
+            return
+
+        y = 10
+        win.draw_text(f"FPS: {int(fps)}", pos=(10, y))
+        y += 20
+
+        if hasattr(win, "mouse_pos"):
+            mx, my = win.mouse_pos
+            win.draw_text(f"Mouse: {mx},{my}", pos=(10, y))
+            y += 20
 
-    def draw(self, win, fps=60):
-        if self.active:
-            win.draw_text(f"FPS: {fps}", pos=(10,10))
-            mx,my = win.mouse_pos
-            win.draw_text(f"Mouse: {mx},{my}", pos=(10,30))
+        for line in self.lines:
+            win.draw_text(line, pos=(10, y))
+            y += 18

crystalwindow/gui.py

@@ -16,13 +16,14 @@ def lerp_color(c1, c2, t):
 
 # ----------------- GUI Elements -----------------
 class Button:
-    def __init__(self, rect, text,
+    def __init__(self, pos, size, text,
                  color=(200,200,200),
                  hover_color=(255,255,255),
                  press_color=(180,180,180),
                  text_color=(0,0,0)):
 
-        self.rect = rect
+        self.pos = pos
+        self.size = size
         self.text = text
 
         self.color = color
@@ -45,7 +46,8 @@ class Button:
     # ======================================
     def update(self, win):
         mx, my = win.mouse_pos
-        x, y, w, h = self.rect 
+        x, y = self.pos
+        w, h = self.size
 
         # Reset transient states
         self._clicked = False
@@ -94,7 +96,8 @@ class Button:
     #   DRAW
     # ======================================
     def draw(self, win):
-        x, y, w, h = self.rect
+        x, y = self.pos
+        w, h = self.size
 
         # choose color by state
         if self._held:

crystalwindow/objects.py

@@ -71,21 +71,21 @@ class Player(Sprite):
         spd = self.speed * dt * 60
 
         # movement
-        if win.is_key_pressed("left"):
+        if win.key_pressed("left"):
             self.x -= spd
             self.flip_x = True
             moving = True
 
-        if win.is_key_pressed("right"):
+        if win.key_pressed("right"):
             self.x += spd
             self.flip_x = False
             moving = True
 
-        if win.is_key_pressed("up"):
+        if win.key_pressed("up"):
             self.y -= spd
             moving = True
 
-        if win.is_key_pressed("down"):
+        if win.key_pressed("down"):
             self.y += spd
             moving = True
 

{crystalwindow-4.9.dist-info → crystalwindow-5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 4.9
+Version: 5.1
 Summary: A Tkinter powered window + GUI toolkit made by Crystal (ME)! Easier apps, smoother UI and all-in-one helpers!, Gui, Buttons, FileHelper, Sprites, Animations, Colors, Math, Gravity, Camera, 3D and more!
 Home-page: https://pypi.org/project/crystalwindow/
 Author: CrystalBallyHereXD

{crystalwindow-4.9.dist-info → crystalwindow-5.1.dist-info}/RECORD

@@ -1,25 +1,25 @@
 crystalwindow/FileHelper.py,sha256=U20iwND4jX1y91TOK46e8MPH8xyw7GOrZ697nPEnOPk,10706
-crystalwindow/__init__.py,sha256=3YBPnMJuc-jatE__Ts-cs5s2J1OWeDE7HzgCv95ykdA,2823
+crystalwindow/__init__.py,sha256=dqow94sID2DEnUwiIFtmz38RrVGautAVMz1c4Wrt6BU,2953
 crystalwindow/ai.py,sha256=YIt6dNe1QljSAlNECCVa3DMUSIqQEJRIAAbQpYqFNNo,11525
 crystalwindow/animation.py,sha256=zHjrdBXQeyNaLAuaGPldJueX05OZ5j31YR8NizmR0uQ,427
 crystalwindow/assets.py,sha256=8MxPSk7W5YcBnKDh6KcLdg34uxmACf_m6feSYFCWHqA,11405
-crystalwindow/camera.py,sha256=tbn4X-jxMIszAUg3Iu-89gJN5nij0mjPMEzGotcLbJI,712
+crystalwindow/camera.py,sha256=1PGGzCCelI6a7aWOuiqqM2OgmrHOBeyobAnSbX-tWgw,1338
 crystalwindow/chatvpn.py,sha256=Ij3wRNrMbPINO-SX9vx8xlrKRLvG7zJgzAN2T0jzSz8,2477
-crystalwindow/clock.py,sha256=LZUm4WoAnJuGA-efRKkLHRE9cxCs3pRhwcZZF14fIKA,5109
+crystalwindow/clock.py,sha256=M7oMjnGNkFOcchqtQn_voWao4kFtxXpTJe2VUjqvGKQ,5041
 crystalwindow/collision.py,sha256=hpkHTp_KparghVK-itp_rxuYdd2GbQMxICHlUBv0rSw,472
 crystalwindow/color_handler.py,sha256=K3LipCPOjYt1NemeT-hNWf886LL59QgRN8ifHOi7-0M,3255
 crystalwindow/crystal3d.py,sha256=8n42S71NZWgBgYwP8ZWfobXFeWvNrhJY80YGK-PzI8s,5375
-crystalwindow/draw_helpers.py,sha256=HqjI5fTbdnA55g4LKYEuMUdIjrWaBm2U8RmeUXjcQGw,821
+crystalwindow/draw_helpers.py,sha256=S1jkZbq-9NZrBPJ3tAl1abIc0M-GgNJkHfOtEnQZuS4,1019
 crystalwindow/draw_rects.py,sha256=o7siET3y35N2LPeNBGe8QhsQbOH8J-xF6fOUz07rymU,1484
 crystalwindow/draw_text_helper.py,sha256=qv5fFCuTCKWeGDk9Z_ZpOzrTFP8YYwlgQrrorwrq9Hg,1298
 crystalwindow/draw_tool.py,sha256=1YYEqjmgt4HpV3S15sTjCSmcqgHup4fD8gskTkxU0t4,1638
-crystalwindow/fun_helpers.py,sha256=x-OF5dlMlHgvXjtT7Om8RvzKWgizSwnzeaM0_W3-SKQ,870
+crystalwindow/fun_helpers.py,sha256=UHfveBTJ3NlgFd8ZbEJpHtQL-YUWiG7Hl9CWhT06VmQ,5144
 crystalwindow/gravity.py,sha256=pZJykZzO-mKVBPsZRP55nnlvUoYQfR29wPgJcI4IbBs,2904
-crystalwindow/gui.py,sha256=_T4diMardg50gk0_OBpFHfJo5Coo-D3aZt3Vl6PJjxQ,5287
+crystalwindow/gui.py,sha256=9JA25IztgqSYN1NnWVKK99G0rlEosXf2ATWww2rUZIQ,5353
 crystalwindow/gui_ext.py,sha256=JctpNPr7gtGdro3csyUo9ft3FFArj3JhkVlgKF0lyME,3407
 crystalwindow/math.py,sha256=slOY3KQZ99VDMUMxsSJabMyRtJcwVzEyxR2RoXspHho,963
 crystalwindow/messagebus.py,sha256=9K2P_TkdQ1rt-oouIkRg_XHwMTwykttBt-9gFYaItyI,696
-crystalwindow/objects.py,sha256=VCEvRrzPv-bWCiVw63rMF67KYluP6FKySgDOvOiN8QU,5413
+crystalwindow/objects.py,sha256=zps-5taLGTmIvlZ76VQhvVHK2NtrrQyxBQMHGwEsCIM,5401
 crystalwindow/sprites.py,sha256=IADCQetFDQoat3qGpKkH93TdtqqgldfHl4N0HKX1Ajc,7480
 crystalwindow/tilemap.py,sha256=endJ8KcbP9EjPvL9qWsOpV4jc_Re1yH080aUyDkwufA,3378
 crystalwindow/ver_warner.py,sha256=qEN3ulc1NixBy15FFx2R3Zu0DhyJTVJwiESGAPwpynM,3373
@@ -38,8 +38,8 @@ crystalwindow/gametests/sandbox.py,sha256=Oo2tU2N0y3BPVa6T5vs_h9N6islhQrjSrr_78X
 crystalwindow/gametests/squaremove.py,sha256=ei6DMnvcgpOhmxbGv-Yqmx5EqiZjKbVlZhI7YbT2hY8,643
 crystalwindow/gametests/testtttagain.py,sha256=oIhK9MGgMVly_W2lRwD9Hn9WyPdd8JnX2HGrLTGZdxY,373
 crystalwindow/gametests/windowtesting.py,sha256=_9X6wnV1-_X_PtNS-0zu-k209NtFIwAc4vpxLPp7V2o,97
-crystalwindow-4.9.dist-info/licenses/LICENSE,sha256=Gt5cJRchdNt0guxyQMHKsATN5PM5mjuDhdO6Gzs9qQc,1096
-crystalwindow-4.9.dist-info/METADATA,sha256=9CY3r5w-s8NAWe5ynIBOWOehMyRDro-zXnhhPw1yL2Q,7523
-crystalwindow-4.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-crystalwindow-4.9.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
-crystalwindow-4.9.dist-info/RECORD,,
+crystalwindow-5.1.dist-info/licenses/LICENSE,sha256=Gt5cJRchdNt0guxyQMHKsATN5PM5mjuDhdO6Gzs9qQc,1096
+crystalwindow-5.1.dist-info/METADATA,sha256=FZFBz4n7kKSScSqNqT1mxn5pM05SgwcCBqMmwqC29XE,7523
+crystalwindow-5.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+crystalwindow-5.1.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
+crystalwindow-5.1.dist-info/RECORD,,