Python3+OpenGL 移植Python2 STL绘制程序触发无有效上下文错误

复现场景 #

STL绘制程序在Python2环境下功能完全正常，移植到Python3.8、搭配PyOpenGL 3.1.5版本运行时，调用draw_facets执行绘制逻辑，会在glVertexPointer调用位置抛出上下文无效错误。

触发错误的原函数实现 #

def draw_facets(self):
    glPushMatrix()

    # 光照、颜色与材质设置
    ...
    ### VBO逻辑块
    glBegin(GL_LINES)

    # 错误触发位置
    self.vertex_buffer.bind()
    glVertexPointer(3, GL_FLOAT, 0, None)
    self.normal_buffer.bind()
    glNormalPointer(GL_FLOAT, 0, None)

    glEnableClientState(GL_VERTEX_ARRAY)
    glEnableClientState(GL_NORMAL_ARRAY)
    glDrawArrays(GL_TRIANGLES, 0, len(self.vertices))

    glDisableClientState(GL_NORMAL_ARRAY)
    glDisableClientState(GL_VERTEX_ARRAY)
    self.normal_buffer.unbind()
    self.vertex_buffer.unbind()

    glEnd()
    glPopMatrix()

完整报错堆栈 #

File "../libtatlin/actors.py", line 553, in draw_facets
    glVertexPointer(3, GL_FLOAT, 0, None)
File "/usr/local/lib/python3.8/dist-packages/PyOpenGL-3.1.5-py3.8.egg/OpenGL/latebind.py", line 43, in __call__
    return self._finalCall( *args, **named )
File "/usr/local/lib/python3.8/dist-packages/PyOpenGL-3.1.5-py3.8.egg/OpenGL/wrapper.py", line 818, in wrapperCall
    storeValues(
File "/usr/local/lib/python3.8/dist-packages/PyOpenGL-3.1.5-py3.8.egg/OpenGL/arrays/arrayhelpers.py", line 156, in __call__
    contextdata.setValue( self.constant, pyArgs[self.pointerIndex] )
File "/usr/local/lib/python3.8/dist-packages/PyOpenGL-3.1.5-py3.8.egg/OpenGL/contextdata.py", line 58, in setValue
    context = getContext( context )
File "/usr/local/lib/python3.8/dist-packages/PyOpenGL-3.1.5-py3.8.egg/OpenGL/contextdata.py", line 40, in getContext
    raise error.Error(
OpenGL.error.Error: Attempt to retrieve context when no valid context

问题根源定位 #

• 两类OpenGL绘制模式的调用顺序完全混淆
  OpenGL固定管线的即时模式、顶点数组/VBO模式的调用规则是互斥的。glBegin/glEnd块内部是即时模式的专属执行空间，仅允许写入glVertex*/glNormal*这类直接指定顶点属性的即时指令；而VBO绑定、顶点指针配置、客户端状态开关、glDrawArrays这类顶点数组模式的接口，必须完全放在glEnd调用结束之后才能执行。
  Python2环境下使用的旧版PyOpenGL对这类非法调用校验非常宽松，即便代码顺序混乱也不会立刻拦截，最终还能正常出图；但Python3环境下的PyOpenGL 3.1.5版本新增了调用位置合法性校验，检测到顶点数组接口被放在glBegin块内时，会统一返回“无有效上下文”的通用错误——这个错误描述是误导性的，本质是当前状态机不允许调用对应接口，不是真的丢失了OpenGL窗口上下文。
• 代码冗余带来的逻辑矛盾
  原代码在执行三角形实体绘制（GL_TRIANGLES）时，外层套了glBegin(GL_LINES)的线框绘制块，和实际绘制目标完全不匹配，属于移植时未清理的遗留代码，也是触发校验拦截的直接诱因。
• 若调整完调用顺序仍报同样的错误，需要额外排查绘制函数的调用时机：确认draw_facets是在OpenGL窗口创建完成、进入事件绘制循环后才被触发，不要在窗口初始化阶段提前调用绘制逻辑。

修正方案 #

移除冗余的glBegin/glEnd块，将所有VBO相关逻辑调整到即时模式块之外，修正后的函数实现：

def draw_facets(self):
    glPushMatrix()

    # 光照、颜色与材质设置
    ...
    ### VBO实体绘制逻辑
    # 绑定顶点/法线缓冲
    self.vertex_buffer.bind()
    glVertexPointer(3, GL_FLOAT, 0, None)
    self.normal_buffer.bind()
    glNormalPointer(GL_FLOAT, 0, None)

    # 开启客户端顶点状态
    glEnableClientState(GL_VERTEX_ARRAY)
    glEnableClientState(GL_NORMAL_ARRAY)
    # 执行三角形实体绘制
    glDrawArrays(GL_TRIANGLES, 0, len(self.vertices))

    # 状态清理
    glDisableClientState(GL_NORMAL_ARRAY)
    glDisableClientState(GL_VERTEX_ARRAY)
    self.normal_buffer.unbind()
    self.vertex_buffer.unbind()

    glPopMatrix()

如果需要额外绘制STL模型的线框轮廓，可以单独抽出独立的代码块调用glDrawArrays(GL_LINES, ...)，不要和实体三角形绘制的逻辑混在同一个状态机块中。 #

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