如何让Python创建的窗口在部分离屏时仍可被正常录制？

Windows 10下常规应用会通过后台缓冲区完整渲染窗口内容，即便部分区域离屏也能被OBS正常录制，但PyQt6、pygame、tkinter、pyglet等Python GUI库默认只渲染屏幕可见区域，导致离屏部分录制时出现撕裂或不更新。以下是针对各库的具体解决方案：

PyQt6 解决方案 #

核心是强制Qt使用离屏缓冲区渲染整个窗口，并触发完整重绘：

from PyQt6.QtWidgets import QApplication, QWidget
from PyQt6.QtCore import QTimer, Qt

app = QApplication([])
# 强制使用光栅化渲染，确保窗口内容全量写入缓冲区
app.setAttribute(Qt.ApplicationAttribute.AA_ForceRasterWidgets, True)

window = QWidget()
# 禁用直接屏幕绘制，改用离屏缓冲区
window.setAttribute(Qt.WidgetAttribute.WA_PaintOnScreen, False)
# 确保系统背景被正确绘制
window.setAttribute(Qt.WidgetAttribute.WA_NoSystemBackground, False)
window.setStyleSheet("background-color: white;")
window.show()

def toggle_color():
    current_color = window.styleSheet()
    new_color = "background-color: black;" if current_color == "background-color: white;" else "background-color: white;"
    window.setStyleSheet(new_color)
    # 强制重绘整个窗口区域（包括离屏部分）
    window.update(window.rect())

timer = QTimer()
timer.timeout.connect(toggle_color)
timer.start(500)

app.exec()

pygame 解决方案 #

使用双缓冲硬件表面，并调用flip()更新整个窗口缓冲区：

import pygame
import time

pygame.init()
# 创建双缓冲+硬件加速的窗口表面
screen = pygame.display.set_mode((400, 300), pygame.DOUBLEBUF | pygame.HWSURFACE)
clock = pygame.time.Clock()
color = (255, 255, 255)

running = True
while running:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False
            
    # 切换背景色
    color = (0, 0, 0) if color == (255, 255, 255) else (255, 255, 255)
    # 填充整个窗口表面
    screen.fill(color)
    # 更新整个缓冲区（而非局部区域）
    pygame.display.flip()
    clock.tick(2)

pygame.quit()

tkinter 解决方案 #

强制触发顶层窗口的全部闲置任务更新，确保离屏区域被重绘：

import tkinter as tk

root = tk.Tk()
root.geometry("400x300")
frame = tk.Frame(root, bg="white")
frame.pack(fill=tk.BOTH, expand=True)

def toggle_color():
    current_bg = frame.cget("bg")
    new_bg = "black" if current_bg == "white" else "white"
    frame.config(bg=new_bg)
    # 强制更新顶层窗口的所有区域
    root.update_idletasks()
    root.after(500, toggle_color)

toggle_color()
root.mainloop()

pyglet 解决方案 #

启用双缓冲，并在on_draw事件中绘制整个窗口区域：

import pyglet

# 创建双缓冲窗口
window = pyglet.window.Window(400, 300, double_buffer=True)
color = (1, 1, 1, 1)

@window.event
def on_draw():
    window.clear()
    # 绘制覆盖整个窗口的矩形
    pyglet.graphics.draw(4, pyglet.gl.GL_QUADS,
                        ('v2f', [0, 0, window.width, 0, window.width, window.height, 0, window.height]),
                        ('c4f', color * 4))

def toggle_color(dt):
    global color
    color = (0, 0, 0, 1) if color == (1, 1, 1, 1) else (1, 1, 1, 1)

pyglet.clock.schedule_interval(toggle_color, 0.5)
pyglet.app.run()

通用原理 #

所有方案的核心是：

• 让GUI库将整个窗口内容渲染到后台缓冲区，而非仅屏幕可见区域
• 每次更新时触发完整窗口重绘，避免局部更新导致的离屏区域失效

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