daniel@transgaming.com | 6cfe678 | 2011-04-06 18:45:47 +0000 | [diff] [blame] | 1 | Name |
| 2 | |
| 3 | ANGLE_query_surface_pointer |
| 4 | |
| 5 | Name Strings |
| 6 | |
| 7 | EGL_ANGLE_query_surface_pointer |
| 8 | |
| 9 | Contributors |
| 10 | |
| 11 | Vladimir Vukicevic |
| 12 | Daniel Koch |
| 13 | |
| 14 | Contacts |
| 15 | |
| 16 | Vladimir Vukicevic (vladimir 'at' pobox.com) |
| 17 | |
| 18 | Status |
| 19 | |
| 20 | Complete |
| 21 | Implemented (ANGLE r558) |
| 22 | |
| 23 | Version |
| 24 | |
| 25 | Version 3, February 11, 2011 |
| 26 | |
| 27 | Number |
| 28 | |
daniel@transgaming.com | c6489b1 | 2012-01-17 14:28:13 +0000 | [diff] [blame^] | 29 | EGL Extension #28 |
daniel@transgaming.com | 6cfe678 | 2011-04-06 18:45:47 +0000 | [diff] [blame] | 30 | |
| 31 | Dependencies |
| 32 | |
| 33 | This extension is written against the wording of the EGL 1.4 |
| 34 | Specification. |
| 35 | |
| 36 | Overview |
| 37 | |
| 38 | This extension allows querying pointer-sized surface attributes, |
| 39 | thus avoiding problems with coercing 64-bit pointers into a 32-bit |
| 40 | integer. |
| 41 | |
| 42 | New Types |
| 43 | |
| 44 | None |
| 45 | |
| 46 | New Procedures and Functions |
| 47 | |
| 48 | EGLBoolean eglQuerySurfacePointerANGLE( |
| 49 | EGLDisplay dpy, |
| 50 | EGLSurface surface, |
| 51 | EGLint attribute, |
| 52 | void **value); |
| 53 | |
| 54 | New Tokens |
| 55 | |
| 56 | None |
| 57 | |
| 58 | Additions to Chapter 3 of the EGL 1.4 Specification (EGL Functions and Errors) |
| 59 | |
| 60 | Add to the end of the paragraph starting with "To query an |
| 61 | attribute associated with an EGLSurface" in section 3.5.6, |
| 62 | "Surface Attributes": |
| 63 | |
| 64 | "If the attribute type in table 3.5 is 'pointer', then |
| 65 | eglQuerySurface returns EGL_FALSE and an EGL_BAD_PARAMETER error |
| 66 | is generated. To query pointer attributes, call: |
| 67 | |
| 68 | EGLBoolean eglQuerySurfacePointerANGLE( |
| 69 | EGLDisplay dpy, |
| 70 | EGLSurface surface, |
| 71 | EGLint attribute, |
| 72 | void **value); |
| 73 | |
| 74 | eglQuerySurfacePointerANGLE behaves identically to eglQuerySurface, |
| 75 | except that only attributes of type 'pointer' can be queried. |
| 76 | If an attribute queried via eglQuerySurfacePointerANGLE is not |
| 77 | of type 'pointer', then eglQuerySurfacePointer returns EGL_FALSE |
| 78 | and an EGL_BAD_PARAMETER error is generated." |
| 79 | |
| 80 | Issues |
| 81 | |
| 82 | Revision History |
| 83 | |
| 84 | Version 3, 2011/02/11 - publish |
| 85 | |
| 86 | Version 2, 2010/12/21 - fix typos. |
| 87 | |
| 88 | Version 1, 2010/12/07 - first draft. |