GlUtil

public static final int[] EGL_CONFIG_ATTRIBUTES_RGBA_1010102

public static final int[] EGL_CONFIG_ATTRIBUTES_RGBA_8888

public static final int HOMOGENEOUS_COORDINATE_VECTOR_SIZE = 4

Number of elements in a 3d homogeneous coordinate vector describing a vertex.

public static final float LENGTH_NDC = 2.0f

Length of the normalized device coordinate (NDC) space, which spans from -1 to 1.

public static void awaitSyncObject(long syncObject)

Ensures that following commands on the current OpenGL context will not be executed until the sync point has been reached. If syncObject equals 0, this does not block the CPU, and only affects the current OpenGL context. Otherwise, this will block the CPU.

public static void bindTexture(int textureTarget, int texId)

Binds the texture of the given type with default configuration of GL_LINEAR filtering and GL_CLAMP_TO_EDGE wrapping.

public static void checkGlError()

Collects all OpenGL errors that occurred since this method was last called and throws a with the combined error message.

public static void checkGlException(boolean expression, String errorMessage)

Throws a GlException with the given message if expression evaluates to false.

public static void clearFocusedBuffers()

Fills the pixels in the current output render target buffers with (r=0, g=0, b=0, a=0).

Buffers can be focused using focusEglSurface and focusFramebufferUsingCurrentContext, focusFramebuffer, and createFocusedPlaceholderEglSurface.

public static float[] create4x4IdentityMatrix()

Creates a 4x4 identity matrix.

public static FloatBuffer createBuffer(float[] data)

Allocates a FloatBuffer with the given data.

@RequiresApi(value = 17)
public static EGLContext createEglContext(EGLDisplay eglDisplay)

Creates a new EGLContext for the specified EGLDisplay.

Configures the EGLContext with EGL_CONFIG_ATTRIBUTES_RGBA_8888 and OpenGL ES 2.0.

@RequiresApi(value = 17)
public static EGLContext createEglContext(
    EGLContext sharedContext,
    EGLDisplay eglDisplay,
    @IntRange(from = 2, to = 3) int openGlVersion,
    int[] configAttributes
)

Creates a new EGLContext for the specified EGLDisplay.

@RequiresApi(value = 17)
public static EGLSurface createEglSurface(
    EGLDisplay eglDisplay,
    Object surface,
    @C.ColorTransfer int colorTransfer,
    boolean isEncoderInputSurface
)

Creates a new EGLSurface wrapping the specified surface.

The EGLSurface will configure with OpenGL ES 2.0.

public static int createExternalTexture()

Creates a GL_TEXTURE_EXTERNAL_OES with default configuration of GL_LINEAR filtering and GL_CLAMP_TO_EDGE wrapping.

public static int createFboForTexture(int texId)

Returns a new framebuffer for the texture.

@RequiresApi(value = 17)
public static EGLSurface createFocusedPlaceholderEglSurface(
    EGLContext eglContext,
    EGLDisplay eglDisplay
)

Creates and focuses a placeholder EGLSurface.

This makes a EGLContext current when reading and writing to a surface is not required, configured with EGL_CONFIG_ATTRIBUTES_RGBA_8888.

@RequiresApi(value = 17)
public static long createGlSyncFence()

Returns a newly created sync object and inserts it into the GL command stream.

Returns 0 if the operation failed, no EGLContext is focused, or the focused EGLContext version is less than 3.0.

public static int createTexture(Bitmap bitmap)

Allocates a new texture, initialized with the bitmap data and size.

public static int createTexture(
    int width,
    int height,
    boolean useHighPrecisionColorComponents
)

Allocates a new RGBA texture with the specified dimensions and color component precision.

The created texture is not zero-initialized. To clear the texture, focus on the texture and clear its content.

public static float[] createVertexBuffer(List<float[]> vertexList)

Flattens the list of 4 element NDC coordinate vectors into a buffer.

public static void deleteFbo(int fboId)

Deletes a framebuffer, or silently ignores the method call if fboId is unused.

public static void deleteRbo(int rboId)

Deletes a renderbuffer, or silently ignores the method call if rboId is unused.

public static void deleteSyncObject(long syncObject)

Deletes the underlying native object.

The syncObject must not be used after deletion.

public static void deleteSyncObjectQuietly(long syncObject)

Releases the GL sync object if set, suppressing any error.

public static void deleteTexture(int textureId)

Deletes a GL texture.

@RequiresApi(value = 17)
public static void destroyEglContext(
    @Nullable EGLDisplay eglDisplay,
    @Nullable EGLContext eglContext
)

Destroys the EGLContext identified by the provided EGLDisplay and .

This is a no-op if called on already-destroyed EGLDisplay and EGLContext instances.

@RequiresApi(value = 17)
public static void destroyEglSurface(
    @Nullable EGLDisplay eglDisplay,
    @Nullable EGLSurface eglSurface
)

Destroys the EGLSurface identified by the provided EGLDisplay and .

@RequiresApi(value = 17)
public static void focusEglSurface(
    EGLDisplay eglDisplay,
    EGLContext eglContext,
    EGLSurface eglSurface,
    int width,
    int height
)

Makes the specified eglSurface the render target, using a viewport of width by height pixels.

@RequiresApi(value = 17)
public static void focusFramebuffer(
    EGLDisplay eglDisplay,
    EGLContext eglContext,
    EGLSurface eglSurface,
    int framebuffer,
    int width,
    int height
)

Makes the specified framebuffer the render target, using a viewport of width by height pixels.

public static void focusFramebufferUsingCurrentContext(
    int framebuffer,
    int width,
    int height
)

Makes the specified framebuffer the render target, using a viewport of width by height pixels.

The caller must ensure that there is a current OpenGL context before calling this method.

public static int generateTexture()

Returns a new, unbound GL texture identifier.

@RequiresApi(value = 17)
public static long getContextMajorVersion()

Returns the EGL_CONTEXT_CLIENT_VERSION of the current context.

Returns 0 if no EGLContextis focused.

@RequiresApi(value = 17)
public static EGLContext getCurrentContext()

Gets the current context.

@RequiresApi(value = 17)
public static EGLDisplay getDefaultEglDisplay()

Returns an initialized default EGLDisplay.

public static float[] getNormalizedCoordinateBounds()

Bounds of normalized device coordinates, commonly used for defining viewport boundaries.

public static float[] getTextureCoordinateBounds()

Typical bounds used for sampling from textures.

public static boolean isBt2020PqExtensionSupported()

Returns whether EXTENSION_COLORSPACE_BT2020_PQ is supported.

public static boolean isProtectedContentExtensionSupported(Context context)

Returns whether creating a GL context with EXTENSION_PROTECTED_CONTENT is possible.

If true, the device supports a protected output path for DRM content when using GL.

public static boolean isSurfacelessContextExtensionSupported()

Returns whether the EXTENSION_SURFACELESS_CONTEXT extension is supported.

This extension allows passing EGL_NO_SURFACE for both the write and read surfaces in a call to eglMakeCurrent.

public static boolean isYuvTargetExtensionSupported()

Returns whether the EXTENSION_YUV_TARGET extension is supported.

This extension allows sampling raw YUV values from an external texture, which is required for HDR input.

public static void setTexture(int texId, Bitmap bitmap)

Sets the texId to contain the bitmap data and size.

public static void setToIdentity(float[] matrix)

Sets the input matrix to an identity matrix.