Name
KHR_image
Name Strings
EGL_KHR_image
Contributors
Jeff Juliano
Gary King
Jon Leech
Barthold Lichtenbelt
Aaftab Munshi
Acorn Pooley
Chris Wynn
Contacts
Jon Leech (jon 'at' alumni.caltech.edu)
Gary King, NVIDIA Corporation (gking 'at' nvidia.com)
Status
Complete.
Approved by the Khronos Board of Promoters on February 11, 2008.
Rewritten in terms of split functionality in KHR_image_base and
KHR_image_pixmap, approved by the Khronos Technical Working Group
on November 19, 2008.
Version
Version 11, November 12, 2008
Number
EGL Extension #3
Dependencies
EGL 1.2 is required.
An EGL client API, such as OpenGL ES or OpenVG, is required.
The specifications of EGL_KHR_image_base and EGL_KHR_image_pixmap are
required to determine the specification of this extension, although
those extentions may not be supported.
This extension is written against the wording of the EGL 1.2
Specification.
Overview
This extension defines a new EGL resource type that is suitable for
sharing 2D arrays of image data between client APIs, the EGLImage,
and allows creating EGLImages from EGL native pixmaps.
New Types
As defined by EGL_KHR_image_base.
New Procedures and Functions
As defined by EGL_KHR_image_base.
New Tokens
As defined by EGL_KHR_image_base and EGL_KHR_image_pixmap, with the
exception that EGL_IMAGE_PRESERVED_KHR is not defined by this
extension.
Additions to Chapter 2 of the EGL 1.2 Specification (EGL Operation)
EGL_KHR_image is equivalent to the combination of the functionality
defined by EGL_KHR_image_base and EGL_KHR_image_pixmap, with the
exception that if EGL_KHR_image is supported and EGL_KHR_image_base
is not, the attribute EGL_IMAGE_PRESERVED_KHR is not accepted in
<attrib_list>, However, the default value of this attribute is still
EGL_FALSE. In this situation, image preservation is always disabled.
Issues
None (but see the issues lists for EGL_KHR_image_base and
EGL_KHR_image_pixmap).
Revision History
#11 (Jon Leech, November 12, 2008)
- Clarified image preservation behavior when using this extension.
#10 (Jon Leech, October 22, 2008)
- Update description of interactions with EGL_KHR_image_base now
that the default value of EGL_IMAGE_PRESERVED_KHR is always FALSE.
#9 (Jon Leech, October 21, 2008)
- Split functionality into new extensions EGL_KHR_image_base and
EGL_KHR_image_pixmap, and defined legacy non-preserved image behavior
when this extension is supported.
#8 (Jon Leech, October 8, 2008)
- Updated status (approved as part of OpenKODE 1.0)
#7 (Jon Leech, November 20, 2007)
- Corrected 'enum' to 'EGLenum' in prototypes.
#6 (Jon Leech, April 5, 2007)
- Assigned enumerant values
- Added OpenKODE 1.0 Provisional disclaimer
#5 (Jon Leech, February 26, 2007)
- Add eglCreateImageKHR error if native pixmaps are not supported by
EGL.
#4 (December 14, 2006)
- Replaced EGL_OUT_OF_MEMORY error with EGL_BAD_ALLOC
- add "egl" and "EGL" to names to be consistant with spec
- formatting to keep within 80 columns
- Changed requirement to egl 1.2 to include EGLClientBuffer type.
- clarified some unclear error cases
- added some new error cases related to <dpy> and <ctx>
- add <dpy> param to eglCreateImageKHR and eglDestroyImageKHR
#3 (November 27, 2006)
- Converted OES token to KHR token
#2 (October 20, 2006)
- Split out API-specific image source types (VG, GL, etc.) into
individual extensions.
- Merged CreateImage2DOES and CreateImage3DOES functions into
a single CreateImageOES function with an attribute-value list.
- Removed the minimum requirements section (2.5.3), since this
doesn't make sense without the client-API specific extensions.
The minimum requirements should be migrated to the client-API
specific extension specifications.
- Added EGL_NO_IMAGE_OES default object, used as return value for
CreateImage*OES functions in the event of error conditions.
- Reworded issue 5, to clarify that the buffer sub-object (i.e.,
the unique resource specified by <ctx>, <target>, <buffer>,
and <attrib_list>) specified in CreateImage may not already be
an EGLImage sibling (either EGLImage source or EGLImage target).
#1 Original release
