src/egl/main/eglconfig.h

   1 #ifndef EGLCONFIG_INCLUDED
   2 #define EGLCONFIG_INCLUDED
   3
   4
   5 #include <assert.h>
   6 #include "egltypedefs.h"
   7
   8
   9 #define _EGL_CONFIG_FIRST_ATTRIB EGL_BUFFER_SIZE
  10 #define _EGL_CONFIG_LAST_ATTRIB EGL_CONFORMANT
  11 #define _EGL_CONFIG_NUM_ATTRIBS \
  12    (_EGL_CONFIG_LAST_ATTRIB - _EGL_CONFIG_FIRST_ATTRIB + 1)
  13
  14 #define _EGL_CONFIG_STORAGE_SIZE _EGL_CONFIG_NUM_ATTRIBS
  15
  16
  17 struct _egl_config
  18 {
  19    _EGLDisplay *Display;
  20    EGLint Storage[_EGL_CONFIG_STORAGE_SIZE];
  21 };
  22
  23
  24 /**
  25  * Macros for source level compatibility.
  26  */
  27 #define SET_CONFIG_ATTRIB(CONF, ATTR, VAL) _eglSetConfigKey(CONF, ATTR, VAL)
  28 #define GET_CONFIG_ATTRIB(CONF, ATTR) _eglGetConfigKey(CONF, ATTR)
  29
  30
  31 /**
  32  * Given a key, return an index into the storage of the config.
  33  * Return -1 if the key is invalid.
  34  */
  35 static INLINE EGLint
  36 _eglIndexConfig(const _EGLConfig *conf, EGLint key)
  37 {
  38    (void) conf;
  39    if (key >= _EGL_CONFIG_FIRST_ATTRIB &&
  40        key < _EGL_CONFIG_FIRST_ATTRIB + _EGL_CONFIG_NUM_ATTRIBS)
  41       return key - _EGL_CONFIG_FIRST_ATTRIB;
  42    else
  43       return -1;
  44 }
  45
  46
  47 /**
  48  * Reset all keys in the config to a given value.
  49  */
  50 static INLINE void
  51 _eglResetConfigKeys(_EGLConfig *conf, EGLint val)
  52 {
  53    EGLint i;
  54    for (i = 0; i < _EGL_CONFIG_NUM_ATTRIBS; i++)
  55       conf->Storage[i] = val;
  56 }
  57
  58
  59 /**
  60  * Update a config for a given key.
  61  *
  62  * Note that a valid key is not necessarily a valid attribute.  There are gaps
  63  * in the attribute enums.  The separation is to catch application errors.
  64  * Drivers should never set a key that is an invalid attribute.
  65  */
  66 static INLINE void
  67 _eglSetConfigKey(_EGLConfig *conf, EGLint key, EGLint val)
  68 {
  69    EGLint idx = _eglIndexConfig(conf, key);
  70    assert(idx >= 0);
  71    conf->Storage[idx] = val;
  72 }
  73
  74
  75 /**
  76  * Return the value for a given key.
  77  */
  78 static INLINE EGLint
  79 _eglGetConfigKey(const _EGLConfig *conf, EGLint key)
  80 {
  81    EGLint idx = _eglIndexConfig(conf, key);
  82    assert(idx >= 0);
  83    return conf->Storage[idx];
  84 }
  85
  86
  87 PUBLIC void
  88 _eglInitConfig(_EGLConfig *config, _EGLDisplay *dpy, EGLint id);
  89
  90
  91 PUBLIC EGLConfig
  92 _eglAddConfig(_EGLDisplay *dpy, _EGLConfig *conf);
  93
  94
  95 extern EGLBoolean
  96 _eglCheckConfigHandle(EGLConfig config, _EGLDisplay *dpy);
  97
  98
  99 /**
 100  * Lookup a handle to find the linked config.
 101  * Return NULL if the handle has no corresponding linked config.
 102  */
 103 static INLINE _EGLConfig *
 104 _eglLookupConfig(EGLConfig config, _EGLDisplay *dpy)
 105 {
 106    _EGLConfig *conf = (_EGLConfig *) config;
 107    if (!_eglCheckConfigHandle(config, dpy))
 108       conf = NULL;
 109    return conf;
 110 }
 111
 112
 113 /**
 114  * Return the handle of a linked config, or NULL.
 115  */
 116 static INLINE EGLConfig
 117 _eglGetConfigHandle(_EGLConfig *conf)
 118 {
 119    return (EGLConfig) ((conf && conf->Display) ? conf : NULL);
 120 }
 121
 122
 123 PUBLIC EGLBoolean
 124 _eglValidateConfig(const _EGLConfig *conf, EGLBoolean for_matching);
 125
 126
 127 PUBLIC EGLBoolean
 128 _eglMatchConfig(const _EGLConfig *conf, const _EGLConfig *criteria);
 129
 130
 131 PUBLIC EGLBoolean
 132 _eglParseConfigAttribList(_EGLConfig *conf, const EGLint *attrib_list);
 133
 134
 135 PUBLIC EGLint
 136 _eglCompareConfigs(const _EGLConfig *conf1, const _EGLConfig *conf2,
 137                    const _EGLConfig *criteria, EGLBoolean compare_id);
 138
 139
 140 PUBLIC void
 141 _eglSortConfigs(const _EGLConfig **configs, EGLint count,
 142                 EGLint (*compare)(const _EGLConfig *, const _EGLConfig *,
 143                                   void *),
 144                 void *priv_data);
 145
 146
 147 extern EGLBoolean
 148 _eglChooseConfig(_EGLDriver *drv, _EGLDisplay *dpy, const EGLint *attrib_list, EGLConfig *configs, EGLint config_size, EGLint *num_config);
 149
 150
 151 extern EGLBoolean
 152 _eglGetConfigAttrib(_EGLDriver *drv, _EGLDisplay *dpy, _EGLConfig *conf, EGLint attribute, EGLint *value);
 153
 154
 155 extern EGLBoolean
 156 _eglGetConfigs(_EGLDriver *drv, _EGLDisplay *dpy, EGLConfig *configs, EGLint config_size, EGLint *num_config);
 157
 158
 159 #endif /* EGLCONFIG_INCLUDED */