EGL函数翻译–eglReleaseTexImage
函数名
EGLBoolean eglReleaseTexImage(EGLDisplay display,EGLSurface surface,EGLint buffer);
参数描述
display
指定 EGL 显示连接。
surface
指定 EGL 表面。
buffer
指定纹理图像数据。
详细描述
指定的颜色缓冲区被释放回表面。当表面不再有任何颜色缓冲区绑定为纹理时，表面将可用于读写操作。
注意
如果指定的颜色缓冲区不再绑定到纹理（例如，因为纹理对象已被删除），那么 eglReleaseTexImage 不会产生任何效果，也不会生成错误。
当颜色缓冲区首次被释放时，其内容未定义。特别是，无法保证纹理图像仍然存在。然而，其他颜色缓冲区的内容不会受到此调用的影响。此外，深度缓冲区和模板缓冲区的内容不会受到 eglBindTexImage 和 eglReleaseTexImage 的影响。
当颜色缓冲区从纹理中释放后（无论是通过显式调用 eglReleaseTexImage 还是通过调用类似 glTexImage2D 的例程隐式释放），由该颜色缓冲区定义的所有纹理图像将变为 NULL（相当于 glTexImage 被调用时图像的宽度为零）。
错误描述
如果表面属性 EGL_TEXTURE_FORMAT 设置为 EGL_NO_TEXTURE，则会生成 EGL_BAD_MATCH 错误。
如果 buffer 不是有效的缓冲区（当前只能指定 EGL_BACK_BUFFER），则会生成 EGL_BAD_MATCH 错误。
如果 surface 不是 EGL 表面，或不是绑定的 pbuffer 表面，则会生成 EGL_BAD_SURFACE 错误。
英文连接
链接: https://registry.khronos.org/EGL/sdk/docs/man/