OpenGL ES EGL eglCreatePbufferSurface

目录

• 一. EGL 前言
• 二. EGL 绘制流程简介
• 三.eglCreatePbufferSurface 函数简介
  • 1.eglCreatePbufferSurface 简介
  • 2.eglCreatePbufferSurface 和 eglCreateWindowSurface 区别
• 四.eglCreatePbufferSurface 使用
• 五.猜你喜欢

零基础 OpenGL ES 学习路线推荐 : OpenGL ES 学习目录 >> OpenGL ES 基础

零基础 OpenGL ES 学习路线推荐 : OpenGL ES 学习目录 >> OpenGL ES 特效

零基础 OpenGL ES 学习路线推荐 : OpenGL ES 学习目录 >> OpenGL ES 转场

零基础 OpenGL ES 学习路线推荐 : OpenGL ES 学习目录 >> OpenGL ES 函数

零基础 OpenGL ES 学习路线推荐 : OpenGL ES 学习目录 >> OpenGL ES GPUImage 使用

零基础 OpenGL ES 学习路线推荐 : OpenGL ES 学习目录 >> OpenGL ES GLSL 编程

一. EGL 前言

EGLNativeDisplayType – 系统显示类型，标识你所开发设备的物理屏幕，DX/OPenGL ES/Metal/Vulkan….

EGLNativeWindowType – 系统窗口，渲染显示的窗口句柄

EGLDisplay – 关联 EGLNativeDisplayType 系统物理屏幕的通用数据类型，是平台上 WGL / GLX / AGL 的等价物

EGLSurface – 渲染区域，相当于 OpenGL ES 绘图的画布 （一块内存空间），用户想绘制的信息首先都要先绘制到 EGLSurface 上，然后通过 EGLDisplay 显示

EGLConfig – 对 EGLSurface 的 EGL 配置，可以理解为绘制目标 framebuffer 的配置属性

EGLContext – OpenGL ES 图形上下文

二. EGL 绘制流程简介

1. 获取 EGL Display 对象：eglGetDisplay
2. 初始化与 EGLDisplay 之间的连接：eglInitialize
3. 获取 EGLConfig 对象：eglChooseConfig / eglGetConfigs
4. 创建 EGLContext 实例：eglCreateContext
5. 创建 EGLSurface 实例：eglCreateWindowSurface / eglCreatePbufferSurface
6. 连接 EGLContext 和 EGLSurface：eglMakeCurrent
7. 使用 OpenGL ES API 绘制图形：gl_*
8. 切换 front buffer 和 back buffer 显示：eglSwapBuffer
9. 断开并释放与 EGLSurface 关联的 EGLContext 对象：eglRelease
10. 删除 EGLSurface 对象
11. 删除 EGLContext 对象
12. 终止与 EGLDisplay 之间的连接

三.eglCreatePbufferSurface 函数简介

1.eglCreatePbufferSurface 简介

EGLSurface eglCreatePbufferSurface(
	EGLDisplay display, 		// 指定EGL显示连接
        EGLConfig config, 		// 指定配置
        const EGLint *attribList)       // 指定像素缓冲区属性

/*
attribList的属性可以是：

EGL_HEIGHT：默认值为0。
EGL_LARGEST_PBUFFER：默认值为EGL_FALSE。
EGL_MIPMAP_TEXTURE：默认值为EGL_FALSE。
EGL_TEXTURE_FORMAT：默认值为EGL_NO_TEXTURE，还可以选择EGL_TEXTURE_RGB或>EGL_TEXTURE_RGBA。
EGL_TEXTURE_TARGET：默认值为EGL_NO_TEXTURE，还可以选择EGL_TEXTURE_2D。
EGL_VG_ALPHA_FORMAT：只适用于OpenVG，默认值为EGL_VG_ALPHA_FORMAT_NONPRE，>还可以选择EGL_VG_ALPHA_FORMAT_PRE。
EGL_VG_COLORSPACE：只适用于OpenVG，默认值为EGL_VG_COLORSPACE_sRGB，还可以选>择EGL_VG_COLORSPACE_LINEAR。
EGL_WIDTH：默认值为0。

*/
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

相关错误码：

EGL_BAD_MATCH ：提供了与窗口属性不匹配的 EGLConfig，或该 EGLConfig 不支持渲染到窗口
EGL_BAD_CONFIG ：提供的 EGLConfig 没有得到系统支持
EGL_BAD_NATIVE_WINDOW ：提供的原生窗口句柄无效
EGL_BAD_ALLOC ：无法为新的窗口分配资源，或已经有和提供的原生窗口关联的 EGLConfig
1
2
3
4

2.eglCreatePbufferSurface 和eglCreateWindowSurface区别

在文章 《OpenGL ES EGL 名词解释》有详细介绍， EGLSurface 一共分为三类：

1.Surface – 可显示的 Surface，实际上就是一个 FrameBuffer，用于绑定窗口后预览显示，通过 eglCreateWindowSurface 创建；

2.PixmapSurface – 不是可显示的 Surface，保存在系统内存中的位图；

3.PBufferSurface – 不是可显示的 Surface，保存在显存中的帧，用于离屏渲染，不需要绑定窗口，通过 eglCreatePbufferSurface 创建

四.eglCreatePbufferSurface 使用

创建 PBufferSurface 和创建 EGL 窗口非常类似，只有少数微小的不同。为了创建 PBufferSurface，需要和窗口一样找到 EGLConfig ，并作一处修改：我们需要扩增 EGL_SURFACE_TYPE 的值，使其包含 EGL_PBUFFER_BIT

/******************************************************************************************/
//@Author:猿说编程
//@Blog(个人博客地址): www.codersrc.com
//@File:OpenGL ES EGL eglCreatePbufferSurface
//@Time:2022/08/04 07:30
//@Motto:不积跬步无以至千里，不积小流无以成江海，程序人生的精彩需要坚持不懈地积累！
/******************************************************************************************/

	EGLint attribList[] = {
			EGL_SURFACE_TYPE,EGL_PBUFFER_BIT,
			EGL_RENDERABLE_TYPE, EGL_OPENGL_ES3_BIT_KHR,
			EGL_RED_SIZE, 5,
			EGL_GREEN_SIZE, 6,
			EGL_BLUE_SIZE, 5,
			EGL_DEPTH_SIZE, 1,
			EGL_NONE
	};

   // 查询EGL表面配置

	const EGLint MaxConfigs = 10;
	EGLConfig configs[MaxConfigs]; // We'll only accept 10 configs
	EGLint numConfigs;
	if (!eglChooseConfig(display, attribList, configs, MaxConfigs, &numConfigs)) {
		// Something didn't work … handle error situation
	} else {
		// Everything's okay. Continue to create a rendering surface
	}

    // Proceed to create a 512*512 pbuffer
	EGLSurface pbuffer;
	EGLint attribList2[] =
			{
					EGL_WIDTH, 512,
					EGL_HEIGHT, 512,
					EGL_LARGEST_PBUFFER, EGL_TRUE,
					EGL_NONE
			};

	pbuffer = eglCreatePbufferSurface(display, config, attribList2);

	if (pbuffer == EGL_NO_SURFACE) {
		switch (eglGetError()) {
			case EGL_BAD_ALLOC:
				// Not enough resources available. Handle and recover
				break;

			case EGL_BAD_CONFIG:
				// Verify that provided EGLConfig is valid
				break;

			case EGL_BAD_PARAMETER:
				// Verify that EGL_WIDTH and EGL_HEIGHT are non-negative values
				break;

			case EGL_BAD_MATCH:
				// Check window and EGLConfig attributes to determine
				// compatibility, or verify that the EGLConfig
				// supports rendering to a window,
				break;
		}
	}

	EGLint width;
	EGLint height;
	if(!eglQuerySurface( display,pbuffer,EGL_WIDTH,&width) ||
	   !eglQuerySurface( display,pbuffer,EGL_HEIGHT,&height))
	{
		//Unable to query surface information
	}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

五.猜你喜欢

1. OpenGL ES 简介
2. OpenGL ES 版本介绍
3. OpenGL ES 2.0 和 3.0 区别
4. OpenGL ES 名词解释(一)
5. OpenGL ES 名词解释(二)
6. OpenGL ES GLSL 着色器使用过程
7. OpenGL ES EGL 简介
8. OpenGL ES EGL 名词解释
9. OpenGL ES EGL eglGetDisplay
10. OpenGL ES EGL eglInitialize
11. OpenGL ES EGL eglGetConfigs
12. OpenGL ES EGL eglChooseConfig
13. OpenGL ES EGL eglGetError
14. OpenGL ES EGL eglCreateContext
15. OpenGL ES EGL eglCreateWindowSurface
16. OpenGL ES EGL eglCreatePbufferSurface