| 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) |
