纹理映射（Texture Mapping）

以下是关于纹理映射（Texture Mapping）全面的介绍，涵盖原理、概念、过程、分类以及使用C++语言结合OpenGL的代码实现，并按要求详细注释代码中的函数形参与每行代码：

一、原理

纹理映射的基本原理是在三维物体表面和二维纹理图像之间建立起一种映射关系，将纹理图像中的颜色、图案等信息依照该映射关系赋予物体表面相应位置，以此增强物体渲染的真实感与细节丰富度。

具体而言，为物体表面的各个点设定纹理坐标（通常以二维的UV坐标来表示，U坐标对应纹理图像的水平方向，取值范围一般是0到1，类比图像的横坐标；V坐标对应纹理图像的垂直方向，取值范围同样通常为0到1，类似图像的纵坐标）。在图形渲染过程中，根据物体表面各点的纹理坐标去查找纹理图像中对应位置的像素颜色值，随后把获取到的这些颜色值应用到物体表面对应的点上，就好像给物体“穿上”了带有特定图案和颜色的“外衣”一样。例如，要让一个简单的长方体模型呈现出木质纹理，就可以把一张木质纹理的图片通过合理的纹理映射，依据长方体表面各点的纹理坐标与纹理图像建立联系，使得长方体看起来像是用木头制作而成的。

二、概念

• 纹理（Texture）：本质上是二维的图像数据，其来源可以是各种常见格式存储的图片，像PNG、JPEG等格式的文件，经过适当的图形处理转换后，成为能够贴合到物体表面的素材，其中蕴含了各式各样的颜色、图案以及细节等视觉元素，能够极大地丰富物体的外观表现。
• 纹理坐标（Texture Coordinates）：又称UV坐标，是专门定义在物体表面的二维坐标体系，其核心作用是明确物体表面的每个点在纹理图像中对应的具体位置。每个顶点都会附带一组UV坐标值，其中U方向用于定位纹理图像中的水平位置，V方向用于定位垂直位置，并且这两个坐标值大多限定在0到1的区间内，以确保准确地从纹理图像里获取相应像素的颜色信息并应用到物体表面。
• 纹理采样（Texture Sampling）：在渲染阶段，基于物体表面各点的纹理坐标从纹理图像当中获取相应像素颜色值的操作即为纹理采样。由于实际应用中纹理坐标可能出现小数情况，或者因某些变换超出常规的0到1取值范围，所以需要运用特定的采样方式（例如最近邻采样、线性采样、双线性采样等）来确定最终获取的颜色值，进而保证纹理映射所呈现的视觉效果既合理又具有高质量。

三、过程

1. 纹理加载（Texture Loading）：
   • 图像读取：首先要从外部文件（如磁盘上存储的图片文件，格式可能为PNG、JPEG等）中获取纹理图像的数据，这往往需要借助一些图像库（在C++中可以利用如stb_image这样的第三方库）来解析文件格式，进而提取出图像的像素数据（涵盖RGB或者RGBA等不同的颜色通道信息）、宽度、高度以及其他必要的属性信息。
   • 纹理对象创建与配置：在OpenGL环境下，接着创建一个纹理对象，用来统一管理和存储与纹理相关的数据以及各种设置。比如，要明确指定纹理的目标类型（像GL_TEXTURE_2D表示二维纹理，这是最常见的类型），还要设定纹理的多项参数，诸如纹理的过滤方式（这决定了在纹理采样时针对坐标非整数等情况的处理办法，常见的有GL_NEAREST即最近邻过滤，GL_LINEAR为线性过滤等）以及纹理的环绕方式（当纹理坐标超出0到1范围时的应对策略，例如GL_REPEAT意味着重复纹理，GL_CLAMP_TO_EDGE表示把超出范围的坐标限制在边缘等），最后把读取到的图像像素数据绑定到创建好的纹理对象上，使其成为可供渲染使用的有效纹理资源。
2. 纹理坐标指定（Texture Coordinate Specification）：
   • 顶点属性定义：针对需要进行纹理映射的物体模型，在定义其顶点数据时，除了常规的顶点坐标、法向量这些属性外，必须额外添加纹理坐标属性。通常每个顶点对应一组纹理坐标值（包含U、V两个分量），这些值依据物体表面和纹理图像期望达成的对应关系来确定。举例来说，如果期望将整张纹理图像完整且均匀地覆盖在一个平面模型上，那么该平面的四个顶点的纹理坐标可以依次设定为(0, 0)、(1, 0)、(1, 1)、(0, 1)，这意味着纹理图像的四个角分别对应平面的四个顶点。
   • 传递至着色器：将包含纹理坐标的顶点数据传递给顶点着色器，顶点着色器会把它当作顶点的一个属性进行相应处理，并传递给后续的光栅化阶段以及片段着色器，方便在片段着色器中依据这些纹理坐标开展纹理采样相关的计算操作。
3. 纹理采样与应用（Texture Sampling and Application）：
   • 片段着色器内的计算：在片段着色器中，接收从顶点着色器传递过来且经过插值后的纹理坐标（因为经过光栅化之后，图元内部的各个片段需要依据顶点的纹理坐标进行合理插值，从而获取每个片段对应的纹理坐标），然后运用这些纹理坐标针对绑定的纹理对象实施采样操作，按照之前设定好的纹理采样方式（例如最近邻采样、线性采样等）从纹理图像中获取对应的像素颜色值。
   • 颜色融合与渲染：将通过纹理采样获取到的纹理颜色值和可能存在的其他光照计算结果、基础颜色等颜色相关因素进行融合（比如通过简单的乘法运算或者依据更复杂的光照模型结合方式），最终确定片段的颜色值。这个确定好的颜色值会经过后续的深度测试、颜色混合等操作（如果有相关设置的话），进而显示在屏幕上对应的像素位置处，这样就完成了通过纹理映射对物体表面进行渲染呈现的整个流程。

四、分类

• 二维纹理映射（2D Texture Mapping）：这是最为常用的纹理映射类别，就是把二维的纹理图像直接映射到三维物体的表面，只要能合理地规划好物体表面的纹理坐标与纹理图像之间的对应关系，就可以适用于各种各样形状的物体。比如，将壁纸纹理映射到房间的墙壁上，或者把角色皮肤纹理映射到人物模型表面等，这些都是二维纹理映射在实际场景中的常见应用案例。
• 立方体贴图纹理映射（Cube Map Texture Mapping）：这种纹理映射方式主要用于模拟环境反射之类的效果。它是由六张二维纹理图像共同组成（分别对应立方体的六个面，通常表示不同方向上的环境外观，例如天空盒就会用上、下、左、右、前、后六个方向的图像来模拟整个天空环境），通过一套特殊的纹理坐标计算方法，将整个环境的外观映射到具有反射或折射特性的物体表面，让物体看起来好像是在反射周围的环境一样。常用于渲染那些带有镜面反射效果的物体，或者模拟天空、室内环境等特定场景。
• 三维纹理映射（3D Texture Mapping）：此类型是将三维的纹理数据（可以想象成一个具备体积的纹理空间，例如在模拟烟雾、云朵等具有内部结构的物体外观时，就能够借助三维纹理来体现其内部不同位置的颜色、密度等特性）映射到三维物体内部或者整个物体所处的空间范围。相较于二维纹理映射，它的实现更为复杂，应用场景也相对较为特定，常常出现在一些特殊的科学可视化、医学成像或者模拟特殊材质等专业领域当中。

五、C++语言结合OpenGL的代码实现示例

以下是一个使用C++语言结合OpenGL实现纹理映射的简洁示例代码，将纹理映射到一个简单的矩形上，同时按照要求对函数形参和每行代码都给出注释：

#include <GL/glew.h>
#include <GLFW/glfw3.h>
#include <iostream>
// 引入stb_image库用于加载图像文件（确保已正确包含相关文件）
#define STB_IMAGE_IMPLEMENTATION
#include "stb_image.h"

// 读取着色器文件内容并返回字符串的函数
// filePath: 着色器文件的路径，告诉函数去哪里找需要读取的着色器文件
// 返回值: 读取到的文件内容字符串，方便后续编译着色器使用
std::string readShader(const char* filePath) {
    std::string content;
    std::ifstream file(filePath);  // 创建文件输入流，打开指定的着色器文件
    if (file) {
        std::stringstream buffer;
        buffer << file.rdbuf();  // 把文件内容读取到字符串流中
        content = buffer.str();  // 获取字符串流中的内容作为返回值
    }
    return content;
}

// 编译单个着色器的函数
// shaderType: 要编译的着色器类型，比如GL_VERTEX_SHADER（顶点着色器）、GL_FRAGMENT_SHADER（片段着色器）
// source: 包含具体着色器代码的字符串，是实际要编译的代码内容
// 返回值: 编译成功返回着色器对象ID，失败返回0
GLuint compileShader(GLenum shaderType, const std::string& source) {
    GLuint shader = glCreateShader(shaderType);  // 创建指定类型的着色器对象，OpenGL根据shaderType确定类型
    const char* src = source.c_str();  // 将C++字符串转成C风格字符串指针，符合OpenGL函数参数要求
    glShaderSource(shader, 1, &src, nullptr);  // 设置着色器代码源，参数：
    // shader: 刚创建的着色器对象ID
    // 1: 代码源数量，这里是1个
    // &src: 指向代码内容的指针
    // nullptr: 表示字符串以'\0'结尾，无需指定长度
    glCompileShader(shader);  // 编译着色器

    GLint status;
    glGetShaderiv(shader, GL_COMPILE_STATUS, &status);  // 获取编译状态，存入status变量
    if (status == GL_FALSE) {  // 若编译失败
        GLchar infoLog[1024];
        glGetShaderInfoLog(shader, 1024, nullptr, infoLog);  // 获取编译失败详细日志
        std::cerr << "Shader compilation failed: " << infoLog << std::endl;  // 输出错误信息
        glDeleteShader(shader);  // 删除失败的着色器对象，释放资源
        return 0;
    }
    return shader;  // 编译成功返回对象ID
}

// 创建并链接着色器程序的函数
// vertexShader: 已编译好的顶点着色器对象ID
// fragmentShader: 已编译好的片段着色器对象ID
// 返回值: 链接成功返回程序对象ID，失败返回0
GLuint createShaderProgram(GLuint vertexShader, GLuint fragmentShader) {
    GLuint program = glCreateProgram();  // 创建着色器程序对象，获取其ID
    glAttachShader(program, vertexShader);  // 将顶点着色器附加到程序中
    glAttachShader(program, fragmentShader);  // 将片段着色器附加到程序中
    glLinkProgram(program);  // 链接着色器程序

    GLint status;
    glGetProgramiv(program, GL_LINK_STATUS, &status);  // 获取链接状态，存入status变量
    if (status == GL_FALSE) {  // 若链接失败
        GLchar infoLog[1024];
        glGetProgramInfoLog(program, 1024, nullptr, infoLog);  // 获取链接失败详细日志
        std::cerr << "Program linking failed: " << infoLog << std::endl;  // 输出错误信息
        glDeleteProgram(program);  // 删除失败的程序对象，释放资源
        return 0;
    }
    return program;  // 链接成功返回程序对象ID
}

// 加载纹理的函数
// texturePath: 纹理图像文件在磁盘上的路径，指定要加载的纹理图像位置
// 返回值: 创建并配置好的纹理对象ID，用于后续渲染中使用该纹理
GLuint loadTexture(const char* texturePath) {
    GLuint textureID;
    glGenTextures(1, &textureID);  // 生成纹理对象ID
    glBindTexture(GL_TEXTURE_2D, textureID);  // 绑定为二维纹理

    // 设置纹理过滤方式（缩小、放大时）
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAX_FILTER, GL_LINEAR);
    // 设置纹理环绕方式（水平、垂直方向）
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_REPEAT);
    glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_REPEAT);

    int width, height, nrChannels;
    unsigned char* data = stb_image_load(texturePath, &width, &height, &nrChannels, 0);  // 加载图像数据
    if (data) {
        if (nrChannels == 3) {
            glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, width, height, 0, GL_RGB, GL_UNSIGNED_BYTE, data);  // 绑定RGB图像数据到纹理
        } else if (nrChannels == 4) {
            glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, width, height, 0, GL_RGBA, GL_UNSIGNED_BYTE, data);  // 绑定RGBA图像数据到纹理
        }
        glGenerateMipmap(GL_TEXTURE_2D);  // 生成多级渐远纹理，优化不同距离显示效果
        stb_image_free(data);  // 释放图像内存，数据已复制到纹理
    } else {
        std::cerr << "Failed to load texture: " << texturePath << std::endl;  // 加载失败输出错误信息
    }
    return textureID;  // 返回纹理对象ID
}

int main() {
    if (!glfwInit()) {  // 初始化GLFW库，若失败则返回 -1
        std::cerr << "GLFW initialization failed" << std::endl;
        return -1;
    }

    glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3);  // 设置窗口OpenGL版本主版本号为3
    glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3);  // 设置窗口OpenGL版本次版本号为3
    glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE);  // 使用OpenGL核心版本
    glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE);  // 启用前向兼容

    GLFWwindow* window = glfwCreateWindow(800, 600, "Texture Mapping Example", nullptr, nullptr);  // 创建窗口
    if (!window) {
        std::cerr << "Window creation failed" << std::endl;
        glfwTerminate();  // 若窗口创建失败，终止GLFW库使用
        return -1;
    }

    glfwMakeContextCurrent(window);  // 设置当前窗口为OpenGL上下文

    if (glewInit()!= GLEW_OK) {  // 初始化GLEW库，若失败则返回 -1
        std::cerr << "GLEW initialization failed" << std::endl;
        glfwDestroyWindow(window);  // 销毁窗口
        glfwTerminate();  // 终止GLFW库使用
        return -1;
    }

    std::string vertexShaderSource = readShader("vertex_shader.glsl");  // 读取顶点着色器文件内容
    GLuint vertexShader = compileShader(GL_VERTEX_SHADER, vertexShaderSource);  // 编译顶点着色器

    std::string fragmentShaderSource = readShader("fragment_shader.glsl");  // 读取片段着色器文件内容
    GLuint fragmentShader = compileShader(GL_FRAGMENT_SHADER, fragmentShaderSource);  // 编译片段着色器

    GLuint shaderProgram = createShaderProgram(vertexShader, fragmentShader);  // 创建并链接着色器程序
    glDeleteShader(vertexShader);  // 删除已编译的顶点着色器，资源已在程序中
    glDeleteShader(fragmentShader);  // 删除已编译的片段着色器，资源已在程序中

    GLuint textureID = loadTexture("texture.jpg");  // 加载纹理

    float vertices[] = {
        -0.5f, -0.5f, 0.0f,
         0.5f, -0.5f, 0.0f,
         0.5f,  0.5f, 0.0f,
        -0.5f, -0.5f, 0.0f,
         0.5f,  0.5f, 0.0f,
        -0.5f,  0.5f, 0.0f
    };

    float texCoords[] = {
        0.0f, 0.0f,
        1.0f, 0.0f,
        1.0f, 1.0f,
        0.0f, 0.0f,
        1.0f, 1.0f,
        0.0f, 1.0f
    };

    GLuint VBO, TBO;
    glGenBuffers(1, &VBO);  // 生成顶点缓冲对象ID
    glBindBuffer(GL_ARRAY_BUFFER, VBO);  // 绑定顶点缓冲对象用于存储顶点数据
    glBufferData(GL_ARRAY_BUFFER, sizeof(vertices), vertices, GL_STATIC_DRAW);  // 复制顶点数据到缓冲

    glGenBuffers(1, &TBO);  // 生成纹理坐标缓冲对象ID
    glBindBuffer(GL_ARRAY_BUFFER, TBO);  // 绑定纹理坐标缓冲对象用于存储纹理坐标数据
    glBufferData(GL_ARRAY_BUFFER, sizeof(texCoords), texCoords, GL_STATIC_DRAW);  // 复制纹理坐标数据到缓冲

    GLint posAttrib = glGetAttribLocation(shaderProgram, "aPos");  // 获取顶点坐标属性位置
    glEnableVertexAttribArray(posAttrib);  // 启用顶点坐标属性
    glVertexAttribPointer(posAttrib, 3, GL_FLOAT, GL_FALSE, 3 * sizeof(float), nullptr);  // 设置顶点属性指针

    GLint texCoordAttrib = glGetAttribLocation(shaderProgram, "aTexCoord");  // 获取纹理坐标属性位置
    glEnableVertexAttribArray(texCoordAttrib);  // 启用纹理坐标属性
    glVertexAttribPointer(texCoordAttrib, 2, GL_FLOAT, GL_FALSE, 2 * sizeof(float), nullptr);  // 设置纹理坐标属性指针

    while (!glfwWindowShouldClose(window)) {  // 主循环，直到窗口关闭
        glfwPollEvents();  // 处理窗口事件

        glClear(GL_COLOR_BUFFER_BIT);  // 清除颜色缓冲

        glUseProgram(shaderProgram);  // 使用着色器程序

        glActiveTexture(GL_TEXTURE0);  // 激活纹理单元0
        glBindTexture(GL_TEXTURE_2D, textureID);  // 绑定纹理到纹理单元0

        glDrawArrays(GL_TRIANGLES, 0, 6);  // 绘制矩形（由两个三角形组成）

        glfwSwapBuffers(window);  // 交换前后缓冲，显示渲染结果
    }

    glDeleteBuffers(1, &VBO);  // 清理顶点缓冲对象资源
    glDeleteBuffers(1, &TBO);  // 清理纹理坐标缓冲对象资源
    glDeleteTextures(1, &textureID);  // 清理纹理资源
    glfwTerminate();  // 终止GLFW库使用
    return 0;
}

以下是对应的顶点着色器代码（vertex_shader.glsl）：

#version 330 core

layout (location = 0) in vec3 aPos;
layout (location = 1) in vec2 aTexCoord;

out vec2 TexCoord;

void main()
{
    gl_Position = vec4(aPos, 1.0);
    TexCoord = aTexCoord;
}

以下是对应的片段着色器代码（fragment_shader.glsl）：

#version 330 core

in vec2 TexCoord;

uniform sampler2D ourTexture;

out vec4 FragColor;

void main()
{
    FragColor = texture(ourTexture, TexCoord);
}

下面对代码进一步解释：

1. readShader 函数

• 函数目的：从磁盘文件中读取着色器代码内容，方便后续进行编译操作。
• 代码细节：
  • std::string content;：定义一个字符串变量 content，用于存储读取到的文件内容。
  • std::ifstream file(filePath);：尝试打开由 filePath 指定路径的文件，创建一个文件输入流对象 file，如果文件打开失败（比如文件不存在等情况），后续操作不会执行，函数直接返回空字符串。
  • if (file)：检查文件是否成功打开，若打开成功，则执行下面的操作。
  • buffer << file.rdbuf();：通过 file.rdbuf() 获取文件的缓冲区内容，并将其读取到 stringstream 类型的 buffer 中，相当于把文件内容逐字符地放入 buffer 里。
  • content = buffer.str();：将 buffer 中的内容转换为 std::string 类型，并赋值给 content，这样 content 就存储了整个文件的内容，最后作为函数返回值返回。

2. compileShader 函数

• 函数目的：根据给定的着色器类型和代码内容，创建并编译一个OpenGL着色器对象，检查编译结果并返回相应的对象ID（成功则返回ID，失败则返回0）。
• 代码细节：
  • GLuint shader = glCreateShader(shaderType);：调用OpenGL函数 glCreateShader，按照传入的 shaderType 参数（如 GL_VERTEX_SHADER 或 GL_FRAGMENT_SHADER 等）创建对应的着色器对象，并获取其对象ID，后续操作都通过这个ID来关联和操作该着色器。
  • const char* src = source.c_str();：由于OpenGL函数 glShaderSource 要求以C风格字符串指针的形式传入着色器代码内容，所以这里将传入的 std::string 类型的 source 转换为C风格字符串指针 src。
  • glShaderSource(shader, 1, &src, nullptr);：使用 glShaderSource 函数设置刚创建的着色器对象 shader 的代码源，其中 1 表示只有一个代码源，&src 指向实际的代码内容，nullptr 表示字符串以 '\0' 结尾，不需要额外指定长度信息。
  • glCompileShader(shader);：调用OpenGL的 glCompileShader 函数对设置好代码源的着色器对象进行编译操作。
  • glGetShaderiv(shader, GL_COMPILE_STATUS, &status);：使用 glGetShaderiv 函数向OpenGL查询该着色器对象的编译状态，并将结果存储在 status 变量中，通过检查 status 的值来判断编译是否成功。
  • if (status == GL_FALSE) 及其后续代码块：如果 status 的值为 GL_FALSE，说明编译失败，此时使用 glGetShaderInfoLog 函数获取详细的编译失败日志信息，存储在 infoLog 数组中，然后通过 std::cerr 将错误信息输出到标准错误输出流，告知用户编译出现问题，接着调用 glDeleteShader 函数删除这个失败的着色器对象以释放相关的OpenGL资源，最后返回0表示编译失败。
  • return shader;：如果编译成功（即 status 的值不为 GL_FALSE），则返回该着色器对象的ID，以便后续在创建和链接着色器程序等操作中使用。

3. createShaderProgram 函数

• 函数目的：创建一个OpenGL着色器程序对象，将已编译好的顶点着色器和片段着色器附加到该程序中并进行链接操作，检查链接结果并返回相应的程序对象ID（成功则返回ID，失败则返回0）。
• 代码细节：
  • GLuint program = glCreateProgram();：调用OpenGL函数 glCreateProgram 创建一个着色器程序对象，并获取其对象ID，这个程序对象将用于管理和整合多个着色器（这里主要是顶点着色器和片段着色器），后续通过该ID来操作整个着色器程序。
  • glAttachShader(program, vertexShader); 和 glAttachShader(program, fragmentShader);：分别使用 glAttachShader 函数将传入的已编译好的 vertexShader（顶点着色器对象ID）和 fragmentShader（片段着色器对象ID）附加到刚创建的 program（着色器程序对象）中，使其成为程序的一部分，这样OpenGL在后续链接操作时就知道要将这两个着色器的逻辑整合在一起。