SurfaceTexture与camera preview绑定

1. 核心概念

SurfaceTexture 是 Android 中的一个类，它允许你从某些图像源（例如相机预览）捕获帧，并将这些帧作为纹理（Texture）渲染到 OpenGL ES 环境中。它通常用于需要在自定义渲染管道中显示摄像头预览的场景。

• 纹理（Texture）：SurfaceTexture 将图像帧作为 OpenGL ES 纹理，方便与 OpenGL 进行高效的图像处理。
• 帧缓冲区（Frame Buffer）：SurfaceTexture 内部维护着一个帧缓冲区，从源（如相机）接收帧。
• OpenGL 与 SurfaceTexture 结合：通常，SurfaceTexture 会与 OpenGL 一起使用，以便更高效地渲染和处理图像帧。

2. 主要功能

• 用于相机预览：常用于相机 API 中的自定义预览（比如将相机帧直接传输到 OpenGL 纹理中）。
• 低延迟处理：与 OpenGL 结合时，它能够实现低延迟的图像流处理。
• 同步处理：提供了对帧同步的支持，通过 updateTexImage() 同步纹理。

3. 关键方法

1. 构造方法

• SurfaceTexture(int texName)：创建一个 SurfaceTexture，并将其与指定的 OpenGL ES 纹理 ID 绑定（texName 是纹理的句柄）。

2. 绑定 SurfaceTexture 与 Surface

• Surface getSurface()：获取与此 SurfaceTexture 关联的 Surface 对象，可以将其传递给相机或视频解码器等，用于图像捕获。
• setDefaultBufferSize(int width, int height)：设置 SurfaceTexture 的默认缓冲区大小，这通常是预览帧的大小。

3. 处理图像帧

• updateTexImage()：从缓冲区中更新当前的纹理图像。这个方法通常在每一帧图像到来时调用，确保纹理内容被更新。
• getTimestamp()：获取当前纹理图像的时间戳，通常用于同步图像帧和其他信号。
• release()：释放 SurfaceTexture 占用的资源，通常在 SurfaceTexture 不再需要时调用。

4. 监听帧更新

• setOnFrameAvailableListener(SurfaceTexture.OnFrameAvailableListener listener)：设置帧可用时的监听器。当新的图像帧可用时，系统会调用此监听器。

surfaceTexture.setOnFrameAvailableListener(new SurfaceTexture.OnFrameAvailableListener() {
   
   
    @Override
    public void onFrameAvailable(SurfaceTexture surfaceTexture) {
   
   
        // 在新的图像帧到达时回调
    }
});

4. 使用流程

1. 创建 SurfaceTexture 对象

首先，通过创建 SurfaceTexture 并传递一个 OpenGL 纹理 ID 来初始化它。

int[] texture = new int[1];
GLES20.glGenTextures(1, texture, 0); // 创建一个 OpenGL 纹理
SurfaceTexture surfaceTexture = new SurfaceTexture(texture[0]); // 绑定这个纹理

2. 设置默认缓冲区大小

接下来，通常会设置 SurfaceTexture 的默认缓冲区大小，通常是相机预览的分辨率大小。

surfaceTexture.setDefaultBufferSize(1920, 1080); // 设置为 1920x1080 的分辨率

3. 获取 Surface 对象

你可以通过 SurfaceTexture.getSurface() 获取 Surface 对象，并将其传递给相机进行图像流的捕获。

Surface surface = new Surface(surfaceTexture);
camera.setPreviewSurface(surface); // 将 Surface 传递给相机

4. 同步纹理图像

在每一帧到达时，你需要调用 updateTexImage() 来同步纹理，并将其更新到 OpenGL 的纹理缓冲区中。

surfaceTexture.updateTexImage(); // 更新纹理图像

5. 释放资源

在不需要 SurfaceTexture 时，调用 release() 方法来释放它占用的资源。

surfaceTexture.release(); // 释放资源

5. 完整的示例代码

下面是一个完整的示例，展示如何使用 SurfaceTexture 来处理相机预览，并将其作为 OpenGL 纹理渲染。

public class MyGLRenderer implements GLSurfaceView.Renderer {
   
   

    private SurfaceTexture surfaceTexture;
    private int[] textures;

    @Override
    public void onSurfaceCreated(GL10 gl, EGLConfig config) {
   
   
        // 创建 OpenGL 纹理
        textures = new