游戏客户端架构 / 系统课时
加载与采样纹理
加载与采样纹理
本课完成一条最小纹理链路:把图片像素上传到 GPU,配置采样参数,再通过纹理坐标在片元着色器中读取颜色。完成后,你将能判断图像倒置、边缘拉伸和纹理模糊分别由哪个环节引起。
学习目标
- 创建 OpenGL 二维纹理并上传图片像素
- 使用 UV 坐标和采样器读取纹理颜色
- 正确选择环绕、过滤和透明通道配置
纹理采样解决什么问题
顶点只能描述几何形状,纹理负责为形状表面提供连续的颜色数据。二维精灵通常使用四边形承载图像,每个顶点保存一个 UV 坐标,片元着色器会对 UV 插值并从纹理中取样。

UV 坐标通常归一化到 。位置坐标决定片元出现在屏幕哪里,UV 坐标决定该片元读取图片的哪一部分,两者职责不同。
从文件创建纹理对象
下面是依赖已初始化 OpenGL 上下文、GLAD 和 stb_image.h 的片段示例。函数负责解码图片、选择像素格式、上传数据并生成 mipmap。
#include <glad/glad.h>
#define STB_IMAGE_IMPLEMENTATION
#include "stb_image.h"
#include <stdexcept>
#include <string>
GLuint loadTexture2D(const std::string& path) {
stbi_set_flip_vertically_on_load(true);
int width = 0;
int height = 0;
int channels = 0;
unsigned char* pixels = stbi_load(
path.c_str(), &width, &height, &channels, 0
);
if (pixels == nullptr) {
throw std::runtime_error("Failed to load texture: " + path);
}
const GLenum format = channels == 4 ? GL_RGBA : GL_RGB;
GLuint texture = 0;
glGenTextures(1, &texture);
glBindTexture(GL_TEXTURE_2D, texture);
// 精灵边缘通常不应重复,缩小时使用 mipmap 减少闪烁。
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE);
glTexParameteri(
GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR_MIPMAP_LINEAR
);
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
glPixelStorei(GL_UNPACK_ALIGNMENT, 1);
glTexImage2D(
GL_TEXTURE_2D,
0,
format,
width,
height,
0,
format,
GL_UNSIGNED_BYTE,
pixels
);
glGenerateMipmap(GL_TEXTURE_2D);
stbi_image_free(pixels);
glBindTexture(GL_TEXTURE_2D, 0);
return texture;
}预期结果
函数返回一个非 0 的纹理对象 ID;后续绑定该纹理并绘制四边形时,屏幕显示对应图片。stbi_set_flip_vertically_on_load(true) 用于协调常见图片左上角原点与 OpenGL UV 左下角原点的差异。若引擎统一在顶点数据中翻转 V 坐标,就不应再次翻转图片。
在片元着色器中采样
纹理对象必须绑定到某个纹理单元,采样器 uniform 再指向该单元。着色器通过 texture 函数读取插值后的 UV 对应颜色。
#version 330 core
in vec2 vTexCoord;
out vec4 fragColor;
uniform sampler2D uTexture;
uniform vec4 uTint;
void main() {
vec4 sampled = texture(uTexture, vTexCoord);
fragColor = sampled * uTint;
}绑定与绘制前的关键调用如下,属于依赖着色器程序和 VAO 的片段示例。
glUseProgram(shaderProgram);
glActiveTexture(GL_TEXTURE0);
glBindTexture(GL_TEXTURE_2D, textureId);
glUniform1i(glGetUniformLocation(shaderProgram, "uTexture"), 0);
glUniform4f(
glGetUniformLocation(shaderProgram, "uTint"),
1.0f, 1.0f, 1.0f, 1.0f
);
glBindVertexArray(quadVao);
glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, nullptr);预期结果
四边形显示完整纹理;uTint 为白色时保留原图颜色,修改 uTint 后颜色按分量相乘。采样器值 0 表示 GL_TEXTURE0,不是纹理对象 ID。把纹理 ID 直接传给 glUniform1i 是常见错误。
过滤与环绕如何选择
GL_NEAREST 保留像素块,适合像素画;GL_LINEAR 在相邻纹素间插值,适合平滑缩放。缩小纹理时建议使用 mipmap 过滤,否则远处或小尺寸精灵容易出现闪烁。
精灵图集通常使用 GL_CLAMP_TO_EDGE,避免边缘采到相邻区域。重复地面或背景图案时才使用 GL_REPEAT。带透明通道的 PNG 应以 RGBA 上传,否则透明信息会丢失。
验证与常见故障
先用纯白色 uTint 绘制一张已知图片,再逐项检查。画面全黑时确认纹理单元、采样器和着色器程序是否一致;图像上下颠倒时只保留一种翻转策略;边缘出现杂色时改用边缘夹取并为图集增加留白。
还可以在上传后调用 glGetError()。返回 GL_NO_ERROR 只能说明 API 调用未报错,最终仍需通过实际绘制验证 UV、透明度与颜色是否正确。
本课总结
- 纹理加载包含图片解码、GPU 上传、参数配置和资源释放四个环节
- UV 坐标决定采样位置,采样器必须指向当前绑定的纹理单元
- 过滤与环绕方式应根据像素风格、缩放比例和图集边缘选择
下一课预告
下一课将把纹理、变换矩阵和颜色统一到精灵渲染器中,用一次绘制调用完成二维对象的定位、旋转、缩放与着色。