11 Rob Clark <robdclark 'at' gmail.com>
12 Nicolai Hähnle <Nicolai.Haehnle 'at' amd.com>
16 Veluri Mithun <velurimithun38 'at' gmail.com>
36 When an application has to query the name of a driver and for
37 obtaining driver's option list (UTF-8 encoded XML) of a driver
38 the below functions are useful.
40 XML file formally describes all available options and also
41 includes verbal descriptions in multiple languages. Its main purpose
42 is to be automatically processed by configuration GUIs.
43 The XML shall respect the following DTD:
45 <!ELEMENT driinfo (section*)>
46 <!ELEMENT section (description+, option+)>
47 <!ELEMENT description (enum*)>
48 <!ATTLIST description lang CDATA #REQUIRED
50 <!ELEMENT option (description+)>
51 <!ATTLIST option name CDATA #REQUIRED
52 type (bool|enum|int|float) #REQUIRED
53 default CDATA #REQUIRED
56 <!ATTLIST enum value CDATA #REQUIRED
59 New Procedures and Functions
61 char* eglGetDisplayDriverConfig(EGLDisplay dpy);
62 const char* eglGetDisplayDriverName(EGLDisplay dpy);
66 By passing EGLDisplay as parameter to `eglGetDisplayDriverName` one can retrieve
67 driverName. Similarly passing EGLDisplay to `eglGetDisplayDriverConfig` we can retrieve
68 driverConfig options of the driver in XML format.
70 The string returned by `eglGetDisplayDriverConfig` is heap-allocated and caller
71 is responsible for freeing it.
73 EGL_BAD_DISPLAY is generated if `disp` is not an EGL display connection.
75 EGL_NOT_INITIALIZED is generated if `disp` has not been initialized.
77 If the implementation does not have enough resources to allocate the XML then an
78 EGL_BAD_ALLOC error is generated.
91 Version 1, 2018-11-05 - First draft (Veluri Mithun)
92 Version 2, 2019-01-23 - Final version (Veluri Mithun)
93 Version 3, 2019-01-24 - Mark as complete, add Khronos extension
94 number, fix parameter name in prototypes,
95 write revision history (Eric Engestrom)