diff options
Diffstat (limited to 'glew/auto/EGL-Registry/extensions/KHR/EGL_KHR_platform_android.txt')
-rw-r--r-- | glew/auto/EGL-Registry/extensions/KHR/EGL_KHR_platform_android.txt | 102 |
1 files changed, 102 insertions, 0 deletions
diff --git a/glew/auto/EGL-Registry/extensions/KHR/EGL_KHR_platform_android.txt b/glew/auto/EGL-Registry/extensions/KHR/EGL_KHR_platform_android.txt new file mode 100644 index 0000000..6568b64 --- /dev/null +++ b/glew/auto/EGL-Registry/extensions/KHR/EGL_KHR_platform_android.txt @@ -0,0 +1,102 @@ +Name + + KHR_platform_android + +Name Strings + + EGL_KHR_platform_android + +Contributors + + Jesse Hall <jessehall 'at' google.com> + The contributors to the EGL_KHR_platform_gbm extension, which this + extension was based on. + +Contacts + + Jesse Hall <jessehall 'at' google.com> + +Status + + Complete. + Approved by the EGL Working Group on January 31, 2014. + Ratified by the Khronos Board of Promoters on March 14, 2014. + +Version + + Version 1, 2014/01/27 + +Number + + EGL Extension #68 + +Extension Type + + EGL client extension + +Dependencies + + EGL 1.5 is required. + + This extension is written against the EGL 1.5 Specification (draft + 20140122). + +Overview + + This extension defines how to create EGL resources from native Android + resources using the EGL 1.5 platform functionality. + +New Types + + None + +New Procedures and Functions + + None + +New Tokens + + Accepted as the <platform> argument of eglGetPlatformDisplay: + + EGL_PLATFORM_ANDROID_KHR 0x3141 + +Additions to the EGL Specification + + None. + +New Behavior + + To determine if the EGL implementation supports this extension, clients + should query the EGL_EXTENSIONS string of EGL_NO_DISPLAY. + + To obtain an EGLDisplay for the Android device, call eglGetPlatformDisplay + with <platform> set to EGL_PLATFORM_ANDROID_KHR and with <native_display> + set to EGL_DEFAULT_DISPLAY. + + For each EGLConfig that belongs to the Android platform, the + EGL_NATIVE_VISUAL_ID attribute is an Android window format, such as + WINDOW_FORMAT_RGBA_8888. + + To obtain a rendering surface from an Android native window, call + eglCreatePlatformWindowSurface with a <dpy> that belongs to the Android + platform and a <native_window> that points to a ANativeWindow. + + It is not valid to call eglCreatePlatformPixmapSurface with a <dpy> that + belongs to the Android platform. Any such call fails and generates + an EGL_BAD_PARAMETER error. + +Issues + + 1. Should this extension even exist? Android devices only support one + window system. + + RESOLUTION: Yes. Although the Android Open Source Project master branch + only supports one window system, customized versions of Android could + extend that to support other window systems. More importantly, having a + platform extension allows EGL 1.5 applications to use the platform and + non-platform Get*Display and Create*WindowSurface calls interchangeably. As a user of the API it would be confusing if that didn't work. + +Revision History + + Version 1, 2014/01/27 (Jesse Hall) + - Initial draft. |