• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Name
2
3    EGL_EXT_config_select_group
4
5Name Strings
6
7    EGL_EXT_config_select_group
8
9Contributors
10
11    Hal Gentz <zegentzy@protonmail.com>
12    Adam Jackson <ajax@redhat.com>
13    Robert Mader <robert.mader@posteo.de>
14
15Contacts
16
17    Hal Gentz <zegentzy@protonmail.com>
18
19Status
20
21    Draft
22
23Version
24
25    Version 4, 2021-06-24
26
27Number
28
29    EGL Extension #145
30
31Extension Type
32
33    EGL client extension
34
35Dependencies
36
37    This extension is written against the wording of the 2014.08.27 revision
38    of the EGL 1.5 Specification.
39
40Overview
41
42    This extension provides a mechanism to lower the config selection priority
43    of the configs returned by eglChooseConfig. A new config attribute is
44    introduced, providing a way for the implementation to group configs into
45    different config selection categories.  The config selection priorities of
46    all the configs in one category may be higher or lower than the ones in
47    other categories.  The config selection priorities in one category follow
48    the rules of eglChooseConfig. See also GLX_SGIX_visual_select_group.
49
50New Types
51
52    None
53
54New Procedures and Functions
55
56    None
57
58New Tokens
59
60    Accepted as a new EGLConfig attribute:
61
62        EGL_CONFIG_SELECT_GROUP_EXT                0x34C0
63
64Additions to the EGL 1.5 Specification
65
66    In section 3.4 "Configuration Management", under the "Buffer Descriptions
67    and Attributes" heading, append to table 3.1 the following:
68
69    "EGL_CONFIG_SELECT_GROUP_EXT | integer | the config select group"
70
71    In section 3.4 "Configuration Management", under the "Other EGLConfig
72    Attribute Descriptions" heading, append to the end the following:
73
74    "The attribute EGL_CONFIG_SELECT_GROUP_EXT is used to specify the config
75    selection category of the config. Configs in the i-th category have a higher
76    config selection priority than those found in the (i+1)-th category.
77
78    "The attribute EGL_CONFIG_SELECT_GROUP_EXT is used by the implementation to
79    override the default sorting rules, by collecting configurations into
80    groups. It is not accepted by the <attrib_list> parameter of
81    eglChooseConfig, but it is accepted as the <attribute> in
82    eglGetConfigAtrrib."
83
84    In section 3.4 "Configuration Management", under the "Sorting of EGLConfigs"
85    heading, append to table 3.4 the following:
86
87    "EGL_CONFIG_SELECT_GROUP_EXT | 0 | Ignore | Smaller | 0"
88
89    In section 3.4 "Configuration Management", under the "Sorting of EGLConfigs"
90    heading, append before the list entry which starts with "1. Special: by
91    EGL_CONFIG_CAVEAT" the following entry:
92
93    "0. Smaller EGL_CONFIG_SELECT_GROUP_EXT."
94
95Issues
96
97    None
98
99Revision History
100
101    Version 4, 2021-06-24 (Robert Mader)
102        - Moved to EXT, changed enum value to 0x34C0.
103
104    Version 3, 2020-04-06 (Robert Mader)
105        - Changed enum value to 0x31DF, added contributors.
106
107    Version 2, 2019-07-11 (Hal Gentz)
108        - Resolved issues pointed out by Adam Jackson.
109
110    Version 1, 2019-06-21 (Hal Gentz)
111        - Initial draft
112