简介：一份面向Visual C++ 6.0环境下学习OpenGL三维图形绘制的完整工程包，围绕三维场景的搭建与渲染，演示了窗口创建、OpenGL上下文初始化、投影与模型视图矩阵设置、几何体绘制、光照材质配置以及纹理映射等关键环节，并包含顶点着色器/片段着色器的应用思路，能帮助初学者串联Win32 API与GLUT的使用流程，从基础绘制过渡到更真实的视觉效果。压缩包共45个文件，除cpp/h源文件和工程配置文件外，还含zbak备份、obj/pdb等编译中间文件，以及exe可执行程序、ico图标、rc资源脚本、bmp位图和说明文档，整体体积约4.17MB，目录结构便于查看学习。已有66人学习浏览，适合对计算机图形学、游戏渲染入门感兴趣，并想在VS旧版友好环境中动手实践的开发新手。
1. 用 OpenGL 画三维图形：先把窗口、着色器和矩阵一起点亮
用 OpenGL 画三维图形，最难的往往不是建模，而是窗口打开后的一片黑。环境配好了、驱动也正常，代码也照着教程敲了，可屏幕上就是什么都没有。这套流程从渲染管线讲起，再到实际能跑的 C++ 工程，最后落到 llvmpipe、context 创建失败这类天天遇到的坎。适合毕业设计画网格、上位机做三维可视化、或者想自己写一个小渲染器的人看。读完你会有一条清晰的验证路径：先确认环境，再画三角形，再画立方体，最后有理有据地排除问题。
2. 先把渲染管线立住：从顶点到像素，OpenGL 到底替你做了哪几步
要画三维图形，不能一上来就敲 glDrawArrays。在核心模式下，GPU 不会替你做“找到所有顶点并涂色”这件事，你要自己把每一步安排清楚。很多黑屏和花屏，根源不是 OpenGL 太玄学，而是对渲染管线的某个阶段理解偏差。
2.1 为什么核心模式下“没有东西可画”：可编程管线与状态机
现代 OpenGL 是一个状态机。你调用某个函数，改变的不是几何体本身，而是当前状态。比如当前绑定的是哪个着色器程序、哪个 VAO、是否开启了深度测试、清除颜色是什么。真正把顶点变成像素的，是这么一条链：
顶点着色器处理每个顶点，输出裁剪坐标；之后图元装配把顶点组成三角形；光栅化把三角形覆盖到的像素找出来；片段着色器逐个像素决定颜色；最后经过深度测试、混合等逐片段操作，颜色才写进默认帧缓冲。你写的数据，只是这条链的输入，不会自动被“看见”。
固定管线的老教材里，glBegin 和 glEnd 内部替你做完了这些。核心模式把这层壳拆掉了，所有环节都要由着色器代码和状态设置接管。初学者最常见的第一个坑，就是以为自己已经把顶点数据传进去了，屏幕上就该出现东西。实际上只要 VAO 没绑定、着色器链接失败、绘制命令没调用，这一帧就是空白。
这个阶段我会要求自己先记住一个判断原则：黑屏时，先确认管线有没有完整跑起来，再怀疑算法。管线没跑起来，改一万行矩阵代码都没用。
2.2 三维图形必须有的三个变换：模型、视图与投影
三维图形的“立体感”，靠的是把物体从自己的局部坐标，一步一步挪到屏幕坐标。这一路要经过三个矩阵：
模型矩阵把物体的顶点从局部坐标变换到世界坐标，可以用来旋转、缩放、平移；视图矩阵把世界坐标变换到摄像机坐标，相当于调整“相机镜头”；投影矩阵把摄像机坐标变换到裁剪坐标，决定了你看到的是透视还是正交。最终传到顶点着色器里的计算公式是：
gl_Position = mvp * vec4(aPos, 1.0);这里 mvp 就是projection * view * model的乘积。注意顺序，矩阵乘法先把 model 作用于顶点，然后再经过 view 和 projection，所以组合顺序是 P 乘 V 乘 M，不是 M 乘 V 乘 P。很多人的图形显示位置不对，就是这里乘反了。
投影矩阵里最重要的三个参数是视角 fovy、宽高比 aspect、近裁剪面 near 和远裁剪面 far。视角越大，看到的范围越广，透视拉伸越明显；near 太大会把靠近摄像机的物体切掉，far 太小会导致远一点的面消失。后续教程里我用glm::perspective(glm::radians(45.0f), aspect, 0.1f, 100.0f)，near 取 0.1，far 取 100，就是一个很通用的起步值。
2.3 核心模式还是固定管线：选型别被老教材带偏
网上大量旧教程还在用glRotatef、glBegin、gluPerspective这套立即模式。它们在 VS2010 那批老项目里确实能跑，因为当时的驱动还兼容固定管线。但现在桌面系统普遍只支持 OpenGL 3.3 以上的核心模式，固定管线接口被标记为 deprecated，不少环境里直接不可用。
| 对比项 | 固定管线 | 核心模式 |
|---|---|---|
| 代码量 | 绘制一个立方体很少 | 需要着色器、VAO、矩阵 |
| 灵活性 | 只能调预设灯光材质 | 完全控制每个像素 |
| 驱动兼容性 | 老驱动可用，现代平台逐步移除 | 3.3 以上是主流基线 |
| 学习成本 | 填几个函数就行 | 先理解管线、状态、矩阵 |
我的选择是直接学核心模式。原因很实际：很多企业项目和竞赛模板已经切到 OpenGL 3.3 / 4.x，你花半天学的立即模式，换个环境就得推翻。而且核心模式反而避开了很多旧 API 的模糊行为，问题更容易定位。
3. OpenGL 环境配置与最小工程：在 VS 里跑通第一个窗口
环境配置是这个方向劝退率最高的一关。很多人连 800×600 的空白窗口都跑不出来，最后发现是函数指针加载、链接库、窗口 hint 几个地方出了问题。这一章直接用可运行工程走通。
3.1 选型：GLFW + GLAD 为什么是落地最快的组合
OpenGL 本身只定义接口，不负责创建窗口，也不负责加载函数指针。常见做法是用 GLFW 管理窗口和输入，用 GLAD 在运行时加载 OpenGL 函数地址。Qt 的 QOpenGLWidget 也可以，但它在项目的生成和编译结构上更重，调试时多一层框架概念。纯学习阶段，GLFW + GLAD 能把问题收敛到 OpenGL 本身。
如果你用的是 Visual Studio，需要做三件事：建一个 C++ 空项目；把 glad 的头文件和 glad.c 加入项目；项目属性里链接glfw3.lib和opengl32.lib。GLFW 我建议用 vcpkg 或官方预编译包，别自己从源码折腾，省时间。
3.2 你的第一个 main.cpp：初始化、创建窗口、打印渲染器
先写一个不画任何图形的空窗口，目标是验证环境没问题。这是整个三维绘制工程的地基。
#include <glad/glad.h> // 顺序很重要：GLAD 必须在 GLFW 之前 #include <GLFW/glfw3.h> #include <iostream> void framebuffer_size_callback(GLFWwindow* window, int width, int height) { glViewport(0, 0, width, height); } int main() { if (!glfwInit()) { std::cerr << "glfw init failed" << std::endl; return -1; } glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3); glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3); glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE); GLFWwindow* window = glfwCreateWindow(800, 600, "OpenGL 3D", nullptr, nullptr); if (!window) { const char* desc = nullptr; glfwGetError(&desc); std::cerr << "window/context create failed: " << (desc ? desc : "unknown") << std::endl; glfwTerminate(); return -1; } glfwMakeContextCurrent(window); glfwSetFramebufferSizeCallback(window, framebuffer_size_callback); if (!gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)) { std::cerr << "glad load failed" << std::endl; glfwTerminate(); return -1; } std::cerr << "OpenGL renderer string: " << glGetString(GL_RENDERER) << std::endl; std::cerr << "OpenGL version string: " << glGetString(GL_VERSION) << std::endl; while (!glfwWindowShouldClose(window)) { glClearColor(0.2f, 0.2f, 0.3f, 1.0f); glClear(GL_COLOR_BUFFER_BIT); glfwSwapBuffers(window); glfwPollEvents(); } glfwDestroyWindow(window); glfwTerminate(); return 0; }这段代码逻辑是：初始化 GLFW，设置 OpenGL 版本为 3.3 核心模式，创建窗口，让当前线程绑定这个 OpenGL 上下文。GLAD 负责把 glClear、glGetString 这些函数指针加载进进程，所以必须放在glfwMakeContextCurrent之后。
三个参数值得注意：GLFW_CONTEXT_VERSION_MAJOR和GLFW_CONTEXT_VERSION_MINOR一起决定了版本号，这里组合成 3.3；GLFW_OPENGL_CORE_PROFILE表示只使用核心模式，不会暴露已废弃的固定管线函数。如果在 Mac 上，还要加一行glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE)，否则某些系统拒绝创建 3.2 以上的上下文。窗口尺寸回调里调用glViewport，保证拉伸窗口时渲染区域跟随变化。
3.3 跑起来之后先看 renderer string：硬卡还是 llvmpipe
上面的代码会在控制台打印出 OpenGL 渲染器信息。正常情况下你会看到类似NVIDIA GeForce RTX ...、AMD Radeon ...或者核显的名字。但如果你在虚拟机、远程桌面、或者没装显卡驱动环境里跑，很可能会看到这样一行：
OpenGL renderer string: llvmpipe (LLVM 15.0.7, 256 bits)这不是错误，而是 Mesa 在告诉你：现在没有可用的硬件 OpenGL 设备，GPU 工作由 CPU 软件完成。llvmpipe 的光栅化和片段处理都是用 SIMD 指令跑的，能正确渲染，但性能远低于硬卡。在这个环境下做学习验证没问题，不要用帧率来评价三维算法的优劣。如果后续做比较大的场景，先解决驱动或换一台有独显的机器。
4. 从三角形到立方体：三维图形绘制必不可少的矩阵、深度和剔除
环境跑通之后，就可以进入真正的三维绘制了。这一步我用一个旋转立方体作为里程碑：着色器、VAO/VBO、MVP 矩阵、深度测试全部要上场。按这个顺序搭，每一步都能验证。
4.1 立方体顶点与索引：为什么用 36 个索引而不是 8 个点
立方体有 8 个顶点，但 OpenGL 三角形图元需要的是三角形列表。每个面拆成两个三角形，6 个面就是 12 个三角形，每个三角形 3 个顶点，一共 36 组顶点。如果直接传 8 个顶点给 36 个索引，能减少数据量，但后续要加法线、纹理坐标时，因为每个面的顶点的属性可能不同，就必须把顶点拆开。
这里先用 8 个位置顶点加索引缓冲，代码最精简。VBO 里放的位置数据只包含坐标 xyz：
float cubeVertices[] = { -0.5f, -0.5f, -0.5f, 0.5f, -0.5f, -0.5f, 0.5f, 0.5f, -0.5f, -0.5f, 0.5f, -0.5f, -0.5f, -0.5f, 0.5f, 0.5f, -0.5f, 0.5f, 0.5f, 0.5f, 0.5f, -0.5f, 0.5f, 0.5f }; unsigned int indices[] = { 4, 5, 6, 4, 6, 7, 0, 3, 2, 0, 2, 1, 3, 7, 6, 3, 6, 2, 0, 1, 5, 0, 5, 4, 0, 4, 7, 0, 7, 3, 1, 2, 6, 1, 6, 5 };前 8 个点分别是后左下、后右下、后右上、后左上、前左下、前右下、前右上、前左上。indices 里每 3 个组成一个三角形，前 6 个索引画前面，后 18 个画其余五个面。这样画出来的立方体边长为 1，中心在原点。
4.2 着色器编译与 VAO/VBO 绑定：三个关键步骤
核心模式必须用着色器。这里用一个最简顶点着色器和一个纯色片段着色器：
#version 330 core layout (location = 0) in vec3 aPos; uniform mat4 mvp; void main() { gl_Position = mvp * vec4(aPos, 1.0); }#version 330 core out vec4 FragColor; void main() { FragColor = vec4(0.8f, 0.2f, 0.25f, 1.0f); }顶点着色器把位置乘上 uniform 传入的 MVP 矩阵，片段着色器直接返回一个红色。着色器要经过编译和链接两个阶段，我习惯写一个小函数：
GLuint compileShader(GLenum type, const char* src) { GLuint shader = glCreateShader(type); glShaderSource(shader, 1, &src, nullptr); glCompileShader(shader); GLint ok = 0; glGetShaderiv(shader, GL_COMPILE_STATUS, &ok); if (!ok) { char log[1024]; glGetShaderInfoLog(shader, 1024, nullptr, log); std::cerr << "shader compile error: " << log << std::endl; glDeleteShader(shader); return 0; } return shader; } GLuint buildProgram(const char* vsSrc, const char* fsSrc) { GLuint vs = compileShader(GL_VERTEX_SHADER, vsSrc); GLuint fs = compileShader(GL_FRAGMENT_SHADER, fsSrc); GLuint program = glCreateProgram(); glAttachShader(program, vs); glAttachShader(program, fs); glLinkProgram(program); glDeleteShader(vs); glDeleteShader(fs); GLint ok = 0; glGetProgramiv(program, GL_LINK_STATUS, &ok); if (!ok) { char log[1024]; glGetProgramInfoLog(program, 1024, nullptr, log); std::cerr << "program link error: " << log << std::endl; } return program; }着色器编译错误的日志非常关键。很多人黑屏，其实是着色器里有拼写错误，但代码里没打印日志，导致只能傻看空窗口。VS 2010 这类老 IDE 里，std::cerr输出到输出窗口不一定能看到，可以先写进一个文件或者直接弹 MessageBox。
接下来创建 VAO、VBO、EBO，并告诉 OpenGL 如何解析顶点属性：
GLuint vao, vbo, ebo; glGenVertexArrays(1, &vao); glBindVertexArray(vao); glGenBuffers(1, &vbo); glBindBuffer(GL_ARRAY_BUFFER, vbo); glBufferData(GL_ARRAY_BUFFER, sizeof(cubeVertices), cubeVertices, GL_STATIC_DRAW); glGenBuffers(1, &ebo); glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, ebo); glBufferData(GL_ELEMENT_ARRAY_BUFFER, sizeof(indices), indices, GL_STATIC_DRAW); glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 3 * sizeof(float), (void*)0); glEnableVertexAttribArray(0); glBindVertexArray(0);glVertexAttribPointer的第 5 个参数是 stride，这里每个顶点只有 3 个浮点数，所以 stride 是3 * sizeof(float)。最后一个参数是数据偏移，(void*)0 表示从 VBO 开头开始取。如果顶点结构里有位置和法线，stride 就要改成6 * sizeof(float)，偏移改成3 * sizeof(float)。这个参数写错的最典型现象就是图形错乱或直接不显示。
4.3 MVP 矩阵怎么算：perspective、lookAt、rotate 三个参数逐个解释
不用自己写矩阵运算，GLM 是头文件库，直接把 include 目录加进项目就能用。核心代码是：
#include <glm/glm.hpp> #include <glm/gtc/matrix_transform.hpp> #include <glm/gtc/type_ptr.hpp> glm::mat4 model = glm::rotate(glm::mat4(1.0f), (float)glfwGetTime() * 0.6f, glm::vec3(1.0f, 0.5f, 0.0f)); glm::mat4 view = glm::lookAt(glm::vec3(3.0f, 2.0f, 3.0f), glm::vec3(0.0f), glm::vec3(0.0f, 1.0f, 0.0f)); glm::mat4 proj = glm::perspective(glm::radians(45.0f), (float)width / (float)height, 0.1f, 100.0f); glm::mat4 mvp = proj * view * model;glm::rotate的第一个矩阵是单位矩阵，第二个是旋转角度，第三个是旋转轴。我这里用glfwGetTime()随时间变化，所以立方体会以绕 (1, 0.5, 0) 轴的姿态持续旋转。lookAt的三个参数分别是相机位置、观察目标点、向上方向。相机放在 (3, 2, 3) 位置看向原点，是一个偏左上的视角，能同时看见三个面。
perspective的第一个参数视野角度，建议 45 到 60 之间，太大物体会变小，太小孩子会感觉别扭；第二个参数 aspect 必须用当前 framebuffer 的宽高比，否则物体横竖比例失真；第三第四个参数是裁剪平面距离。最后把组合好的矩阵传给顶点着色器里的 uniform：
GLint mvpLoc = glGetUniformLocation(program, "mvp"); glUniformMatrix4fv(mvpLoc, 1, GL_FALSE, glm::value_ptr(mvp));glUniformMatrix4fv的第三个参数必须是GL_FALSE，因为 GLM 默认按列主序存储，OpenGL 也是列主序，不需要转置。如果你用手写的行列式结构，这里就很容易踩坑。
4.4 在绘制循环中开启深度测试并完成立方体
主循环里除了清颜色，还要清深度缓冲，否则后绘制的面会覆盖先绘制的面，产生透明、闪面等奇怪视觉：
glEnable(GL_DEPTH_TEST); while (!glfwWindowShouldClose(window)) { glClearColor(0.1f, 0.15f, 0.2f, 1.0f); glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); glUseProgram(program); glBindVertexArray(vao); glDrawElements(GL_TRIANGLES, 36, GL_UNSIGNED_INT, 0); glfwSwapBuffers(window); glfwPollEvents(); }glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)会把颜色和深度一起重置。如果不加 GL_DEPTH_BUFFER_BIT，上一帧的深度信息会残留，下一帧的像素会错误地通过或遮挡。glDrawElements里 36 是索引数量，因为用了索引缓冲，所以不能再用glDrawArrays，否则会把顶点数据当线性数组重画 36 次。
到这里你已经能看到一个在空间里旋转的红色立方体了。半透明的感觉？不对，那是没有深度测试或者没清深度导致的错觉。下一步就是通过实战把各种翻车情况收进排查清单。
5. 排错与避坑：黑屏、renderer 回退、context 创建失败，都是常见坑
这一章我挑了五个高频问题。每个问题按照“现象 → 原因 → 解决”的顺序写，遇到问题可以按图索骥。
5.1 窗口正常打开，画面只有背景色
现象：控制台打印了 OpenGL 版本，循环也跑起来了，但窗口里永远是清屏色，没有任何几何图形。
原因：状态机缺一环。最常见的是着色器编译失败、VAO 没有绑定、绘制命令没调用，或者顶点数据没有被正确读取。另一个隐藏原因是glDrawElements和glDrawArrays用错，索引缓冲没绑好时会画不出东西。
解决：先确认着色器日志有没有输出。glGetShaderInfoLog和glGetProgramInfoLog必须在编译、链接失败时打印出来。然后在主循环每一次glDrawElements前检查glGetError()，如果返回GL_INVALID_OPERATION，多半是 program 或者 VAO 状态不对。最后检查glVertexAttribPointer的 stride 和 offset，和 C 结构体内存布局一一对应。
5.2 立方体旋转时看起来像透明玻璃
现象：能看到立方体的背面，前后两个面的颜色混在一起，像半透明。
原因：没有开启深度测试，或者开启了但没清深度缓冲。OpenGL 默认是不开启深度测试的，后绘制的像素会直接覆盖先绘制的像素，但 GPU 并不知道哪个面离摄像机更近。
解决：在主循环前加glEnable(GL_DEPTH_TEST)，主循环里清屏时使用glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)。这一步做完，透明感立刻消失。如果还觉得有零星闪面，再检查 near 和 far 的取值，near 太小会导致深度精度在远处分布不均匀，出现 z-fighting。
5.3 打印出OpenGL renderer string: llvmpipe (LLVM 15.0.7, 256 bits)
现象：程序能跑，但将三维物体转起来特别卡，一个只有 36 个三角形的立方体都只有十几帧。
原因：这台机器根本没有可用的硬件 OpenGL 驱动。虚拟机、远程桌面、无显卡驱动、或者显卡驱动被禁用时，系统会回退到 Mesa 的软件渲染器，也就是 llvmpipe。它用 CPU 模拟整个 GPU 管线，所以帧率低是正常的。
解决：先通过 renderer string 确认当前是软件渲染。如果是本地机器，更新显卡驱动或者重装显卡驱动；如果是云服务器，换带 GPU 的实例；如果在远程桌面里，试试本地用户会话或者开启 GPU 直通。学习阶段用 llvmpipe 验证逻辑没问题，但不要在它上面测性能，测出来的数据不能代表真实硬件表现。
5.4 链接 Qt 时报failed to create OpenGL context for format QSurfaceFormat(version 2.0
现象：Qt 项目启动时控制台报这个错误，窗口打不开或者打开后黑屏，报错里还能看到QSurfaceFormat(version 2.0)之类的字样。
原因：Qt 在创建 QOpenGLWidget 时会按照 QSurfaceFormat 申请一个 OpenGL 上下文。如果驱动不支持请求的版本，或者 QSurfaceFormat 的设置没有在 QApplication 创建之前生效，就会创建失败。很多人把setDefaultFormat写在 QApplication 构造之后，Qt 已经来不及采纳，于是默认申请了一个格式，而系统又给不了。
解决：在创建 QApplication 之前先调用：
QSurfaceFormat format; format.setVersion(3, 3); format.setProfile(QSurfaceFormat::CoreProfile); format.setDepthBufferSize(24); QSurfaceFormat::setDefaultFormat(format);如果还失败，把版本降级到 2.0，或者去掉setProfile试试。有些老笔记本双显卡切换有问题，会看到 OpenGL 2.0 正常、3.3 失败，这时候不是代码问题，是驱动切换不正常，更新驱动或用核显驱动修复。
5.5gladLoadGLLoader返回失败，或者调用glGenVertexArrays直接崩溃
现象：程序在初始化时返回glad load failed，或者一调用glGenVertexArrays就访问冲突崩溃。
原因：GLAD 加载函数指针必须在当前线程有自己的上下文之后执行。也就是说，你还没有glfwMakeContextCurrent，或者把gladLoadGLLoader放到了窗口创建之前。另一个常见原因是头文件包含顺序错了，GLAD 需要放在 GLFW 头文件之前，否则会缺少 OpenGL 类型定义。
解决：确认顺序是glad.h在前，glfw3.h在后；确认gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)位于窗口创建和 make current 之后。链接阶段崩溃还有一个老问题：没有在项目链接器设置里加上opengl32.lib，GLAD 生成的调用会找不到入口。把所有 OpenGL 函数调用加一个glGetError()断点，也能快速缩小范围。
6. 让立方体再真实一点：漫反射光照与三个调试习惯
仅仅一个纯色立方体，还是不够“三维”。你可以从光照和调试两个方向继续加深。这里我给一个最简的漫反射做法：顶点数据里加上法线，片段着色器用光源方向和法线点积计算亮度。
在片段着色器里，核心计算就三行：
vec3 n = normalize(vNormal); vec3 l = normalize(lightDir); float diff = max(dot(n, l), 0.0);lightDir可以放在 uniform 里，从 CPU 传入一个固定方向，例如glm::vec3 lightDir(0.5f, 1.0f, -0.3f)。这样被光源照到的面亮、背光面暗，立方体一下子就有了体量感。这比直接给整个物体一个亮色更直观，也能帮助你检查矩阵变换是否正确——如果光照方向跟随物体一起旋转了，说明法线在 MVP 变换里处理错了。
同时，建议养成三个调试习惯。第一，每个绘制循环末尾放一个glGetError()检查点，把 OpenGL 报错当作第一优先级看待。第二，改参数一次只改一处，比如先改视角，再改旋转速度，不要同时动矩阵和顶点数据，否则出问题不知道归因到谁。第三，把 renderer string 和 GL_VERSION 的打印留在程序入口的初始化阶段，crash 时能快速判断是不是运行环境问题。这套排错习惯帮我减少了很多“黑屏一晚上最后发现是少打一个字母”的情况。希望帮到你。
本文还有配套的精品资源，点击获取
