📚 课程目录第4章 EGL与上下文管理

4. EGL与上下文管理

在OpenGL ES多线程渲染工程中，EGL是连接应用层与底层图形硬件的桥梁。它负责管理显示连接、配置帧缓冲、创建渲染上下文与表面，并决定上下文之间的资源共享关系。很多渲染异常——黑屏、纹理丢失、上下文切换崩溃、线程间资源竞争——根源并不在着色器或绘制调用，而在EGL初始化与上下文管理策略上。本章围绕EGL的完整生命周期展开，重点说明如何在多线程环境下正确创建、共享与切换上下文。

核心原理：EGL的四个关键对象

EGL的工作模型可以概括为四个对象：Display、Config、Context、Surface。Display代表与窗口系统的显示连接；Config描述帧缓冲的像素格式、深度、模板、多重采样等属性；Context保存OpenGL ES的状态机与对象命名空间；Surface则是实际可绘制的缓冲区，分为窗口表面、像素缓冲表面和离屏表面。

多线程渲染的核心矛盾在于：一个Context同一时刻只能被一个线程设为当前。若多个线程各自创建独立Context，则它们默认拥有彼此隔离的对象空间，纹理、缓冲区、着色器程序无法直接共用。EGL提供的共享上下文机制，允许在创建Context时传入一个已存在的Context作为share_context，使新Context与旧Context共享纹理、缓冲区、着色器等资源，但各自保留独立的渲染状态与当前表面。

方法流程：EGL初始化与上下文创建

标准EGL初始化流程如下：获取Display、初始化EGL、选择Config、创建Context、创建Surface、绑定上下文与表面。在多线程工程中，通常由主线程完成Display与Config的初始化，再将Config句柄传递给渲染线程，由各线程分别创建自己的Context与Surface。

EGLDisplay display = eglGetDisplay(EGL_DEFAULT_DISPLAY);
eglInitialize(display, &major, &minor);

EGLint configAttribs[] = {
    EGL_SURFACE_TYPE, EGL_WINDOW_BIT | EGL_PBUFFER_BIT,
    EGL_RENDERABLE_TYPE, EGL_OPENGL_ES3_BIT,
    EGL_RED_SIZE, 8, EGL_GREEN_SIZE, 8, EGL_BLUE_SIZE, 8,
    EGL_ALPHA_SIZE, 8, EGL_DEPTH_SIZE, 24, EGL_STENCIL_SIZE, 8,
    EGL_NONE
};
eglChooseConfig(display, configAttribs, &config, 1, &numConfigs);

// 主线程创建主上下文
EGLContext mainCtx = eglCreateContext(display, config, EGL_NO_CONTEXT, ctxAttribs);

// 渲染线程创建共享上下文
EGLContext workerCtx = eglCreateContext(display, config, mainCtx, ctxAttribs);

// 绑定当前线程的上下文与表面
eglMakeCurrent(display, surface, surface, workerCtx);

关键点在于eglCreateContext的第三个参数：传入EGL_NO_CONTEXT表示创建独立上下文；传入已有Context句柄则创建共享上下文。共享上下文之间可以互相访问纹理、缓冲区、着色器程序等对象，但FBO、VAO、查询对象等容器类对象默认不共享，需要显式管理。

共享上下文的边界与同步

共享上下文并非“所有资源都能共享”。下表列出常见对象的共享行为，工程中必须据此设计资源归属与同步策略。

对象类型	是否共享	多线程注意事项
纹理 Texture	共享	上传与采样需用Fence/事件同步
缓冲区 Buffer	共享	避免两线程同时写入同一Buffer
着色器/程序	共享	链接完成后不可再修改
Framebuffer Object	不共享	每线程各自创建与绑定
Vertex Array Object	不共享	每线程维护独立VAO
查询对象 Query	不共享	结果读取需在所属上下文
同步对象 Fence	共享	用于跨上下文GPU同步

常见误区：认为共享上下文后所有状态都互通。实际上，当前绑定的FBO、VAO、视口、混合状态、深度测试状态都是每上下文独立的。若渲染线程未正确设置视口，画面会被裁剪或拉伸。

表面与窗口系统集成

Surface是EGL与窗口系统之间的接口。Android平台上，通常通过ANativeWindow或Surface创建EGLSurface。窗口表面与视图生命周期强绑定：当窗口尺寸变化、Surface销毁或应用退到后台时，必须重新创建或更新EGLSurface，否则会出现渲染到无效缓冲区的问题。

典型集成流程为：窗口就绪后获取NativeWindow，创建EGLSurface，调用eglMakeCurrent绑定；窗口销毁前先调用eglMakeCurrent(display, EGL_NO_SURFACE, EGL_NO_SURFACE, EGL_NO_CONTEXT)解绑，再销毁Surface。多线程场景下，每个渲染线程应绑定自己的Surface，避免多个线程同时向同一窗口表面绘制。

// 窗口尺寸变化时重建Surface
eglMakeCurrent(display, EGL_NO_SURFACE, EGL_NO_SURFACE, EGL_NO_CONTEXT);
eglDestroySurface(display, oldSurface);
oldSurface = eglCreateWindowSurface(display, config, nativeWindow, NULL);
eglMakeCurrent(display, oldSurface, oldSurface, workerCtx);
glViewport(0, 0, newWidth, newHeight);

案例与复盘：多线程纹理上传

一个典型场景是：主线程负责渲染，工作线程负责解码并上传纹理。工作线程创建与主线程共享的Context，绑定PBuffer Surface，将解码后的图像上传为纹理，然后通过Fence通知主线程。主线程在渲染前等待Fence，确保纹理数据已就绪。这样既利用了多核并行，又避免了主线程阻塞。

实践建议：共享上下文数量不宜过多，通常1个主上下文加1~2个工作上下文即可。每个上下文都会占用GPU状态资源，过多上下文会增加驱动调度开销。上下文切换时务必确认当前线程已解绑旧上下文，避免跨线程使用同一Context。

复盘要点：第一，EGL初始化必须检查每一步返回值，eglGetError是排障的第一手信息；第二，共享上下文创建时必须使用同一个Display和兼容的Config；第三，Surface生命周期与窗口系统一致，窗口变化时先解绑再重建；第四，跨线程资源共享必须配合Fence或事件同步，不能依赖“先后顺序”假设。掌握这些原则，才能为后续多线程渲染管线打下稳定基础。