OpenGL ES EGL eglCreatePbufferSurface-猿说编程

ChatGPT 3.5 国内中文镜像站免费使用啦

零基础 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 绘制流程简介

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

图片[1]-OpenGL ES EGL eglCreatePbufferSurface-猿说编程

三.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。

*/

相关错误码：

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

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
	}