GLFrameBufferRenderer.Builder

Builder(
    surfaceView: SurfaceView,
    callback: GLFrameBufferRenderer.Callback
)

Create a new GLFrameBufferRenderer.Builder with the provided SurfaceView to be the parent of the SurfaceControlCompat that is presented on screen.

fun build(): GLFrameBufferRenderer

Create the GLFrameBufferRenderer with the specified parameters on this Builder instance

fun setBufferFormat(format: Int): GLFrameBufferRenderer.Builder

Specify the buffer format of the underlying buffers being rendered into by the created GLFrameBufferRenderer. The set of valid formats is implementation-specific and may depend on additional EGL extensions. The particular valid combinations for a given Android version and implementation should be documented by that version.

HardwareBuffer.RGBA_8888 and HardwareBuffer.RGBX_8888 are guaranteed to be supported. However, consumers are recommended to query the desired HardwareBuffer configuration using HardwareBuffer.isSupported.

See: khronos.org/registry/EGL/extensions/ANDROID/EGL_ANDROID_get_native_client_buffer.txt

fun setGLRenderer(glRenderer: GLRenderer?): GLFrameBufferRenderer.Builder

Configure the GLRenderer instance to be used by the GLFrameBufferRenderer. By default this parameter is null indicating that the GLFrameBufferRenderer will create and manage its own GLRenderer. This is useful to share the same OpenGL resources and thread across multiple GLFrameBufferRenderer instances.

fun setMaxBuffers(numBuffers: @IntRange(from = 1, to = 64) Int): GLFrameBufferRenderer.Builder

Specify the maximum number of buffers used within the swap chain of the GLFrameBufferRenderer. If 1 is specified, then the created GLFrameBufferRenderer is running in "single buffer mode". In this case consumption of the buffer content would need to be coordinated with the SyncFenceCompat instance specified by the corresponding SyncStrategy algorithm

fun setSyncStrategy(syncStrategy: SyncStrategy): GLFrameBufferRenderer.Builder

Specify the SyncStrategy used for determining when to create SyncFenceCompat objects in order to handle synchronization. The SyncFenceCompat instance created according to the algorithm specified in the provided SyncStrategy will be passed to the corresponding SurfaceControlCompat.Transaction.setBuffer call in order to ensure the underlying buffer is not presented by the display until the fence signals.

fun setUsageFlags(usageFlags: Long): GLFrameBufferRenderer.Builder

Specify the usage flags to be configured on the underlying HardwareBuffer instances created by the GLFrameBufferRenderer.