图形渲染与 Shader / 系统课时

创建立方体贴图

创建立方体贴图

立方体贴图把六张方形图像绑定到同一个纹理对象,并通过三维方向向量采样。创建时最容易出错的是六个方向的顺序、图片尺寸一致性和边缘采样参数;把这三点固定下来,就能稳定用于天空盒和环境反射。

学习目标

  • 正确对应立方体贴图的六个纹理目标
  • 一次创建并上传六张方向纹理
  • 配置边缘采样参数并验证纹理完整性

先固定六个方向的对应关系

OpenGL 为六个面提供连续枚举,可以从 GL_TEXTURE_CUBE_MAP_POSITIVE_X 开始按索引递增。常用数组顺序是 +X、-X、+Y、-Y、+Z、-Z;文件名可以自定义,但它代表的方向必须与这一顺序一致。

OpenGL 立方体贴图六个方向与纹理目标

六张图必须采用相同的宽高和兼容的内部格式。为了避免把某一面旋转或镜像错,最好在素材准备阶段就按方向命名,而不是在加载代码里猜测“前、后、左、右”。

创建并上传六个面

下面是片段示例,依赖有效的 OpenGL 上下文、GLAD 和 stb_image.h。传入数组必须严格按 +X、-X、+Y、-Y、+Z、-Z 排列。

cpp
#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;
}

预期输出

text
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 的方向约定不一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建立方体贴图

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

登录哪都通