xref: /aosp_15_r20/external/angle/extensions/EGL_ANGLE_display_power_preference.txt (revision 8975f5c5ed3d1c378011245431ada316dfb6f244)
1Name
2
3    ANGLE_display_power_preference
4
5Name Strings
6
7    EGL_ANGLE_display_power_preference
8
9Contributors
10
11    Kenneth Russell
12    Jonah Ryan-Davis
13
14Contacts
15
16    Kenneth Russell, Google Inc. (kbr 'at' google.com)
17    Jonah Ryan-Davis, Google Inc. (jonahr 'at' google.com)
18
19Status
20
21    Draft
22
23Version
24
25    Version 1, Oct 20, 2021
26
27Number
28
29    EGL Extension #??
30
31Extension Type
32
33    EGL client extension
34
35Dependencies
36
37    This extension is written against the wording of the EGL 1.4
38    Specification.
39
40Overview
41
42    This extension allows selection of the high- or low-power GPU on
43    dual-GPU systems, specifically on macOS.
44
45New Types
46
47    None
48
49New Tokens
50
51    Accepted as an attribute name in the <attrib_list> argument to
52    eglGetPlatformDisplayEXT:
53
54        EGL_POWER_PREFERENCE_ANGLE  0x3482
55
56    Accepted as an attribute value in the <attrib_list> argument to
57    eglGetPlatformDisplayEXT:
58
59        EGL_LOW_POWER_ANGLE         0x0001
60        EGL_HIGH_POWER_ANGLE        0x0002
61
62Additions to the EGL 1.4 Specification
63
64    Add the following to section 3.7.1 "Creating Rendering Contexts":
65
66    EGL_POWER_PREFERENCE_ANGLE indicates whether the display should be
67    created on the integrated (low-power) or discrete (high-power) GPU
68    on dual-GPU systems. EGL_POWER_PREFERENCE_ANGLE is only a legal
69    display creation attribute when the EGL_ANGLE_power_preference
70    extension is advertised. The valid values for this attribute are
71    EGL_LOW_POWER_ANGLE and EGL_HIGH_POWER_ANGLE. If this extension is
72    advertised and this display creation attribute is not specified,
73    the default value is EGL_LOW_POWER_ANGLE.
74
75Issues
76
77    None yet.
78
79Revision History
80
81    Rev.    Date         Author     Changes
82    ----  -------------  ---------  ----------------------------------------
83      1   Oct 20, 2021   jonahr     Extension based off
84                                      EGL_ANGLE_power_preference
85