使用OpenGL与Pygame绘制旋转线框立方体时遇视频系统未初始化错误

这个错误的核心问题是Pygame视频系统未完成初始化就执行了依赖它的OpenGL渲染操作，或者窗口关闭后代码仍在尝试访问视频资源。以下是具体修复方案：

关键错误点及修复 #

• 初始化顺序错误：必须先初始化Pygame并创建带OpenGL标志的窗口，再配置OpenGL参数
• 缺少必要的窗口标志：创建窗口时必须传入pygame.OPENGL | pygame.DOUBLEBUF，确保Pygame与OpenGL绑定
• 未处理退出事件：窗口关闭后若不终止主循环，后续渲染操作会触发视频系统未初始化错误

修复后的完整代码 #

import pygame
from pygame.locals import *
from OpenGL.GL import *
from OpenGL.GLU import *

# 立方体顶点
vertices = (
    (1, -1, -1),
    (1, 1, -1),
    (-1, 1, -1),
    (-1, -1, -1),
    (1, -1, 1),
    (1, 1, 1),
    (-1, -1, 1),
    (-1, 1, 1)
)

# 立方体边
edges = (
    (0,1), (1,2), (2,3), (3,0),
    (4,5), (5,7), (7,6), (6,4),
    (0,4), (1,5), (2,7), (3,6)
)

def draw_cube():
    glBegin(GL_LINES)
    for edge in edges:
        for vertex in edge:
            glVertex3fv(vertices[vertex])
    glEnd()

def main():
    # 1. 初始化Pygame
    pygame.init()
    # 2. 创建带OpenGL标志的窗口
    display = (800, 600)
    pygame.display.set_mode(display, DOUBLEBUF | OPENGL)
    
    # 3. 配置OpenGL参数（必须在窗口创建后执行）
    gluPerspective(45, (display[0]/display[1]), 0.1, 50.0)
    glTranslatef(0.0, 0.0, -5)
    
    # 主循环
    while True:
        # 处理事件：必须捕获QUIT事件终止循环
        for event in pygame.event.get():
            if event.type == pygame.QUIT:
                pygame.quit()
                return
        
        # 旋转立方体
        glRotatef(1, 3, 1, 1)
        glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)
        draw_cube()
        # 更新屏幕
        pygame.display.flip()
        pygame.time.wait(10)

if __name__ == "__main__":
    main()

关键代码解释 #

1. 窗口初始化：pygame.display.set_mode(display, DOUBLEBUF | OPENGL) 是核心，这一步会初始化Pygame的视频系统并绑定OpenGL上下文，没有这一步直接调用OpenGL函数就会触发错误。
2. 事件处理：专门捕获pygame.QUIT事件，调用pygame.quit()后立即返回终止程序，避免窗口关闭后代码继续执行渲染操作。
3. OpenGL配置时机：gluPerspective和glTranslatef必须在窗口创建后执行，因为这些操作需要依赖已初始化的OpenGL上下文。

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