Transcoder代码学习-核心代码-egloo库

com.otaliastudios.opengl:egloo 开源库代码分析

egloo 是一个轻量级 Android OpenGL ES 工具库，专注于简化 EGL 环境管理和 OpenGL 操作。以下是其核心实现分析：

---

​一、核心功能模块​

1. ​EGL 环境管理 ​ (EglCore, EglSurface)

   • 封装 EGLDisplay/EGLContext/EGLConfig 初始化

   • 提供离屏渲染表面（EGL_PBUFFER）和窗口表面（EGL_WINDOW_BIT）支持

   • 自动处理线程绑定关系：

     public void makeCurrent() {
         if (!egl.eglMakeCurrent(display, surface, surface, context)) {
             throw new GLException("eglMakeCurrent failed");
         }
         currentThread = Thread.currentThread();
     }

2. ​纹理管理 ​ (GlTexture)

   • 自动化纹理生命周期：

     public void setup(int width, int height, int format) {
         int[] textures = new int[1];
         GLES20.glGenTextures(1, textures, 0);
         id = textures[0];
         // 绑定并配置纹理参数
         GLES20.glBindTexture(target, id);
         GLES20.glTexImage2D(..., width, height, ..., format, ...);
     }

3. ​帧缓冲对象 ​ (GlFramebuffer)

   • 封装 FBO 的创建/绑定/删除：

     public void attachTexture(GlTexture texture) {
         GLES20.glFramebufferTexture2D(
             GL_FRAMEBUFFER, 
             GL_COLOR_ATTACHMENT0,
             texture.getTarget(), 
             texture.getId(), 0
         );
         checkFramebufferStatus();
     }

4. ​着色器工具 ​ (ShaderProgram)

   • GLSL 程序自动编译：

     public void link() {
         GLES20.glLinkProgram(handle);
         int[] status = new int[1];
         GLES20.glGetProgramiv(handle, GL_LINK_STATUS, status, 0);
         if (status[0] != GL_TRUE) {
             throw new GLException("Link failed: " + GLES20.glGetProgramInfoLog(handle));
         }
     }

---

​二、关键设计亮点​

1. ​线程安全保障​

   • 通过 ThreadLocal 跟踪当前 EGL 上下文线程

   • 跨线程调用自动检测：

     void checkThread() {
         if (Thread.currentThread() != currentThread) {
             throw new IllegalStateException("Wrong thread");
         }
     }

2. ​资源自动回收​

   • 实现 Releasable 接口统一管理资源：

     public interface Releasable {
         void release();
     }

   • GlTexture/GlFramebuffer 在析构时自动释放 GPU 资源

3. ​异常处理策略​

   • 封装 GL 错误检查宏：

     static void checkError(String op) {
         int error;
         while ((error = GLES20.glGetError()) != GL_NO_ERROR) {
             Log.e("GL", op + ": glError " + error);
         }
     }

---

​三、性能优化点​

1. ​对象池重用​

   • 对 FloatBuffer/IntBuffer 等高频对象使用对象池
   • 减少 JVM 内存分配开销

2. ​纹理格式推断​

   • 根据 Android 版本自动选择最优内部格式：

     int internalFormat = Build.VERSION.SDK_INT >= 26 ? 
                          GL_RGBA8 : GL_RGBA;

3. ​异步操作支持​

   • EglSurface 提供 swapBuffers() 非阻塞实现
   • 通过 EGL 扩展 EGL_KHR_fence_sync 实现 GPU-CPU 同步

---

​四、典型使用场景​

// 1. 初始化EGL环境
EglCore core = new EglCore(null, EglCore.FLAG_TRY_GLES3);

// 2. 创建离屏渲染表面
EglSurface surface = new OffscreenSurface(core, 720, 1080);
surface.makeCurrent();

// 3. 配置帧缓冲
GlFramebuffer fbo = new GlFramebuffer();
fbo.attachTexture(texture);

// 4. 执行渲染
GLES20.glClear(GL_COLOR_BUFFER_BIT);
GLES20.glDrawArrays(...);

// 5. 读取像素数据
ByteBuffer pixels = ByteBuffer.allocate(4 * width * height);
GLES20.glReadPixels(0, 0, width, height, GL_RGBA, GL_UNSIGNED_BYTE, pixels);

// 6. 释放资源
fbo.release();
surface.release();
core.release();

---

​五、局限性与改进方向​

1. ​功能局限​

   • 不支持 Vulkan/Metal 多后端
   • 缺少高级渲染特性（如计算着色器）

2. ​扩展建议​

   // 示例：添加多目标渲染支持（MRT）
   public void attachTextures(GlTexture[] textures) {
       DrawBuffer[] buffers = new DrawBuffer[textures.length];
       for (int i=0; i<textures.length; i++) {
           glFramebufferTexture2D(..., GL_COLOR_ATTACHMENT0 + i, ...);
           buffers[i] = GL_COLOR_ATTACHMENT0 + i;
       }
       GLES30.glDrawBuffers(buffers.length, buffers, 0);
   }

---

总结

egloo 通过简洁的 API 设计解决了 Android OpenGL 开发的三大痛点：

1. EGL上下文生命周期管理
2. GPU资源泄漏风险
3. 跨线程安全调用机制

其核心价值在于为 Android 平台上的 ​高效离屏渲染​（如视频帧处理、图像滤镜）提供了轻量级基础设施。对于需要直接操作 OpenGL 但避免重型引擎（如 GPUImage）的场景是理想选择。