图形渲染与 Shader / 系统课时

创建二维纹理

创建二维纹理

本课完成一张二维纹理从对象创建、参数设置到像素上传的完整过程。你将用一组 2×2 RGBA 像素验证 glTexImage2D 的关键参数,并能判断尺寸、格式或数据类型不匹配时为何会出现黑色纹理或颜色错乱。

学习目标

  • 创建并绑定 GL_TEXTURE_2D 纹理对象
  • 正确区分内部格式、源像素格式和数据类型
  • 通过查询纹理级别与错误码验证上传结果

纹理上传的参数关系

二维纹理不是把一段内存“原样塞进 GPU”,而是要同时描述目标、尺寸、存储格式和源数据布局。glTexImage2D 中最容易混淆的是 internalFormat、format 与 type:前者决定 GPU 如何保存,后两者说明 CPU 内存里的每个像素怎样排列。

参数 示例 作用
internalFormat GL_RGBA8 指定 GPU 端每个通道按 8 位无符号归一化值存储
format GL_RGBA 说明源数据按 R、G、B、A 四个通道排列
type GL_UNSIGNED_BYTE 说明每个通道由一个无符号字节表示
width、height 2、2 指定当前 mipmap 层的尺寸
data pixels.data() 指向 CPU 端连续像素数据;传 nullptr 可只分配空间

level 通常从 0 开始,表示最高分辨率层。border 在现代 OpenGL 中必须为 0。源数据总字节数应与宽、高、通道数和类型一致,否则驱动会按错误布局读取后续内存。

上传一张可验证的纹理

下面的程序创建隐藏窗口以获得 OpenGL 3.3 上下文,再上传四个 RGBA 像素。示例依赖 GLFW 与 GLAD,二者需已经加入工程并正确链接。

cpp
#include <array>
#include <iostream>

#include <glad/glad.h>
#define GLFW_INCLUDE_NONE
#include <GLFW/glfw3.h>

int main() {
    if (!glfwInit()) {
        std::cerr << "Failed to initialize GLFW\n";
        return 1;
    }

    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(1, 1, "texture-test", nullptr, nullptr);
    if (window == nullptr) {
        std::cerr << "Failed to create OpenGL context\n";
        glfwTerminate();
        return 1;
    }

    glfwMakeContextCurrent(window);
    if (!gladLoadGLLoader(reinterpret_cast<GLADloadproc>(glfwGetProcAddress))) {
        std::cerr << "Failed to load OpenGL functions\n";
        glfwDestroyWindow(window);
        glfwTerminate();
        return 1;
    }

    // 四个像素依次为红、绿、蓝、白,每个像素占 4 字节。
    const std::array<unsigned char, 16> pixels{
        255,   0,   0, 255,
          0, 255,   0, 255,
          0,   0, 255, 255,
        255, 255, 255, 255
    };

    GLuint texture = 0;
    glGenTextures(1, &texture);
    glBindTexture(GL_TEXTURE_2D, texture);

    // 不生成 mipmap 时,缩小过滤不能使用依赖 mipmap 的模式。
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE);

    glPixelStorei(GL_UNPACK_ALIGNMENT, 1);
    glTexImage2D(
        GL_TEXTURE_2D,
        0,
        GL_RGBA8,
        2,
        2,
        0,
        GL_RGBA,
        GL_UNSIGNED_BYTE,
        pixels.data()
    );
    glPixelStorei(GL_UNPACK_ALIGNMENT, 4);

    GLint width = 0;
    GLint height = 0;
    glGetTexLevelParameteriv(GL_TEXTURE_2D, 0, GL_TEXTURE_WIDTH, &width);
    glGetTexLevelParameteriv(GL_TEXTURE_2D, 0, GL_TEXTURE_HEIGHT, &height);

    const GLenum error = glGetError();
    if (error != GL_NO_ERROR) {
        std::cerr << "OpenGL error: " << error << '\n';
        glDeleteTextures(1, &texture);
        glfwDestroyWindow(window);
        glfwTerminate();
        return 1;
    }

    std::cout << "Texture created: " << width << 'x' << height
              << ", format=RGBA8\n";

    glDeleteTextures(1, &texture);
    glfwDestroyWindow(window);
    glfwTerminate();
    return 0;
}

预期输出:

text
Texture created: 2x2, format=RGBA8

程序查询的是驱动实际记录的第 0 层尺寸,而不是直接打印输入常量。输出正确且 glGetError() 返回 GL_NO_ERROR,说明纹理对象已经分配并接收像素数据;它尚未绑定到着色器采样器,因此本例不会绘制到窗口。

采样参数与边界

纹理过滤和环绕方式属于纹理对象状态。放大过滤只允许 GL_NEAREST 或 GL_LINEAR;缩小过滤还可使用 mipmap 模式,但只有在上传所有层级或调用 glGenerateMipmap 后才能安全使用,否则纹理可能因“不完整”而采样为黑色。

GL_UNPACK_ALIGNMENT 默认是 4,表示每行起始地址按 4 字节对齐。RGBA8 每个像素正好 4 字节,通常不会出错;RGB 图像若一行字节数不是 4 的倍数,就应临时设为 1。完成上传后恢复默认值,可避免影响后续资源加载。

纹理尺寸还受 GL_MAX_TEXTURE_SIZE 限制。实际项目在接收外部图片前应先查询上限,并检查 width > 0、height > 0 与数据指针非空,避免把解码失败误判为 OpenGL 上传失败。

常见错误检查

  • 纹理全黑:确认缩小过滤没有引用缺失的 mipmap,并检查采样器绑定的纹理单元。
  • 颜色错位:核对源数据是 RGB 还是 RGBA,不能用 GL_RGBA 读取只有三个通道的数据。
  • 图像出现斜纹:检查每行字节数与 GL_UNPACK_ALIGNMENT 是否匹配。
  • 上传报错:在调用后立即读取 glGetError(),并确认尺寸未超过设备上限。

本课总结

  • internalFormat 描述 GPU 存储,format 与 type 描述 CPU 源数据。
  • 创建纹理至少要完成生成、绑定、参数设置和像素上传四步。
  • 过滤模式、mipmap 完整性和行对齐是黑纹理与错位问题的高频根因。

下一课预告

下一课将把硬编码像素替换为真实图像文件,使用图像库处理通道数量、像素格式与上下方向后再上传到二维纹理。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建二维纹理

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

登录哪都通