【open gl】基本api方法

OpenGL API 及其作用和解决的问题总结：

一、核心 OpenGL API 分类与作用

1. 纹理管理

API	作用	解决的问题	代码示例
`glGenTextures`	生成纹理对象	创建 GPU 纹理存储空间	`glGenTextures(RENDER_IMG_NUM, m_TextureIds)`
`glActiveTexture`	激活纹理单元	支持多纹理同时使用（如同时绑定多个贴图）	`glActiveTexture(GL_TEXTURE0)`
`glBindTexture`	绑定纹理到当前状态	指定后续操作的纹理目标	`glBindTexture(GL_TEXTURE_2D, m_TextureIds[i])`
`glTexImage2D`	上传图像数据到纹理	将 CPU 图像数据传递到 GPU	`glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, ...)`
`glTexParameterf/glTexParameteri`	设置纹理参数	控制纹理采样行为（过滤、环绕方式）	`glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR)`

2. 缓冲区管理

API	作用	解决的问题	代码示例
`glGenBuffers`	生成缓冲区对象	创建 GPU 缓冲区存储空间	`glGenBuffers(3, m_VboIds)`
`glBindBuffer`	绑定缓冲区到目标	指定后续操作的缓冲区目标（顶点/索引数据）	`glBindBuffer(GL_ARRAY_BUFFER, m_VboIds[0])`
`glBufferData`	上传数据到缓冲区	将顶点/索引数据传递到 GPU	`glBufferData(GL_ARRAY_BUFFER, sizeof(verticesCoords), ...)`

3. 顶点属性配置

API	作用	解决的问题	代码示例
`glEnableVertexAttribArray`	启用顶点属性	允许着色器访问顶点属性（如位置、纹理坐标）	`glEnableVertexAttribArray(0)`
`glVertexAttribPointer`	定义顶点数据格式	解释缓冲区中的原始数据如何映射到顶点属性	`glVertexAttribPointer(0, 3, GL_FLOAT, ...)`

4. 着色器与渲染控制

API	作用	解决的问题	代码示例
`glGetUniformLocation`	获取 Uniform 变量位置	在 CPU 端设置着色器参数（如 MVP 矩阵）	`glGetUniformLocation(m_ProgramObj, "u_MVPMatrix")`
`glUseProgram`	绑定着色器程序	指定当前渲染使用的着色器	`glUseProgram(m_ProgramObj)`
`glUniformMatrix4fv`	设置矩阵型 Uniform	传递变换矩阵到着色器	`glUniformMatrix4fv(m_MVPMatLoc, 1, GL_FALSE, ...)`
`glDrawElements`	索引绘制	根据索引高效绘制几何体	`glDrawElements(GL_TRIANGLES, 6, ...)`

5. 状态管理

API	作用	解决的问题	代码示例
`glClear`	清空缓冲区	重置颜色/深度/模板缓冲区	`glClear(GL_COLOR_BUFFER_BIT
`glEnable/glDisable`	启用/禁用功能	控制混合、深度测试等渲染功能	`glEnable(GL_BLEND)`

二、关键流程与协作

1. 初始化阶段

纹理初始化
- glGenTextures → 生成纹理对象
- glActiveTexture + glBindTexture → 绑定到指定纹理单元
- glTexImage2D → 上传图像数据
- glTexParameteri → 设置过滤/环绕参数
缓冲区初始化
- glGenBuffers → 生成 VBO/IBO
- glBindBuffer + glBufferData → 上传顶点/索引数据
顶点属性配置
- glEnableVertexAttribArray → 启用属性通道
- glVertexAttribPointer → 定义数据格式

2. 渲染阶段

状态设置
- glUseProgram → 绑定着色器
- glActiveTexture + glBindTexture → 绑定当前纹理
- glUniform* → 传递参数到着色器
绘制命令
- glDrawElements → 执行绘制操作

三、解决的问题

资源管理
- 通过 glGen* 创建 GPU 资源（纹理、缓冲区）
- 通过 glBind* 管理当前操作目标
数据传输
- glTexImage2D 和 glBufferData 将数据从 CPU 传递到 GPU
状态控制
- 纹理参数、混合模式、顶点属性格式等状态的配置
高效渲染
- 通过 VBO/VAO 减少重复数据上传
- 通过索引绘制 (glDrawElements) 减少顶点重复

四、代码中的典型应用

1. 多纹理渲染

cpp 复制代码

// 激活纹理单元0，绑定背景纹理
glActiveTexture(GL_TEXTURE0);
glBindTexture(GL_TEXTURE_2D, m_TextureIds[0]);
glUniform1i(m_SamplerLoc, 0); // 告诉着色器使用纹理单元0

2. 顶点数据配置

cpp 复制代码

// 配置顶点位置属性
glEnableVertexAttribArray(0);
glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 3*sizeof(GLfloat), (void*)0);
// 配置纹理坐标属性
glEnableVertexAttribArray(1);
glVertexAttribPointer(1, 2, GL_FLOAT, GL_FALSE, 2*sizeof(GLfloat), (void*)0);

3. 动态参数传递

cpp 复制代码

// 更新 MVP 矩阵并传递到着色器
UpdateMVPMatrix(...);
glUniformMatrix4fv(m_MVPMatLoc, 1, GL_FALSE, &m_MVPMatrix[0][0]);

五、常见问题与注意事项

未绑定对象直接操作
- 错误示例：调用 glTexImage2D 前未 glBindTexture
- 结果：数据上传失败，纹理显示异常
顶点属性未启用
- 错误示例：忘记调用 glEnableVertexAttribArray
- 结果：着色器无法读取顶点数据，模型不显示
纹理单元冲突
- 错误示例：多个纹理绑定到同一单元未切换
- 结果：纹理采样混乱，显示错误贴图