GLES2.0中文API-glReadPixels

名称

glReadPixels - 从帧缓冲区中读取一个像素块

C规范

void glReadPixels（GLint x,

GLint y,

GLsizei width,

GLsizei height,

GLenum format,

GLenum type,

GLvoid * data）;

参数

x，y

指定从帧缓冲区读取的第一个像素的窗口坐标。此位置是矩形像素块的左下角。

width,height

指定像素矩形的尺寸。一个宽度和高度对应于单个像素。

format

指定像素数据的格式。接受以下符号值：GL_ALPHA，GL_RGB和GL_RGBA。

type

指定像素数据的数据类型。必须是GL_UNSIGNED_BYTE，GL_UNSIGNED_SHORT_5_6_5，GL_UNSIGNED_SHORT_4_4_4_4或GL_UNSIGNED_SHORT_5_5_5_1之一。

data

返回像素数据。

描述

glReadPixels从帧缓冲区返回像素数据，从左下角位于（x，y）的像素开始，从位置data开始返回客户端内存。使用glPixelStorei命令设置的GL_PACK_ALIGNMENT参数会影响像素数据在放入客户端内存之前的处理。

glReadPixels返回每个像素的值，左下角为x + i y + j，0 <= i <width，0 <= j <height。该像素被称为第j行中的第i个像素。像素按行顺序从最低行返回到最高行，每行从左到右排列。

format指定返回像素值的格式; 可接受的值是：

GL_ALPHA

GL_RGB

GL_RGBA

从颜色缓冲区读取RGBA颜色分量。每个颜色分量都转换为浮点，使零强度映射到0.0，全强度映射到1.0。

丢弃不需要的数据。例如，GL_ALPHA丢弃红色，绿色和蓝色组件，而GL_RGB仅丢弃alpha组件。最终值被限制在[0 1]的范围内。

最后，组件将转换为由类型指定合适的格式，。当类型为GL_UNSIGNED_BYTE时，每个组件乘以2^8 - 1。当类型为GL_UNSIGNED_SHORT_5_6_5，GL_UNSIGNED_SHORT_4_4_4_4或GL_UNSIGNED_SHORT_5_5_5_1时，每个分量乘以2^N-1，其中N是位域中的位数。

返回值按如下方式放入内存中。如果format是GL_ALPHA，则返回单个值，并且第j行中第i个像素的数据放置在位置j*width + i中。 GL_RGB返回三个值，GL_RGBA为每个像素返回四个值，所有值对应于占据数据中连续空间的单个像素。由glPixelStorei设置的存储参数GL_PACK_ALIGNMENT会影响数据写入内存的方式。有关说明，请参阅glPixelStorei。

注意

如果当前绑定的帧缓冲区不是默认的帧缓冲区对象，则从附加到GL_COLOR_ATTACHMENT0附着点的彩色图像中读取颜色分量。

只有两个format/type参数对是可接受的。GL_RGBA / GL_UNSIGNED_BYTE是始终都可以接受的，另外的就需要查询了：通过查询GL_IMPLEMENTATION_COLOR_READ_FORMAT和GL_IMPLEMENTATION_COLOR_READ_TYPE来发现其他可接受的对。

位于连接到当前GL上下文的窗口之外的像素值是未定义的。

如果生成错误，则不会更改data内容。

错误

GL_INVALID_ENUM ：如果format或type不是可接受的值。

GL_INVALID_VALUE ：如果width或height是负数

GL_INVALID_OPERATION ：如果type为GL_UNSIGNED_SHORT_5_6_5且格式不是GL_RGB。

GL_INVALID_OPERATION ：如果type为GL_UNSIGNED_SHORT_4_4_4_4或GL_UNSIGNED_SHORT_5_5_5_1且格式不是GL_RGBA。

GL_INVALID_OPERATION ：如果format和type分别既不是GL_RGBA又不是GL_UNSIGNED_BYTE，也不是通过查询GL_IMPLEMENTATION_COLOR_READ_FORMAT和GL_IMPLEMENTATION_COLOR_READ_TYPE返回的格式/类型对。

GL_INVALID_FRAMEBUFFER_OPERATION ：如果当前绑定的帧缓冲区不是帧缓冲区完成状态（即glCheckFramebufferStatus的返回值不是GL_FRAMEBUFFER_COMPLETE）。

另见

glCheckFramebufferStatus，glPixelStorei

版权

https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glReadPixels.xml

https://blog.csdn.net/flycatdeng

Demo

Android Demo：glReadPixel读取当前缓冲区像素并保存成Bitmap

GLES2.0中文API-glReadPixels相关推荐

GLES2.0中文API-glGet
名称 glGet - 返回所选参数的值 C规范 void glGetBooleanv( GLenum pname, GLboolean * params); void glGetFlo ...
GLES2.0中文API-glTexImage2D
名称 glTexImage2D- 指定一个二维的纹理图片 C规范 void glTexImage2D(GLenum target, GLint level, GLint internalformat, ...
GLES2.0中文API-glCopyTexImage2D
名称 glCopyTexImage2D - 将像素复制到2D纹理图像中 C规范 void glCopyTexImage2D( GLenum target, GLint level, ...
GLES2.0中文API-glCopyTexSubImage2D
名称 glCopyTexSubImage2D - 复制二维纹理子图像 C规范 void glCopyTexSubImage2D( GLenum target, GLint level ...
GLES2.0中文API-glBindFramebuffer
名称 glBindFramebuffer- 绑定一个命名的帧缓冲区对象 C规范 void glBindFramebuffer(GLenum target, GLuint framebuffer); 参 ...
GLES2.0中文API-glUseProgram
名称 glUseProgram- 使用程序对象作为当前渲染状态的一部分 C规范 void glUseProgram(GLuint program); 参数 program 指定程序对象的句柄,该程序对 ...
GLES2.0中文API-glUniform
名称 glUniform - 指定当前程序对象的统一变量的值 C规范 void glUniform1f( GLint location, GLfloat v0); void glUniform2 ...
GLES2.0中文API-glGetActiveUniform
名称 glGetActiveUniform - 返回有关活动统一变量的信息 C规范 void glGetActiveUniform(GLuint program, GLuint index, GLsi ...
GLES2.0中文API-glTexParameter
名称 glTexParameter - 设置纹理参数 C规范 void glTexParameterf(GLenum target,GLenum pname,GLfloat param); void ...

GLES2.0中文API-glReadPixels

名称

C规范

参数

描述

注意

错误

相关Gets

另见

版权

Demo

GLES2.0中文API-glReadPixels相关推荐

最新文章

热门文章