blob: 75126fcbc31d7ddd578d279ea69ba9945d2659d2 [file] [log] [blame]
daniel@transgaming.com559f51c2011-04-06 18:45:47 +00001Name
2
3 ANGLE_query_surface_pointer
4
5Name Strings
6
7 EGL_ANGLE_query_surface_pointer
8
9Contributors
10
11 Vladimir Vukicevic
12 Daniel Koch
13
14Contacts
15
16 Vladimir Vukicevic (vladimir 'at' pobox.com)
17
18Status
19
20 Complete
21 Implemented (ANGLE r558)
22
23Version
24
25 Version 3, February 11, 2011
26
27Number
28
daniel@transgaming.com55693832012-01-17 14:28:13 +000029 EGL Extension #28
daniel@transgaming.com559f51c2011-04-06 18:45:47 +000030
31Dependencies
32
33 This extension is written against the wording of the EGL 1.4
34 Specification.
35
36Overview
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
42New Types
43
44 None
45
46New Procedures and Functions
47
48 EGLBoolean eglQuerySurfacePointerANGLE(
49 EGLDisplay dpy,
50 EGLSurface surface,
51 EGLint attribute,
52 void **value);
53
54New Tokens
55
56 None
57
58Additions 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
80Issues
81
82Revision 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.