获取绘制信息

======================

EGL的API作用分类:

用于与手机关联并获取手机支持的配置信息

用于根据需要生成手机支持的surface和context,并对surface和context进行关联

用于指定使用哪个版本的OpenGL ES,并与OpenGL ES建立关联

用于操作EGL上纹理,以及与多线程相关的高级功能

其他用处



常用API如下:

1.


EGLint eglGetError(void);


功能:用于返回当前thread,如果EGL的API出错的话,最近一个错误所对应的错误代码

输出:错误代码



2.


EGLDsiplay eglGetDisplay(EGLNativeDisplayType display_id);


功能:从EGL运行的操作系统中获取一个Display(获取手机屏幕)

输入:从操作系统中,得知的Display的ID

输出:用于显示图片绘制的Display



3.


EGLBoolean eglInitalize(EGLDisplay dpy, EGLint *major, EGLint *minor);


功能:针对某display初始化一个某版本的EGL

输入:使用Display的handle特指某个Display,major和minor共同用于指定EGL的版本

输出:EGL初始化成功或者失败



4.


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


功能:获取某display支持的配置信息

输入:display的handle,一个用于保存配置信息的指针,指针中存放的配置信息的数量,某display支持的配置信息数量

输出:配置信息获取成功或者失败



5.


EGLBoolean eglChooseConfig(EGLDisplay dpy, const EGLint * attrib_list, EGLConfig* configs, ELGint config_size, EGLint * num_config)


功能:获取与需求匹配,且某display支持的配置信息(根据开发者的需要,获取一种手机支持的buffer格式)

输入:display的handle,用于匹配使用的需求信息,一个用于保存匹配信息的指针,指针中存放的配置信息的数量,匹配配置信息的数量

输出:匹配的配置信息获取成功或者失败



6.


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


功能:创建一个可以显示在屏幕上的rendering surface(根据获取的格式,创建handle,用于包含手机系统提供的绘制所需的buffer)

输入:display的handle,用于创建surface的配置信息,窗口信息的handle,额外的需求信息

输出:创建的rendering surface的handle



7. 


EGLBoolean eglBindAPI(EGLenum api)


功能:设置当前thread的绘制API(用于指定使用的绘制语言:EGL_OPENGL_ES_API)

输入:支持的绘制API

输出:API设置成功或者失败



8.


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


功能:针对当前的绘制API创建一个rendering context(创建调色板,用于保存状态集)

输入:display的handle,用于创建context的配置信息,指定一个context使得创建的context与其share,额外的需求信息

输出:创建的rendering context的handle



9.


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


功能:将指定的context绑定到当前thread以及读和写的surface上(将创建的surface和context启动)

输入:display的handle,用于写入的surface,用于读取的surface,指定的context

输出:创建的rendering context的handle



10.


EGLBoolean eglSwapBuffers(EGLDisplay dpy, EGLSurface surface)


功能:将surface中的color buffer显示到屏幕上(用于将绘制完毕的buffer与手机屏幕上显示的buffer进行交换)

输入:display的handle,将会被展示的surface

输出:显示成功或者失败



11.


EGLBoolean eglTerminate(EGLDisplay dpy)


功能:将某display对应的EGL相关的资源释放

输入:使用Display的handle特指某个display

输出:释放EGL相关资源成功或者失败