图形渲染与 Shader / 系统课时

设置统一变量

设置统一变量

统一变量用于把 CPU 侧的状态传入已经链接好的 GLSL 程序。本课通过一个可运行示例完成位置查询,并分别上传浮点标量、三维向量、4×4 矩阵和浮点数组,同时说明位置缓存、类型匹配与失效边界。

学习目标

  • 理解统一变量位置与着色器程序之间的绑定关系
  • 掌握标量、向量、矩阵和数组的上传接口
  • 能定位位置为 -1、类型不匹配和程序未绑定问题

统一变量的工作规则

统一变量在一次绘制调用期间对所有顶点或片元保持一致,适合传递变换矩阵、颜色、时间和材质参数。变量必须在着色器程序链接成功后查询位置,查询结果只对当前这次链接有效。

调用传统 glUniform* 接口前,应先通过 glUseProgram(program) 绑定目标程序。OpenGL 4.1 及以上还可以使用 glProgramUniform* 直接指定程序,但基础代码通常先采用兼容性更好的绑定方式。

位置返回 -1 不一定表示链接失败。变量名拼写错误、变量未声明,或者编译器发现变量对最终输出没有影响并将其优化掉,都会得到 -1。

完整上传示例

下面的程序创建隐藏窗口和 OpenGL 3.3 Core 上下文,编译一对着色器,然后上传四类统一变量。示例依赖 GLFW 与 GLAD,工程需要正确链接 GLFW,并包含生成好的 GLAD 源码。

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

#include <array>
#include <cstdlib>
#include <iostream>
#include <stdexcept>
#include <string>

GLuint compileShader(GLenum type, const char* source) {
    // 每个阶段独立编译,失败时立即返回完整日志。
    GLuint shader = glCreateShader(type);
    glShaderSource(shader, 1, &source, nullptr);
    glCompileShader(shader);

    GLint ok = GL_FALSE;
    glGetShaderiv(shader, GL_COMPILE_STATUS, &ok);
    if (ok == GL_FALSE) {
        GLint length = 0;
        glGetShaderiv(shader, GL_INFO_LOG_LENGTH, &length);
        std::string log(static_cast<std::size_t>(length), '\0');
        glGetShaderInfoLog(shader, length, nullptr, log.data());
        glDeleteShader(shader);
        throw std::runtime_error(log);
    }
    return shader;
}

GLuint createProgram() {
    const char* vertexSource = R"(
        #version 330 core
        layout(location = 0) in vec3 aPosition;
        uniform mat4 uMvp;
        void main() {
            gl_Position = uMvp * vec4(aPosition, 1.0);
        }
    )";

    const char* fragmentSource = R"(
        #version 330 core
        out vec4 fragColor;
        uniform float uExposure;
        uniform vec3 uTint;
        uniform float uWeights[3];
        void main() {
            float factor = uExposure * (uWeights[0] + uWeights[1] + uWeights[2]);
            fragColor = vec4(uTint * factor, 1.0);
        }
    )";

    GLuint vertex = compileShader(GL_VERTEX_SHADER, vertexSource);
    GLuint fragment = 0;
    try {
        fragment = compileShader(GL_FRAGMENT_SHADER, fragmentSource);
    } catch (...) {
        glDeleteShader(vertex);
        throw;
    }

    // program 链接后即可删除阶段对象,链接结果会保留其可执行代码。
    GLuint program = glCreateProgram();
    glAttachShader(program, vertex);
    glAttachShader(program, fragment);
    glLinkProgram(program);
    glDeleteShader(vertex);
    glDeleteShader(fragment);

    GLint ok = GL_FALSE;
    glGetProgramiv(program, GL_LINK_STATUS, &ok);
    if (ok == GL_FALSE) {
        GLint length = 0;
        glGetProgramiv(program, GL_INFO_LOG_LENGTH, &length);
        std::string log(static_cast<std::size_t>(length), '\0');
        glGetProgramInfoLog(program, length, nullptr, log.data());
        glDeleteProgram(program);
        throw std::runtime_error("shader program link failed: " + log);
    }
    return program;
}

int main() {
    if (glfwInit() == GLFW_FALSE) {
        std::cerr << "GLFW initialization failed\n";
        return EXIT_FAILURE;
    }

    glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3);
    glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3);
    glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);
    glfwWindowHint(GLFW_VISIBLE, GLFW_FALSE);

    GLFWwindow* window = glfwCreateWindow(64, 64, "uniform-demo", nullptr, nullptr);
    if (window == nullptr) {
        glfwTerminate();
        return EXIT_FAILURE;
    }
    glfwMakeContextCurrent(window);

    if (gladLoadGLLoader(reinterpret_cast<GLADloadproc>(glfwGetProcAddress)) == 0) {
        glfwDestroyWindow(window);
        glfwTerminate();
        return EXIT_FAILURE;
    }

    GLuint program = 0;
    try {
        program = createProgram();
        // 传统 glUniform* 只会写入当前绑定的 program。
        glUseProgram(program);

        GLint exposureLoc = glGetUniformLocation(program, "uExposure");
        GLint tintLoc = glGetUniformLocation(program, "uTint");
        GLint mvpLoc = glGetUniformLocation(program, "uMvp");
        GLint weightsLoc = glGetUniformLocation(program, "uWeights[0]");

        if (exposureLoc < 0 || tintLoc < 0 || mvpLoc < 0 || weightsLoc < 0) {
            throw std::runtime_error("required uniform is inactive or missing");
        }

        // OpenGL 默认按列主序读取矩阵;单位矩阵两种视角下结果相同。
        const std::array<float, 16> identity = {
            1.0F, 0.0F, 0.0F, 0.0F,
            0.0F, 1.0F, 0.0F, 0.0F,
            0.0F, 0.0F, 1.0F, 0.0F,
            0.0F, 0.0F, 0.0F, 1.0F
        };
        const std::array<float, 3> weights = {0.2F, 0.3F, 0.5F};

        // 数组一次上传 3 个 float,数量参数不是字节数。
        glUniform1f(exposureLoc, 1.25F);
        glUniform3f(tintLoc, 0.8F, 0.6F, 0.4F);
        glUniformMatrix4fv(mvpLoc, 1, GL_FALSE, identity.data());
        glUniform1fv(weightsLoc, static_cast<GLsizei>(weights.size()), weights.data());

        if (glGetError() != GL_NO_ERROR) {
            throw std::runtime_error("uniform upload produced an OpenGL error");
        }

        std::cout << "uniform upload succeeded\n";
        glDeleteProgram(program);
        program = 0;
    } catch (const std::exception& error) {
        if (program != 0) {
            glDeleteProgram(program);
        }
        std::cerr << error.what() << '\n';
        glfwDestroyWindow(window);
        glfwTerminate();
        return EXIT_FAILURE;
    }

    glfwDestroyWindow(window);
    glfwTerminate();
    return EXIT_SUCCESS;
}

预期输出:

text
uniform upload succeeded

该输出表示程序完成链接、四个位置均有效,并且上传阶段没有产生 OpenGL 错误。示例不执行绘制,因此窗口保持隐藏。

接口选择与数据布局

标量与向量接口名称中的数字表示分量数,例如 glUniform1f 上传一个浮点数,glUniform3f 上传三个浮点分量。批量数据使用带 v 的版本,例如 glUniform1fv,第二个参数是元素数量,不是字节数。

glUniformMatrix4fv 的第二个参数是矩阵数量。OpenGL 按列主序读取矩阵,通常将 transpose 设为 GL_FALSE;如果 CPU 侧库采用不同布局,应在生成矩阵时统一约定,而不是依赖转置参数补救。

数组通常查询首元素名称,如 uWeights[0],再一次上传连续数据。不要假设不同统一变量的位置连续,也不要通过位置加一访问另一个独立变量。

缓存位置与处理边界

位置查询会访问程序的链接结果,适合在初始化阶段完成并缓存。每帧只上传变化的数据,可以减少重复查询和无意义状态更新。

重新调用 glLinkProgram 后,旧位置全部失效,必须重新查询。删除程序后继续使用缓存位置属于未定义使用。封装层应让位置缓存与程序对象拥有相同生命周期。

调试时先确认当前程序,再核对变量类型和名称。向 vec3 位置调用 glUniform4f 会产生 GL_INVALID_OPERATION;上传矩阵时数量或指针错误则可能导致错误数据甚至越界读取。

本课总结

  • 统一变量位置必须在链接后查询,并只对当前程序链接结果有效
  • 上传前要绑定正确程序,接口类型必须与 GLSL 声明匹配
  • 数组从首元素位置批量上传,矩阵通常按列主序并使用 GL_FALSE

下一课预告

下一课将把编译、链接、资源释放和统一变量设置封装进可复用的着色器程序类,减少业务代码中的重复 OpenGL 调用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设置统一变量

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通