gradienttk 0.1.1__tar.gz → 0.1.2__tar.gz

{gradienttk-0.1.1 → gradienttk-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gradienttk
-Version: 0.1.1
+Version: 0.1.2
 Summary: Modern Gradient Widgets for CustomTkinter
 Author: Mohammad Amin
 License-Expression: MIT

gradienttk-0.1.2/gradienttk/core/colors.py

@@ -0,0 +1,72 @@
+from typing import Tuple
+from .types import GradientType
+
+def hex_to_rgb(color: str) -> Tuple[int, int, int]:
+    color = color.lstrip("#")
+
+    if len(color) != 6:
+        raise ValueError("Color must be a 6-digit HEX value.")
+
+    return (
+        int(color[0:2], 16),
+        int(color[2:4], 16),
+        int(color[4:6], 16),
+    )
+
+def rgb_to_hex(rgb: Tuple[int, int, int]) -> str:
+    """
+    Convert RGB tuple to HEX.
+
+    Example:
+        (255, 0, 0) -> "#FF0000"
+    """
+    return "#{:02X}{:02X}{:02X}".format(*rgb)
+
+def interpolate_color(
+    start: Tuple[int, int, int],
+    end: Tuple[int, int, int],
+    factor: float
+) -> Tuple[int, int, int]:
+    """
+    Returns a color between two RGB colors.
+
+    factor:
+        0.0 -> start color
+        1.0 -> end color
+    """
+
+    return (
+        int(start[0] + (end[0] - start[0]) * factor),
+        int(start[1] + (end[1] - start[1]) * factor),
+        int(start[2] + (end[2] - start[2]) * factor),
+    )
+
+def darken_color(color: str, amount: float = 0.15) -> str:
+    """
+    Darken a HEX color.
+
+    amount:
+        0.0 -> no change
+        1.0 -> completely black
+    """
+
+    r, g, b = hex_to_rgb(color)
+
+    r = int(r * (1 - amount))
+    g = int(g * (1 - amount))
+    b = int(b * (1 - amount))
+
+    return rgb_to_hex((r, g, b))
+
+def darken_gradient(
+    gradient: GradientType,
+    amount: float = 0.15,
+) -> GradientType:
+    """
+    Darken all colors in a gradient.
+    """
+
+    return tuple(
+        darken_color(color, amount)
+        for color in gradient
+    )

gradienttk-0.1.2/gradienttk/core/constants.py

@@ -0,0 +1,6 @@
+HORIZONTAL = "horizontal"
+VERTICAL = "vertical"
+NORMAL = "normal"
+HOVER = "hover"
+PRESSED = "pressed"
+PRESS_ANIMATION_TIME = 100

gradienttk-0.1.2/gradienttk/core/gradient.py

@@ -0,0 +1,47 @@
+from PIL import Image
+from .constants import HORIZONTAL
+
+from .colors import hex_to_rgb, interpolate_color
+from .image import apply_corner_radius
+from typing import Tuple
+
+GradientType = Tuple[str, str]
+
+
+class GradientEngine:
+    def __init__(
+            self,
+            gradient: GradientType,
+            width: int,
+            height: int,
+            direction: str = HORIZONTAL,
+            corner_radius: int = 12,
+    ):
+        self.gradient = gradient
+        self.width = width
+        self.height = height
+        self.direction = direction
+        self.corner_radius = corner_radius
+
+    def generate(self) -> Image.Image:
+        image = Image.new("RGB", (self.width, self.height))
+
+        pixels = image.load()
+
+        start = hex_to_rgb(self.gradient[0])
+        end = hex_to_rgb(self.gradient[1])
+
+        if self.direction == "horizontal":
+
+            for x in range(self.width):
+
+                factor = x / (self.width - 1)
+
+                color = interpolate_color(start, end, factor)
+
+                for y in range(self.height):
+                    pixels[x, y] = color
+
+        image = apply_corner_radius(image, self.corner_radius)
+
+        return image

gradienttk-0.1.2/gradienttk/core/image.py

@@ -0,0 +1,22 @@
+from PIL import Image, ImageDraw
+
+
+def apply_corner_radius(image: Image.Image, radius: int) -> Image.Image:
+    """Apply rounded corners to a PIL image."""
+
+    if radius <= 0:
+        return image
+
+    mask = Image.new("L", image.size, 0)
+
+    draw = ImageDraw.Draw(mask)
+
+    draw.rounded_rectangle(
+        (0, 0, image.width, image.height),
+        radius=radius,
+        fill=255,
+    )
+
+    image.putalpha(mask)
+
+    return image

gradienttk-0.1.2/gradienttk/core/types.py

@@ -0,0 +1,3 @@
+from typing import Tuple
+
+GradientType = Tuple[str, ...]

gradienttk-0.1.2/gradienttk/widgets/__init__.py

@@ -0,0 +1 @@
+from .button import GradientButton

gradienttk-0.1.2/gradienttk/widgets/button.py

@@ -0,0 +1,215 @@
+import tkinter as tk
+
+import customtkinter as ctk
+from PIL import ImageTk
+
+from gradienttk.core.colors import darken_gradient
+from gradienttk.core.constants import (
+    HORIZONTAL,
+    HOVER,
+    NORMAL,
+    PRESSED,
+    PRESS_ANIMATION_TIME
+)
+from gradienttk.core.gradient import GradientEngine
+
+
+class GradientButton(ctk.CTkFrame):
+    """
+    GradientTk Button Widget
+    """
+
+    def __init__(
+            self,
+            master,
+            text="",
+            gradient=("#6C63FF", "#00C9FF"),
+            direction: str = HORIZONTAL,
+            command=None,
+            corner_radius: int = 12,
+            width=140,
+            height=35,
+            **kwargs
+    ):
+        super().__init__(
+            master,
+            width=width,
+            height=height,
+            fg_color="transparent",
+            **kwargs
+        )
+
+        self._canvas_bg = self._apply_appearance_mode(self._bg_color)
+
+        self._text = text
+        self._command = command
+        self._width = width
+        self._height = height
+        self._corner_radius = corner_radius
+        self._state = NORMAL
+
+        self._gradient = gradient
+        self._direction = direction
+        self._hover_gradient = darken_gradient(self._gradient)
+
+        self._engine = GradientEngine(
+            gradient=self._gradient,
+            width=self._width,
+            height=self._height,
+            direction=self._direction,
+            corner_radius=self._corner_radius,
+        )
+
+        self._canvas = tk.Canvas(
+            self,
+            width=width,
+            height=height,
+            highlightthickness=0,
+            bd=0,
+            relief="flat",
+            bg=self._canvas_bg,
+        )
+
+        self._canvas.bind("<Enter>", self._on_enter)
+        self._canvas.bind("<Leave>", self._on_leave)
+
+        self._canvas.bind("<ButtonPress-1>", self._on_press)
+        self._canvas.bind("<ButtonRelease-1>", self._on_release)
+
+        self._canvas.pack(fill="both", expand=True)
+
+        self.bind("<Configure>", self._on_resize)
+
+        self._render()
+
+    def configure(self, require_redraw=True, **kwargs):
+
+        if "text" in kwargs:
+            self._text = kwargs.pop("text")
+
+        if "gradient" in kwargs:
+            self._gradient = kwargs.pop("gradient")
+            self._hover_gradient = darken_gradient(self._gradient)
+            self._engine.gradient = self._gradient
+
+        if "command" in kwargs:
+            self._command = kwargs.pop("command")
+
+        if "corner_radius" in kwargs:
+            self._corner_radius = kwargs.pop("corner_radius")
+            self._engine.corner_radius = self._corner_radius
+
+        super().configure(**kwargs)
+
+        if require_redraw:
+            self._render()
+
+    def cget(self, attribute):
+
+        if attribute == "text":
+            return self._text
+
+        if attribute == "gradient":
+            return self._gradient
+
+        if attribute == "command":
+            return self._command
+
+        if attribute == "corner_radius":
+            return self._corner_radius
+
+        return super().cget(attribute)
+
+    def set_text(self, text):
+        self.configure(text=text)
+
+    def set_gradient(self, start, end):
+        self.configure(gradient=(start, end))
+
+    def _on_resize(self, event):
+
+        if event.width <= 1 or event.height <= 1:
+            return
+
+        if event.width == self._width and event.height == self._height:
+            return
+
+        self._width = event.width
+        self._height = event.height
+
+        self._engine.width = self._width
+        self._engine.height = self._height
+
+        self._canvas.config(
+            width=self._width,
+            height=self._height
+        )
+
+        self._render()
+
+    def _on_enter(self, event):
+
+        self._state = HOVER
+
+        self._set_gradient(self._hover_gradient)
+
+    def _on_leave(self, event):
+
+        self._state = NORMAL
+
+        self._set_gradient(self._gradient)
+
+    def _on_press(self, event):
+
+        if callable(self._command):
+            self._command()
+
+        self._state = PRESSED
+
+        self._set_gradient(self._gradient)
+
+    def _on_release(self, event):
+
+        if self._state != PRESSED:
+            return
+
+        self.after(
+            PRESS_ANIMATION_TIME,
+            self._restore_hover
+        )
+
+    def _render(self):
+        self._canvas.delete("all")
+
+        self._photo = self._create_gradient()
+
+        self._canvas.create_image(
+            0,
+            0,
+            anchor="nw",
+            image=self._photo,
+        )
+
+        self._canvas.create_text(
+            self._width // 2,
+            self._height // 2,
+            text=self._text,
+            fill="white",
+        )
+
+    def _set_gradient(self, gradient):
+        self._engine.gradient = gradient
+        self._render()
+
+    def _create_gradient(self):
+        image = self._engine.generate()
+        return ImageTk.PhotoImage(image)
+
+    def _restore_hover(self):
+
+        if self._state != PRESSED:
+            return
+
+        self._state = HOVER
+
+        self._set_gradient(self._hover_gradient)

{gradienttk-0.1.1 → gradienttk-0.1.2}/gradienttk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gradienttk
-Version: 0.1.1
+Version: 0.1.2
 Summary: Modern Gradient Widgets for CustomTkinter
 Author: Mohammad Amin
 License-Expression: MIT

gradienttk-0.1.2/gradienttk.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+README.md
+pyproject.toml
+gradienttk/__init__.py
+gradienttk.egg-info/PKG-INFO
+gradienttk.egg-info/SOURCES.txt
+gradienttk.egg-info/dependency_links.txt
+gradienttk.egg-info/requires.txt
+gradienttk.egg-info/top_level.txt
+gradienttk/core/__init__.py
+gradienttk/core/colors.py
+gradienttk/core/constants.py
+gradienttk/core/gradient.py
+gradienttk/core/image.py
+gradienttk/core/types.py
+gradienttk/widgets/__init__.py
+gradienttk/widgets/button.py

{gradienttk-0.1.1 → gradienttk-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gradienttk"
-version = "0.1.1"
+version = "0.1.2"
 description = "Modern Gradient Widgets for CustomTkinter"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -31,5 +31,6 @@ dependencies = [
     "Pillow>=10.0.0"
 ]
 
-[tool.setuptools]
-packages = ["gradienttk"]
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["gradienttk*"]

gradienttk-0.1.1/gradienttk.egg-info/SOURCES.txt

@@ -1,9 +0,0 @@
-LICENSE
-README.md
-pyproject.toml
-gradienttk/__init__.py
-gradienttk.egg-info/PKG-INFO
-gradienttk.egg-info/SOURCES.txt
-gradienttk.egg-info/dependency_links.txt
-gradienttk.egg-info/requires.txt
-gradienttk.egg-info/top_level.txt