forked from Qortal/Brooklyn
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
95 lines
2.5 KiB
95 lines
2.5 KiB
Name |
|
|
|
MESA_query_driver |
|
|
|
Name Strings |
|
|
|
EGL_MESA_query_driver |
|
|
|
Contact |
|
|
|
Rob Clark <robdclark 'at' gmail.com> |
|
Nicolai Hähnle <Nicolai.Haehnle 'at' amd.com> |
|
|
|
Contibutors |
|
|
|
Veluri Mithun <velurimithun38 'at' gmail.com> |
|
|
|
Status |
|
|
|
Complete |
|
|
|
Version |
|
|
|
Version 3, 2019-01-24 |
|
|
|
Number |
|
|
|
EGL Extension 131 |
|
|
|
Dependencies |
|
|
|
EGL 1.0 is required. |
|
|
|
Overview |
|
|
|
When an application has to query the name of a driver and for |
|
obtaining driver's option list (UTF-8 encoded XML) of a driver |
|
the below functions are useful. |
|
|
|
XML file formally describes all available options and also |
|
includes verbal descriptions in multiple languages. Its main purpose |
|
is to be automatically processed by configuration GUIs. |
|
The XML shall respect the following DTD: |
|
|
|
<!ELEMENT driinfo (section*)> |
|
<!ELEMENT section (description+, option+)> |
|
<!ELEMENT description (enum*)> |
|
<!ATTLIST description lang CDATA #REQUIRED |
|
text CDATA #REQUIRED> |
|
<!ELEMENT option (description+)> |
|
<!ATTLIST option name CDATA #REQUIRED |
|
type (bool|enum|int|float) #REQUIRED |
|
default CDATA #REQUIRED |
|
valid CDATA #IMPLIED> |
|
<!ELEMENT enum EMPTY> |
|
<!ATTLIST enum value CDATA #REQUIRED |
|
text CDATA #REQUIRED> |
|
|
|
New Procedures and Functions |
|
|
|
char* eglGetDisplayDriverConfig(EGLDisplay dpy); |
|
const char* eglGetDisplayDriverName(EGLDisplay dpy); |
|
|
|
Description |
|
|
|
By passing EGLDisplay as parameter to `eglGetDisplayDriverName` one can retrieve |
|
driverName. Similarly passing EGLDisplay to `eglGetDisplayDriverConfig` we can retrieve |
|
driverConfig options of the driver in XML format. |
|
|
|
The string returned by `eglGetDisplayDriverConfig` is heap-allocated and caller |
|
is responsible for freeing it. |
|
|
|
EGL_BAD_DISPLAY is generated if `disp` is not an EGL display connection. |
|
|
|
EGL_NOT_INITIALIZED is generated if `disp` has not been initialized. |
|
|
|
If the implementation does not have enough resources to allocate the XML then an |
|
EGL_BAD_ALLOC error is generated. |
|
|
|
New Tokens |
|
|
|
No new tokens |
|
|
|
Issues |
|
|
|
None |
|
|
|
|
|
Revision History |
|
|
|
Version 1, 2018-11-05 - First draft (Veluri Mithun) |
|
Version 2, 2019-01-23 - Final version (Veluri Mithun) |
|
Version 3, 2019-01-24 - Mark as complete, add Khronos extension |
|
number, fix parameter name in prototypes, |
|
write revision history (Eric Engestrom)
|
|
|