图形渲染与 Shader / 系统课时
设置统一变量
设置统一变量
统一变量用于把 CPU 侧的状态传入已经链接好的 GLSL 程序。本课通过一个可运行示例完成位置查询,并分别上传浮点标量、三维向量、4×4 矩阵和浮点数组,同时说明位置缓存、类型匹配与失效边界。
学习目标
- 理解统一变量位置与着色器程序之间的绑定关系
- 掌握标量、向量、矩阵和数组的上传接口
- 能定位位置为
-1、类型不匹配和程序未绑定问题
统一变量的工作规则
统一变量在一次绘制调用期间对所有顶点或片元保持一致,适合传递变换矩阵、颜色、时间和材质参数。变量必须在着色器程序链接成功后查询位置,查询结果只对当前这次链接有效。
调用传统 glUniform* 接口前,应先通过 glUseProgram(program) 绑定目标程序。OpenGL 4.1 及以上还可以使用 glProgramUniform* 直接指定程序,但基础代码通常先采用兼容性更好的绑定方式。
位置返回 -1 不一定表示链接失败。变量名拼写错误、变量未声明,或者编译器发现变量对最终输出没有影响并将其优化掉,都会得到 -1。
完整上传示例
下面的程序创建隐藏窗口和 OpenGL 3.3 Core 上下文,编译一对着色器,然后上传四类统一变量。示例依赖 GLFW 与 GLAD,工程需要正确链接 GLFW,并包含生成好的 GLAD 源码。
#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;
}预期输出:
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 调用。