1/**************************************************************************
2 *
3 * Copyright 2008 VMware, Inc.
4 * Copyright 2009-2010 Chia-I Wu <olvaffe@gmail.com>
5 * Copyright 2010-2011 LunarG, Inc.
6 * All Rights Reserved.
7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the
10 * "Software"), to deal in the Software without restriction, including
11 * without limitation the rights to use, copy, modify, merge, publish,
12 * distribute, sub license, and/or sell copies of the Software, and to
13 * permit persons to whom the Software is furnished to do so, subject to
14 * the following conditions:
15 *
16 * The above copyright notice and this permission notice (including the
17 * next paragraph) shall be included in all copies or substantial portions
18 * of the Software.
19 *
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
23 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
25 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
26 * DEALINGS IN THE SOFTWARE.
27 *
28 **************************************************************************/
29
30
31#ifndef EGLCONFIG_INCLUDED
32#define EGLCONFIG_INCLUDED
33
34
35#include <assert.h>
36#include <stddef.h>
37#include "c99_compat.h"
38
39#include "egltypedefs.h"
40
41
42#ifdef __cplusplus
43extern "C" {
44#endif
45
46/* update _eglValidationTable and _eglOffsetOfConfig before updating this
47 * struct */
48struct _egl_config
49{
50   _EGLDisplay *Display;
51
52   /* core */
53   EGLint BufferSize;
54   EGLint AlphaSize;
55   EGLint BlueSize;
56   EGLint GreenSize;
57   EGLint RedSize;
58   EGLint DepthSize;
59   EGLint StencilSize;
60   EGLint ConfigCaveat;
61   EGLint ConfigID;
62   EGLint Level;
63   EGLint MaxPbufferHeight;
64   EGLint MaxPbufferPixels;
65   EGLint MaxPbufferWidth;
66   EGLint NativeRenderable;
67   EGLint NativeVisualID;
68   EGLint NativeVisualType;
69   EGLint Samples;
70   EGLint SampleBuffers;
71   EGLint SurfaceType;
72   EGLint TransparentType;
73   EGLint TransparentBlueValue;
74   EGLint TransparentGreenValue;
75   EGLint TransparentRedValue;
76   EGLint BindToTextureRGB;
77   EGLint BindToTextureRGBA;
78   EGLint MinSwapInterval;
79   EGLint MaxSwapInterval;
80   EGLint LuminanceSize;
81   EGLint AlphaMaskSize;
82   EGLint ColorBufferType;
83   EGLint RenderableType;
84   EGLint MatchNativePixmap;
85   EGLint Conformant;
86
87   /* extensions */
88   EGLint YInvertedNOK;
89   EGLint FramebufferTargetAndroid;
90   EGLint RecordableAndroid;
91};
92
93
94/**
95 * Map an EGL attribute enum to the offset of the member in _EGLConfig.
96 */
97static inline EGLint
98_eglOffsetOfConfig(EGLint attr)
99{
100   switch (attr) {
101#define ATTRIB_MAP(attr, memb) case attr: return offsetof(_EGLConfig, memb)
102   /* core */
103   ATTRIB_MAP(EGL_BUFFER_SIZE,               BufferSize);
104   ATTRIB_MAP(EGL_ALPHA_SIZE,                AlphaSize);
105   ATTRIB_MAP(EGL_BLUE_SIZE,                 BlueSize);
106   ATTRIB_MAP(EGL_GREEN_SIZE,                GreenSize);
107   ATTRIB_MAP(EGL_RED_SIZE,                  RedSize);
108   ATTRIB_MAP(EGL_DEPTH_SIZE,                DepthSize);
109   ATTRIB_MAP(EGL_STENCIL_SIZE,              StencilSize);
110   ATTRIB_MAP(EGL_CONFIG_CAVEAT,             ConfigCaveat);
111   ATTRIB_MAP(EGL_CONFIG_ID,                 ConfigID);
112   ATTRIB_MAP(EGL_LEVEL,                     Level);
113   ATTRIB_MAP(EGL_MAX_PBUFFER_HEIGHT,        MaxPbufferHeight);
114   ATTRIB_MAP(EGL_MAX_PBUFFER_PIXELS,        MaxPbufferPixels);
115   ATTRIB_MAP(EGL_MAX_PBUFFER_WIDTH,         MaxPbufferWidth);
116   ATTRIB_MAP(EGL_NATIVE_RENDERABLE,         NativeRenderable);
117   ATTRIB_MAP(EGL_NATIVE_VISUAL_ID,          NativeVisualID);
118   ATTRIB_MAP(EGL_NATIVE_VISUAL_TYPE,        NativeVisualType);
119   ATTRIB_MAP(EGL_SAMPLES,                   Samples);
120   ATTRIB_MAP(EGL_SAMPLE_BUFFERS,            SampleBuffers);
121   ATTRIB_MAP(EGL_SURFACE_TYPE,              SurfaceType);
122   ATTRIB_MAP(EGL_TRANSPARENT_TYPE,          TransparentType);
123   ATTRIB_MAP(EGL_TRANSPARENT_BLUE_VALUE,    TransparentBlueValue);
124   ATTRIB_MAP(EGL_TRANSPARENT_GREEN_VALUE,   TransparentGreenValue);
125   ATTRIB_MAP(EGL_TRANSPARENT_RED_VALUE,     TransparentRedValue);
126   ATTRIB_MAP(EGL_BIND_TO_TEXTURE_RGB,       BindToTextureRGB);
127   ATTRIB_MAP(EGL_BIND_TO_TEXTURE_RGBA,      BindToTextureRGBA);
128   ATTRIB_MAP(EGL_MIN_SWAP_INTERVAL,         MinSwapInterval);
129   ATTRIB_MAP(EGL_MAX_SWAP_INTERVAL,         MaxSwapInterval);
130   ATTRIB_MAP(EGL_LUMINANCE_SIZE,            LuminanceSize);
131   ATTRIB_MAP(EGL_ALPHA_MASK_SIZE,           AlphaMaskSize);
132   ATTRIB_MAP(EGL_COLOR_BUFFER_TYPE,         ColorBufferType);
133   ATTRIB_MAP(EGL_RENDERABLE_TYPE,           RenderableType);
134   ATTRIB_MAP(EGL_MATCH_NATIVE_PIXMAP,       MatchNativePixmap);
135   ATTRIB_MAP(EGL_CONFORMANT,                Conformant);
136   /* extensions */
137   ATTRIB_MAP(EGL_Y_INVERTED_NOK,            YInvertedNOK);
138   ATTRIB_MAP(EGL_FRAMEBUFFER_TARGET_ANDROID, FramebufferTargetAndroid);
139   ATTRIB_MAP(EGL_RECORDABLE_ANDROID,        RecordableAndroid);
140#undef ATTRIB_MAP
141   default:
142      return -1;
143   }
144}
145
146
147/**
148 * Update a config for a given key.
149 *
150 * Note that a valid key is not necessarily a valid attribute.  There are gaps
151 * in the attribute enums.  The separation is to catch application errors.
152 * Drivers should never set a key that is an invalid attribute.
153 */
154static inline void
155_eglSetConfigKey(_EGLConfig *conf, EGLint key, EGLint val)
156{
157   EGLint offset = _eglOffsetOfConfig(key);
158   assert(offset >= 0);
159   *((EGLint *) ((char *) conf + offset)) = val;
160}
161
162
163/**
164 * Return the value for a given key.
165 */
166static inline EGLint
167_eglGetConfigKey(const _EGLConfig *conf, EGLint key)
168{
169   EGLint offset = _eglOffsetOfConfig(key);
170   assert(offset >= 0);
171   return *((EGLint *) ((char *) conf + offset));
172}
173
174
175extern void
176_eglInitConfig(_EGLConfig *config, _EGLDisplay *dpy, EGLint id);
177
178
179extern EGLConfig
180_eglLinkConfig(_EGLConfig *conf);
181
182
183extern _EGLConfig *
184_eglLookupConfig(EGLConfig config, _EGLDisplay *dpy);
185
186
187/**
188 * Return the handle of a linked config.
189 */
190static inline EGLConfig
191_eglGetConfigHandle(_EGLConfig *conf)
192{
193   return (EGLConfig) conf;
194}
195
196
197extern EGLBoolean
198_eglValidateConfig(const _EGLConfig *conf, EGLBoolean for_matching);
199
200
201extern EGLBoolean
202_eglMatchConfig(const _EGLConfig *conf, const _EGLConfig *criteria);
203
204
205extern EGLBoolean
206_eglParseConfigAttribList(_EGLConfig *conf, _EGLDisplay *dpy,
207                          const EGLint *attrib_list);
208
209
210extern EGLint
211_eglCompareConfigs(const _EGLConfig *conf1, const _EGLConfig *conf2,
212                   const _EGLConfig *criteria, EGLBoolean compare_id);
213
214
215extern EGLBoolean
216_eglFilterConfigArray(_EGLArray *array, EGLConfig *configs,
217                      EGLint config_size, EGLint *num_configs,
218                      EGLBoolean (*match)(const _EGLConfig *, void *),
219                      EGLint (*compare)(const _EGLConfig *, const _EGLConfig *,
220                                        void *),
221                      void *filter_data);
222
223
224extern EGLBoolean
225_eglChooseConfig(_EGLDriver *drv, _EGLDisplay *dpy, const EGLint *attrib_list, EGLConfig *configs, EGLint config_size, EGLint *num_config);
226
227
228extern EGLBoolean
229_eglGetConfigAttrib(_EGLDriver *drv, _EGLDisplay *dpy, _EGLConfig *conf, EGLint attribute, EGLint *value);
230
231
232extern EGLBoolean
233_eglGetConfigs(_EGLDriver *drv, _EGLDisplay *dpy, EGLConfig *configs, EGLint config_size, EGLint *num_config);
234
235
236#ifdef __cplusplus
237}
238#endif
239
240#endif /* EGLCONFIG_INCLUDED */
241