xref: /aosp_15_r20/external/angle/extensions/EGL_ANGLE_query_surface_pointer.txt (revision 8975f5c5ed3d1c378011245431ada316dfb6f244)
1Name
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
29    EGL Extension #28
30
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.
89