第三章 EGL介绍

╰+攻爆jí腚メ 2022-07-14 06:53 296阅读 0赞

转自：http://blog.csdn.net/ba\_jie/article/details/6370701

EGL是由Khronos Group提供的一组平台无关的API。它的功能：  
  
1> 和本地窗口系统（native windowing system）通讯；  
2> 查询可用的配置；  
3> 创建OpenGL ES可用的“绘图表面”（drawing surface）；  
4> 同步不同类别的API之间的渲染，比如在OpenGL ES和OpenVG之间同步，或者在OpenGL和本地窗口的绘图命令之间；  
5> 管理“渲染资源”，比如纹理映射（rendering map）。  
  
● EGLDisplay  
  
EGL可运行于GNU/Linux的X Window System，Microsoft Windows和MacOS X的Quartz。  
EGL把这些平台的显示系统抽象为一个独立的类型：EGLDisplay。  
使用EGL的第一步就是初始化一个可用的EGLDisplay：

EGLint majorVersion; EGLint minorVersion; EGLBoolean success = EGL\_FALSE; EGLDisplay display = eglGetDisplay(EGL\_DEFAULT\_DISPLAY); if (display != EGL\_NO\_DISPLAY) \{ success = eglInitialize(display, &majorVersion, &minorVersion); \} if (success != EGL\_TRUE) \{ EGLint errno = eglGetError(); if (errno != EGL\_SUCCESS) \{ \_TCHAR errmsg\[32\]; \_stprintf(errmsg, \_T("\[EGL\] Initialization failed. Error code: 0x%04x"), errno); // EGL\_BAD\_DISPLAY EGLDisplay参数错误 // EGL\_NOT\_INITIALIZED EGL不能初始化 \} \}

这里用到了三个EGL函数：

EGLDisplay eglGetDisplay(EGLNativeDisplayType id); EGLBoolean eglInitialize(EGLDisplay display, EGLint\* majorVersion, EGLint\* minorVersion); EGLint eglGetError();

● EGLConfig  
  
初始化过后，要选择一个合适的“绘图表面”。

EGLBoolean eglGetConfigs(EGLDisplay display, // 已初始化好 EGLConfig\* configs, // 如果为NULL，则返回EGL\_TRUE和numConfigs，即图形系统所有可用的配置 EGLint maxConfigs, // 上面那个configs数组的容量 EGLint\* numConfigs); // 图形系统返回的实际的可用的配置个数，存储在configs数组里

用例：

static const EGLint CONFIG\_ATTRIBS\[\] = \{ EGL\_RED\_SIZE, 5, EGL\_GREEN\_SIZE, 6, EGL\_BLUE\_SIZE, 5, EGL\_DEPTH\_SIZE, 16, EGL\_ALPHA\_SIZE, EGL\_DONT\_CARE, EGL\_STENCIL\_SIZE, EGL\_DONT\_CARE, EGL\_SURFACE\_TYPE, EGL\_WINDOW\_BIT, EGL\_NONE // 属性表以该常量为结束符 \}; GLint numConfigs; EGLConfig config; if (success != EGL\_FALSE) success = eglGetConfigs(display, NULL, 0, &numConfigs); if (success != EGL\_FALSE && numConfigs > 0) success = eglChooseConfig(display, CONFIG\_ATTRIBS, &config, 1, &numConfigs);

可以查询某个配置的某个属性：

EGLBoolean eglGetConfigAttrib(EGLDisplay display, // 已初始化 EGLConfig config, // 某个配置 EGLint attribute, // 某个属性 EGLint \* value);

让EGL为你选择一个配置：

EGLBoolean eglChooseConfig(EGLDisplay display, const EGLint\* attribs, // 你想要的属性事先定义到这个数组里 EGLConfig\* configs, // 图形系统将返回若干满足条件的配置到该数组 EGLint maxConfigs, // 上面数组的容量 EGLint\* numConfigs); // 图形系统返回的可用的配置个数

EGL如果选择了多个配置给你，则按一定规则放到数组里：  
1> EGL\_CONFIG\_CAVEAT  
2> EGL\_COLOR\_BUFFER\_TYPE  
3> 按color buffer所占位宽  
4> EGL\_BUFFER\_SIZE  
5> EGL\_SAMPLE\_BUFFERS  
6> EGL\_SAMPLES  
7> EGL\_DEPTH\_SIZE  
8> EGL\_STENCIL\_SIZE  
9> EGL\_ALPHA\_MASK\_SIZE  
10> EGL\_NATIVE\_VISUAL\_TYPE  
11> EGL\_CONFIG\_ID  
  
● EGLSurface

EGLSurface eglCreateWindowSurface(EGLDisplay display, EGLConfig config, EGLNativeWindowType window, // 在Windows上就是HWND类型 const EGLint\* attribs); // 此属性表非彼属性表

这里的属性表并非用于OpenGL ES 2.0，而是其它的API，比如OpenVG。我们只需要记住一个：EGL\_RENDER\_BUFFER \[EGL\_BACK\_BUFFER, EGL\_FRONT\_BUFFER\]。  
OpenGL ES 2.0是必须工作于双缓冲窗口系统的。  
该属性表当然也可以为NULL，也可以只有一个EGL\_NONE。那表示所有属性使用默认值。  
如果函数返回EGL\_NO\_SURFACE，则失败。错误码：  
EGL\_BAD\_MATCH:          属性设置错误。比如EGL\_SURFACE\_TYPE没有设置EGL\_WINDOW\_BIT  
EGL\_BAD\_CONFIG:         因为配置错误，图形系统不支持  
EGL\_BAD\_NATIVE\_WINDOW:  窗口句柄错误  
EGL\_BAD\_ALLOC:          无法创建绘图表面。比如先前已经创建一个了。

● pixel buffer  
  
OpenGL ES 2.0可以向pixel buffer渲染，同样使用硬件加速。pbuffer经常用来生成纹理映射。如果想渲染到纹理，常用更高效的framebuffer对象。  
在EGL\_SURFACE\_TYPE里使用使用EGL\_PBUFFER\_BIT可创建pbuffer：

EGLSurface eglCreatePbufferSurface(EGLDisplay display, EGLConfig config, const EGLint\* attribs);

使用到的属性：

EGL\_WIDTH, EGL\_HEIGHT  
EGL\_LARGEST\_PBUFFER:        如果参数不合适，可使用最大的pbuffer  
EGL\_TEXTURE\_FORMAT:         \[EGL\_NO\_TEXTURE\] 如果pbuffer要绑定到纹理映射，要指定纹理的格式  
EGL\_TEXTURE\_TARGET:            \[EGL\_NO\_TEXTURE, EGL\_TEXTURE\_2D\]  
EGL\_MIPMAP\_TEXTRUE:         \[EGL\_TRUE, EGL\_FALSE\]  
  
创建失败时返回EGL\_NO\_SURFACE，错误码：  
EGL\_BAD\_ALLOC:      缺少资源  
EGL\_BAD\_CONFIG:     配置错误  
EGL\_BAD\_PARAMETER:  EGL\_WIDTH和EGL\_HEIGHT为负数  
EGL\_BAD\_MATCH:      配置错误；如果用于纹理映射，则高宽参数错误；EGL\_TEXTURE\_FORMAT和EGL\_TEXTURE\_TARGET只有一个不是EGL\_NO\_TEXTURE  
EGL\_BAD\_ATTRIBUTE:  指定了EGL\_TEXTURE\_FORMAT、EGL\_TEXTURE\_TARGET或者EGL\_MIPMAP\_TEXTRUE，却不指定使用OpenGLES在配置里  
  
使用pbuffer的例子：

EGLint cfgAttribs\[\] = \{ EGL\_SURFACE\_TYPE, EGL\_PBUFFER\_BIT, EGL\_RENDERABLE\_TYPE, EGL\_OPENGL\_ES2\_BIT, EGL\_RED\_SIZE, 5, EGL\_GREEN\_SIZE, 6, EGL\_BLUE\_SIZE, 5, EGL\_DEPTH\_SIZE, 1, EGL\_NONE \}; const EGLint MAX\_CONFIG = 10; // 我们要从10个配置里挑选一个 EGLConfig configs\[MAX\_CONFIG\]; EGLint numConfigs; if (!eglChooseConfig(display, cfgAttribs, configs, MAX\_CONFIG, &numConfigs)) \{ // 报错 \} else \{ // 挑选一个配置 \} EGLint PBufAttribs\[\] = \{ EGL\_WIDTH, 512, EGL\_HEIGHT, 512, EGL\_LARGEST\_PBUFFER, EGL\_TRUE, EGL\_NONE \}; EGLRenderSurface pbuffer = eglCreatePbufferSurface(display, config, PBufAttribs); if (pbuffer == EGL\_NO\_SURFACE) \{ // 创建失败，报各种错 \} EGLint width, height; if (!eglQuerySurface(display, pbuffer, EGL\_HEIGHT, &height) || !eglQuerySurface(display, pbuffer, EGL\_WIDTH, &width) \{ // 查询不到信息，报错 \}

pbuffer和普通的窗口渲染最大的不同是不能swap，要么拷贝其值，要么修改其绑定成为纹理。  
  
● EGLContext

EGLContext eglCreateContext(EGLDisplay display, EGLConfig config, EGLContext context, // EGL\_NO\_CONTEXT表示不向其它的context共享资源 const EGLint \* attribs)// 我们暂时只用EGL\_CONTEXT\_CLIENT\_VERSION const EGLint attribs\[\] = \{ EGL\_CONTEXT\_CLIENT\_VERSION, 2, EGL\_NONE \}; EGLContext context = eglCreateContext(display, cfg, EGL\_NO\_CONTEXT, attribs); if (context == EGL\_NO\_CONTEXT) \{ if (EGL\_BAD\_CONFIG == eglGetError()) \{ ... \} \} if (!eglMakeCurrent(display, window, window, context)) // 两个window表示读写都在一个窗口 \{ // 报错 \}

● 渲染同步  
  
只使用OpenGL ES 2.0，那么，glFinish即可保证所有的渲染工作进行下去。  
但使用OpenVG或本地图形API渲染字体，要比使用OpenGL ES 2.0要容易。所以，你可能要在同一个窗口使用多个库来渲染。  
  
可以用EGL的同步函数：EGLBoolean eglWaitClient() 延迟客户端的执行，等待服务器端完成OpenGL ES 2.0或者OpenVG的渲染。  
如果失败，返回错误码：EGL\_BAD\_CURRENT\_SURFACE。  
  
如果要等待本地图形API的渲染完成，使用：EGLBoolean eglWaitNative(EGLint engine)。  
engine参数必须是EGL\_CORE\_NATIVE\_ENGINE。其它值都是通过EGL扩展来指定。  
如果失败，返回错误码：EGL\_BAD\_PARAMETER。