NV_native_query

EGL_NV_native_query

Mathias Heyer, NVIDIA
Daniel Kartch, NVIDIA
Peter Pipkorn, NVIDIA
Acorn Pooley, NVIDIA
Greg Roth, NVIDIA

Peter Pipkorn, NVIDIA Corporation (ppipkorn 'at' nvidia.com)

Complete

Version 0.4, 25 Sept, 2012

EGL Extension #45

Requires EGL 1.0

This extension is written against the wording of the EGL 1.4
Specification.

This extension allows an application to query which native display,
pixmap and surface corresponds to a EGL object. 

EGLBoolean eglQueryNativeDisplayNV(
                        EGLDisplay dpy,
                        EGLNativeDisplayType* display_id);

EGLBoolean eglQueryNativeWindowNV(
                        EGLDisplay dpy,
                        EGLSurface surf,
                        EGLNativeWindowType* window);

EGLBoolean eglQueryNativePixmapNV(
                        EGLDisplay dpy,
                        EGLSurface surf,
                        EGLNativePixmapType* pixmap);

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.