图形渲染与 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,二者需已经加入工程并正确链接。
#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;
}预期输出:
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 完整性和行对齐是黑纹理与错位问题的高频根因。
下一课预告
下一课将把硬编码像素替换为真实图像文件,使用图像库处理通道数量、像素格式与上下方向后再上传到二维纹理。