纹理API

//**读取文件**
//改变像素存储方式
void glPixelStorei(GLenum pname, GLint param);
//恢复像素存储方式
void glPixelStoref(GLenum pname, GLfloat param);
//举例:
//参数1:GL_UNPACK_ALIGNMENT 指定OpenGL如何从数据缓存区中解包图像数据
//参数2:表示参数GL_UNPACK_ALIGNMENT设置的值
//GL_UNPACK_ALIGNMENT 指内存中每个像素⾏起点的排列请求，允许设置为1 (byte排列)、2(排列为偶数byte的⾏)、4(字word排列)、8(⾏从双字节边界开始)
glPixelStorei(GL_UNPACK_ALIGNMENT, 1);

//从颜色缓存区内容作为像素图直接读取
//参数1:x,矩形左下角的窗⼝坐标
//参数2:y,矩形左下角的窗⼝坐标
//参数3:width,矩形的宽，以像素为单位
//参数4:height,矩形的⾼，以像素为单位
//参数5:format,OpenGL 的像素格式，参考 表6-1
//参数6:type,解释参数pixels指向的数据，告诉OpenGL 使⽤缓存区中的什么 数据类型来存储颜⾊分量，像素数据的数据类型，参考 表6-2 
//参数7:pixels,指向图形数据的指针
void glReadPixels(GLint x, GLint y, GLSizei width, GLSizei height, GLenum format, GLenum type, const void * pixels);
// 指定读取的缓存 
glReadBuffer(mode); 
// 指定写入的缓存
glWriteBuffer(mode); 

//读纹理位，读取像素
//参数1：纹理文件名称
//参数2：文件宽度地址
//参数3：文件高度地址
//参数4：文件组件地址
//参数5：文件格式地址
//返回值：pBits,指向图像数据的指针
GLbyte *gltReadTGABits(const char *szFileName, GLint *iWidth, GLint *iHeight, GLint *iComponents, GLenum *eFormat, GLbyte *pData = NULL);

//**载入纹理**
//载入纹理
/*
* target:`GL_TEXTURE_1D`、`GL_TEXTURE_2D`、`GL_TEXTURE_3D`。
* level:指定所加载的mip贴图层次。⼀般我们都把这个参数设置为0。
* internalformat:每个纹理单元中存储多少颜⾊成分。
* width、height、depth参数:指加载纹理的宽度、⾼度、深度。
==注意!==这些值必须是 2的整数次方。
(这是因为OpenGL 旧版本上的遗留留下的⼀个要求。当然现在已经可以⽀支持不不是 2的整数次方。但是开发者们还是习惯使⽤以2的整数次方去设置这些参数。)
* border参数:允许为纹理贴图指定⼀个边界宽度。
* format、type、data参数:与我们在讲glDrawPixels 函数对于的参数相同
*/
void glTexImage1D(GLenum target, GLint level, GLint internalformat, GLsizei width, GLint border, GLenum format, GLenum type, void *data);
void glTexImage2D(GLenum target, GLint level, GLint internalformat, GLsizei width, GLsizei height, GLint border, GLenum format, GLenum type, void * data);
void glTexImage3D(GLenum target, GLint level, GLint internalformat, GLSizei width, GLsizei height, GLsizei depth, GLint border, GLenum format, GLenum type, void *data);

//更新纹理
void glTexSubImage1D(GLenum target, GLint level, GLint xOffset, GLsizei width, GLenum format, GLenum type, const GLvoid *data);
void glTexSubImage2D(GLenum target, GLint level, GLint xOffset, GLint yOffset, GLsizei width, GLsizei height, GLenum format, GLenum type, const GLvoid *data);
void glTexSubImage3D(GLenum target, GLint level, GLint xOffset, GLint yOffset, GLint zOffset, GLsizei width, GLsizei height, GLsizei depth, Glenum type, const GLvoid * data);

//插入替换纹理
void glCopyTexSubImage1D(GLenum target, GLint level, GLint xoffset, GLint x, GLint y, GLsize width);
void glCopyTexSubImage2D(GLenum target, GLint level, GLint xoffset, GLint yOffset, GLint x, GLint y, GLsizei width, GLsizei height);
void glCopyTexSubImage3D(GLenum target, GLint level, GLint xoffset, GLint yOffset, GLint zOffset, GLint x, GLint y, GLsizei width, GLsizei height);

//使用颜⾊缓存区加载数据，形成新的纹理使用
// x,y 在颜⾊缓存区中指定了开始读取纹理数据的位置; 
// 缓存区⾥的数据，是源缓存区通过glReadBuffer设置的。
void glCopyTexImage1D(GLenum target, GLint level, GLenum internalformt, GLint x, GLint y, GLsizei width, GLint border);
void glCopyTexImage2D(GLenum target, GLint level, GLenum internalformt, GLint x, GLint y, GLsizei width, GLsizei height, GLint border);


//**纹理对象**
//使⽤函数分配纹理对象
//指定纹理对象的数量 和 指针(指针指向⼀个⽆符号整形数组，由纹理对象标识符填充)。 
void glGenTextures(GLsizei n, GLuint * textTures);
//绑定纹理状态 
//参数target:GL_TEXTURE_1D、GL_TEXTURE_2D、GL_TEXTURE_3D
//参数texture:需要绑定的纹理对象
void glBindTexture(GLenum target, GLunit texture);
//删除绑定纹理对象
//纹理对象 以及 纹理对象指针(指针指向⼀个⽆符号整形数组，由纹理对象标识符填充)。
void glDeleteTextures(GLsizei n, GLuint *textures);
//测试纹理对象是否有效
//如果texture是⼀个已经分配空间的纹理对象，那么这个函数会返回GL_TRUE,否则会返回GL_FALSE。 
GLboolean glIsTexture(GLuint texture);

//设置纹理参数
//参数1:target,指定这些参数将要应⽤在那个纹理模式上，⽐如GL_TEXTURE_1D、GL_TEXTURE_2D、GL_TEXTURE_3D。 
//参数2:pname,指定需要设置那个纹理参数
//参数3:param,设定特定的纹理参数的值
glTexParameterf(GLenum target, GLenum pname, GLFloat param);
glTexParameteri(GLenum target, GLenum pname, GLint param);
glTexParameterfv(GLenum target, GLenum pname, GLFloat *param);
glTexParameteriv(GLenum target, GLenum pname, GLint *param);
//举例：
//设置纹理过滤方式：邻近过滤(GL_NEAREST)，线性过滤(GL_LINEAR)
//纹理缩⼩时,使用邻近过滤
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST) 
//纹理放大时,使⽤线性过滤
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR) 
//举例：
//设置x轴/y轴纹理环绕⽅式：(x,y,z,w)对应（s,t,r,q）
//参数1:GL_TEXTURE_1D、GL_TEXTURE_2D、GL_TEXTURE_3D 
//参数2:GL_TEXTURE_WRAP_S、GL_TEXTURE_T、GL_TEXTURE_R,针对s,t,r坐标 
//参数3:GL_REPEAT、GL_CLAMP、GL_CLAMP_TO_EDGE、GL_CLAMP_TO_BORDER
//GL_REPEAT:OpenGL 在纹理坐标超过1.0的⽅方向上对纹理进⾏重复。
//GL_CLAMP:所需的纹理单元取⾃纹理边界或TEXTURE_BORDER_COLOR。
//GL_CLAMP_TO_EDGE环绕模式强制对范围之外的纹理坐标沿着合法的纹理单元的最后⼀⾏或者最后⼀列来进⾏采样。
//GL_CLAMP_TO_BORDER:在纹理坐标在0.0到1.0范围之外的只使⽤用边界纹理单元。边界纹理单元是作为围绕基本图像的额外的⾏和列，并与基本纹理图像⼀起加载的。
glTextParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAR_S, GL_CLAMP_TO_EDGE);
glTextParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAR_T, GL_CLAMP_TO_EDGE);

纹理过滤方式：

image1.png

纹理环绕⽅式：

image2.png image3.png image4.png