EGL_KHR_image_base#

Supported Hardware#

Series5, Series5XT, Series6, Series6XE, Series6XT

Valid APIs#

EGL 1.2, 1.3, 1.4

Description#

This extension introduces image objects to EGL. Image objects are a way of defining a somewhat generic object which stores something that may be considered an array of image data; for example, textures, renderbuffers, or pixmaps. This extension defines what an EGLImage is to a developer and makes no assumptions about the underlying data - internally data is stored in a format that is friendly to whatever client APIs are supported by a given implementation. This extension also does not define any source targets for creating an EGLImage; on its own, it’s of little use beyond defining the object itself and the interface. Extensions which add functionality to create EGLImages from various sources are: EGLEGL_KHR_image_pixmap, OpenGL/ESEGL_KHR_gl_texture_2D_image, EGL_KHR_gl_texture_cubemap_image, EGL_KHR_gl_texture_3D_image, EGL_KHR_gl_renderbuffer_image, OpenCLEGL_IMG_cl_image, AndroidEGL_ANDROID_image_native_buffer, LinuxEGL_EXT_image_dma_buf_import, and OpenVGEGL_KHR_vg_parent_image. Other various client extensions enable the creation of a client object from an EGLImage, such as GL_KHR_EGL_image.

Note#

This functionality is core to EGL 1.5, so the extension is no longer needed.

Example#

// Create an EGLImageKHR from an EGL Pixmap
EGLImageKHR eglImage = eglCreateImageKHR(eglDisplay, eglOpenGLESContext, EGL_NATIVE_PIXMAP_KHR, (EGLClientBuffer)anEGLPixmap, NULL);