【OpenGL】C++ OpenGL 安装与使用指南

C++ OpenGL 安装与使用指南

一、环境安装（以 Windows + Visual Studio 为例）

1. 安装 Visual Studio

   • 下载 Visual Studio
   • 安装时勾选 C++桌面开发 工作负载

2. 安装 GLFW（窗口管理库）

   • 下载 GLFW 预编译包
   • 解压后将 include 和 lib-vc2022 文件夹复制到项目目录

3. 安装 GLAD（OpenGL 函数加载器）

   • 访问 GLAD 在线生成器
   • 选择 gl 版本（如 OpenGL 3.3），Profile 选 Core
   • 生成后下载 zip 文件，解压得到 include 和 src 文件夹

4. 配置 Visual Studio 项目

   • 新建 C++ 空项目
   • 右键项目 → 属性：
     • VC++ 目录：
       • 包含目录：添加 GLFW\include 和 GLAD\include
       • 库目录：添加 GLFW\lib-vc2022
     • 链接器 → 输入：
       • 附加依赖项：添加 glfw3.lib 和 opengl32.lib

二、基础代码示例（渲染彩色三角形）

#include <glad/glad.h>
#include <GLFW/glfw3.h>
#include <iostream>

// 顶点着色器源码
const char* vertexShaderSource = R"(
    #version 330 core
    layout (location = 0) in vec3 aPos;
    void main() {
        gl_Position = vec4(aPos.x, aPos.y, aPos.z, 1.0);
    }
)";

// 片段着色器源码
const char* fragmentShaderSource = R"(
    #version 330 core
    out vec4 FragColor;
    void main() {
        FragColor = vec4(1.0, 0.5, 0.2, 1.0); // 橙色
    }
)";

void framebuffer_size_callback(GLFWwindow* window, int width, int height) {
    glViewport(0, 0, width, height);
}

int main() {
    // 初始化 GLFW
    if (!glfwInit()) {
        std::cerr << "GLFW 初始化失败" << 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 Demo", NULL, NULL);
    if (!window) {
        std::cerr << "窗口创建失败" << std::endl;
        glfwTerminate();
        return -1;
    }
    glfwMakeContextCurrent(window);
    glfwSetFramebufferSizeCallback(window, framebuffer_size_callback);

    // 加载 OpenGL 函数
    if (!gladLoadGLLoader((GLADloadproc)glfwGetProcAddress)) {
        std::cerr << "GLAD 初始化失败" << std::endl;
        return -1;
    }

    // 编译着色器
    unsigned int vertexShader = glCreateShader(GL_VERTEX_SHADER);
    glShaderSource(vertexShader, 1, &vertexShaderSource, NULL);
    glCompileShader(vertexShader);

    unsigned int fragmentShader = glCreateShader(GL_FRAGMENT_SHADER);
    glShaderSource(fragmentShader, 1, &fragmentShaderSource, NULL);
    glCompileShader(fragmentShader);

    // 创建着色器程序
    unsigned int shaderProgram = glCreateProgram();
    glAttachShader(shaderProgram, vertexShader);
    glAttachShader(shaderProgram, fragmentShader);
    glLinkProgram(shaderProgram);
    glDeleteShader(vertexShader);
    glDeleteShader(fragmentShader);

    // 三角形顶点数据
    float vertices[] = {
        -0.5f, -0.5f, 0.0f, // 左下
         0.5f, -0.5f, 0.0f, // 右下
         0.0f,  0.5f, 0.0f  // 顶部
    };

    // 创建 VAO/VBO
    unsigned int VAO, VBO;
    glGenVertexArrays(1, &VAO);
    glGenBuffers(1, &VBO);
    
    glBindVertexArray(VAO);
    glBindBuffer(GL_ARRAY_BUFFER, VBO);
    glBufferData(GL_ARRAY_BUFFER, sizeof(vertices), vertices, GL_STATIC_DRAW);
    
    glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 3 * sizeof(float), (void*)0);
    glEnableVertexAttribArray(0);
    
    glBindBuffer(GL_ARRAY_BUFFER, 0);
    glBindVertexArray(0);

    // 渲染循环
    while (!glfwWindowShouldClose(window)) {
        // 输入检测
        if (glfwGetKey(window, GLFW_KEY_ESCAPE) == GLFW_PRESS)
            glfwSetWindowShouldClose(window, true);

        // 渲染
        glClearColor(0.2f, 0.3f, 0.3f, 1.0f);
        glClear(GL_COLOR_BUFFER_BIT);
        
        glUseProgram(shaderProgram);
        glBindVertexArray(VAO);
        glDrawArrays(GL_TRIANGLES, 0, 3);

        // 交换缓冲
        glfwSwapBuffers(window);
        glfwPollEvents();
    }

    // 清理资源
    glDeleteVertexArrays(1, &VAO);
    glDeleteBuffers(1, &VBO);
    glDeleteProgram(shaderProgram);
    
    glfwTerminate();
    return 0;
}

三、关键概念说明

1. 核心组件：

   • VAO：顶点数组对象（存储顶点属性配置）
   • VBO：顶点缓冲对象（存储顶点数据）
   • Shader：着色器程序（GPU 执行指令）

2. 渲染管线流程：

四、常见问题解决

1. 黑屏问题：

   • 检查着色器编译日志：glGetShaderInfoLog
   • 验证 OpenGL 上下文是否创建成功
   • 确保 VAO/VBO 绑定正确

2. GLAD 加载失败：

   • 确认 GLFW 窗口创建后再初始化 GLAD
   • 检查 OpenGL 版本是否匹配

3. 访问冲突错误：

   • 确保所有 OpenGL 操作在渲染线程执行
   • 检查指针是否越界

五、下一步学习建议

1. 进阶内容：

   • 纹理贴图 (glTexImage2D)
   • 3D 变换（模型/视图/投影矩阵）
   • 光照模型（Phong 光照）
   • 模型加载（Assimp 库）

2. 推荐资源：

   • LearnOpenGL（最佳入门教程）
   • 《OpenGL 编程指南》（红宝书）
   • OpenGL 官方文档

注意：Linux/macOS 用户需通过包管理器安装依赖（如 libglfw3-dev），Mac 需额外添加 glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE);