1Name
2
3    ANGLE_vulkan_display
4
5Name Strings
6
7    EGL_ANGLE_vulkan_display
8
9Contributors
10
11    Xiaoxuan Liu, Arm Ltd.
12    Sunny Sun, Arm Ltd.
13
14Contacts
15
16    Xiaoxuan Liu, Arm Ltd. (xiaoxuan 'dot' liu 'at' arm 'dot' com)
17
18Status
19
20    Draft
21
22Version
23
24    Version 1, 2020-10-29
25
26Number
27
28    EGL Extension XXX
29
30Extension Type
31
32    EGL client extension
33
34Dependencies
35
36    Requires EGL_EXT_platform_angle_vulkan.
37
38Overview
39
40    This extension allows ANGLE to use simple display mode through
41    VK_KHR_display without native platform support (e.g. X11, GBM).
42    The EGLSurfaces to be created from native types only contain the
43    basic width and height info.
44
45New Types
46
47    The basic structure to represent a display window, used by vulkan
48    backend to create valid display with VK_KHR_display.
49
50        typedef struct displayWindow
51        {
52            khronos_uint16_t width;
53            khronos_uint16_t height;
54        } DisplayWindow;
55
56New Procedures and Functions
57
58    None
59
60New Tokens
61
62    Accepted as values for the EGL_PLATFORM_ANGLE_NATIVE_PLATFORM_TYPE_ANGLE
63    attribute:
64
65        EGL_PLATFORM_VULKAN_DISPLAY_MODE_SIMPLE_ANGLE 0x34A4
66        EGL_PLATFORM_VULKAN_DISPLAY_MODE_HEADLESS_ANGLE 0x34A5
67
68Additions to the EGL Specification
69
70    None
71
72New Behavior
73
74    To obtain an simple EGLDisplay backed by a ANGLE vulkan with
75    VK_KHR_display, request a display that is backed by a Vulkan driver
76    through EGL_ANGLE_platform_angle_vulkan. And the value of attribute
77    EGL_PLATFORM_ANGLE_NATIVE_PLATFORM_TYPE_ANGLE should be
78    EGL_PLATFORM_VULKAN_DISPLAY_MODE_SIMPLE_ANGLE or
79    EGL_PLATFORM_VULKAN_DISPLAY_MODE_HEADLESS_ANGLE.
80
81    If an EGLDisplay is backed by  ANGLE vulkan VK_KHR_display and the
82    value of attribute EGL_PLATFORM_ANGLE_NATIVE_PLATFORM_TYPE_ANGLE is
83    set but neither EGL_PLATFORM_VULKAN_DISPLAY_MODE_SIMPLE_ANGLE or
84    EGL_PLATFORM_VULKAN_DISPLAY_MODE_HEADLESS_ANGLE, then EGL_NO_DISPLAY
85    should be returned.
86
87Issues
88
89    None
90
91Revision History
92
93    Version 1, 2020-10-29 (Xiaoxuan Liu)
94      - Initial draft
95
96