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）。

相关Gets

glGet 参数GL_IMPLEMENTATION_COLOR_READ_FORMAT或GL_IMPLEMENTATION_COLOR_READ_TYPE

glGet 参数GL_PACK_ALIGNMENT

另见

glCheckFramebufferStatus，glPixelStorei

版权

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

https://blog.youkuaiyun.com/flycatdeng

Copyright © 1991-2006 Silicon Graphics, Inc.本文档的许可是根据SGI Free Software B License.详见http://oss.sgi.com/projects/FreeB/.

Android,OpenGL ES,图形学

 

Demo

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