OLD | NEW |
| (Empty) |
1 /* -*- mode: c; tab-width: 8; -*- */ | |
2 /* vi: set sw=4 ts=8: */ | |
3 /* Reference version of egl.h for EGL 1.4. | |
4 * $Revision: 9356 $ on $Date: 2009-10-21 02:52:25 -0700 (Wed, 21 Oct 2009) $ | |
5 */ | |
6 | |
7 /* | |
8 ** Copyright (c) 2007-2009 The Khronos Group Inc. | |
9 ** | |
10 ** Permission is hereby granted, free of charge, to any person obtaining a | |
11 ** copy of this software and/or associated documentation files (the | |
12 ** "Materials"), to deal in the Materials without restriction, including | |
13 ** without limitation the rights to use, copy, modify, merge, publish, | |
14 ** distribute, sublicense, and/or sell copies of the Materials, and to | |
15 ** permit persons to whom the Materials are furnished to do so, subject to | |
16 ** the following conditions: | |
17 ** | |
18 ** The above copyright notice and this permission notice shall be included | |
19 ** in all copies or substantial portions of the Materials. | |
20 ** | |
21 ** THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, | |
22 ** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF | |
23 ** MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. | |
24 ** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY | |
25 ** CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, | |
26 ** TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE | |
27 ** MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS. | |
28 */ | |
29 | |
30 #ifndef __egl_h_ | |
31 #define __egl_h_ | |
32 | |
33 /* All platform-dependent types and macro boilerplate (such as EGLAPI | |
34 * and EGLAPIENTRY) should go in eglplatform.h. | |
35 */ | |
36 #include <EGL/eglplatform.h> | |
37 | |
38 #ifdef __cplusplus | |
39 extern "C" { | |
40 #endif | |
41 | |
42 /* EGL Types */ | |
43 /* EGLint is defined in eglplatform.h */ | |
44 typedef unsigned int EGLBoolean; | |
45 typedef unsigned int EGLenum; | |
46 typedef void *EGLConfig; | |
47 typedef void *EGLContext; | |
48 typedef void *EGLDisplay; | |
49 typedef void *EGLSurface; | |
50 typedef void *EGLClientBuffer; | |
51 | |
52 /* EGL Versioning */ | |
53 #define EGL_VERSION_1_0 1 | |
54 #define EGL_VERSION_1_1 1 | |
55 #define EGL_VERSION_1_2 1 | |
56 #define EGL_VERSION_1_3 1 | |
57 #define EGL_VERSION_1_4 1 | |
58 | |
59 /* EGL Enumerants. Bitmasks and other exceptional cases aside, most | |
60 * enums are assigned unique values starting at 0x3000. | |
61 */ | |
62 | |
63 /* EGL aliases */ | |
64 #define EGL_FALSE 0 | |
65 #define EGL_TRUE 1 | |
66 | |
67 /* Out-of-band handle values */ | |
68 #define EGL_DEFAULT_DISPLAY ((EGLNativeDisplayType)0) | |
69 #define EGL_NO_CONTEXT ((EGLContext)0) | |
70 #define EGL_NO_DISPLAY ((EGLDisplay)0) | |
71 #define EGL_NO_SURFACE ((EGLSurface)0) | |
72 | |
73 /* Out-of-band attribute value */ | |
74 #define EGL_DONT_CARE ((EGLint)-1) | |
75 | |
76 /* Errors / GetError return values */ | |
77 #define EGL_SUCCESS 0x3000 | |
78 #define EGL_NOT_INITIALIZED 0x3001 | |
79 #define EGL_BAD_ACCESS 0x3002 | |
80 #define EGL_BAD_ALLOC 0x3003 | |
81 #define EGL_BAD_ATTRIBUTE 0x3004 | |
82 #define EGL_BAD_CONFIG 0x3005 | |
83 #define EGL_BAD_CONTEXT 0x3006 | |
84 #define EGL_BAD_CURRENT_SURFACE 0x3007 | |
85 #define EGL_BAD_DISPLAY 0x3008 | |
86 #define EGL_BAD_MATCH 0x3009 | |
87 #define EGL_BAD_NATIVE_PIXMAP 0x300A | |
88 #define EGL_BAD_NATIVE_WINDOW 0x300B | |
89 #define EGL_BAD_PARAMETER 0x300C | |
90 #define EGL_BAD_SURFACE 0x300D | |
91 #define EGL_CONTEXT_LOST 0x300E /* EGL 1.1 - IMG_power_managemen
t */ | |
92 | |
93 /* Reserved 0x300F-0x301F for additional errors */ | |
94 | |
95 /* Config attributes */ | |
96 #define EGL_BUFFER_SIZE 0x3020 | |
97 #define EGL_ALPHA_SIZE 0x3021 | |
98 #define EGL_BLUE_SIZE 0x3022 | |
99 #define EGL_GREEN_SIZE 0x3023 | |
100 #define EGL_RED_SIZE 0x3024 | |
101 #define EGL_DEPTH_SIZE 0x3025 | |
102 #define EGL_STENCIL_SIZE 0x3026 | |
103 #define EGL_CONFIG_CAVEAT 0x3027 | |
104 #define EGL_CONFIG_ID 0x3028 | |
105 #define EGL_LEVEL 0x3029 | |
106 #define EGL_MAX_PBUFFER_HEIGHT 0x302A | |
107 #define EGL_MAX_PBUFFER_PIXELS 0x302B | |
108 #define EGL_MAX_PBUFFER_WIDTH 0x302C | |
109 #define EGL_NATIVE_RENDERABLE 0x302D | |
110 #define EGL_NATIVE_VISUAL_ID 0x302E | |
111 #define EGL_NATIVE_VISUAL_TYPE 0x302F | |
112 #define EGL_SAMPLES 0x3031 | |
113 #define EGL_SAMPLE_BUFFERS 0x3032 | |
114 #define EGL_SURFACE_TYPE 0x3033 | |
115 #define EGL_TRANSPARENT_TYPE 0x3034 | |
116 #define EGL_TRANSPARENT_BLUE_VALUE 0x3035 | |
117 #define EGL_TRANSPARENT_GREEN_VALUE 0x3036 | |
118 #define EGL_TRANSPARENT_RED_VALUE 0x3037 | |
119 #define EGL_NONE 0x3038 /* Attrib list terminator */ | |
120 #define EGL_BIND_TO_TEXTURE_RGB 0x3039 | |
121 #define EGL_BIND_TO_TEXTURE_RGBA 0x303A | |
122 #define EGL_MIN_SWAP_INTERVAL 0x303B | |
123 #define EGL_MAX_SWAP_INTERVAL 0x303C | |
124 #define EGL_LUMINANCE_SIZE 0x303D | |
125 #define EGL_ALPHA_MASK_SIZE 0x303E | |
126 #define EGL_COLOR_BUFFER_TYPE 0x303F | |
127 #define EGL_RENDERABLE_TYPE 0x3040 | |
128 #define EGL_MATCH_NATIVE_PIXMAP 0x3041 /* Pseudo-attribute (not queryab
le) */ | |
129 #define EGL_CONFORMANT 0x3042 | |
130 | |
131 /* Reserved 0x3041-0x304F for additional config attributes */ | |
132 | |
133 /* Config attribute values */ | |
134 #define EGL_SLOW_CONFIG 0x3050 /* EGL_CONFIG_CAVEAT value */ | |
135 #define EGL_NON_CONFORMANT_CONFIG 0x3051 /* EGL_CONFIG_CAVEAT value */ | |
136 #define EGL_TRANSPARENT_RGB 0x3052 /* EGL_TRANSPARENT_TYPE value */ | |
137 #define EGL_RGB_BUFFER 0x308E /* EGL_COLOR_BUFFER_TYPE value *
/ | |
138 #define EGL_LUMINANCE_BUFFER 0x308F /* EGL_COLOR_BUFFER_TYPE value *
/ | |
139 | |
140 /* More config attribute values, for EGL_TEXTURE_FORMAT */ | |
141 #define EGL_NO_TEXTURE 0x305C | |
142 #define EGL_TEXTURE_RGB 0x305D | |
143 #define EGL_TEXTURE_RGBA 0x305E | |
144 #define EGL_TEXTURE_2D 0x305F | |
145 | |
146 /* Config attribute mask bits */ | |
147 #define EGL_PBUFFER_BIT 0x0001 /* EGL_SURFACE_TYPE mask bits */ | |
148 #define EGL_PIXMAP_BIT 0x0002 /* EGL_SURFACE_TYPE mask bits */ | |
149 #define EGL_WINDOW_BIT 0x0004 /* EGL_SURFACE_TYPE mask bits */ | |
150 #define EGL_VG_COLORSPACE_LINEAR_BIT 0x0020 /* EGL_SURFACE_TYPE mask bits */ | |
151 #define EGL_VG_ALPHA_FORMAT_PRE_BIT 0x0040 /* EGL_SURFACE_TYPE mask bits */ | |
152 #define EGL_MULTISAMPLE_RESOLVE_BOX_BIT 0x0200 /* EGL_SURFACE_TYPE mask bits */ | |
153 #define EGL_SWAP_BEHAVIOR_PRESERVED_BIT 0x0400 /* EGL_SURFACE_TYPE mask bits */ | |
154 | |
155 #define EGL_OPENGL_ES_BIT 0x0001 /* EGL_RENDERABLE_TYPE mask bits
*/ | |
156 #define EGL_OPENVG_BIT 0x0002 /* EGL_RENDERABLE_TYPE mask bits
*/ | |
157 #define EGL_OPENGL_ES2_BIT 0x0004 /* EGL_RENDERABLE_TYPE mask bits
*/ | |
158 #define EGL_OPENGL_BIT 0x0008 /* EGL_RENDERABLE_TYPE mask bits
*/ | |
159 | |
160 /* QueryString targets */ | |
161 #define EGL_VENDOR 0x3053 | |
162 #define EGL_VERSION 0x3054 | |
163 #define EGL_EXTENSIONS 0x3055 | |
164 #define EGL_CLIENT_APIS 0x308D | |
165 | |
166 /* QuerySurface / SurfaceAttrib / CreatePbufferSurface targets */ | |
167 #define EGL_HEIGHT 0x3056 | |
168 #define EGL_WIDTH 0x3057 | |
169 #define EGL_LARGEST_PBUFFER 0x3058 | |
170 #define EGL_TEXTURE_FORMAT 0x3080 | |
171 #define EGL_TEXTURE_TARGET 0x3081 | |
172 #define EGL_MIPMAP_TEXTURE 0x3082 | |
173 #define EGL_MIPMAP_LEVEL 0x3083 | |
174 #define EGL_RENDER_BUFFER 0x3086 | |
175 #define EGL_VG_COLORSPACE 0x3087 | |
176 #define EGL_VG_ALPHA_FORMAT 0x3088 | |
177 #define EGL_HORIZONTAL_RESOLUTION 0x3090 | |
178 #define EGL_VERTICAL_RESOLUTION 0x3091 | |
179 #define EGL_PIXEL_ASPECT_RATIO 0x3092 | |
180 #define EGL_SWAP_BEHAVIOR 0x3093 | |
181 #define EGL_MULTISAMPLE_RESOLVE 0x3099 | |
182 | |
183 /* EGL_RENDER_BUFFER values / BindTexImage / ReleaseTexImage buffer targets */ | |
184 #define EGL_BACK_BUFFER 0x3084 | |
185 #define EGL_SINGLE_BUFFER 0x3085 | |
186 | |
187 /* OpenVG color spaces */ | |
188 #define EGL_VG_COLORSPACE_sRGB 0x3089 /* EGL_VG_COLORSPACE value */ | |
189 #define EGL_VG_COLORSPACE_LINEAR 0x308A /* EGL_VG_COLORSPACE value */ | |
190 | |
191 /* OpenVG alpha formats */ | |
192 #define EGL_VG_ALPHA_FORMAT_NONPRE 0x308B /* EGL_ALPHA_FORMAT value */ | |
193 #define EGL_VG_ALPHA_FORMAT_PRE 0x308C /* EGL_ALPHA_FORMAT value */ | |
194 | |
195 /* Constant scale factor by which fractional display resolutions & | |
196 * aspect ratio are scaled when queried as integer values. | |
197 */ | |
198 #define EGL_DISPLAY_SCALING 10000 | |
199 | |
200 /* Unknown display resolution/aspect ratio */ | |
201 #define EGL_UNKNOWN ((EGLint)-1) | |
202 | |
203 /* Back buffer swap behaviors */ | |
204 #define EGL_BUFFER_PRESERVED 0x3094 /* EGL_SWAP_BEHAVIOR value */ | |
205 #define EGL_BUFFER_DESTROYED 0x3095 /* EGL_SWAP_BEHAVIOR value */ | |
206 | |
207 /* CreatePbufferFromClientBuffer buffer types */ | |
208 #define EGL_OPENVG_IMAGE 0x3096 | |
209 | |
210 /* QueryContext targets */ | |
211 #define EGL_CONTEXT_CLIENT_TYPE 0x3097 | |
212 | |
213 /* CreateContext attributes */ | |
214 #define EGL_CONTEXT_CLIENT_VERSION 0x3098 | |
215 | |
216 /* Multisample resolution behaviors */ | |
217 #define EGL_MULTISAMPLE_RESOLVE_DEFAULT 0x309A /* EGL_MULTISAMPLE_RESOLVE value
*/ | |
218 #define EGL_MULTISAMPLE_RESOLVE_BOX 0x309B /* EGL_MULTISAMPLE_RESOLVE value
*/ | |
219 | |
220 /* BindAPI/QueryAPI targets */ | |
221 #define EGL_OPENGL_ES_API 0x30A0 | |
222 #define EGL_OPENVG_API 0x30A1 | |
223 #define EGL_OPENGL_API 0x30A2 | |
224 | |
225 /* GetCurrentSurface targets */ | |
226 #define EGL_DRAW 0x3059 | |
227 #define EGL_READ 0x305A | |
228 | |
229 /* WaitNative engines */ | |
230 #define EGL_CORE_NATIVE_ENGINE 0x305B | |
231 | |
232 /* EGL 1.2 tokens renamed for consistency in EGL 1.3 */ | |
233 #define EGL_COLORSPACE EGL_VG_COLORSPACE | |
234 #define EGL_ALPHA_FORMAT EGL_VG_ALPHA_FORMAT | |
235 #define EGL_COLORSPACE_sRGB EGL_VG_COLORSPACE_sRGB | |
236 #define EGL_COLORSPACE_LINEAR EGL_VG_COLORSPACE_LINEAR | |
237 #define EGL_ALPHA_FORMAT_NONPRE EGL_VG_ALPHA_FORMAT_NONPRE | |
238 #define EGL_ALPHA_FORMAT_PRE EGL_VG_ALPHA_FORMAT_PRE | |
239 | |
240 /* EGL extensions must request enum blocks from the Khronos | |
241 * API Registrar, who maintains the enumerant registry. Submit | |
242 * a bug in Khronos Bugzilla against task "Registry". | |
243 */ | |
244 | |
245 | |
246 | |
247 /* EGL Functions */ | |
248 | |
249 EGLAPI EGLint EGLAPIENTRY eglGetError(void); | |
250 | |
251 EGLAPI EGLDisplay EGLAPIENTRY eglGetDisplay(EGLNativeDisplayType display_id); | |
252 EGLAPI EGLBoolean EGLAPIENTRY eglInitialize(EGLDisplay dpy, EGLint *major, EGLin
t *minor); | |
253 EGLAPI EGLBoolean EGLAPIENTRY eglTerminate(EGLDisplay dpy); | |
254 | |
255 EGLAPI const char * EGLAPIENTRY eglQueryString(EGLDisplay dpy, EGLint name); | |
256 | |
257 EGLAPI EGLBoolean EGLAPIENTRY eglGetConfigs(EGLDisplay dpy, EGLConfig *configs, | |
258 EGLint config_size, EGLint *num_config); | |
259 EGLAPI EGLBoolean EGLAPIENTRY eglChooseConfig(EGLDisplay dpy, const EGLint *attr
ib_list, | |
260 EGLConfig *configs, EGLint config_size, | |
261 EGLint *num_config); | |
262 EGLAPI EGLBoolean EGLAPIENTRY eglGetConfigAttrib(EGLDisplay dpy, EGLConfig confi
g, | |
263 EGLint attribute, EGLint *value); | |
264 | |
265 EGLAPI EGLSurface EGLAPIENTRY eglCreateWindowSurface(EGLDisplay dpy, EGLConfig c
onfig, | |
266 EGLNativeWindowType win, | |
267 const EGLint *attrib_list); | |
268 EGLAPI EGLSurface EGLAPIENTRY eglCreatePbufferSurface(EGLDisplay dpy, EGLConfig
config, | |
269 const EGLint *attrib_list); | |
270 EGLAPI EGLSurface EGLAPIENTRY eglCreatePixmapSurface(EGLDisplay dpy, EGLConfig c
onfig, | |
271 EGLNativePixmapType pixmap, | |
272 const EGLint *attrib_list); | |
273 EGLAPI EGLBoolean EGLAPIENTRY eglDestroySurface(EGLDisplay dpy, EGLSurface surfa
ce); | |
274 EGLAPI EGLBoolean EGLAPIENTRY eglQuerySurface(EGLDisplay dpy, EGLSurface surface
, | |
275 EGLint attribute, EGLint *value); | |
276 | |
277 EGLAPI EGLBoolean EGLAPIENTRY eglBindAPI(EGLenum api); | |
278 EGLAPI EGLenum EGLAPIENTRY eglQueryAPI(void); | |
279 | |
280 EGLAPI EGLBoolean EGLAPIENTRY eglWaitClient(void); | |
281 | |
282 EGLAPI EGLBoolean EGLAPIENTRY eglReleaseThread(void); | |
283 | |
284 EGLAPI EGLSurface EGLAPIENTRY eglCreatePbufferFromClientBuffer( | |
285 EGLDisplay dpy, EGLenum buftype, EGLClientBuffer buffer, | |
286 EGLConfig config, const EGLint *attrib_list); | |
287 | |
288 EGLAPI EGLBoolean EGLAPIENTRY eglSurfaceAttrib(EGLDisplay dpy, EGLSurface surfac
e, | |
289 EGLint attribute, EGLint value); | |
290 EGLAPI EGLBoolean EGLAPIENTRY eglBindTexImage(EGLDisplay dpy, EGLSurface surface
, EGLint buffer); | |
291 EGLAPI EGLBoolean EGLAPIENTRY eglReleaseTexImage(EGLDisplay dpy, EGLSurface surf
ace, EGLint buffer); | |
292 | |
293 | |
294 EGLAPI EGLBoolean EGLAPIENTRY eglSwapInterval(EGLDisplay dpy, EGLint interval); | |
295 | |
296 | |
297 EGLAPI EGLContext EGLAPIENTRY eglCreateContext(EGLDisplay dpy, EGLConfig config, | |
298 EGLContext share_context, | |
299 const EGLint *attrib_list); | |
300 EGLAPI EGLBoolean EGLAPIENTRY eglDestroyContext(EGLDisplay dpy, EGLContext ctx); | |
301 EGLAPI EGLBoolean EGLAPIENTRY eglMakeCurrent(EGLDisplay dpy, EGLSurface draw, | |
302 EGLSurface read, EGLContext ctx); | |
303 | |
304 EGLAPI EGLContext EGLAPIENTRY eglGetCurrentContext(void); | |
305 EGLAPI EGLSurface EGLAPIENTRY eglGetCurrentSurface(EGLint readdraw); | |
306 EGLAPI EGLDisplay EGLAPIENTRY eglGetCurrentDisplay(void); | |
307 EGLAPI EGLBoolean EGLAPIENTRY eglQueryContext(EGLDisplay dpy, EGLContext ctx, | |
308 EGLint attribute, EGLint *value); | |
309 | |
310 EGLAPI EGLBoolean EGLAPIENTRY eglWaitGL(void); | |
311 EGLAPI EGLBoolean EGLAPIENTRY eglWaitNative(EGLint engine); | |
312 EGLAPI EGLBoolean EGLAPIENTRY eglSwapBuffers(EGLDisplay dpy, EGLSurface surface)
; | |
313 EGLAPI EGLBoolean EGLAPIENTRY eglCopyBuffers(EGLDisplay dpy, EGLSurface surface, | |
314 EGLNativePixmapType target); | |
315 | |
316 /* This is a generic function pointer type, whose name indicates it must | |
317 * be cast to the proper type *and calling convention* before use. | |
318 */ | |
319 typedef void (*__eglMustCastToProperFunctionPointerType)(void); | |
320 | |
321 /* Now, define eglGetProcAddress using the generic function ptr. type */ | |
322 EGLAPI __eglMustCastToProperFunctionPointerType EGLAPIENTRY | |
323 eglGetProcAddress(const char *procname); | |
324 | |
325 #ifdef __cplusplus | |
326 } | |
327 #endif | |
328 | |
329 #endif /* __egl_h_ */ | |
OLD | NEW |