| Name |
| |
| ANDROID_get_native_client_buffer |
| |
| Name Strings |
| |
| EGL_ANDROID_get_native_client_buffer |
| |
| Contributors |
| |
| Craig Donner |
| |
| Contact |
| |
| Craig Donner, Google Inc. (cdonner 'at' google.com) |
| |
| Status |
| |
| Complete |
| |
| Version |
| |
| Version 3, October 11, 2017 |
| |
| Number |
| |
| EGL Extension #123 |
| |
| Dependencies |
| |
| Requires EGL 1.2. |
| |
| EGL_ANDROID_image_native_buffer and EGL_KHR_image_base are required. |
| |
| This extension is written against the wording of the EGL 1.2 |
| Specification as modified by EGL_KHR_image_base and |
| EGL_ANDROID_image_native_buffer. |
| |
| Overview |
| |
| This extension allows creating an EGLClientBuffer from an Android |
| AHardwareBuffer object which can be later used to create an EGLImage. |
| |
| New Types |
| |
| struct AHardwareBuffer |
| |
| New Procedures and Functions |
| |
| EGLClientBuffer eglGetNativeClientBufferANDROID(const struct AHardwareBuffer *buffer) |
| |
| New Tokens |
| |
| None |
| |
| Changes to Chapter 3 of the EGL 1.2 Specification (EGL Functions and Errors) |
| |
| Add the following to section 2.5.1 "EGLImage Specification" (as modified by |
| the EGL_KHR_image_base and EGL_ANDROID_image_native_buffer specifications), |
| below the description of eglCreateImageKHR: |
| |
| "The command |
| |
| EGLClientBuffer eglGetNativeClientBufferANDROID( |
| const struct AHardwareBuffer *buffer) |
| |
| may be used to create an EGLClientBuffer from an AHardwareBuffer object. |
| EGL implementations must guarantee that the lifetime of the returned |
| EGLClientBuffer is at least as long as the EGLImage(s) it is bound to, |
| following the lifetime semantics described below in section 2.5.2; the |
| EGLClientBuffer must be destroyed no earlier than when all of its associated |
| EGLImages are destroyed by eglDestroyImageKHR. |
| |
| Errors |
| |
| If eglGetNativeClientBufferANDROID fails, NULL will be returned, no |
| memory will be allocated, and the following error will be generated: |
| |
| * If the value of buffer is NULL, the error EGL_BAD_PARAMETER is |
| generated. |
| |
| Issues |
| |
| 1. Should this extension define what particular AHardwareBuffer formats EGL |
| implementations are required to support? |
| |
| RESOLVED: No. |
| |
| The set of valid formats is implementation-specific and may depend on |
| additional EGL extensions. The particular valid combinations for a given |
| Android version and implementation should be documented by that version. |
| |
| Revision History |
| |
| #3 (Jesse Hall, October 11, 2017) |
| - Assigned extension number, fixed minor issues for publication |
| |
| #2 (Craig Donner, February 17, 2017) |
| - Fix typographical errors. |
| |
| #1 (Craig Donner, January 27, 2017) |
| - Initial draft. |
