diff options
Diffstat (limited to 'glew/auto/EGL-Registry/extensions/NV/EGL_NV_native_query.txt')
-rw-r--r-- | glew/auto/EGL-Registry/extensions/NV/EGL_NV_native_query.txt | 137 |
1 files changed, 137 insertions, 0 deletions
diff --git a/glew/auto/EGL-Registry/extensions/NV/EGL_NV_native_query.txt b/glew/auto/EGL-Registry/extensions/NV/EGL_NV_native_query.txt new file mode 100644 index 0000000..ce35633 --- /dev/null +++ b/glew/auto/EGL-Registry/extensions/NV/EGL_NV_native_query.txt @@ -0,0 +1,137 @@ +Name + + NV_native_query + +Name Strings + + EGL_NV_native_query + +Contributors + + Mathias Heyer, NVIDIA + Daniel Kartch, NVIDIA + Peter Pipkorn, NVIDIA + Acorn Pooley, NVIDIA + Greg Roth, NVIDIA + +Contacts + + Peter Pipkorn, NVIDIA Corporation (ppipkorn 'at' nvidia.com) + +Status + + Complete + +Version + + Version 0.4, 25 Sept, 2012 + +Number + + EGL Extension #45 + +Dependencies + + Requires EGL 1.0 + + This extension is written against the wording of the EGL 1.4 + Specification. + +Overview + + This extension allows an application to query which native display, + pixmap and surface corresponds to a EGL object. + +New Procedures and Functions + + EGLBoolean eglQueryNativeDisplayNV( + EGLDisplay dpy, + EGLNativeDisplayType* display_id); + + EGLBoolean eglQueryNativeWindowNV( + EGLDisplay dpy, + EGLSurface surf, + EGLNativeWindowType* window); + + EGLBoolean eglQueryNativePixmapNV( + EGLDisplay dpy, + EGLSurface surf, + EGLNativePixmapType* pixmap); + +Changes to Chapter 3 of the EGL 1.4 Specification (EGL Functions and Errors) + + In Chapter 3.2, after the description of eglInitialize and before the + description of eglTerminate insert + + "While initialized, the native display that corresponds to an + EGLDisplay can retrieved by + + EGLBoolean eglQueryNativeDisplayNV( + EGLDisplay dpy, + EGLNativeDisplayType* display_id); + + If the <dpy> is a valid and initialized EGLDisplay, EGL_TRUE + will be returned and the native display handle will be written + to <display_id>. Otherwise EGL_FALSE will be returned and the + contents of <display_id> are left untouched. If the <dpy> is + not valid, an EGL_BAD_DISPLAY error will be generated. If <dpy> + is not initialized, an EGL_NOT_INITIALIZED error will be + generated. If <display_id> is NULL, an EGL_BAD_PARAMETER error + will be generated. + + In Chapter 3.5 Rendering Surfaces, after section 3.5.1 insert + + "The native window that corresponds to an EGLSurface can be + retrieved by + + EGLBoolean eglQueryNativeWindowNV( + EGLDisplay dpy, + EGLSurface surf, + EGLNativeWindowType* win); + + The corresponding native window will be written to <win>, + and EGL_TRUE will be returned. If the call fails, EGL_FALSE + will be returned, and content of <win> will not be modified. + If <dpy> is not a valid EGLDisplay, an EGL_BAD_DISPLAY error + will be generated. If <dpy> is not initialized, an EGL_NOT_- + INITIALIZED error will be generated. If <surf> is not a valid + EGLSurface, or <surf> does not have a corresponding native + window, an EGL_BAD_SURFACE error will be generated." If <win> + is NULL, an EGL_BAD_PARAMETER error will be generated. + + After section 3.5.4 Creating Native Pixmap Rendering Surfaces insert + + "The native pixmap that corresponds to an EGLSurface can be + retrieved by + + EGLBoolean eglQueryNativePixmapNV( + EGLDisplay dpy, + EGLSurface surf, + EGLNativePixmapType* pixmap); + + The corresponding native pixmap will be written to <pixmap>, + and EGL_TRUE will be returned. If the call fails, EGL_FALSE + will be returned, and the content of <pixmap> will not be + modified. If <dpy> is not a valid EGLDisplay, an EGL_BAD_- + DISPLAY error will be generated. If <dpy> is not initialized, + an EGL_NOT_INITIALIZED error will be generated. If <surf> is + not a valid EGLSurface, or <surf> does not have a corresponding + native pixmap, an EGL_BAD_SURFACE error will be generated." If + <pixmap> is NULL, an EGL_BAD_PARAMETER error will be + generated. + +Issues + +Revision History +#4 (Greg Roth, Sept 25, 2012) + - Further document all potential errors for all functions + +#3 (Daniel Kartch, August 30, 2011) + - Add restriction that EGLDisplay be initialized + +#2 (Peter Pipkorn, December 16, 2009) + - Minor cleanup + +#1 (Peter Pipkorn, December 15, 2009) + - First Draft + |