• 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
61Additions to the EGL Specification
62
63    None
64
65New Behavior
66
67    To request a display that is backed by a specific graphics device,
68    EGL_PLATFORM_ANGLE_DEVICE_ID_HIGH_ANGLE and/or
69    EGL_PLATFORM_ANGLE_DEVICE_ID_LOW_ANGLE should be set to the high part and
70    low part of the device's ID. If only one attribute is specified, the other
71    is assumed to be zero. The device's ID is specific to the platform that
72    ANGLE is running on, but should fit into one 64-bit value.
73
74    If the high part and low part combined is zero, an EGL_BAD_ATTRIBUTE error
75    is generated and EGL_NO_DISPLAY is returned.
76
77    If the ID specified doesn't match any devices on the system, the device
78    is selected as described in the EGL_ANGLE_display_power_preference extension.
79
80Issues
81
82    None
83
84Revision History
85
86    Version 2, 2022-04-09 (Kimmo Kinnunen)
87      - Describe interaction with EGL_ANGLE_display_power_preference,
88        EGL_ANGLE_platform_angle_device_id takes precedence.
89
90    Version 1, 2021-12-14 (Jonah Ryan-Davis)
91      - Initial draft, based on EGL_ANGLE_platform_angle_d3d_luid
92