SurfaceTexture Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Captura los fotogramas de una secuencia de imágenes como una textura de OpenGL ES.
[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
- Herencia
- Atributos
Comentarios
Captura los fotogramas de una secuencia de imágenes como una textura de OpenGL ES.
La secuencia de imágenes puede provenir de la vista previa de la cámara o descodificación de vídeo. Un android.view.Surface objeto creado a partir de SurfaceTexture se puede usar como destino de salida para las android.hardware.camera2API , android.media.MediaCodec, android.media.MediaPlayery android.renderscript.Allocation . Cuando #updateTexImage se llama a , el contenido del objeto de textura especificado cuando se creó SurfaceTexture se actualiza para contener la imagen más reciente de la secuencia de imágenes. Esto puede hacer que se omitan algunos fotogramas de la secuencia.
También se puede usar SurfaceTexture en lugar de surfaceHolder al especificar el destino de salida de la API anterior android.hardware.Camera . Si lo hace, todos los fotogramas de la secuencia de imágenes se enviarán al objeto SurfaceTexture en lugar de a la pantalla del dispositivo.
Un patrón típico es usar SurfaceTexture para representar fotogramas en ; TextureViewsin embargo, no es necesario usar textureView para usar el objeto de textura. El objeto de textura se puede usar como parte de un sombreador openGL ES.
Cuando el muestreo de la textura debe transformar primero las coordenadas de textura mediante la matriz consultada a través #getTransformMatrix(float[])de . La matriz de transformación puede cambiar cada vez #updateTexImage que se llama, por lo que se debe volver a consultar cada vez que se actualiza la imagen de textura. Esta matriz transforma los vectores de columna de coordenadas de textura 2D OpenGL ES tradicionales del formulario (s, t, 0, 1) donde s y t se encuentran en el intervalo inclusivo [0, 1] a la ubicación de muestreo adecuada en la textura secuenciada. Esta transformación compensa las propiedades del origen de flujo de imagen que hacen que parezca diferente de una textura tradicional de OpenGL ES. Por ejemplo, el muestreo desde la esquina inferior izquierda de la imagen se puede realizar mediante la transformación del vector de columna (0, 0, 0, 0, 1) mediante la matriz consultada, mientras que el muestreo desde la esquina superior derecha de la imagen se puede realizar mediante la transformación (1, 1, 0, 1).
El objeto de textura usa el destino de textura GL_TEXTURE_EXTERNAL_OES, definido por la extensión openGL ES de GL_OES_EGL_image_external. Esto limita cómo se puede usar la textura. Cada vez que la textura está enlazada, debe enlazarse al destino GL_TEXTURE_EXTERNAL_OES en lugar del destino GL_TEXTURE_2D. Además, cualquier sombreador de OpenGL ES 2.0 que muestre de la textura debe declarar su uso de esta extensión mediante, por ejemplo, una directiva "#extension GL_OES_EGL_image_external : require". Estos sombreadores también deben tener acceso a la textura mediante el tipo samplerExternalOES GLSL.
Los objetos SurfaceTexture se pueden crear en cualquier subproceso.
#updateTexImage solo se puede llamar a en el subproceso con el contexto de OpenGL ES que contiene el objeto de textura. La devolución de llamada disponible para fotogramas se llama en un subproceso arbitrario, por lo que, a menos que no #updateTexImage se llame a especial cuidado directamente desde la devolución de llamada.
Java documentación para android.graphics.SurfaceTexture.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Constructores
| Nombre | Description |
|---|---|
| SurfaceTexture(Boolean) |
Construye una nueva SurfaceTexture para transmitir imágenes a una textura de OpenGL determinada. |
| SurfaceTexture(Int32, Boolean) |
Construye una nueva SurfaceTexture para transmitir imágenes a una textura de OpenGL determinada. |
| SurfaceTexture(Int32) |
Construye una nueva SurfaceTexture para transmitir imágenes a una textura de OpenGL determinada. |
| SurfaceTexture(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución. |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| DataSpace |
Recupere el espacio de datos asociado a la imagen de textura establecida por la llamada más reciente a |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| IsReleased |
Devuelve |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
Obtiene las marcas de estado asignadas por última vez por el tiempo de ejecución. (Heredado de JavaObject) |
| JniPeerMembers |
Obtiene los metadatos de JNI usados para acceder a los miembros de este enlace de Java. |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| Timestamp |
Recupere la marca de tiempo asociada a la imagen de textura establecida por la llamada más reciente a |
Métodos
| Nombre | Description |
|---|---|
| AttachToGLContext(Int32) |
Adjunte SurfaceTexture al contexto de OpenGL ES que está activo en el subproceso que realiza la llamada. |
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Delega la construcción de este elemento del mismo nivel en el administrador de valores del entorno de ejecución. (Heredado de JavaObject) |
| DetachFromGLContext() |
Desasocie SurfaceTexture del contexto de OpenGL ES que posee el objeto de textura openGL ES. |
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
Pide al administrador de valores que elimine este elemento del mismo nivel a menos que su asignación conserve esta misma instancia administrada. (Heredado de JavaObject) |
| Equals(Object) |
Comprueba si otro elemento del mismo nivel administrado hace referencia al mismo objeto Java. (Heredado de JavaObject) |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| GetHashCode() |
Devuelve un valor de código hash del objeto. (Heredado de Object) |
| GetTransformMatrix(Single[]) |
Recupere la matriz de transformación de coordenadas de textura 4x4 asociada con la imagen de textura establecida por la llamada más reciente a |
| JavaFinalize() |
Obsoletos.
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| Release() |
|
| ReleaseTexImage() |
Libera el contenido de textura. |
| SetDefaultBufferSize(Int32, Int32) |
Establezca el tamaño predeterminado de los búferes de imágenes. |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetOnFrameAvailableListener(SurfaceTexture+IOnFrameAvailableListener, Handler) |
Registre una devolución de llamada que se invocará cuando un nuevo marco de imagen esté disponible para SurfaceTexture. |
| SetOnFrameAvailableListener(SurfaceTexture+IOnFrameAvailableListener) |
Registre una devolución de llamada que se invocará cuando un nuevo marco de imagen esté disponible para SurfaceTexture. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Almacena un valor de referencia en el bloque de control sin crear una copia de referencia de JNI. (Heredado de JavaObject) |
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToString() |
Devuelve una representación de cadena del objeto. (Heredado de Object) |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| UpdateTexImage() |
Actualice la imagen de textura al marco más reciente de la secuencia de imágenes. |
| Wait() |
Hace que el subproceso actual espere hasta que se despierta, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Eventos
| Nombre | Description |
|---|---|
| FrameAvailable |
Se produce cuando hay un nuevo marco disponible en la cola de imágenes. |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IJavaPeerable.Disposed() |
Marca este elemento del mismo nivel como eliminado y llama |
| IJavaPeerable.Finalized() |
Marca este elemento del mismo nivel como eliminado y llama |
| IJavaPeerable.JniObjectReferenceControlBlock |
Obtiene el puntero de bloque de control nativo usado por este elemento del mismo nivel. (Heredado de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Almacena el código hash de identidad proporcionado por el tiempo de ejecución. (Heredado de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Reemplaza las marcas de estado del mismo nivel administradas almacenadas. (Heredado de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Actualiza la referencia del mismo nivel y libera un bloque de control del mismo nivel eliminado cuando la referencia no es válida. (Heredado de JavaObject) |
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
Reutiliza un par administrado compatible o obtiene un contenedor del tipo solicitado. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |