OpenGL场景无法渲染：带灯杆底座的灯具模型问题排查

核心问题列表 #

• 顶点数据格式与顶点属性不匹配
  createSphere和createCylinder函数中，每个顶点存储了3个位置分量+4个颜色分量（共7个float），但设置VAO顶点属性指针时，错误将步长（stride）设为3 * sizeof(float)，且未为颜色分量添加对应顶点属性输入。OpenGL无法正确解析顶点数据，导致渲染异常。

• 顶点着色器未使用传入的顶点颜色
  当前顶点着色器硬编码了固定黄色，完全忽略VBO中存储的每个顶点的颜色数据，既不符合“每个顶点设置不同颜色”的需求，也浪费了已存储的颜色数据。

• 缺少视图(View)与投影(Projection)矩阵
  仅使用Model矩阵无法将3D坐标转换到屏幕空间，物体可能处于相机视锥体之外，导致完全不可见。必须组合Model-View-Projection（MVP）矩阵才能完成正确的坐标变换。

• 圆柱体创建函数错误复用球体分段数
  createCylinder中使用了sphereSegments而非定义好的poleSegments，导致圆柱分段数不符合预期，可能出现形状失真。

修复后的关键代码修改 #

1. 修正顶点着色器（添加颜色输入与MVP矩阵） #

const char* vertexShaderSource = R"(
    #version 330 core
    layout (location = 0) in vec3 aPos;
    layout (location = 1) in vec4 aColor; // 添加颜色输入属性
    uniform mat4 model;
    uniform mat4 view;
    uniform mat4 projection;
    out vec4 vertexColor;
    void main()
    {
        gl_Position = projection * view * model * vec4(aPos, 1.0); // MVP矩阵变换
        vertexColor = aColor; // 使用传入的顶点颜色，而非硬编码值
    }
)";

2. 修正VAO的顶点属性指针设置（以baseVAO为例，其他VAO同理） #

// 初始化base VAO, VBO, and EBO
glGenVertexArrays(1, &baseVAO);
glBindVertexArray(baseVAO);

glGenBuffers(1, &baseVBO);
glBindBuffer(GL_ARRAY_BUFFER, baseVBO);
glBufferData(GL_ARRAY_BUFFER, baseVertices.size() * sizeof(float), &baseVertices[0], GL_STATIC_DRAW);

glGenBuffers(1, &baseEBO);
glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, baseEBO);
glBufferData(GL_ELEMENT_ARRAY_BUFFER, baseIndices.size() * sizeof(unsigned int), &baseIndices[0], GL_STATIC_DRAW);

// 设置位置属性：每个顶点7个float，位置占前3个
glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 7 * sizeof(float), (void*)0);
glEnableVertexAttribArray(0);

// 设置颜色属性：偏移3个float，占4个分量
glVertexAttribPointer(1, 4, GL_FLOAT, GL_FALSE, 7 * sizeof(float), (void*)(3 * sizeof(float)));
glEnableVertexAttribArray(1);

3. 添加视图与投影矩阵到渲染循环 #

// 在渲染循环外提前获取uniform位置（避免每次循环查询，提升性能）
unsigned int modelLoc = glGetUniformLocation(shaderProgram, "model");
unsigned int viewLoc = glGetUniformLocation(shaderProgram, "view");
unsigned int projLoc = glGetUniformLocation(shaderProgram, "projection");

// 初始化投影矩阵（透视投影）
glm::mat4 projection = glm::perspective(glm::radians(45.0f), 800.0f / 600.0f, 0.1f, 100.0f);
glUniformMatrix4fv(projLoc, 1, GL_FALSE, glm::value_ptr(projection));

// 渲染循环内
while (!glfwWindowShouldClose(window)) {
    glClearColor(0.0f, 0.0f, 0.0f, 1.0f);
    glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);

    glUseProgram(shaderProgram);

    // 设置视图矩阵：相机位置在(0,0,3)，看向原点
    glm::mat4 view = glm::lookAt(glm::vec3(0.0f, 0.0f, 3.0f), glm::vec3(0.0f, 0.0f, 0.0f), glm::vec3(0.0f, 1.0f, 0.0f));
    glUniformMatrix4fv(viewLoc, 1, GL_FALSE, glm::value_ptr(view));

    // Base transformation
    glm::mat4 model = glm::translate(glm::mat4(1.0f), glm::vec3(0.0f, -1.0f, 0.0f));
    glUniformMatrix4fv(modelLoc, 1, GL_FALSE, glm::value_ptr(model));
    glBindVertexArray(baseVAO);
    glDrawElements(GL_TRIANGLES, baseIndices.size(), GL_UNSIGNED_INT, 0);

    // Pole transformation
    model = glm::translate(glm::mat4(1.0f), glm::vec3(0.0f, 0.0f, 0.0f));
    glUniformMatrix4fv(modelLoc, 1, GL_FALSE, glm::value_ptr(model));
    glBindVertexArray(poleVAO);
    glDrawElements(GL_TRIANGLES, poleIndices.size(), GL_UNSIGNED_INT, 0);

    // Shade transformation
    model = glm::translate(glm::mat4(1.0f), glm::vec3(0.0f, 1.0f, 0.0f));
    glUniformMatrix4fv(modelLoc, 1, GL_FALSE, glm::value_ptr(model));
    glBindVertexArray(shadeVAO);
    glDrawElements(GL_TRIANGLES, shadeIndices.size(), GL_UNSIGNED_INT, 0);

    glfwSwapBuffers(window);
    glfwPollEvents();
}

4. 修正圆柱体分段数问题 #

void createCylinder(std::vector<float>& vertices, std::vector<unsigned int>& indices, float radius, float height, glm::vec4 color) {
    const float pi = glm::pi<float>();
    const float twoPi = 2.0f * pi;
    // 将sphereSegments改为poleSegments
    const float thetaStep = twoPi / static_cast<float>(poleSegments);

    // 剩余代码不变
}

额外优化建议 #

• 可将所有组件的顶点数据合并到一个VBO和VAO中，减少状态切换，提升渲染性能。
• 为圆柱体添加顶部和底部的面，避免空心效果。
• 可通过修改顶点生成逻辑，基于位置计算颜色，真正实现“每个顶点不同颜色”的需求。

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