OpenGL沿Z轴绘制直线显示异常问题排查与解决

核心问题定位 #

代码里存在4处直接导致渲染异常的错误：

• 顶点属性配置错误：位置、颜色均为glm::vec3类型（3个浮点分量），但glVertexAttribPointer的分量数参数填为2，GPU读取顶点时直接丢弃了Z轴坐标，Z方向的顶点位移完全没传入渲染管线。
• 矩阵传参逻辑失效：初始状态从未上传观察矩阵、投影矩阵到着色器，两个矩阵变量为未初始化的随机值；且观察矩阵仅在按下1键的单帧内上传，松开后矩阵值不保留，视角切换逻辑完全不生效。
• 缓冲清除不完整：仅清除了颜色缓冲，未清除深度缓冲，开启深度测试时会出现渲染结果错乱。
• 顶点数据不符合需求：当前定义的两个顶点连线是XZ平面上的斜线，并非沿Z轴方向的直线。

修复方案 #

1. 修正VAO顶点属性配置 #

将顶点属性读取的分量数从2改为3，保证Z轴坐标、颜色B分量能正常传入管线：

int createLineVertexArrayObject(const glm::vec3* vertexArray, int arraySize)
{
    GLuint vertexArrayObject;
    glGenVertexArrays(1, &vertexArrayObject);
    glBindVertexArray(vertexArrayObject);

    GLuint vertexBufferObject;
    glGenBuffers(1, &vertexBufferObject);
    glBindBuffer(GL_ARRAY_BUFFER, vertexBufferObject);
    glBufferData(GL_ARRAY_BUFFER, arraySize, vertexArray, GL_STATIC_DRAW);

    // 位置属性：3个分量
    glVertexAttribPointer(0,
        3,
        GL_FLOAT,
        GL_FALSE,
        2 * sizeof(glm::vec3),
        (void*)0
    );
    glEnableVertexAttribArray(0);

    // 颜色属性：3个分量
    glVertexAttribPointer(1,
        3,
        GL_FLOAT,
        GL_FALSE,
        2 * sizeof(glm::vec3),
        (void*)sizeof(glm::vec3)
    );
    glEnableVertexAttribArray(1);

    glBindBuffer(GL_ARRAY_BUFFER, 0);
    glBindVertexArray(0);

    return vertexArrayObject;
}

2. 补全渲染状态与矩阵逻辑 #

初始化阶段开启深度测试，渲染循环内同时清除颜色、深度缓冲；将矩阵设置逻辑移到渲染循环内固定执行，补上投影矩阵，按键仅做视角切换标记：

// 初始化阶段，glewInit之后加
glEnable(GL_DEPTH_TEST);

// 渲染循环内修改如下
while (!glfwWindowShouldClose(window))
{
    glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
    glUseProgram(shaderProgram);

    // 视角控制
    static bool useTopView = false;
    if (glfwGetKey(window, GLFW_KEY_1) == GLFW_PRESS)
        useTopView = true;
    if (glfwGetKey(window, GLFW_KEY_ESCAPE) == GLFW_PRESS)
        glfwSetWindowShouldClose(window, true);

    glm::mat4 viewMatrix;
    if (useTopView) {
        // 顶视角
        viewMatrix = glm::lookAt(glm::vec3(0.0f, 2.0f, 0.0f),
            glm::vec3(0.0f, 0.0f, 0.0f),
            glm::vec3(0.0f, 0.0f, -1.0f));
    } else {
        // 默认斜视角，可同时观察三个轴向
        viewMatrix = glm::lookAt(glm::vec3(2.0f, 2.0f, 2.0f),
            glm::vec3(0.0f, 0.0f, 0.0f),
            glm::vec3(0.0f, 1.0f, 0.0f));
    }
    // 透视投影矩阵
    glm::mat4 projMatrix = glm::perspective(glm::radians(45.0f), 1024.0f/768.0f, 0.1f, 100.0f);
    glm::mat4 worldMatrix = glm::mat4(1.0f);

    // 上传三个矩阵到着色器
    glUniformMatrix4fv(glGetUniformLocation(shaderProgram, "worldMatrix"), 1, GL_FALSE, &worldMatrix[0][0]);
    glUniformMatrix4fv(glGetUniformLocation(shaderProgram, "viewMatrix"), 1, GL_FALSE, &viewMatrix[0][0]);
    glUniformMatrix4fv(glGetUniformLocation(shaderProgram, "projectionMatrix"), 1, GL_FALSE, &projMatrix[0][0]);

    // 绘制直线
    glBindVertexArray(lineVao);
    glDrawArrays(GL_LINES, 0, 2);
    glBindVertexArray(0);

    glfwSwapBuffers(window);
    glfwPollEvents();
}

注意：顶点着色器中gl_Position的计算必须为projectionMatrix * viewMatrix * worldMatrix * aPos，不能漏乘任意矩阵。

3. 修正Z轴直线顶点数据 #

将顶点数组改为沿Z轴延伸的两个端点，Z轴惯例使用蓝色标识：

glm::vec3 LineArray[] = {
        glm::vec3(0.0f, 0.0f, 0.0f),  // 起点：原点
        glm::vec3(0.0f, 0.0f, 1.0f),  // 颜色：蓝色
        glm::vec3(0.0f, 0.0f, -1.0f), // 终点：沿Z轴负方向延伸1单位
        glm::vec3(0.0f, 0.0f, 1.0f),  // 颜色：蓝色
};

完成以上修改后，默认斜视角下可直接看到沿Z轴的蓝色直线，按1键切换顶视角时直线会显示为一个点（视线与Z轴重合，直线沿视线方向投影为点），符合透视规律。

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