图形渲染与 Shader / 系统课时
创建立方体贴图
创建立方体贴图
立方体贴图把六张方形图像绑定到同一个纹理对象,并通过三维方向向量采样。创建时最容易出错的是六个方向的顺序、图片尺寸一致性和边缘采样参数;把这三点固定下来,就能稳定用于天空盒和环境反射。
学习目标
- 正确对应立方体贴图的六个纹理目标
- 一次创建并上传六张方向纹理
- 配置边缘采样参数并验证纹理完整性
先固定六个方向的对应关系
OpenGL 为六个面提供连续枚举,可以从 GL_TEXTURE_CUBE_MAP_POSITIVE_X 开始按索引递增。常用数组顺序是 +X、-X、+Y、-Y、+Z、-Z;文件名可以自定义,但它代表的方向必须与这一顺序一致。

六张图必须采用相同的宽高和兼容的内部格式。为了避免把某一面旋转或镜像错,最好在素材准备阶段就按方向命名,而不是在加载代码里猜测“前、后、左、右”。
创建并上传六个面
下面是片段示例,依赖有效的 OpenGL 上下文、GLAD 和 stb_image.h。传入数组必须严格按 +X、-X、+Y、-Y、+Z、-Z 排列。
#include <glad/glad.h>
#include <stb_image.h>
#include <array>
#include <iostream>
#include <stdexcept>
#include <string>
GLuint loadCubemap(const std::array<std::string, 6>& faces) {
GLuint texture = 0;
glGenTextures(1, &texture);
glBindTexture(GL_TEXTURE_CUBE_MAP, texture);
int expectedSize = -1;
GLenum expectedFormat = 0;
for (size_t i = 0; i < faces.size(); ++i) {
int width = 0;
int height = 0;
int channels = 0;
unsigned char* data =
stbi_load(faces[i].c_str(), &width, &height, &channels, 0);
if (!data) {
glDeleteTextures(1, &texture);
throw std::runtime_error("failed to load cubemap face: " + faces[i]);
}
GLenum format = channels == 4 ? GL_RGBA :
channels == 3 ? GL_RGB : GL_RED;
if (width != height ||
(expectedSize != -1 && width != expectedSize) ||
(expectedFormat != 0 && format != expectedFormat)) {
stbi_image_free(data);
glDeleteTextures(1, &texture);
throw std::runtime_error("cubemap faces must match");
}
expectedSize = width;
expectedFormat = format;
glTexImage2D(
static_cast<GLenum>(GL_TEXTURE_CUBE_MAP_POSITIVE_X + i),
0, format, width, height, 0,
format, GL_UNSIGNED_BYTE, data
);
stbi_image_free(data);
std::cout << "face " << i << " uploaded: "
<< width << "x" << height << "\n";
}
glTexParameteri(GL_TEXTURE_CUBE_MAP, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
glTexParameteri(GL_TEXTURE_CUBE_MAP, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
glTexParameteri(GL_TEXTURE_CUBE_MAP, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE);
glTexParameteri(GL_TEXTURE_CUBE_MAP, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE);
glTexParameteri(GL_TEXTURE_CUBE_MAP, GL_TEXTURE_WRAP_R, GL_CLAMP_TO_EDGE);
return texture;
}预期输出
face 0 uploaded: <VALUE>x<VALUE>
face 1 uploaded: <VALUE>x<VALUE>
face 2 uploaded: <VALUE>x<VALUE>
face 3 uploaded: <VALUE>x<VALUE>
face 4 uploaded: <VALUE>x<VALUE>
face 5 uploaded: <VALUE>x<VALUE><VALUE> 是素材实际边长。若任意图片不是方形、尺寸不同或通道格式不一致,示例会直接抛出异常,而不是留下一个不完整的 cubemap。
为什么要使用边缘夹取
立方体贴图的采样方向经常落在两个面的交界附近。若使用重复寻址,坐标越界可能从同一面的另一侧取样,形成明显接缝;GL_CLAMP_TO_EDGE 会把采样限制在当前面的边缘,因此 S、T、R 三个方向都应设置。
这里使用 GL_LINEAR 作为最小过滤,所以不要求 mipmap。若后续调用 glGenerateMipmap(GL_TEXTURE_CUBE_MAP),应把最小过滤改成支持 mipmap 的模式,并确保六个面在生成前已经全部上传完成。
绑定并验证
渲染天空盒或环境反射时,把纹理绑定到一个纹理单元,并让着色器中的 samplerCube 指向同一单元。采样参数不是二维 UV,而是方向向量,例如 texture(skybox, direction)。
验证时重点观察三个位置:正对六个轴方向时内容是否正确、立方体边缘是否出现接缝、上下两个面是否发生旋转或镜像。若只在某一方向错位,通常不是 OpenGL 上传失败,而是该文件与 +X/-X/+Y/-Y/+Z/-Z 的方向约定不一致。