1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/gfx/angle/extensions/EGL_ANGLE_query_surface_pointer.txt Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,88 @@
1.4 +Name
1.5 +
1.6 + ANGLE_query_surface_pointer
1.7 +
1.8 +Name Strings
1.9 +
1.10 + EGL_ANGLE_query_surface_pointer
1.11 +
1.12 +Contributors
1.13 +
1.14 + Vladimir Vukicevic
1.15 + Daniel Koch
1.16 +
1.17 +Contacts
1.18 +
1.19 + Vladimir Vukicevic (vladimir 'at' pobox.com)
1.20 +
1.21 +Status
1.22 +
1.23 + Complete
1.24 + Implemented (ANGLE r558)
1.25 +
1.26 +Version
1.27 +
1.28 + Version 3, February 11, 2011
1.29 +
1.30 +Number
1.31 +
1.32 + EGL Extension #28
1.33 +
1.34 +Dependencies
1.35 +
1.36 + This extension is written against the wording of the EGL 1.4
1.37 + Specification.
1.38 +
1.39 +Overview
1.40 +
1.41 + This extension allows querying pointer-sized surface attributes,
1.42 + thus avoiding problems with coercing 64-bit pointers into a 32-bit
1.43 + integer.
1.44 +
1.45 +New Types
1.46 +
1.47 + None
1.48 +
1.49 +New Procedures and Functions
1.50 +
1.51 + EGLBoolean eglQuerySurfacePointerANGLE(
1.52 + EGLDisplay dpy,
1.53 + EGLSurface surface,
1.54 + EGLint attribute,
1.55 + void **value);
1.56 +
1.57 +New Tokens
1.58 +
1.59 + None
1.60 +
1.61 +Additions to Chapter 3 of the EGL 1.4 Specification (EGL Functions and Errors)
1.62 +
1.63 + Add to the end of the paragraph starting with "To query an
1.64 + attribute associated with an EGLSurface" in section 3.5.6,
1.65 + "Surface Attributes":
1.66 +
1.67 + "If the attribute type in table 3.5 is 'pointer', then
1.68 + eglQuerySurface returns EGL_FALSE and an EGL_BAD_PARAMETER error
1.69 + is generated. To query pointer attributes, call:
1.70 +
1.71 + EGLBoolean eglQuerySurfacePointerANGLE(
1.72 + EGLDisplay dpy,
1.73 + EGLSurface surface,
1.74 + EGLint attribute,
1.75 + void **value);
1.76 +
1.77 + eglQuerySurfacePointerANGLE behaves identically to eglQuerySurface,
1.78 + except that only attributes of type 'pointer' can be queried.
1.79 + If an attribute queried via eglQuerySurfacePointerANGLE is not
1.80 + of type 'pointer', then eglQuerySurfacePointer returns EGL_FALSE
1.81 + and an EGL_BAD_PARAMETER error is generated."
1.82 +
1.83 +Issues
1.84 +
1.85 +Revision History
1.86 +
1.87 + Version 3, 2011/02/11 - publish
1.88 +
1.89 + Version 2, 2010/12/21 - fix typos.
1.90 +
1.91 + Version 1, 2010/12/07 - first draft.
