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 텍스처로 캡처합니다.

이미지 스트림은 카메라 미리 보기 또는 비디오 디코딩에서 올 수 있습니다. SurfaceTexture에서 만든 API android.view.Surface 는 , android.media.MediaCodecandroid.media.MediaPlayer및 android.renderscript.Allocation API의 android.hardware.camera2출력 대상으로 사용할 수 있습니다. #updateTexImage 호출되면 SurfaceTexture를 만들 때 지정된 질감 개체의 내용이 이미지 스트림의 최신 이미지를 포함하도록 업데이트됩니다. 이로 인해 스트림의 일부 프레임을 건너뛸 수 있습니다.

이전 android.hardware.Camera API의 출력 대상을 지정할 때 SurfaceHolder 대신 SurfaceTexture를 사용할 수도 있습니다. 이렇게 하면 이미지 스트림의 모든 프레임이 디바이스의 디스플레이가 아닌 SurfaceTexture 개체로 전송됩니다.

텍스처에서 샘플링하는 경우 먼저 을 통해 #getTransformMatrix(float[])쿼리된 행렬을 사용하여 텍스처 좌표를 변환해야 합니다. 변환 행렬은 호출될 때마다 #updateTexImage 변경될 수 있으므로 텍스처 이미지가 업데이트될 때마다 다시 쿼리해야 합니다. 이 행렬은 포괄 간격 [0, 1]에 있는 폼의 기존 2D OpenGL ES 텍스처 좌표 열 벡터(s, 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_2D 대상이 아닌 GL_TEXTURE_EXTERNAL_OES 대상에 바인딩되어야 합니다. 또한 텍스처에서 샘플링하는 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 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.

생성자

속성

메서드

이벤트

명시적 인터페이스 구현

확장 메서드

적용 대상