xref: /aosp_15_r20/external/angle/extensions/EGL_ANGLE_platform_angle_opengl.txt (revision 8975f5c5ed3d1c378011245431ada316dfb6f244) 
1Name
2
3    ANGLE_platform_angle_opengl
4
5Name Strings
6
7    EGL_ANGLE_platform_angle_opengl
8
9Contributors
10
11    Shannon Woods, Google
12    Geoff Lang, Google
13    Courtney Goeltzenleuchter, Google
14
15Contacts
16
17    Geoff Lang, Google (geofflang 'at' chromium 'dot' org)
18
19Status
20
21    Draft
22
23Version
24
25    Version 4, 2018-05-17
26
27Number
28
29    EGL Extension XXX
30
31Extension Type
32
33    EGL client extension
34
35Dependencies
36
37    Requires ANGLE_platform_angle.
38
39Overview
40
41    This extension enables selection of OpenGL display types and,
42    for OpenGL ES display types, allows the application to pass
43    in a handle to the EGL library to use.
44
45New Types
46
47    None
48
49New Procedures and Functions
50
51    None
52
53New Tokens
54
55    Accepted as values for the EGL_PLATFORM_ANGLE_TYPE_ANGLE attribute:
56
57        EGL_PLATFORM_ANGLE_TYPE_OPENGL_ANGLE               0x320D
58        EGL_PLATFORM_ANGLE_TYPE_OPENGLES_ANGLE             0x320E
59
60    Accepted as an attribute name in the <attrib_list> argument of
61    eglGetPlatformDisplayEXT:
62        EGL_PLATFORM_ANGLE_EGL_HANDLE_ANGLE                0x3480
63
64Additions to the EGL Specification
65
66    None.
67
68New Behavior
69
70    To request a display that translates to OpenGL or OpenGL ES, the value of
71    EGL_PLATFORM_ANGLE_TYPE_ANGLE should be:
72      - EGL_PLATFORM_ANGLE_TYPE_OPENGL_ANGLE for an OpenGL display,
73      - EGL_PLATFORM_ANGLE_TYPE_OPENGLES_ANGLE for a native OpenGL ES display.
74
75    To request a specific maximum context version to use for the underlying
76    API, EGL_PLATFORM_ANGLE_MAX_VERSION_MAJOR_ANGLE and
77    EGL_PLATFORM_ANGLE_MAX_VERSION_MINOR_ANGLE can be used.
78
79    To pass in a handle to the system EGL library, use the attribute
80    EGL_PLATFORM_ANGLE_EGL_HANDLE_ANGLE. If EGL_PLATFORM_ANGLE_TYPE_ANGLE
81    is not equal to EGL_PLATFORM_ANGLE_TYPE_OPENGLES_ANGLE, an
82    EGL_BAD_ATTRIBUTE is generated. If the handle provided with
83    EGL_PLATFORM_ANGLE_EGL_HANDLE_ANGLE is not a valid EGL handle,
84    behaviour is undefined.
85
86Issues
87
88    None
89
90Revision History
91
92    Version 1, 2014-06-05 (Geoff Lang)
93      - Initial draft
94    Version 2, 2014-10-27 (Geoff Lang)
95      - Moved descriptions of platforms and major/minor versions from
96        EGL_ANGLE_platform_angle spec to EGL_ANGLE_platform_angle_opengl.
97    Version 3, 2014-11-26 (Geoff Lang)
98      - Updated enum values.
99    Version 4, 2018-05-17 (Courtney Goeltzenleuchter)
100      - Add attribute for specifying underlying EGL library.
101