SurfaceTexture 类

定义

[Android.Runtime.Register("android/graphics/SurfaceTexture", DoNotGenerateAcw=true)]
public class SurfaceTexture : Java.Lang.Object

[<Android.Runtime.Register("android/graphics/SurfaceTexture", DoNotGenerateAcw=true)>]
type SurfaceTexture = class
    inherit Object

继承

Object

Object

SurfaceTexture

属性

RegisterAttribute

注解

将图像流中的帧捕获为 OpenGL ES 纹理。

图像流可能来自相机预览或视频解码。 android.view.Surface从 SurfaceTexture 创建的，可用作 API 和 android.renderscript.Allocation API 的android.hardware.camera2android.media.MediaCodecandroid.media.MediaPlayer输出目标。 调用时 #updateTexImage ，将更新在创建 SurfaceTexture 时指定的纹理对象的内容，以包含图像流中的最新图像。 这可能会导致跳过流的某些帧。

指定较旧 android.hardware.Camera API 的输出目标时，还可以使用 SurfaceTexture 代替 SurfaceHolder。 这样做将导致图像流中的所有帧都发送到 SurfaceTexture 对象，而不是发送到设备的显示器。

从纹理采样时，应首先使用通过查询 #getTransformMatrix(float[])的矩阵来转换纹理坐标。 每次调用转换矩阵时都可能会更改 #updateTexImage ，因此每次更新纹理图像时都应重新查询该矩阵。 此矩阵将传统的 2D OpenGL ES 纹理坐标列向量（s、t、0、1）转换为流式处理纹理中的适当采样位置（其中 s、t、0、1） 和 t 处于非独占间隔 [0， 1]。 此转换可补偿图像流源的任何属性，这些属性会导致它与传统的 OpenGL ES 纹理不同。 例如，可以通过使用查询矩阵转换列向量（0、0、0、1）来实现图像左下角的采样，而图像右上角的采样可以通过转换（1、1、0、1）来完成。

纹理对象使用由 GL_OES_EGL_image_external OpenGL ES 扩展定义的 GL_TEXTURE_EXTERNAL_OES 纹理目标。 这会限制如何使用纹理。 每次绑定纹理时，它都必须绑定到GL_TEXTURE_EXTERNAL_OES目标，而不是GL_TEXTURE_2D目标。 此外，从纹理采样的任何 OpenGL ES 2.0 着色器都必须声明其使用此扩展的使用，例如，“#extension GL_OES_EGL_image_external： require”指令。 此类着色器还必须使用 samplerExternalOES GLSL 采样器类型访问纹理。

可以在任何线程上创建 SurfaceTexture 对象。 #updateTexImage 只能在包含纹理对象的 OpenGL ES 上下文的线程上调用。 在任意线程上调用帧可用的回调，因此，除非不应直接从回调中调用特殊小心 #updateTexImage 。

适用于 . 的 android.graphics.SurfaceTextureJava 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

构造函数

属性

方法

事件

显式接口实现

扩展方法

适用于