FovesColor 0.1.0__py3-none-any.whl

FovesColor/__init__.py

@@ -0,0 +1 @@
+from colors import color_whell, hsl_to_rgb, rgb_tuple_to_hex

FovesColor/colors.py

@@ -0,0 +1,64 @@
+def hsl_to_rgb(h: int, s: int, l: int) -> tuple[int, int, int]:
+    """
+    将HSL颜色转换为RGB颜色
+    
+    参数:
+        h: 色相 (0-360)
+        s: 饱和度 (0-100)
+        l: 亮度 (0-100)
+    
+    返回:
+        tuple[int, int, int]: RGB颜色值，每个分量范围0-255
+    """
+    # 将HSL值转换为0-1范围
+    h_norm = h / 360.0
+    s_norm = s / 100.0
+    l_norm = l / 100.0
+    
+    # 如果饱和度为0，则是灰色
+    if s_norm == 0:
+        r = g = b = l_norm
+    else:
+        # 计算临时变量
+        def hue_to_rgb(p: float, q: float, t: float) -> float:
+            if t < 0:
+                t += 1
+            if t > 1:
+                t -= 1
+            if t < 1/6:
+                return p + (q - p) * 6 * t
+            if t < 1/2:
+                return q
+            if t < 2/3:
+                return p + (q - p) * (2/3 - t) * 6
+            return p
+        
+        q = l_norm * (1 + s_norm) if l_norm < 0.5 else l_norm + s_norm - l_norm * s_norm
+        p = 2 * l_norm - q
+        
+        r = hue_to_rgb(p, q, h_norm + 1/3)
+        g = hue_to_rgb(p, q, h_norm)
+        b = hue_to_rgb(p, q, h_norm - 1/3)
+    
+    # 将RGB值转换为0-255范围并四舍五入
+    return (int(round(r * 255)), int(round(g * 255)), int(round(b * 255)))
+
+def rgb_tuple_to_hex(rgb: tuple[int, int, int]|list[tuple[int, int, int]]) -> str|list[str]:
+    """
+    将RGB元组转换为十六进制颜色字符串，支持批量调用
+
+    参数:
+        rgb: RGB元组，每个分量范围0-255
+
+    返回:
+        str: 十六进制颜色字符串，例如'#RRGGBB'
+    """
+    if isinstance(rgb, list):
+        return [f'#{i[0]:02x}{i[1]:02x}{i[2]:02x}' for i in rgb]
+    else:
+        return f'#{rgb[0]:02x}{rgb[1]:02x}{rgb[2]:02x}'
+
+
+def color_whell(split: int, s: int, l: int) -> list[tuple[int, int, int]]:
+    """ 将色轮分为 split 等分，然后按给定的饱和度和亮度生成颜色 """
+    return [hsl_to_rgb(int(i * 360 / split), s, l) for i in range(split)]

fovescolor-0.1.0.dist-info/METADATA

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: FovesColor
+Version: 0.1.0
+Summary: 四叶的颜色管理工具
+Project-URL: Repository, https://github.com/Foves7017/FovesLib
+Author: Foves7017
+License: MIT License
+        
+        Copyright (c) 2026 Foves7017
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# FovesColor
+包括一系列和颜色相关的工具。
+
+可使用 pip 安装或下载源码使用：
+```BASH
+pip install FovesColor
+```
+
+项目主页：
+https://github.com/Foves7017/FovesLib
+
+
+## `hsl_to_rgb(h, s, l)`
+
+将 HSL 颜色转换为 RGB。
+
+| 参数 | 类型 | 范围 | 说明 |
+|------|------|------|------|
+| `h` | `int` | 0–360 | 色相 |
+| `s` | `int` | 0–100 | 饱和度 |
+| `l` | `int` | 0–100 | 亮度 |
+
+返回 `tuple[int, int, int]`，每个分量范围 0–255。
+
+
+## `rgb_tuple_to_hex(rgb)`
+
+将 RGB 元组转换为 `#RRGGBB` 十六进制字符串。**支持单个和批量**——传入列表自动返回列表。
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `rgb` | `tuple[int,int,int]` | 单个 RGB 颜色 |
+| `rgb` | `list[tuple[int,int,int]]` | 批量 RGB 颜色 |
+
+返回 `str`（单个）或 `list[str]`（批量）。
+
+
+## `color_whell(split, s, l)`
+
+将色轮均分为 `split` 等份，按指定饱和度和亮度生成 RGB 颜色列表。
+
+| 参数 | 类型 | 范围 | 说明 |
+|------|------|------|------|
+| `split` | `int` | ≥1 | 色轮分割份数 |
+| `s` | `int` | 0–100 | 饱和度 |
+| `l` | `int` | 0–100 | 亮度 |
+
+返回 `list[tuple[int, int, int]]`。

fovescolor-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+FovesColor/__init__.py,sha256=AK1lnPef0ZIJlu-C2rzTT1Dm1jooh1MhTDtn3B2NFNk,60
+FovesColor/colors.py,sha256=HroexMJrN8rTL2x7tbRoP5ApAmFS4iGS4ZUG-dstQGE,2071
+fovescolor-0.1.0.dist-info/METADATA,sha256=0ItAmh8X1wnZibyQvr5Z0v8Gd-7Atx8V_uHlNRfsoP8,2712
+fovescolor-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+fovescolor-0.1.0.dist-info/licenses/LICENSE,sha256=lXz0pZeICx_-HWjVeatkJhfuZp5Wd4jOPYzVs57mLfM,1087
+fovescolor-0.1.0.dist-info/RECORD,,

fovescolor-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

fovescolor-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Foves7017
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.