xref: /aosp_15_r20/external/angle/extensions/EGL_ANGLE_platform_angle_vulkan.txt (revision 8975f5c5ed3d1c378011245431ada316dfb6f244)
1Name
2
3    ANGLE_platform_angle_vulkan
4
5Name Strings
6
7    EGL_ANGLE_platform_angle_vulkan
8
9Contributors
10
11    Jamie Madill, Google
12
13Contacts
14
15    Jamie Madill, Google (jmadill 'at' google 'dot' com)
16
17Status
18
19    Draft
20
21Version
22
23    Version 2, 2017-07-19
24
25Number
26
27    EGL Extension XXX
28
29Extension Type
30
31    EGL client extension
32
33Dependencies
34
35    Requires ANGLE_platform_angle.
36
37Overview
38
39    This extension enables selection of Vulkan display types.
40
41New Types
42
43    None
44
45New Procedures and Functions
46
47    None
48
49New Tokens
50
51    Accepted as values for the EGL_PLATFORM_ANGLE_TYPE_ANGLE attribute:
52
53        EGL_PLATFORM_ANGLE_TYPE_VULKAN_ANGLE               0x3450
54
55Additions to the EGL Specification
56
57    None.
58
59New Behavior
60
61    To request a display that is backed by a Vulkan driver, the value of
62    EGL_PLATFORM_ANGLE_TYPE_ANGLE should be
63    EGL_PLATFORM_ANGLE_TYPE_VULKAN_ANGLE.
64
65    If EGL_PLATFORM_ANGLE_MAX_VERSION_MAJOR_ANGLE and
66    EGL_PLATFORM_ANGLE_MAX_VERSION_MINOR_ANGLE are not specified, the
67    implementation will decide which version of Vulkan to instantiate. If they
68    are specified, it will choose a version that is lower or equal to the
69    specified major and minor versions. The only current values accepted for
70    major and minor version are 1 for major and 0 for minor.
71
72Issues
73
74    1) Should ANGLE always instantiate the highest available version of Vulkan?
75
76       RESOLVED: It's possible that in a future implementation of Vulkan there
77       may be driver issues present only on some version of Vulkan, and there's
78       no explicit guarantee higher versions will be more stable. Hence, we should
79       give ANGLE some flexiblity in this regard and leave this unspecified.
80
81Revision History
82
83    Version 1, 2016-11-17 (Jamie Madill)
84      - Initial draft
85    Version 2, 2017-07-19 (Jamie Madill)
86      - Moved debug layer control to EGL_ANGLE_platform_angle
87