2003-2014
The Khronos Group Inc.
eglReleaseTexImage
3G
eglReleaseTexImage
Releases a color buffer that is being used as a texture
C Specification
EGLBoolean eglReleaseTexImage
EGLDisplay display
EGLSurface surface
EGLint buffer
Parameters
display
Specifies the EGL display connection.
surface
Specifies the EGL surface.
buffer
Specifies the texture image data.
Description
The specified color buffer is released back to the surface. The surface is made
available for reading and writing when it no longer has any color buffers bound as
textures.
Notes
If the specified color buffer is no longer bound to a texture (e.g., because the
texture object was deleted) then eglReleaseTexImage has no effect. No error is
generated.
The contents of the color buffer are undefined when it is first released. In particular,
there is no guarantee that the texture image is still present. However, the contents of
other color buffers are unaffected by this call. Also, the contents of the depth and stencil buffers
are not affected by eglBindTexImage
and eglReleaseTexImage.
After a color buffer is released from a texture (either explicitly by calling
eglReleaseTexImage or implicitly by calling a routine such as
glTexImage2D),
all texture images that were defined by the color buffer become NULL
(it is as if glTexImage was called with an image of zero width).
Errors
EGL_BAD_MATCH is generated if the
surface attribute EGL_TEXTURE_FORMAT is
set to EGL_NO_TEXTURE.
EGL_BAD_MATCH is generated if
buffer is not a valid buffer
(currently only EGL_BACK_BUFFER may be
specified).
EGL_BAD_SURFACE is generated if
surface is not an EGL surface, or is
not a bound pbuffer surface.
See Also
eglBindTexImage