如何消除Python Kivy+pywin32圆角窗口的边角伪影？

以下是针对Kivy结合pywin32设置圆角窗口时出现伪影的有效解决思路及实现：

1. 让Kivy自身绘制时裁剪圆角 #

Kivy的默认绘制可能超出Win32设置的圆角区域，导致边角伪影。可以通过Kivy的Canvas裁剪指令，让UI绘制时自动限制在圆角范围内，和Win32的SetWindowRgn形成双重约束：

from kivy.graphics import RoundRect
from kivy.uix.widget import Widget

class RootLayout(Widget):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        with self.canvas.before:
            # 初始化圆角裁剪区域，radius值和Win32设置保持一致
            self.clip_rect = RoundRect(pos=self.pos, size=self.size, radius=[20])
            self.canvas.clip_instructions.add(self.clip_rect)
        # 绑定布局位置/尺寸变化，实时更新裁剪区域
        self.bind(pos=self._update_clip, size=self._update_clip)

    def _update_clip(self, *args):
        self.clip_rect.pos = self.pos
        self.clip_rect.size = self.size

将这个布局作为Kivy窗口的根控件，确保所有子控件的绘制都被裁剪到圆角内。

2. 使用Win32分层窗口属性 #

启用WS_EX_LAYERED扩展属性后，系统会更精准地处理窗口边缘的渲染，减少伪影。结合Kivy的透明窗口设置，实现更干净的圆角效果：

import win32gui, win32api, win32con
from kivy.config import Config
from kivy.core.window import Window

# 配置Kivy窗口透明
Config.set('graphics', 'transparentcolor', '000000')
Config.set('graphics', 'borderless', '1')
Config.write()

# 获取Kivy窗口句柄
Window.title = "圆角窗口测试"
hwnd = win32gui.FindWindow(None, Window.title)

# 设置分层窗口属性
ex_style = win32api.GetWindowLong(hwnd, win32con.GWL_EXSTYLE)
win32api.SetWindowLong(hwnd, win32con.GWL_EXSTYLE, ex_style | win32con.WS_EX_LAYERED)

# 创建并设置圆角区域
width, height = Window.size
rgn = win32gui.CreateRoundRectRgn(0, 0, width, height, 20, 20)
win32gui.SetWindowRgn(hwnd, rgn, True)

# 设置分层窗口的透明规则（这里用黑色作为透明色，alpha设为255保持不透明）
win32gui.SetLayeredWindowAttributes(
    hwnd, 
    win32api.RGB(0, 0, 0), 
    255, 
    win32con.LWA_COLORKEY | win32con.LWA_ALPHA
)

3. 实时同步圆角区域与窗口尺寸 #

伪影可能源于窗口尺寸变化后，旧的圆角区域未及时更新。绑定Kivy窗口的尺寸变化事件，每次窗口大小改变时重新生成并设置圆角区域：

import win32gui, win32con
from kivy.core.window import Window

def sync_rgn_with_size(window, new_size):
    hwnd = win32gui.FindWindow(None, window.title)
    if not hwnd:
        return
    # 销毁旧区域（可选，系统会自动回收，但手动清理更稳妥）
    old_rgn = win32gui.GetWindowRgn(hwnd)
    if old_rgn:
        win32gui.DeleteObject(old_rgn)
    # 创建新的圆角区域
    new_rgn = win32gui.CreateRoundRectRgn(0, 0, new_size[0], new_size[1], 20, 20)
    win32gui.SetWindowRgn(hwnd, new_rgn, True)

# 绑定尺寸变化事件
Window.bind(size=sync_rgn_with_size)

4. 禁用Kivy默认边框并自定义绘制 #

Kivy默认窗口边框的渲染逻辑可能和Win32圆角区域冲突，禁用默认边框后，手动绘制圆角背景和边框，避免边缘溢出：

from kivy.config import Config
from kivy.graphics import Color, RoundedRectangle
from kivy.uix.widget import Widget

# 禁用Kivy默认边框
Config.set('graphics', 'borderless', '1')
Config.write()

class RootLayout(Widget):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        with self.canvas.before:
            Color(1, 1, 1, 1)  # 背景色
            self.bg_rect = RoundedRectangle(pos=self.pos, size=self.size, radius=[20])
        self.bind(pos=self._update_bg, size=self._update_bg)

    def _update_bg(self, *args):
        self.bg_rect.pos = self.pos
        self.bg_rect.size = self.size

将此布局作为根控件，确保窗口背景完全贴合圆角，没有超出边缘的绘制内容。

内容的提问来源于stack exchange，提问作者xx1mde