使用OpenTK的C# OpenGL程序仅显示空白灰色窗口的原因排查

你的代码无法渲染3D模型的核心原因是：使用了OpenGL立即模式（GL.Begin/GL.End），但OpenTK默认创建的是OpenGL核心上下文，核心模式完全移除了立即模式的API支持，所有绘制调用均不会生效，因此仅显示灰色背景。

具体修改步骤 #

1. 修改窗口上下文设置，启用兼容模式 #

修改Game类的构造函数，显式创建兼容模式的OpenGL上下文，以支持立即模式API：

public Game()
{
    var nativeSettings = new NativeWindowSettings
    {
        Api = ContextAPI.OpenGL,
        Profile = ContextProfile.Compatability, // 启用兼容模式
        APIVersion = new Version(2, 1), // 指定完全支持立即模式的OpenGL版本
        Size = new Vector2i(800, 600)
    };
    base.Initialize(GameWindowSettings.Default, nativeSettings);
    CenterWindow();
}

2. 规范渲染帧方法的执行顺序 #

确保基类渲染逻辑在缓冲区交换后执行，原代码顺序已符合要求，可明确保持：

protected override void OnRenderFrame(FrameEventArgs args)
{
    GL.Clear(ClearBufferMask.ColorBufferBit | ClearBufferMask.DepthBufferBit);
    
    Matrix4 modelview = Matrix4.LookAt(new Vector3(5, 5, 5), Vector3.Zero, Vector3.UnitY);
    GL.MatrixMode(MatrixMode.Modelview);
    GL.LoadMatrix(ref modelview);

    GL.Color3(1.0, 0.0, 0.0);
    this.DrawSphere(1.0, 20, 20);
    
    GL.Color3(0.0, 1.0, 0.0);
    GL.PushMatrix();
    GL.Translate(3.0, 0.0, 0.0);
    this.DrawTriangularPrism();
    GL.PopMatrix();
    
    GL.Color3(0.0, 0.0, 1.0);
    GL.PushMatrix();
    GL.Translate(-3.0, 0.0, 0.0);
    this.DrawHexagonalPyramid();
    GL.PopMatrix();

    GL.Flush();
    Context.SwapBuffers();
    base.OnRenderFrame(args);
}

3. 补全三棱柱的侧面绘制（可选） #

原DrawTriangularPrism仅绘制了上下三角形和底部四边形，缺少三个侧面，补充后可显示完整模型：

private void DrawTriangularPrism()
{
    // 顶部三角形
    GL.Begin(PrimitiveType.Triangles);
    GL.Vertex3(0, 1, 0);
    GL.Vertex3(-1, -1, 1);
    GL.Vertex3(1, -1, 1);
    
    // 底部三角形
    GL.Vertex3(0, 1, 0);
    GL.Vertex3(1, -1, -1);
    GL.Vertex3(-1, -1, -1);
    GL.End();

    // 底部四边形
    GL.Begin(PrimitiveType.Quads);
    GL.Vertex3(-1, -1, 1);
    GL.Vertex3(-1, -1, -1);
    GL.Vertex3(1, -1, -1);
    GL.Vertex3(1, -1, 1);
    GL.End();

    // 三个侧面四边形
    GL.Begin(PrimitiveType.Quads);
    // 侧面1
    GL.Vertex3(0, 1, 0);
    GL.Vertex3(-1, -1, 1);
    GL.Vertex3(-1, -1, -1);
    GL.Vertex3(0, 1, 0);
    
    // 侧面2
    GL.Vertex3(0, 1, 0);
    GL.Vertex3(-1, -1, -1);
    GL.Vertex3(1, -1, -1);
    GL.Vertex3(0, 1, 0);
    
    // 侧面3
    GL.Vertex3(0, 1, 0);
    GL.Vertex3(1, -1, -1);
    GL.Vertex3(1, -1, 1);
    GL.Vertex3(0, 1, 0);
    GL.End();
}

完成以上修改后，运行程序即可正常显示红色球体、绿色三棱柱、蓝色六角锥三个3D模型。

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