forked from Qortal/Brooklyn
96 lines
2.5 KiB
Plaintext
96 lines
2.5 KiB
Plaintext
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)
|