michael@0: Name
michael@0: 
michael@0:     ANGLE_query_surface_pointer
michael@0: 
michael@0: Name Strings
michael@0: 
michael@0:     EGL_ANGLE_query_surface_pointer
michael@0: 
michael@0: Contributors
michael@0: 
michael@0:     Vladimir Vukicevic
michael@0:     Daniel Koch
michael@0: 
michael@0: Contacts
michael@0: 
michael@0:     Vladimir Vukicevic (vladimir 'at' pobox.com)
michael@0: 
michael@0: Status
michael@0: 
michael@0:     Complete
michael@0:     Implemented (ANGLE r558)
michael@0: 
michael@0: Version
michael@0: 
michael@0:     Version 3, February 11, 2011
michael@0: 
michael@0: Number
michael@0: 
michael@0:     EGL Extension #28
michael@0: 
michael@0: Dependencies
michael@0: 
michael@0:     This extension is written against the wording of the EGL 1.4
michael@0:     Specification. 
michael@0: 
michael@0: Overview
michael@0: 
michael@0:     This extension allows querying pointer-sized surface attributes,
michael@0:     thus avoiding problems with coercing 64-bit pointers into a 32-bit
michael@0:     integer.
michael@0: 
michael@0: New Types
michael@0: 
michael@0:     None
michael@0: 
michael@0: New Procedures and Functions
michael@0: 
michael@0:     EGLBoolean eglQuerySurfacePointerANGLE(
michael@0:                         EGLDisplay dpy,
michael@0:                         EGLSurface surface,
michael@0:                         EGLint attribute,
michael@0:                         void **value);
michael@0: 
michael@0: New Tokens
michael@0: 
michael@0:     None
michael@0: 
michael@0: Additions to Chapter 3 of the EGL 1.4 Specification (EGL Functions and Errors)
michael@0: 
michael@0:     Add to the end of the paragraph starting with "To query an
michael@0:     attribute associated with an EGLSurface" in section 3.5.6,
michael@0:     "Surface Attributes":
michael@0: 
michael@0:     "If the attribute type in table 3.5 is 'pointer', then
michael@0:     eglQuerySurface returns EGL_FALSE and an EGL_BAD_PARAMETER error
michael@0:     is generated.  To query pointer attributes, call:
michael@0: 
michael@0:          EGLBoolean eglQuerySurfacePointerANGLE(
michael@0:                              EGLDisplay dpy,
michael@0:                              EGLSurface surface,
michael@0:                              EGLint attribute,
michael@0:                              void **value);
michael@0: 
michael@0:      eglQuerySurfacePointerANGLE behaves identically to eglQuerySurface,
michael@0:      except that only attributes of type 'pointer' can be queried.
michael@0:      If an attribute queried via eglQuerySurfacePointerANGLE is not
michael@0:      of type 'pointer', then eglQuerySurfacePointer returns EGL_FALSE
michael@0:      and an EGL_BAD_PARAMETER error is generated."
michael@0: 
michael@0: Issues
michael@0: 
michael@0: Revision History
michael@0: 
michael@0:     Version 3, 2011/02/11 - publish
michael@0: 
michael@0:     Version 2, 2010/12/21 - fix typos.
michael@0: 
michael@0:     Version 1, 2010/12/07 - first draft.