glass-ui 0.1.0__tar.gz

glass_ui-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jiyihao
+
+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.

glass_ui-0.1.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include LICENSE
+include README.md
+
+recursive-include docs *.md
+recursive-include examples *.py *.png *.ico
+
+global-exclude __pycache__ *.py[cod] .DS_Store

glass_ui-0.1.0/PKG-INFO

@@ -0,0 +1,279 @@
+Metadata-Version: 2.4
+Name: glass-ui
+Version: 0.1.0
+Summary: Liquid-glass UI layer for tkinter on Windows: real desktop blur behind your window, plus fully self-drawn widgets.
+Author: jiyihao
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/jiyihao/glass-ui
+Project-URL: Repository, https://github.com/jiyihao/glass-ui
+Project-URL: Issues, https://github.com/jiyihao/glass-ui/issues
+Project-URL: Changelog, https://github.com/jiyihao/glass-ui/releases
+Keywords: tkinter,gui,glass,liquid-glass,glassmorphism,blur,acrylic,mica,windows,desktop,ui
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow>=9.0
+Dynamic: license-file
+
+# glass-ui
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-2ea44f.svg)](https://github.com/jiyihao/glass-ui/blob/main/LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.9%2B-3776ab.svg)]()
+[![Platform](https://img.shields.io/badge/Platform-Windows-0078d4.svg)]()
+[![Deps](https://img.shields.io/badge/Deps-Pillow%20only-8a2be2.svg)]()
+
+**给 tkinter 用的液态玻璃（Liquid Glass）界面层。**
+
+tkinter 本身没有任何模糊、半透明合成能力，所以 Python 桌面小工具默认长相都很朴素。
+这个库把「看起来像一块真玻璃」需要的东西都包好了：抓取窗口后方的真实桌面 → 高斯模糊
+→ 上色调色 → 把卡片/描边/按钮底面合成进同一张底图 → 整张铺成 Canvas 背景，
+再配一套完全自绘的控件。
+
+透出来的是**真实桌面内容**，不是渐变模拟。
+
+![示例](https://raw.githubusercontent.com/jiyihao/glass-ui/main/examples/dashboard.png)
+
+> 不想写代码？[**下载 MemTidy.exe**](https://github.com/jiyihao/glass-ui/releases/latest)
+> 直接体验这个库的成品效果 —— 单文件免安装，双击就跑（Windows）。
+
+---
+
+## 这个库到底在做什么
+
+tkinter 的三个「看起来能用其实不行」的方案：
+
+| 做法 | 为什么不行 |
+|---|---|
+| `wm_attributes("-alpha", 0.9)` | 整窗一起变透，**文字跟着发虚**，中文尤其明显 |
+| `wm_attributes("-transparentcolor", "#010203")` | 挖洞，那块区域**连鼠标事件一起消失**，控件点不到 |
+| `ttk` 自定义主题 | 只能换配色，做不出模糊 |
+
+所以只能自己合成。渲染管线是这样的：
+
+```
+ 窗口后方的桌面
+      │  ImageGrab / BitBlt          （抓屏时用 WDA_EXCLUDEFROMCAPTURE 排除自身）
+      ▼
+  高斯模糊 + 饱和度 ×2.05 + 深色面纱
+      │
+      ▼
+  四角彩色氛围光（screen 混合） + 顶部镜面高光 + 极淡噪点
+      │
+      ▼
+  GlassEngine.compose()
+      ├─ 卡片外阴影（向下偏移 6px，模糊 14）
+      ├─ 玻璃层：标题栏渐亮带 + 卡片白 16/255 填充 + 双层描边
+      ├─ 每张卡片内部的顶部柔光
+      ├─ 你插入的自定义图层（进度条凹槽、徽章底…）
+      ├─ 窗口棱边：整圈亮边 + 上缘更亮
+      └─ 按钮底面（一般留空，按钮有自己的画布）
+      │
+      ▼
+  一张 RGBA 底图 → 当 Canvas 背景铺上去
+      │
+      ▼
+  Canvas 上只画文字和交互图元（重绘开销极低）
+```
+
+窗口圆角由 `SetWindowRgn` 在系统层裁掉；无边框窗口补 `WS_EX_APPWINDOW`
+才能进任务栏和 Alt+Tab。这些都在库里。
+
+---
+
+## 安装
+
+```bash
+pip install glass-ui
+```
+
+只依赖 Pillow。想改源码就用可编辑安装：
+
+```bash
+git clone https://github.com/jiyihao/glass-ui.git
+cd glass-ui
+pip install -e .
+```
+
+或者直接把 `glass_ui/` 文件夹丢进你的项目里，不需要装任何东西。
+
+要求：Windows（用到了 Win32 接口）、Python 3.9+、Pillow 9+。
+没有 Pillow 时库不会崩，会自动退化成纯色直角界面。
+
+---
+
+## 快速开始
+
+```python
+import tkinter as tk
+from glass_ui import GlassWindow, GlassButton, FONT_UI
+
+class Demo(GlassWindow):
+    TITLE = "Hello Glass"
+    WIN_W, WIN_H = 720, 420
+
+    def build_ui(self):
+        self.make_canvas()                       # 建主 Canvas + 绑定拖动
+        self.btn = GlassButton(self, "点我", self.on_click,
+                               24, 300, 120, 44, "primary")
+
+    def glass_cards(self):                       # 哪些矩形是卡片
+        return [(24, 80, 672, 190)]
+
+    def glass_slices(self):                      # 哪些子控件要背景切片
+        return [(self.btn, self.btn.x, self.btn.y, self.btn.w, self.btn.h)]
+
+    def draw_chrome(self):                       # 画字
+        cv = self.cv
+        cv.delete("all")
+        if self.bg_photo is not None:
+            cv.create_image(0, 0, image=self.bg_photo, anchor="nw")
+        cv.create_text(48, 120, text="你好，玻璃", anchor="w",
+                       fill="#ffffff", font=(FONT_UI, 22, "bold"))
+
+    def on_click(self):
+        self.info("提示", "模糊的是窗口后面真实的桌面。")
+
+root = tk.Tk()
+Demo(root).run()
+```
+
+跑起来就有了圆角、无边框、可拖动、背后是真桌面的玻璃窗口。
+
+---
+
+## 五个钩子
+
+`GlassWindow` 的子类只需要实现这几件事，其余（抓屏、模糊、圆角、拖动、
+任务栏、背景切片分发、弹窗）都由基类负责：
+
+| 方法 | 作用 |
+|---|---|
+| `build_ui()` | 建 `self.cv`（调 `self.make_canvas()`）和所有控件 |
+| `glass_cards()` | 返回 `[(x, y, w, h)]`，这些矩形会变成玻璃卡片 |
+| `glass_decorators()` | 返回 `[fn(img) -> img]`，画必须带 alpha 的静态层 |
+| `glass_slices()` | 返回 `[(控件, x, y, w, h)]`，基类把底图切给控件 |
+| `draw_chrome()` | 在 `self.cv` 上画文字和交互图元 |
+
+还有一个可选钩子 `on_ready()`，在界面搭好、背景还没建时调用，适合塞首屏数据。
+
+### `glass_slices()` 为什么必须写
+
+每个控件都是一个子 Canvas。子 Canvas 有自己的底色，圆角之外的四角会露出一个
+**深色方框**。解法是把主底图对应区域切一块贴给它 —— 这就是 `glass_slices()`。
+
+漏写某个控件的后果就是它周围出现一个黑方块。这个坑我们在弹窗按钮上也踩过。
+
+---
+
+## 控件
+
+| 控件 | 说明 |
+|---|---|
+| `GlassButton` | 胶囊按钮，`primary` / `ghost` 两种；自带常态 / 悬停 / 按下三态贴图 |
+| `IconButton` | 标题栏圆形图标按钮（最小化 / 关闭 / 帮助） |
+| `GlassToggle` | iOS 风格开关，轨道渐变 + 滑块投影 + 球体明暗 |
+| `GlassTable` | 自绘可滚动表格，行底纹是内缩圆角条；带 Treeview 的一个子集接口 |
+| `GlassLog` | 只读日志，时间戳等宽字体，正文按 tag 上色 |
+| `GlassWindow` | 无边框圆角窗口基类，附带 `ask()` / `info()` 玻璃弹窗 |
+
+表格和日志的 tag 颜色由类属性映射，库不认识你的 tag 叫什么：
+
+```python
+table.ROW_FG  = {"warn": C_ORANGE, "muted": "#949db0"}   # tag -> 主列颜色
+table.ROW_DOT = ("warn",)                                # 这些 tag 左边画圆点
+table.NOTE_FG = {"warn": C_ORANGE}                       # tag -> 备注列颜色
+```
+
+---
+
+## 调参
+
+`GlassEngine` 上的类属性就是全部的旋钮：
+
+| 参数 | 默认 | 效果 |
+|---|---|---|
+| `BLUR` | `30` | 模糊半径。太小像磨砂贴膜，太大看不出桌面内容 |
+| `VEIL` | `0.74` | 深色面纱强度。越低越透、文字越难读 |
+| `CARD_R` | `18` | 卡片圆角 |
+| `WIN_R` | `26` | 整窗圆角（同时是 `SetWindowRgn` 的半径） |
+| `TITLE_H` | `58` | 标题栏高度，`0` 表示不要标题栏底色 |
+
+具体到某个窗口：
+
+```python
+app = MyWindow(root)
+app.engine.VEIL = 0.62      # 想更透一点
+app.engine.BLUR = 26
+app.rebuild_background()
+```
+
+字号、配色在 `glass_ui/theme.py`，都是普通常量，直接改或覆盖即可。
+
+---
+
+## 示例
+
+```
+examples/
+├─ dashboard.py       最小示例：一块"系统概览"面板，也是本页顶部那张图
+└─ memtidy/           MemTidy 内存整理器 —— 真实项目，完整源码
+```
+
+两个都能直接跑：
+
+```bash
+python examples/dashboard.py
+python examples/memtidy/memtidy.py
+```
+
+都支持 `--shot out.png`：渲染完截一张图就退出，用来核对布局。
+调界面时这个模式比反复手动截图舒服得多。
+
+`examples/memtidy/` 是一个能打包成 exe 的真实应用（PyInstaller 单文件 19 MB），
+里面有：内存卡的四级信息层次、进度条渐变填充、带状态点的进程表、整理进度实时回显。
+界面代码全部调库，本体只剩 Win32 内存接口和「画什么字」。
+
+---
+
+## 已知限制
+
+- **只在 Windows 上能用。** 抓屏、圆角、任务栏、抓屏排除都是 Win32 接口。
+- **Alt+Tab 切换回来会短暂看到旧背景。** 窗口重新可见时会重新抓屏（`<Map>` 事件），
+  但抓屏+合成要几十毫秒。
+- **透明区域不能点击** 这个问题本库不存在（用的是系统级圆角裁剪，不是挖洞），
+  但窗口**内部**的圆角处（比如卡片圆角外）仍然是主 Canvas，正常接收事件。
+- **`WDA_EXCLUDEFROMCAPTURE` 需要 Windows 10 2004+。** 更老的系统上抓屏会拍到自己。
+- **性能**：一次 `rebuild_background()` 大约 40~60ms（900×640，抓屏 + 模糊 + 合成）。
+  只在窗口出现、移动结束、尺寸变化时重建，平时不重建。
+- 表格没有多选拖拽、没有列排序，够用但不完整。
+
+---
+
+## 踩过的坑
+
+写这个库的过程中踩到一批 tkinter / Pillow / Win32 的坑，全部记录在
+[`docs/PITFALLS.md`](https://github.com/jiyihao/glass-ui/blob/main/docs/PITFALLS.md)。几条高频的：
+
+- **`ImageDraw` 在 RGBA 图上不混合 alpha**，只是直接写像素。半透明图元必须先画到
+  独立图层再 `alpha_composite`，否则 `convert("RGB")` 之后就是一个纯白实心块。
+- **`create_polygon(..., smooth=True)` 会把胶囊画成菱形**：圆角半径接近半高时，
+  贝塞尔的控制点会把圆弧拉直成 45° 斜边。
+- **`ImageDraw.arc` 的包围盒是整个按钮**，画"高光弧"会变成一条横穿按钮的白线。
+- **`Image.alpha_composite` 没有 `dest` 参数**，想在指定位置合成只能
+  `crop → composite → paste`。
+- **子画布会盖住主画布上的图元**，画在子画布起点之后的分隔线永远看不见。
+- **`tkfont.measure()` 在大字号下偏大十几像素**，用 `cv.bbox(item)` 取实测宽度。
+
+---
+
+## License
+
+[MIT](https://github.com/jiyihao/glass-ui/blob/main/LICENSE)

glass_ui-0.1.0/README.md

@@ -0,0 +1,254 @@
+# glass-ui
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-2ea44f.svg)](https://github.com/jiyihao/glass-ui/blob/main/LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.9%2B-3776ab.svg)]()
+[![Platform](https://img.shields.io/badge/Platform-Windows-0078d4.svg)]()
+[![Deps](https://img.shields.io/badge/Deps-Pillow%20only-8a2be2.svg)]()
+
+**给 tkinter 用的液态玻璃（Liquid Glass）界面层。**
+
+tkinter 本身没有任何模糊、半透明合成能力，所以 Python 桌面小工具默认长相都很朴素。
+这个库把「看起来像一块真玻璃」需要的东西都包好了：抓取窗口后方的真实桌面 → 高斯模糊
+→ 上色调色 → 把卡片/描边/按钮底面合成进同一张底图 → 整张铺成 Canvas 背景，
+再配一套完全自绘的控件。
+
+透出来的是**真实桌面内容**，不是渐变模拟。
+
+![示例](https://raw.githubusercontent.com/jiyihao/glass-ui/main/examples/dashboard.png)
+
+> 不想写代码？[**下载 MemTidy.exe**](https://github.com/jiyihao/glass-ui/releases/latest)
+> 直接体验这个库的成品效果 —— 单文件免安装，双击就跑（Windows）。
+
+---
+
+## 这个库到底在做什么
+
+tkinter 的三个「看起来能用其实不行」的方案：
+
+| 做法 | 为什么不行 |
+|---|---|
+| `wm_attributes("-alpha", 0.9)` | 整窗一起变透，**文字跟着发虚**，中文尤其明显 |
+| `wm_attributes("-transparentcolor", "#010203")` | 挖洞，那块区域**连鼠标事件一起消失**，控件点不到 |
+| `ttk` 自定义主题 | 只能换配色，做不出模糊 |
+
+所以只能自己合成。渲染管线是这样的：
+
+```
+ 窗口后方的桌面
+      │  ImageGrab / BitBlt          （抓屏时用 WDA_EXCLUDEFROMCAPTURE 排除自身）
+      ▼
+  高斯模糊 + 饱和度 ×2.05 + 深色面纱
+      │
+      ▼
+  四角彩色氛围光（screen 混合） + 顶部镜面高光 + 极淡噪点
+      │
+      ▼
+  GlassEngine.compose()
+      ├─ 卡片外阴影（向下偏移 6px，模糊 14）
+      ├─ 玻璃层：标题栏渐亮带 + 卡片白 16/255 填充 + 双层描边
+      ├─ 每张卡片内部的顶部柔光
+      ├─ 你插入的自定义图层（进度条凹槽、徽章底…）
+      ├─ 窗口棱边：整圈亮边 + 上缘更亮
+      └─ 按钮底面（一般留空，按钮有自己的画布）
+      │
+      ▼
+  一张 RGBA 底图 → 当 Canvas 背景铺上去
+      │
+      ▼
+  Canvas 上只画文字和交互图元（重绘开销极低）
+```
+
+窗口圆角由 `SetWindowRgn` 在系统层裁掉；无边框窗口补 `WS_EX_APPWINDOW`
+才能进任务栏和 Alt+Tab。这些都在库里。
+
+---
+
+## 安装
+
+```bash
+pip install glass-ui
+```
+
+只依赖 Pillow。想改源码就用可编辑安装：
+
+```bash
+git clone https://github.com/jiyihao/glass-ui.git
+cd glass-ui
+pip install -e .
+```
+
+或者直接把 `glass_ui/` 文件夹丢进你的项目里，不需要装任何东西。
+
+要求：Windows（用到了 Win32 接口）、Python 3.9+、Pillow 9+。
+没有 Pillow 时库不会崩，会自动退化成纯色直角界面。
+
+---
+
+## 快速开始
+
+```python
+import tkinter as tk
+from glass_ui import GlassWindow, GlassButton, FONT_UI
+
+class Demo(GlassWindow):
+    TITLE = "Hello Glass"
+    WIN_W, WIN_H = 720, 420
+
+    def build_ui(self):
+        self.make_canvas()                       # 建主 Canvas + 绑定拖动
+        self.btn = GlassButton(self, "点我", self.on_click,
+                               24, 300, 120, 44, "primary")
+
+    def glass_cards(self):                       # 哪些矩形是卡片
+        return [(24, 80, 672, 190)]
+
+    def glass_slices(self):                      # 哪些子控件要背景切片
+        return [(self.btn, self.btn.x, self.btn.y, self.btn.w, self.btn.h)]
+
+    def draw_chrome(self):                       # 画字
+        cv = self.cv
+        cv.delete("all")
+        if self.bg_photo is not None:
+            cv.create_image(0, 0, image=self.bg_photo, anchor="nw")
+        cv.create_text(48, 120, text="你好，玻璃", anchor="w",
+                       fill="#ffffff", font=(FONT_UI, 22, "bold"))
+
+    def on_click(self):
+        self.info("提示", "模糊的是窗口后面真实的桌面。")
+
+root = tk.Tk()
+Demo(root).run()
+```
+
+跑起来就有了圆角、无边框、可拖动、背后是真桌面的玻璃窗口。
+
+---
+
+## 五个钩子
+
+`GlassWindow` 的子类只需要实现这几件事，其余（抓屏、模糊、圆角、拖动、
+任务栏、背景切片分发、弹窗）都由基类负责：
+
+| 方法 | 作用 |
+|---|---|
+| `build_ui()` | 建 `self.cv`（调 `self.make_canvas()`）和所有控件 |
+| `glass_cards()` | 返回 `[(x, y, w, h)]`，这些矩形会变成玻璃卡片 |
+| `glass_decorators()` | 返回 `[fn(img) -> img]`，画必须带 alpha 的静态层 |
+| `glass_slices()` | 返回 `[(控件, x, y, w, h)]`，基类把底图切给控件 |
+| `draw_chrome()` | 在 `self.cv` 上画文字和交互图元 |
+
+还有一个可选钩子 `on_ready()`，在界面搭好、背景还没建时调用，适合塞首屏数据。
+
+### `glass_slices()` 为什么必须写
+
+每个控件都是一个子 Canvas。子 Canvas 有自己的底色，圆角之外的四角会露出一个
+**深色方框**。解法是把主底图对应区域切一块贴给它 —— 这就是 `glass_slices()`。
+
+漏写某个控件的后果就是它周围出现一个黑方块。这个坑我们在弹窗按钮上也踩过。
+
+---
+
+## 控件
+
+| 控件 | 说明 |
+|---|---|
+| `GlassButton` | 胶囊按钮，`primary` / `ghost` 两种；自带常态 / 悬停 / 按下三态贴图 |
+| `IconButton` | 标题栏圆形图标按钮（最小化 / 关闭 / 帮助） |
+| `GlassToggle` | iOS 风格开关，轨道渐变 + 滑块投影 + 球体明暗 |
+| `GlassTable` | 自绘可滚动表格，行底纹是内缩圆角条；带 Treeview 的一个子集接口 |
+| `GlassLog` | 只读日志，时间戳等宽字体，正文按 tag 上色 |
+| `GlassWindow` | 无边框圆角窗口基类，附带 `ask()` / `info()` 玻璃弹窗 |
+
+表格和日志的 tag 颜色由类属性映射，库不认识你的 tag 叫什么：
+
+```python
+table.ROW_FG  = {"warn": C_ORANGE, "muted": "#949db0"}   # tag -> 主列颜色
+table.ROW_DOT = ("warn",)                                # 这些 tag 左边画圆点
+table.NOTE_FG = {"warn": C_ORANGE}                       # tag -> 备注列颜色
+```
+
+---
+
+## 调参
+
+`GlassEngine` 上的类属性就是全部的旋钮：
+
+| 参数 | 默认 | 效果 |
+|---|---|---|
+| `BLUR` | `30` | 模糊半径。太小像磨砂贴膜，太大看不出桌面内容 |
+| `VEIL` | `0.74` | 深色面纱强度。越低越透、文字越难读 |
+| `CARD_R` | `18` | 卡片圆角 |
+| `WIN_R` | `26` | 整窗圆角（同时是 `SetWindowRgn` 的半径） |
+| `TITLE_H` | `58` | 标题栏高度，`0` 表示不要标题栏底色 |
+
+具体到某个窗口：
+
+```python
+app = MyWindow(root)
+app.engine.VEIL = 0.62      # 想更透一点
+app.engine.BLUR = 26
+app.rebuild_background()
+```
+
+字号、配色在 `glass_ui/theme.py`，都是普通常量，直接改或覆盖即可。
+
+---
+
+## 示例
+
+```
+examples/
+├─ dashboard.py       最小示例：一块"系统概览"面板，也是本页顶部那张图
+└─ memtidy/           MemTidy 内存整理器 —— 真实项目，完整源码
+```
+
+两个都能直接跑：
+
+```bash
+python examples/dashboard.py
+python examples/memtidy/memtidy.py
+```
+
+都支持 `--shot out.png`：渲染完截一张图就退出，用来核对布局。
+调界面时这个模式比反复手动截图舒服得多。
+
+`examples/memtidy/` 是一个能打包成 exe 的真实应用（PyInstaller 单文件 19 MB），
+里面有：内存卡的四级信息层次、进度条渐变填充、带状态点的进程表、整理进度实时回显。
+界面代码全部调库，本体只剩 Win32 内存接口和「画什么字」。
+
+---
+
+## 已知限制
+
+- **只在 Windows 上能用。** 抓屏、圆角、任务栏、抓屏排除都是 Win32 接口。
+- **Alt+Tab 切换回来会短暂看到旧背景。** 窗口重新可见时会重新抓屏（`<Map>` 事件），
+  但抓屏+合成要几十毫秒。
+- **透明区域不能点击** 这个问题本库不存在（用的是系统级圆角裁剪，不是挖洞），
+  但窗口**内部**的圆角处（比如卡片圆角外）仍然是主 Canvas，正常接收事件。
+- **`WDA_EXCLUDEFROMCAPTURE` 需要 Windows 10 2004+。** 更老的系统上抓屏会拍到自己。
+- **性能**：一次 `rebuild_background()` 大约 40~60ms（900×640，抓屏 + 模糊 + 合成）。
+  只在窗口出现、移动结束、尺寸变化时重建，平时不重建。
+- 表格没有多选拖拽、没有列排序，够用但不完整。
+
+---
+
+## 踩过的坑
+
+写这个库的过程中踩到一批 tkinter / Pillow / Win32 的坑，全部记录在
+[`docs/PITFALLS.md`](https://github.com/jiyihao/glass-ui/blob/main/docs/PITFALLS.md)。几条高频的：
+
+- **`ImageDraw` 在 RGBA 图上不混合 alpha**，只是直接写像素。半透明图元必须先画到
+  独立图层再 `alpha_composite`，否则 `convert("RGB")` 之后就是一个纯白实心块。
+- **`create_polygon(..., smooth=True)` 会把胶囊画成菱形**：圆角半径接近半高时，
+  贝塞尔的控制点会把圆弧拉直成 45° 斜边。
+- **`ImageDraw.arc` 的包围盒是整个按钮**，画"高光弧"会变成一条横穿按钮的白线。
+- **`Image.alpha_composite` 没有 `dest` 参数**，想在指定位置合成只能
+  `crop → composite → paste`。
+- **子画布会盖住主画布上的图元**，画在子画布起点之后的分隔线永远看不见。
+- **`tkfont.measure()` 在大字号下偏大十几像素**，用 `cv.bbox(item)` 取实测宽度。
+
+---
+
+## License
+
+[MIT](https://github.com/jiyihao/glass-ui/blob/main/LICENSE)