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

获取 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 之间的连接

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

五.猜你喜欢

本文由博客 - 猿说编程猿说编程发布！