GLES2.0中文API-glReadPixels

最新推荐文章于 2025-05-13 09:52:16 发布

翻译最新推荐文章于 2025-05-13 09:52:16 发布 · 6.2k 阅读

文章标签：

#glReadPixels #中文 #API #gles

gles 同时被 2 个专栏收录

133 篇文章

订阅专栏

GLES2.0中文API

106 篇文章

订阅专栏

glReadPixels函数用于从帧缓冲区读取像素数据。它接受窗口坐标(x,y)作为起始位置，width和height定义矩形区域大小，format和type指定数据格式和类型。数据存储在data指向的内存中，格式化受glPixelStorei影响。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

名称

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

GLES2.0中文API-glReadPixels

名称

C规范

参数

描述

注意

错误

相关Gets

另见

版权

Demo