• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Name
2
3    ANGLE_platform_angle_device_id
4
5Name Strings
6
7    EGL_ANGLE_platform_angle_device_id
8
9Contributors
10
11    Jonah Ryan-Davis, Google
12    Kimmo Kinnunen, Apple
13
14Contacts
15
16    Jonah Ryan-Davis, Google (jonahr 'at' google.com)
17
18Status
19
20    Draft
21
22Version
23
24    Version 2, 2022-04-09
25
26Number
27
28    EGL Extension XXX
29
30Extension Type
31
32    EGL client extension
33
34Dependencies
35
36    Requires ANGLE_platform_angle.
37
38    EGL_ANGLE_display_power_preference interacts with this extension.
39
40Overview
41
42    This extension enables the selection of a graphics device to back
43    an ANGLE EGLDisplay.
44
45New Types
46
47    None
48
49New Procedures and Functions
50
51    None
52
53New Tokens
54
55    Accepted as an attribute name in the <attrib_list> argument of
56    eglGetPlatformDisplayEXT:
57
58        EGL_PLATFORM_ANGLE_DEVICE_ID_HIGH_ANGLE          0x34D6
59        EGL_PLATFORM_ANGLE_DEVICE_ID_LOW_ANGLE           0x34D7
60        EGL_PLATFORM_ANGLE_DISPLAY_KEY_ANGLE             0x34DC
61
62Additions to the EGL Specification
63
64    None
65
66New Behavior
67
68    To request a display that is backed by a specific graphics device,
69    EGL_PLATFORM_ANGLE_DEVICE_ID_HIGH_ANGLE and/or
70    EGL_PLATFORM_ANGLE_DEVICE_ID_LOW_ANGLE should be set to the high part and
71    low part of the device's ID. If only one attribute is specified, the other
72    is assumed to be zero. The device's ID is specific to the platform that
73    ANGLE is running on, but should fit into one 64-bit value.
74
75    If the high part and low part combined is zero, an EGL_BAD_ATTRIBUTE error
76    is generated and EGL_NO_DISPLAY is returned.
77
78    If the ID specified doesn't match any devices on the system, the device
79    is selected as described in the EGL_ANGLE_display_power_preference extension.
80
81    To select a distinct display on a graphics device that may already have
82    an existing display in ANGLE's cache, use EGL_PLATFORM_ANGLE_DISPLAY_KEY_ANGLE
83    to add a key to the cache entry for this display. The same cached display can
84    be re-requested by specifying the same cache value. If this parameter is not
85    included, the default value used will be 0.
86
87Issues
88
89    None
90
91Revision History
92
93    Version 3, 2023-02-15
94      - Add EGL_PLATFORM_ANGLE_DISPLAY_KEY_ANGLE to allow selection of
95        multiple EGLDisplays from the same graphics device.
96
97    Version 2, 2022-04-09 (Kimmo Kinnunen)
98      - Describe interaction with EGL_ANGLE_display_power_preference,
99        EGL_ANGLE_platform_angle_device_id takes precedence.
100
101    Version 1, 2021-12-14 (Jonah Ryan-Davis)
102      - Initial draft, based on EGL_ANGLE_platform_angle_d3d_luid
103