[3 EGL简介]

EGL提供如下机制：
1 与设备的原生窗口系统通信
2 查询绘图表面的可用类型和配置
3 创建绘图表面
4 在OpenGL ES 3.0和其他图形渲染API(如桌面OpenGL或窗口系统的原生绘图命令)之间同步渲染
5 管理纹理贴图等渲染资源
本章介绍打开一个窗口所需要的基本步骤

3.1 与窗口系统通信

EGL提供了OpenGL ES 3.0和运行于计算机上的原生窗口系统(如Linux系统常见的X Window系统)之间的一个结合层。
EGL提供基本的不透明类型--EGLDisplay,该类型封装了所有系统相关性。任何使用EGL的应用程序必须执行的第一个操作时创建和初始化与本地EGL显示的连接。
例3-1 初始化EGL：

EGLint majorVersion;
EGLint minorVersion;
// 打开与EGL显示服务器的连接
esContext->eglDisplay = eglGetDisplay( esContext->eglNativeDisplay );
if ( esContext->eglDisplay == EGL_NO_DISPLAY )
{
   return GL_FALSE;
}

// Initialize EGL
if ( !eglInitialize ( esContext->eglDisplay, &majorVersion, &minorVersion ) )
{
   return GL_FALSE;
}

3.2 检查错误

EGLint eglGetError()

3.3 初始化EGL

初始化EGL内部数据结构，返回EGL实现的主版本号和次版本号：

// display:指定EGL显示连接
EGLBoolean eglInitialize(EGLDisplay display, EGLint *majorVersion, EGLint *minorVersion)

3.4 确定可用表面配置

查询底层窗口系统支持的所有EGL表面配置：

// display:指定EGL显示连接
// configs:指定configs列表
// maxReturnConfigs:指定configs的大小
// numConfigs:指定返回的configs大小
EGLBoolean eglGetConfigs(EGLDisplay display, EGLConfig *configs, EGLint maxReturnConfigs, EGLint *numConfigs)

3.5 查询EGLConfig属性

// display:指定EGL显示连接
// config:指定要查询的配置
// attribute:指定返回的特定属性
// value:指定返回值
EGLBoolean eglGetConfigAttrib(EGLDisplay display, EGLConfig config, EGLint attribute, EGLint *value)

EGLConfig属性：
https://www.cnblogs.com/wellcherish/p/12727906.html

3.6 让EGL选择配置

// display:指定EGL显示连接
// attribList:指定configs匹配的属性列表
// configs:指定配置列表
// maxReturnConfigs:指定配置的大小
// numConfigs:指定返回的配置大小
EGLBoolean eglChooseConfig(EGLDisplay display, const EGLint *attribList, EGLConfig *configs, EGLint maxReturnConfigs, EGLint *numConfigs)

例3-2 指定EGL属性
需要支持RGB565的渲染表面、一个深度缓冲区和OpenGL ES 3.0的EGLConfig。

EGLint attribList[] =
{
     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
};

例3-3 查询EGL表面配置

const EGLint MaxConfigs = 10;
EGLConfig configs[MaxConfigs];
EGLint numConfigs;
// Choose config
if ( !eglChooseConfig ( esContext->eglDisplay, attribList, &config, MaxConfigs, &numConfigs ) )
{
    // Something did not work
} else {
    // Everything is okey; continue to create a rendering surface
}

3.7 创建屏幕上的渲染区域：EGL窗口

一旦我们有了符合渲染需求的EGLConfig，就为创建窗口做好了准备。

// display:指定EGL显示连接
// config:指定配置
// window:指定原生窗口
// attribList:指定窗口属性列表;可能为NULL
EGLSurface eglCreateWindowSurface(EGLDisplay display, EGLConfig config, EGLNativeWindowType window, const EGLint *attribList)

例3-4 创建一个EGL窗口表面

EGLint attribList [] =
{
    EGL_RENDER_BUFFER, EGL_BACK_BUFFER,
    EGL_NONE
};

// Create a surface
EGLSurface window = eglCreateWindowSurface ( esContext->eglDisplay, config,
                                             esContext->eglNativeWindow, attribList );

if ( window == EGL_NO_SURFACE ) {
    switch (eglGetError()) {
        case EGL_BAD_MATCH:
            break;
        case EGL_BAD_CONFIG:
            break;
        case EGL_BAD_NATIVE_WINDOW:
            break;
        case EGL_BAD_ALLOC:
            break;
    }
}

窗口不是唯一的可用渲染表面，我们来介绍另一种渲染表面类型。

3.8 创建屏幕外渲染区域：EGL Pbuffer

Pbuffer(Pixel buffer像素缓冲区)，常用于生成纹理贴图。

// display:指定EGL显示连接
// config:指定配置
// attribList:指定窗口属性列表;可能为NULL
EGLSurface eglCreatePbufferSurface(EGLDisplay display, EGLConfig config, const EGLint *attribList)

例3-5 创建EGL像素缓冲区

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
};

const EGLint MaxConfigs = 10;
EGLConfig configs[MaxConfigs];
EGLint numConfigs;
// Choose config
if ( !eglChooseConfig ( esContext->eglDisplay, attribList, &config, MaxConfigs, &numConfigs ) )
{
    // Something did not work
} else {
    // Everything is okey; continue to create a rendering surface
}

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

pbuffer = eglCreatePbufferSurface(display, config, attribList);
if (pbuffer == EGL_NO_SURFACE) {
    switch (eglGetError()) {
        case EGL_BAD_MATCH:
            break;
        case EGL_BAD_CONFIG:
            break;
        case EGL_BAD_PARAMETER:
            break;
        case EGL_BAD_ALLOC:
            break;
    }
}

3.9 创建一个渲染上下文

渲染上下文是OpenGL ES 3.0的内部数据结构，包含操作所需的所有状态信息。

// display:指定EGL显示连接
// config:指定配置
// shareContext:允许多个EGL上下文共享特定类型的数据;使用EGL_NO_CONTEXT表示没有共享
// attribList:指定窗口属性列表;可能为NULL
EGLContext eglCreateContext(EGLDisplay display, EGLConfig config, EGLContext shareContext, const EGLint *attribList)

例3-6 创建一个EGL上下文

const EGLint attribList[] = 
{
    // EGL_KHR_create_context is required
    EGL_CONTEXT_CLIENT_VERSION,    3,
    EGL_NONE
}
EGLContext context = eglCreateContext(display, config, EGL_NO_CONTEXT, attribList)
if (context == EGL_NO_CONTEXT) {
    ...
}

3.10 指定某个EGLContext为当前上下文

因为一个应用程序可能创建多个EGLContext用于不同的用途，所以我们需要关联特定的EGLContext和渲染表面。
关联EGLContext和EGLSurface:

// display:指定EGL显示连接
// draw:指定EGL绘图表面
// read:指定EGL读取表面
// context:指定连接到该表面的渲染上下文
EGLBoolean eglMakeCurrent(EGLDispaly display, EGLSurface draw, EGLSurface read, EGLContext context)

3.11 完整例子

例3-7 创建EGL窗口的完整例程

EGLBoolean initializeWindow (EGLNativeWindow nativeWindow)
{
    const EGLint configAttribs[] =
    {
        EGL_RENDER_TYPE, EGL_WINDOW_BIT,
        EGL_RED_SIZE,    8,
        EGL_GREEN_SIZE,    8,
        EGL_BLUE_SIZE,    8,
        EGL_DEPTH_SIZE,    24,
        EGL_NONE
    };

    const EGLint contextAttribs[] =
    {
        EGL_CONTEXT_CLIENT_VERSION,    3,
        EGL_NONE
    };
    
    EGLDisplay display = eglGetDisplay(EGL_DEFAULT_DISPLAY);
    if (display == EGL_NO_DISPLAY) {
        return EGL_FALSE;
    }
    
    EGLint major, minor;
    if (!eglInitialize(display, &major, &minor)) {
        return EGL_FALSE;
    }

    EGLConfig config;
    EGLint numconfigs;
    if (!eglChooseConfig(display, configAttribs, &config, 1, &numConfigs)) {
        return EGL_FALSE;
    }

    EGLSurface window = eglCreateWindowSurface(display, config, nativeWindow, NULL);
    if (window == EGL_NO_SURFACE) {
        return EGL_FALSE;
    }

    EGLContext context = eglCreateContext(display, config, EGL_NO_CONTEXT, contextAttribs);
    if (context == EGL_NO_CONTEXT) {
        return EGL_FALSE;
    }
    if (!eglMakeCurrent(display, window, window, context)) {
        return EGL_FALSE;
    }

    return EGL_TRUE;
}

上述代码和例3-8中代码类似。

例3-8 用esUtil库创建一个窗口

ESContext esContext;
const char* title = "Window Title";

if (esCreateWindow(&esContext, title, 512, 512, ES_WINDOW_RGB|ES_WINDOW_DEPTH)) {
    // Window creation failed
}

ES_WINDOW_RGB:基于RGB的颜色缓冲区
ES_WINDOW_ALPHA:Alpha缓冲区
ES_WINDOW_DEPTH:深度缓冲区
ES_WINDOW_STENCIL:模板缓冲区
ES_WINDOW_MULTISAMPLE:多重采样缓冲区