游戏客户端架构 / 系统课时

加载与采样纹理

加载与采样纹理

本课完成一条最小纹理链路:把图片像素上传到 GPU,配置采样参数,再通过纹理坐标在片元着色器中读取颜色。完成后,你将能判断图像倒置、边缘拉伸和纹理模糊分别由哪个环节引起。

学习目标

  • 创建 OpenGL 二维纹理并上传图片像素
  • 使用 UV 坐标和采样器读取纹理颜色
  • 正确选择环绕、过滤和透明通道配置

纹理采样解决什么问题

顶点只能描述几何形状,纹理负责为形状表面提供连续的颜色数据。二维精灵通常使用四边形承载图像,每个顶点保存一个 UV 坐标,片元着色器会对 UV 插值并从纹理中取样。

图片从文件到屏幕像素的纹理采样链路

UV 坐标通常归一化到 [0,1][0,1]。位置坐标决定片元出现在屏幕哪里,UV 坐标决定该片元读取图片的哪一部分,两者职责不同。

从文件创建纹理对象

下面是依赖已初始化 OpenGL 上下文、GLAD 和 stb_image.h 的片段示例。函数负责解码图片、选择像素格式、上传数据并生成 mipmap。

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

预期结果

text
函数返回一个非 0 的纹理对象 ID;后续绑定该纹理并绘制四边形时,屏幕显示对应图片。

stbi_set_flip_vertically_on_load(true) 用于协调常见图片左上角原点与 OpenGL UV 左下角原点的差异。若引擎统一在顶点数据中翻转 V 坐标,就不应再次翻转图片。

在片元着色器中采样

纹理对象必须绑定到某个纹理单元,采样器 uniform 再指向该单元。着色器通过 texture 函数读取插值后的 UV 对应颜色。

glsl
#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 的片段示例。

cpp
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);

预期结果

text
四边形显示完整纹理;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 坐标决定采样位置,采样器必须指向当前绑定的纹理单元
  • 过滤与环绕方式应根据像素风格、缩放比例和图集边缘选择

下一课预告

下一课将把纹理、变换矩阵和颜色统一到精灵渲染器中,用一次绘制调用完成二维对象的定位、旋转、缩放与着色。

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

目录与阅读设置

阅读设置

17

记录一个想法

加载与采样纹理

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

登录哪都通