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 39extern "C" { 40#endif 41 42/* EGL Types */ 43/* EGLint is defined in eglplatform.h */ 44typedef unsigned int EGLBoolean; 45typedef unsigned int EGLenum; 46typedef void *EGLConfig; 47typedef void *EGLContext; 48typedef void *EGLDisplay; 49typedef void *EGLSurface; 50typedef 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 EGL_CAST(EGLNativeDisplayType, 0) 69#define EGL_NO_CONTEXT EGL_CAST(EGLContext, 0) 70#define EGL_NO_DISPLAY EGL_CAST(EGLDisplay, 0) 71#define EGL_NO_SURFACE EGL_CAST(EGLSurface, 0) 72 73/* Out-of-band attribute value */ 74#define EGL_DONT_CARE EGL_CAST(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_management */ 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 queryable) */ 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 EGL_CAST(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 249EGLAPI EGLint EGLAPIENTRY eglGetError(void); 250 251EGLAPI EGLDisplay EGLAPIENTRY eglGetDisplay(EGLNativeDisplayType display_id); 252EGLAPI EGLBoolean EGLAPIENTRY eglInitialize(EGLDisplay dpy, EGLint *major, EGLint *minor); 253EGLAPI EGLBoolean EGLAPIENTRY eglTerminate(EGLDisplay dpy); 254 255EGLAPI const char * EGLAPIENTRY eglQueryString(EGLDisplay dpy, EGLint name); 256 257EGLAPI EGLBoolean EGLAPIENTRY eglGetConfigs(EGLDisplay dpy, EGLConfig *configs, 258 EGLint config_size, EGLint *num_config); 259EGLAPI EGLBoolean EGLAPIENTRY eglChooseConfig(EGLDisplay dpy, const EGLint *attrib_list, 260 EGLConfig *configs, EGLint config_size, 261 EGLint *num_config); 262EGLAPI EGLBoolean EGLAPIENTRY eglGetConfigAttrib(EGLDisplay dpy, EGLConfig config, 263 EGLint attribute, EGLint *value); 264 265EGLAPI EGLSurface EGLAPIENTRY eglCreateWindowSurface(EGLDisplay dpy, EGLConfig config, 266 EGLNativeWindowType win, 267 const EGLint *attrib_list); 268EGLAPI EGLSurface EGLAPIENTRY eglCreatePbufferSurface(EGLDisplay dpy, EGLConfig config, 269 const EGLint *attrib_list); 270EGLAPI EGLSurface EGLAPIENTRY eglCreatePixmapSurface(EGLDisplay dpy, EGLConfig config, 271 EGLNativePixmapType pixmap, 272 const EGLint *attrib_list); 273EGLAPI EGLBoolean EGLAPIENTRY eglDestroySurface(EGLDisplay dpy, EGLSurface surface); 274EGLAPI EGLBoolean EGLAPIENTRY eglQuerySurface(EGLDisplay dpy, EGLSurface surface, 275 EGLint attribute, EGLint *value); 276 277EGLAPI EGLBoolean EGLAPIENTRY eglBindAPI(EGLenum api); 278EGLAPI EGLenum EGLAPIENTRY eglQueryAPI(void); 279 280EGLAPI EGLBoolean EGLAPIENTRY eglWaitClient(void); 281 282EGLAPI EGLBoolean EGLAPIENTRY eglReleaseThread(void); 283 284EGLAPI EGLSurface EGLAPIENTRY eglCreatePbufferFromClientBuffer( 285 EGLDisplay dpy, EGLenum buftype, EGLClientBuffer buffer, 286 EGLConfig config, const EGLint *attrib_list); 287 288EGLAPI EGLBoolean EGLAPIENTRY eglSurfaceAttrib(EGLDisplay dpy, EGLSurface surface, 289 EGLint attribute, EGLint value); 290EGLAPI EGLBoolean EGLAPIENTRY eglBindTexImage(EGLDisplay dpy, EGLSurface surface, EGLint buffer); 291EGLAPI EGLBoolean EGLAPIENTRY eglReleaseTexImage(EGLDisplay dpy, EGLSurface surface, EGLint buffer); 292 293 294EGLAPI EGLBoolean EGLAPIENTRY eglSwapInterval(EGLDisplay dpy, EGLint interval); 295 296 297EGLAPI EGLContext EGLAPIENTRY eglCreateContext(EGLDisplay dpy, EGLConfig config, 298 EGLContext share_context, 299 const EGLint *attrib_list); 300EGLAPI EGLBoolean EGLAPIENTRY eglDestroyContext(EGLDisplay dpy, EGLContext ctx); 301EGLAPI EGLBoolean EGLAPIENTRY eglMakeCurrent(EGLDisplay dpy, EGLSurface draw, 302 EGLSurface read, EGLContext ctx); 303 304EGLAPI EGLContext EGLAPIENTRY eglGetCurrentContext(void); 305EGLAPI EGLSurface EGLAPIENTRY eglGetCurrentSurface(EGLint readdraw); 306EGLAPI EGLDisplay EGLAPIENTRY eglGetCurrentDisplay(void); 307EGLAPI EGLBoolean EGLAPIENTRY eglQueryContext(EGLDisplay dpy, EGLContext ctx, 308 EGLint attribute, EGLint *value); 309 310EGLAPI EGLBoolean EGLAPIENTRY eglWaitGL(void); 311EGLAPI EGLBoolean EGLAPIENTRY eglWaitNative(EGLint engine); 312EGLAPI EGLBoolean EGLAPIENTRY eglSwapBuffers(EGLDisplay dpy, EGLSurface surface); 313EGLAPI 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 */ 319typedef void (*__eglMustCastToProperFunctionPointerType)(void); 320 321/* Now, define eglGetProcAddress using the generic function ptr. type */ 322EGLAPI __eglMustCastToProperFunctionPointerType EGLAPIENTRY 323 eglGetProcAddress(const char *procname); 324 325#ifdef __cplusplus 326} 327#endif 328 329#endif /* __egl_h_ */ 330