【Android】Android SurfaceFlinger之OpenGL ES

1、OpenGL ES

在Android系统中,直接面向终端用户的便是GUI,可以说任何一款产品的UI都是至关重要的,是用户可以实实在在感受到的东西,是最直观的、最易被感知的东西。SurfaceFlinger作为Android GUI系统的核心模块,与OpenGL ES息息相关,所以在分析SurfaceFlinger之前有必要先了解一下OpenGL ES。

OpenGL即Open Graphics Library,是一款跨语言的、跨平台的开源图形库,包括2D、3D图形,不过OpenGL的运行对设备要求较高,很难被直接应用在CPU和内存资源匮乏、用电量需要严格控制甚至没有浮点数硬件协助的嵌入式设备上,于是OpenGL ES应运而生,OpenGL ES即OpenGL for Embeded System,是专门面向嵌入式系统的OpenGL API子集,可以理解为OpenGL的一个精简版。OpenGL ES现有三个版本(与OpengGL的版本不同),1.x版用于fixed function hardware,2.x版用于programmable hardware,3.x版则加入了更多新特性,如着色语言的完善、支持更多缓冲区对象、支持几何体实例化、统一的纹理压缩格式等。更多信息可查看如下khronos官网:
https://www.khronos.org/

在现实生活中,我们很容易感知到3D物体,但是在计算机屏幕上,物体实际上是2D的,只是通过一定的技术手段产生了3D效果,如3D电影的光影技术、计算机图形处理的透视效果。OpenGL ES支持三种基本的几何元素,点、线段和三角形,但通过这三种元素可以绘制任何复杂的几何体。图形渲染支持不同的pipeline,如1.x版的固定功能管线和2.x版的可编程管线,现在用的较多的是可编程管线,之所以称之为管线,是因为以3D数据作为输入后经过一系列的流水线式处理并最终输出2D光栅图形。

2、Android中的OpenGL ES

下面是Android中OpenGL ES的框架简图:

这里写图片描述

下面是Android源码中OpenGL ES相关的几个代码路径——

Java层SDK:frameworks/base/opengl/java
JNI层实现:frameworks/base/core/jni
C++代码实现:frameworks/native/opengl
Mesa3D引擎库:external/mesa3d

3、EGL

上面的OpenGL ES框架简图中有个EGL,它是图形渲染API(如OpenGL ES)与本地平台窗口系统的一层接口,保证了OpenGL ES的平台独立性。EGL提供了若干功能:创建rendering surface、创建graphics context、同步应用程序和本地平台渲染API、提供对显示设备的访问、提供对渲染配置的管理等。下面分析一下EGL的用法。

图形渲染可通过硬件或软件实现,是在系统启动后动态确定的。如果是硬件加速,首先要加载libhgl库,否则加载libagl库由CPU进行图形处理。具体哪种渲染方式,是由系统解析egl.cfg文件后决定的。若egl.cfg不存在,则说明硬件不支持图形渲染加速;若egl.cfg存在的话,一般放在源码device/[Manufacture]目录下,然后编译、烧机到设备/system/lib/egl/egl.cfg。例如,device/google/marlin/egl.cfg,可能有如下内容:

0 0 android
0 1 adreno

egl.cfg文件中,第一个数字表示显示屏编号,Android系统理论上支持多个显示设备,但到目前位置还只能支持一个,所以这个数值必须为0;第二个数字表示渲染方式,1为硬件加速,2为软件描画;第三个参数是库的名称,需要将对应的实现库放在/system/lib/egl或/vendor/lib/egl目录下,库的名称格式如下:

libEGL_<Lib_Name>.so
libGLES_<Lib_Name>.so
libGLESv1_CM_<Lib_Name>.so
libGLESv2_<Lib_Name>.so

如上device/google/marlin/egl.cfg,“0 0 android”为默认配置,“0 1 adreno”表示采用高通adreno GPU进行硬件加速。egl.cfg可以配置多个库,优先级逐行递减。

4、EGL API

EGL的API名字基本以egl关键字开头,格式固定,头文件位置如下:

frameworks/native/opengl/include/EGL/egl.h
frameworks/native/opengl/include/EGL/eglext.h
frameworks/native/opengl/include/EGL/eglplatform.h

egl.h声明了EGL API,eglext.h是对EGL的扩展,eglplatform.h保证了EGL的平台独立性。下面是EGL常用的类型及常量,可以看出EGL的最新版本为EGL1.4。

typedef int EGLint;
typedef unsigned int EGLBoolean;
typedef unsigned int EGLenum;
typedef void *EGLConfig;
typedef void *EGLContext;
typedef void *EGLDisplay;
typedef void *EGLSurface;
typedef void *EGLClientBuffer;
#define EGL_FALSE            0
#define EGL_TRUE            1
#define EGL_VERSION_1_0            1
#define EGL_VERSION_1_1            1
#define EGL_VERSION_1_2            1
#define EGL_VERSION_1_3            1
#define EGL_VERSION_1_4            1
#define EGL_DEFAULT_DISPLAY        EGL_CAST(EGLNativeDisplayType, 0)
#define EGL_NO_CONTEXT            EGL_CAST(EGLContext, 0)
#define EGL_NO_DISPLAY            EGL_CAST(EGLDisplay, 0)
#define EGL_NO_SURFACE            EGL_CAST(EGLSurface, 0)
#define EGL_DONT_CARE            EGL_CAST(EGLint, -1)

下面简单介绍一下EGL API,更多信息可查看如下khronos官网
https://www.khronos.org/registry/EGL/sdk/docs/man/

eglGetError——

EGLAPI EGLint EGLAPIENTRY eglGetError(void);

eglGetError用于获取当前线程的上一个EGL操作的结果,初始值为EGL_SUCCESS,下面是可能的返回值:

#define EGL_SUCCESS            0x3000
#define EGL_NOT_INITIALIZED        0x3001
#define EGL_BAD_ACCESS            0x3002
#define EGL_BAD_ALLOC            0x3003
#define EGL_BAD_ATTRIBUTE        0x3004
#define EGL_BAD_CONFIG            0x3005
#define EGL_BAD_CONTEXT            0x3006
#define EGL_BAD_CURRENT_SURFACE        0x3007
#define EGL_BAD_DISPLAY            0x3008
#define EGL_BAD_MATCH            0x3009
#define EGL_BAD_NATIVE_PIXMAP        0x300A
#define EGL_BAD_NATIVE_WINDOW        0x300B
#define EGL_BAD_PARAMETER        0x300C
#define EGL_BAD_SURFACE            0x300D
#define EGL_CONTEXT_LOST        0x300E

eglGetDisplay——

EGLAPI EGLDisplay EGLAPIENTRY eglGetDisplay(EGLNativeDisplayType display_id);

eglGetDisplay用于获取display,display_id一般取值为EGL_DEFAULT_DISPLAY,无法获取display时返回EGL_NO_DISPLAY而不产生错误。

eglInitialize——

EGLAPI EGLBoolean EGLAPIENTRY eglInitialize(EGLDisplay dpy, EGLint *major, EGLint *minor);

eglInitialize用于对display进行初始化,并获取当前的EGL版本号major和minor,返回EGL_FALSE时可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED。

eglTerminate——

EGLAPI EGLBoolean EGLAPIENTRY eglTerminate(EGLDisplay dpy);

eglTerminate用于释放display资源,包括surface和context,如果还有其它线程使用这些资源时,会等到它们通过eglMakeCurrent失效后再释放,返回EGL_FALSE时可能的错误为EGL_BAD_DISPLAY。

eglQueryString——

EGLAPI const char * EGLAPIENTRY eglQueryString(EGLDisplay dpy, EGLint name);

eglQueryString用于获取display的某些信息,返回NULL时可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_PARAMETER,name取值如下:

#define EGL_VENDOR            0x3053
#define EGL_VERSION            0x3054
#define EGL_EXTENSIONS            0x3055
#define EGL_CLIENT_APIS            0x308D

eglGetConfigs——

EGLAPI EGLBoolean EGLAPIENTRY eglGetConfigs(EGLDisplay dpy, EGLConfig *configs,
             EGLint config_size, EGLint *num_config);

eglGetConfigs用于获取display的frame buffer配置列表,返回EGL_FALSE时可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_PARAMETER。

eglGetConfigAttrib——

EGLAPI EGLBoolean EGLAPIENTRY eglGetConfigAttrib(EGLDisplay dpy, EGLConfig config,
                  EGLint attribute, EGLint *value);

eglGetConfigAttrib用于获取display的frame buffer配置列表的某个具体的属性值,返回EGL_FALSE时可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、 EGL_BAD_CONFIG、EGL_BAD_ATTRIBUTE,attribute取值如下:

#define EGL_BUFFER_SIZE            0x3020
#define EGL_ALPHA_SIZE            0x3021
#define EGL_BLUE_SIZE            0x3022
#define EGL_GREEN_SIZE            0x3023
#define EGL_RED_SIZE            0x3024
#define EGL_DEPTH_SIZE            0x3025
#define EGL_STENCIL_SIZE        0x3026
#define EGL_CONFIG_CAVEAT        0x3027
#define EGL_CONFIG_ID            0x3028
#define EGL_LEVEL            0x3029
#define EGL_MAX_PBUFFER_HEIGHT        0x302A
#define EGL_MAX_PBUFFER_PIXELS        0x302B
#define EGL_MAX_PBUFFER_WIDTH        0x302C
#define EGL_NATIVE_RENDERABLE        0x302D
#define EGL_NATIVE_VISUAL_ID        0x302E
#define EGL_NATIVE_VISUAL_TYPE        0x302F
#define EGL_SAMPLES            0x3031
#define EGL_SAMPLE_BUFFERS        0x3032
#define EGL_SURFACE_TYPE        0x3033
#define EGL_TRANSPARENT_TYPE        0x3034
#define EGL_TRANSPARENT_BLUE_VALUE    0x3035
#define EGL_TRANSPARENT_GREEN_VALUE    0x3036
#define EGL_TRANSPARENT_RED_VALUE    0x3037
#define EGL_NONE            0x3038
#define EGL_BIND_TO_TEXTURE_RGB        0x3039
#define EGL_BIND_TO_TEXTURE_RGBA    0x303A
#define EGL_MIN_SWAP_INTERVAL        0x303B
#define EGL_MAX_SWAP_INTERVAL        0x303C
#define EGL_LUMINANCE_SIZE        0x303D
#define EGL_ALPHA_MASK_SIZE        0x303E
#define EGL_COLOR_BUFFER_TYPE        0x303F
#define EGL_RENDERABLE_TYPE        0x3040
#define EGL_MATCH_NATIVE_PIXMAP        0x3041
#define EGL_CONFORMANT            0x3042

eglChooseConfig——

EGLAPI EGLBoolean EGLAPIENTRY eglChooseConfig(EGLDisplay dpy, const EGLint *attrib_list,
               EGLConfig *configs, EGLint config_size,
               EGLint *num_config);

eglChooseConfig用于获取display的frame buffer配置列表,不过这个配置列表要与指定的属性列表attrib_list匹配,返回EGL_FALSE时可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_PARAMETER、EGL_BAD_ATTRIBUTE。attrib_list有固定的格式,属性及属性值成对出现,每个属性的属性值也都有一定的要求,最后以EGL_NONE结尾,例子如下:

EGLint const attrib_list[] = {
        EGL_RED_SIZE, 4,
        EGL_GREEN_SIZE, 4,
        EGL_BLUE_SIZE, 4,
        EGL_NONE
};

eglCreateWindowSurface——

EGLAPI EGLSurface EGLAPIENTRY eglCreateWindowSurface(EGLDisplay dpy, EGLConfig config,
                  EGLNativeWindowType win,
                  const EGLint *attrib_list);

eglCreateWindowSurface用于创建window surface,失败时返回EGL_NO_SURFACE,可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_CONFIG、EGL_BAD_NATIVE_WINDOW、EGL_BAD_ATTRIBUTE、EGL_BAD_ALLOC、EGL_BAD_MATCH。attrib_list的属性可以是EGL_RENDER_BUFFER、EGL_VG_ALPHA_FORMAT、EGL_VG_COLORSPACE。

eglCreatePbufferSurface——

EGLAPI EGLSurface EGLAPIENTRY eglCreatePbufferSurface(EGLDisplay dpy, EGLConfig config,
                   const EGLint *attrib_list);

eglCreatePbufferSurface用于创建off-screen的pixel buffer surface,失败时返回EGL_NO_SURFACE,可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_CONFIG、EGL_BAD_ATTRIBUTE、EGL_BAD_ALLOC、EGL_BAD_MATCH。attrib_list的属性可以是EGL_HEIGHT、EGL_LARGEST_PBUFFER、EGL_MIPMAP_TEXTURE、EGL_TEXTURE_FORMAT、EGL_TEXTURE_TARGET、EGL_VG_ALPHA_FORMAT、EGL_VG_COLORSPACE、EGL_WIDTH。

eglCreatePixmapSurface——

EGLAPI EGLSurface EGLAPIENTRY eglCreatePixmapSurface(EGLDisplay dpy, EGLConfig config,
                  EGLNativePixmapType pixmap,
                  const EGLint *attrib_list);

eglCreatePixmapSurface用于创建off-screen的pixmap surface,失败时返回EGL_NO_SURFACE,可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_CONFIG、EGL_BAD_NATIVE_PIXMAP、EGL_BAD_ATTRIBUTE、EGL_BAD_ALLOC、EGL_BAD_MATCH。attrib_list的属性可以是EGL_VG_ALPHA_FORMAT、EGL_VG_COLORSPACE。

eglDestroySurface——

EGLAPI EGLBoolean EGLAPIENTRY eglDestroySurface(EGLDisplay dpy, EGLSurface surface);

eglDestroySurface用于销毁surface,有其它线程使用这个surface时要等到不使用时在销毁,返回EGL_FALSE时可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_SURFACE。

eglQuerySurface——

EGLAPI EGLBoolean EGLAPIENTRY eglQuerySurface(EGLDisplay dpy, EGLSurface surface,
               EGLint attribute, EGLint *value);

eglQuerySurface用于获取surface信息,返回EGL_FALSE时可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_SURFACE、EGL_BAD_ATTRIBUTE。attribute取值为:EGL_CONFIG_ID、EGL_HEIGHT、EGL_HORIZONTAL_RESOLUTION、EGL_LARGEST_PBUFFER、EGL_MIPMAP_LEVEL、EGL_MIPMAP_TEXTURE、EGL_MULTISAMPLE_RESOLVE、EGL_PIXEL_ASPECT_RATIO、EGL_RENDER_BUFFER、EGL_SWAP_BEHAVIOR、EGL_TEXTURE_FORMAT、EGL_TEXTURE_TARGET、EGL_VERTICAL_RESOLUTION、EGL_WIDTH。

eglBindAPI——

EGLAPI EGLBoolean EGLAPIENTRY eglBindAPI(EGLenum api);

eglBindAPI用于设置调用线程的渲染API,返回EGL_FALSE时可能的错误为EGL_BAD_PARAMETER。api取值为:EGL_OPENGL_API、EGL_OPENGL_ES_API、EGL_OPENVG_API。

eglQueryAPI——

EGLAPI EGLenum EGLAPIENTRY eglQueryAPI(void);

eglQueryAPI用于获取调用线程的渲染API,可能返回EGL_NONE。

eglWaitClient——

EGLAPI EGLBoolean EGLAPIENTRY eglWaitClient(void);

eglWaitClient用于等待client API执行完毕才继续后面的渲染工作,返回EGL_FALSE时可能的错误为EGL_BAD_CURRENT_SURFACE。

eglReleaseThread——

EGLAPI EGLBoolean EGLAPIENTRY eglReleaseThread(void);

eglReleaseThread用于清空每个线程的状态为初始值,如错误、API、context等。

eglCreatePbufferFromClientBuffer——

EGLAPI EGLSurface EGLAPIENTRY eglCreatePbufferFromClientBuffer(
          EGLDisplay dpy, EGLenum buftype, EGLClientBuffer buffer,
          EGLConfig config, const EGLint *attrib_list);

eglCreatePbufferFromClientBuffer用于创建绑定到OpenVG图片的off-screen的pixel buffer surface,失败时返回EGL_NO_SURFACE,可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_CONFIG、EGL_BAD_PARAMETER、EGL_BAD_ACCESS、EGL_BAD_ATTRIBUTE、EGL_BAD_ALLOC、EGL_BAD_MATCH。buftype值为EGL_OPENVG_IMAGE,attrib_list的属性可以是EGL_MIPMAP_TEXTURE、EGL_TEXTURE_FORMAT、EGL_TEXTURE_TARGET。

eglSurfaceAttrib——

EGLAPI EGLBoolean EGLAPIENTRY eglSurfaceAttrib(EGLDisplay dpy, EGLSurface surface,
                EGLint attribute, EGLint value);

eglSurfaceAttrib用于设置surface属性,返回EGL_FALSE时可能的错误为EGL_BAD_DISPLAY、EGL_BAD_MATCH、EGL_NOT_INITIALIZED、EGL_BAD_SURFACE、EGL_BAD_ATTRIBUTE。attribute值为EGL_MIPMAP_LEVEL、EGL_MULTISAMPLE_RESOLVE、EGL_SWAP_BEHAVIOR。

eglBindTexImage——

EGLAPI EGLBoolean EGLAPIENTRY eglBindTexImage(EGLDisplay dpy, EGLSurface surface, EGLint buffer);

eglBindTexImage用于定义二维纹理图片,返回EGL_FALSE时可能的错误为EGL_BAD_ACCESS、EGL_BAD_MATCH、EGL_BAD_SURFACE。

eglReleaseTexImage——

EGLAPI EGLBoolean EGLAPIENTRY eglReleaseTexImage(EGLDisplay dpy, EGLSurface surface, EGLint buffer);

eglReleaseTexImage用于释放用作纹理的color buffer,返回EGL_FALSE时可能的错误为EGL_BAD_MATCH、EGL_BAD_SURFACE。

eglSwapInterval——

EGLAPI EGLBoolean EGLAPIENTRY eglSwapInterval(EGLDisplay dpy, EGLint interval);

eglSwapInterval用于设置buffer交换时的最小帧数,返回EGL_FALSE时可能的错误为EGL_BAD_CONTEXT、EGL_BAD_SURFACE。

eglCreateContext——

EGLAPI EGLContext EGLAPIENTRY eglCreateContext(EGLDisplay dpy, EGLConfig config,
                EGLContext share_context,
                const EGLint *attrib_list);

eglCreateContext用于创建渲染context,失败时返回EGL_NO_CONTEXT,可能的错误为EGL_BAD_MATCH、EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_CONFIG、EGL_BAD_CONTEXT、EGL_BAD_ATTRIBUTE、EGL_BAD_ALLOC。attrib_list属性值为EGL_CONTEXT_CLIENT_VERSION。

eglDestroyContext——

EGLAPI EGLBoolean EGLAPIENTRY eglDestroyContext(EGLDisplay dpy, EGLContext ctx);

eglDestroyContext用于销毁渲染context,如果有其它线程使用这个context时就等到不使用时再销毁,返回EGL_FALSE时可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_CONTEXT。

eglMakeCurrent——

EGLAPI EGLBoolean EGLAPIENTRY eglMakeCurrent(EGLDisplay dpy, EGLSurface draw,
              EGLSurface read, EGLContext ctx);

eglMakeCurrent用于绑定渲染context和surface,返回EGL_FALSE时可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_SURFACE、EGL_BAD_CONTEXT、EGL_BAD_MATCH、EGL_BAD_ACCESS 、EGL_BAD_NATIVE_PIXMAP、EGL_BAD_NATIVE_WINDOW、EGL_BAD_CURRENT_SURFACE、EGL_BAD_ALLOC、EGL_CONTEXT_LOST。

eglGetCurrentContext——

EGLAPI EGLContext EGLAPIENTRY eglGetCurrentContext(void);

eglGetCurrentContext用于获取当前的渲染context。

eglGetCurrentSurface——

EGLAPI EGLSurface EGLAPIENTRY eglGetCurrentSurface(EGLint readdraw);

eglGetCurrentSurface用于获取当前的surface。

eglGetCurrentDisplay——

EGLAPI EGLDisplay EGLAPIENTRY eglGetCurrentDisplay(void);

eglGetCurrentDisplay用于获取当前的display。

eglQueryContext——

EGLAPI EGLBoolean EGLAPIENTRY eglQueryContext(EGLDisplay dpy, EGLContext ctx,
               EGLint attribute, EGLint *value);

eglQueryContext用于获取context信息,返回EGL_FALSE时可能的错误为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_CONTEXT、EGL_BAD_ATTRIBUTE。attribute值为EGL_CONFIG_ID、EGL_CONTEXT_CLIENT_TYPE、EGL_CONTEXT_CLIENT_VERSION、EGL_RENDER_BUFFER。

eglWaitGL——

EGLAPI EGLBoolean EGLAPIENTRY eglWaitGL(void);

eglWaitGL用于执行GL操作完毕后才继续后面的渲染工作,返回EGL_FALSE时可能的错误为EGL_BAD_CURRENT_SURFACE。

eglWaitNative——

EGLAPI EGLBoolean EGLAPIENTRY eglWaitNative(EGLint engine);

eglWaitNative用于native操作执行完毕之后才继续后面GL渲染,返回EGL_FALSE时可能的错误为EGL_BAD_CURRENT_SURFACE。engine值为EGL_CORE_NATIVE_ENGINE。

eglSwapBuffers——

EGLAPI EGLBoolean EGLAPIENTRY eglSwapBuffers(EGLDisplay dpy, EGLSurface surface);

eglSwapBuffers用于置换surface的颜色buffer到native window,返回EGL_FALSE时可能的原因为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_SURFACE、EGL_CONTEXT_LOST。

eglCopyBuffers——

EGLAPI EGLBoolean EGLAPIENTRY eglCopyBuffers(EGLDisplay dpy, EGLSurface surface,
              EGLNativePixmapType target);

eglCopyBuffers用于拷贝surface的颜色buffer到native pixmap,返回EGL_FALSE时可能的原因为EGL_BAD_DISPLAY、EGL_NOT_INITIALIZED、EGL_BAD_SURFACE、EGL_BAD_NATIVE_PIXMAP、EGL_BAD_MATCH、EGL_CONTEXT_LOST。

eglGetProcAddress——

typedef void (*__eglMustCastToProperFunctionPointerType)(void);
EGLAPI __eglMustCastToProperFunctionPointerType EGLAPIENTRY
       eglGetProcAddress(const char *procname);

eglGetProcAddress用于获取GL或EGL的扩展函数。

5、EGL综述

(以下内容翻译自https://www.khronos.org/registry/EGL/sdk/docs/man/html/eglIntro.xhtml

EGL(The Khronos Platform Graphics Interface)提供了一种方法用于通过客户端API和本地窗口系统进行渲染,客户端API包括用于嵌入式系统的3D渲染器OpenGL ES、用于桌面系统的的OpenGL ES的超集OpenGL、2D矢量图形渲染器OpenVG,本地窗口系统包括Windows、X。

基于EGL的实现,它或多或少与本地窗口系统紧密关联,大多数EGL功能都需要一个显示连接,这可以通过函数eglGetDisplay获得,然后通过函数eglInitialize初始化显示连接并获得EGL版本号。

本地窗口系统使得EGL的一系列图形可用于客户端API的渲染,这些图形可能是pixel格式、frame buffer配置等,通过这些图形还可能通过本地窗口系统的API创建window和pixmap。

EGL的surface从本地window或pixmap扩展而来,还带有一些额外的buffer,包括color buffer、depth buffer、stencil buffer和alpha mask buffer,在EGL的frame buffer配置中包含这些额外buffer的部分或全部。

EGL支持三种类型的surface渲染,分别是window、pixmap和pixel buffer。其中,window和pixmap类型的surface与本地窗口系统对应的资源息息相关;而pixel buffer则是EGL资源独享的,不可通过本地窗口系统进行渲染。

为了能够在EGL的surface上使用客户端API进行渲染,必须使用应用程序需要的渲染特性来配置合适的EGL frame buffer,相关的三个函数为eglChooseConfig、eglGetConfigs和eglGetConfigAttrib。对于window和pixmap类型的EGL surface来说,合适的本地window或pixmap匹配了本地图形时,应该首先被创建出来;对于一个给定个EGL frame buffer配置,可以通过eglGetConfigAttrib获取本地图形的类型和ID;而对于pixpel buffer来说,则不需本地资源。

从本地窗口创建EGL的window surface时调用eglCreateWindowSurface,从本地pixmap创建EGL的pixmap surface时调用eglCreatePixmapSurface,而创建与本地buffer无关联的EGL pixel buffer surface时,则使用eglCreatePbufferSurface,通过eglCreatePbufferFromClientBuffer创建的pbuffer surface的color buffer则是由OpenVG提供的,使用eglDestroySurface可以释放之前分配的资源。

绑定客户端的渲染与EGL的surface时,需要用到EGL渲染context,context与surface的frame buffer配置必须是兼容的,通过eglCreateContext创建EGL渲染context,客户端API的类型还会被第一次调用eglBindAPI而设定。

通过eglMakeCurrent可能绑定了一个EGL渲染context到一个或多个EGL surface,这样context和surface就建立了关系,后面的客户端API渲染都使用了同样的context,直到以不同的参数来再次调用eglMakeCurrent。

在同一个surface上可能同时执行了本地和客户端API的命令,但它们不是同步的,同步需要调用eglWaitClient或eglWaitNative,或者是其它的本地窗口系统命令。

下面是一个非常简单的例子,用于创建RGBA格式的window,通过OpenGL ES进行渲染,程序运行后,window颜色为黄色。

#include <stdlib.h>
#include <unistd.h>
#include <GLES/egl.h>
#include <GLES/gl.h>
typedef ... NativeWindowType;
extern NativeWindowType createNativeWindow(void);
static EGLint const attribute_list[] = {
        EGL_RED_SIZE, 1,
        EGL_GREEN_SIZE, 1,
        EGL_BLUE_SIZE, 1,
        EGL_NONE
};
int main(int argc, char ** argv)
{
        EGLDisplay display;
        EGLConfig config;
        EGLContext context;
        EGLSurface surface;
        NativeWindowType native_window;
        EGLint num_config;
        /* get an EGL display connection */
        display = eglGetDisplay(EGL_DEFAULT_DISPLAY);
        /* initialize the EGL display connection */
        eglInitialize(display, NULL, NULL);
        /* get an appropriate EGL frame buffer configuration */
        eglChooseConfig(display, attribute_list, &config, 1, &num_config);
        /* create an EGL rendering context */
        context = eglCreateContext(display, config, EGL_NO_CONTEXT, NULL);
        /* create a native window */
        native_window = createNativeWindow();
        /* create an EGL window surface */
        surface = eglCreateWindowSurface(display, config, native_window, NULL);
        /* connect the context to the surface */
        eglMakeCurrent(display, surface, surface, context);
        /* clear the color buffer */
        glClearColor(1.0, 1.0, 0.0, 1.0);
        glClear(GL_COLOR_BUFFER_BIT);
        glFlush();
        eglSwapBuffers(display, surface);
        sleep(10);
        return EXIT_SUCCESS;
}
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值