如何在Pyglet中实现离屏渲染到纹理并显示？

核心方案是利用**OpenGL帧缓冲（Framebuffer）+ 纹理（Texture）**实现完全独立的离屏绘制，彻底和主窗口的渲染缓冲区分离，支持自定义绘制尺寸、独立控制绘制速率。以下是完整可运行的实现步骤和代码：

实现步骤 #

1. 创建离屏纹理与帧缓冲：创建一个指定尺寸的纹理作为离屏绘制的目标，再绑定到帧缓冲对象上，所有绘制命令都会输出到这个纹理。
2. 独立控制离屏绘制：绑定帧缓冲后执行绘制逻辑，完成后解绑，绘制速率可以通过定时任务或手动触发自由控制，不受窗口刷新速率限制。
3. 将离屏纹理渲染到主窗口：在窗口的刷新回调中，把离屏纹理绘制到窗口，支持缩放适配窗口大小。

完整示例代码 #

import pyglet
from pyglet.graphics import Framebuffer, Texture

# 初始化主窗口
window = pyglet.window.Window(width=800, height=600, caption="离屏绘制演示")

# 定义离屏画布尺寸（可自由设置，支持大于窗口）
OFFSCREEN_W = 1200
OFFSCREEN_H = 900

# 创建离屏纹理与帧缓冲
offscreen_texture = Texture.create(OFFSCREEN_W, OFFSCREEN_H)
offscreen_fbo = Framebuffer(color_attachments=[offscreen_texture])

# 准备离屏绘制的内容（示例：旋转的红色矩形）
draw_batch = pyglet.graphics.Batch()
rect = pyglet.shapes.Rectangle(x=OFFSCREEN_W//2 - 100, y=OFFSCREEN_H//2 - 100,
                               width=200, height=200, color=(255, 0, 0), batch=draw_batch)
rotate_speed = 15  # 每秒旋转角度

# 独立更新离屏内容的函数（可自定义触发频率）
def update_offscreen(dt):
    # 绑定离屏帧缓冲，后续绘制都输出到纹理
    offscreen_fbo.bind()
    # 清除离屏画布背景
    pyglet.gl.glClearColor(0.15, 0.15, 0.15, 1.0)
    pyglet.gl.glClear(pyglet.gl.GL_COLOR_BUFFER_BIT)
    # 执行绘制逻辑
    rect.rotation += rotate_speed * dt
    draw_batch.draw()
    # 解绑帧缓冲，回到主窗口渲染上下文
    offscreen_fbo.unbind()

# 设置离屏绘制速率（这里设为每秒30帧，和主窗口的60帧分离）
pyglet.clock.schedule_interval(update_offscreen, 1/30)

# 主窗口绘制回调：将离屏纹理渲染到窗口
@window.event
def on_draw():
    window.clear()
    # 创建Sprite来绘制纹理，自动适配窗口缩放
    sprite = pyglet.sprite.Sprite(offscreen_texture)
    sprite.scale_x = window.width / OFFSCREEN_W
    sprite.scale_y = window.height / OFFSCREEN_H
    sprite.draw()

# 启动事件循环
pyglet.app.run()

关键说明 #

• 帧缓冲的独立性：帧缓冲是OpenGL的离屏渲染对象，完全脱离主窗口的渲染循环，你可以手动调用update_offscreen函数（比如用户点击按钮时），或者用不同的定时频率更新，不受窗口on_draw的刷新速率影响。
• 支持复杂绘制：除了示例中的矩形，你可以在update_offscreen中使用pyglet的所有绘制API（文本、图片、图形等），只要在绑定帧缓冲后执行即可。
• 版本兼容性：该方案基于pyglet 2.x版本的官方API，适配现代OpenGL版本，无需依赖旧版废弃接口。

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