图形渲染与 Shader / 系统课时
加载图像文件
加载图像文件
这一节解决把 PNG、JPEG 等文件可靠读成像素缓冲的问题。完成后,你可以从解码结果得到宽高与通道数,选择匹配的 OpenGL 像素格式,并正确处理图像坐标与纹理坐标方向差异。
学习目标
- 使用图像库读取像素、宽高和通道数量
- 根据通道数量选择匹配的 OpenGL 外部格式
- 理解并控制图像垂直翻转,避免纹理上下颠倒
确认解码约定
常见做法是使用单头文件库 stb_image。stbi_load 返回连续的 8 位像素缓冲,同时通过参数给出宽度、高度和文件实际通道数。调用者使用结束后必须执行 stbi_image_free。
OpenGL 纹理坐标通常把左下角视为 (0, 0),而很多图像文件和解码流程按左上角作为起点。若直接上传而不统一约定,最常见现象就是纹理上下颠倒。stb_image 可以在解码前启用垂直翻转。

读取并识别通道
下面程序接收图片路径作为命令行参数,启用垂直翻转,读取像素并把通道数映射为 OpenGL 外部格式。示例只验证解码结果,因此不需要创建 OpenGL Context,但工程中需要提供 stb_image.h,并包含 OpenGL 头以取得格式常量。
#include <glad/glad.h>
#include <iostream>
#include <stdexcept>
#include <string>
#define STB_IMAGE_IMPLEMENTATION
#include "stb_image.h"
GLenum formatForChannels(int channels) {
switch (channels) {
case 1: return GL_RED;
case 2: return GL_RG;
case 3: return GL_RGB;
case 4: return GL_RGBA;
default:
throw std::runtime_error("unsupported channel count");
}
}
const char* formatName(GLenum format) {
switch (format) {
case GL_RED: return "GL_RED";
case GL_RG: return "GL_RG";
case GL_RGB: return "GL_RGB";
case GL_RGBA: return "GL_RGBA";
default: return "UNKNOWN";
}
}
int main(int argc, char** argv) {
if (argc != 2) {
std::cerr << "usage: image_info <image-path>\n";
return 1;
}
stbi_set_flip_vertically_on_load(1);
int width = 0;
int height = 0;
int channels = 0;
unsigned char* pixels = stbi_load(argv[1], &width, &height, &channels, 0);
if (!pixels) {
std::cerr << "load failed: " << stbi_failure_reason() << '\n';
return 1;
}
try {
GLenum format = formatForChannels(channels);
std::cout << "path=" << argv[1] << '\n'
<< "size=" << width << 'x' << height << '\n'
<< "channels=" << channels << '\n'
<< "format=" << formatName(format) << '\n';
} catch (...) {
stbi_image_free(pixels);
throw;
}
stbi_image_free(pixels);
return 0;
}预期输出
path=<PATH>
size=<VALUE>x<VALUE>
channels=<VALUE>
format=<VALUE><PATH> 与 <VALUE> 取决于实际文件。例如标准 RGB PNG 通常得到 channels=3 和 format=GL_RGB,带 Alpha 的 RGBA PNG 通常得到 channels=4 和 format=GL_RGBA。
让通道数和像素格式一致
上传纹理时,外部格式必须描述内存中的真实排列。通道数与常用格式的对应关系如下:
| 通道数 | 常见含义 | 外部格式 |
|---|---|---|
| 1 | 灰度 | GL_RED |
| 2 | 灰度 + 第二分量 | GL_RG |
| 3 | RGB | GL_RGB |
| 4 | RGBA | GL_RGBA |
不要因为“最终想要 RGBA”就把三通道缓冲直接声明为 GL_RGBA;这会让 OpenGL 按错误步长读取内存。若确实希望统一成四通道,可以把 stbi_load 的最后一个参数改为 4,此时返回缓冲会被转换为 RGBA,但原始 channels 仍表示文件本身的通道数,因此应单独记录“请求通道数”。
控制坐标方向和释放时机
stbi_set_flip_vertically_on_load(1) 是进程级设置,适合所有纹理都遵循同一坐标约定的简单项目。若项目同时处理 UI 图片、离屏渲染结果和普通材质,最好在资源加载层统一规定“CPU 像素的原点方向”,不要让不同调用点各自猜测是否需要翻转。
像素上传完成后即可 stbi_image_free,因为 OpenGL 会把数据复制到纹理对象的存储中;如果还要在 CPU 侧做颜色分析、生成缩略图或二次编码,则应等这些操作结束后再释放。加载失败时先读取 stbi_failure_reason(),比只打印“纹理失败”更有助于定位路径、格式或文件损坏问题。