Added in API level 1

GLUtils


public final class GLUtils
extends Object

java.lang.Object
   ↳ android.opengl.GLUtils


Utility class to help bridging OpenGL ES and Android APIs.

Summary

Public methods

static String getEGLErrorString(int error)

Return a string for the EGL error code, or the hex representation if the error is unknown.

static int getInternalFormat(Bitmap bitmap)

return the internal format as defined by OpenGL ES of the supplied bitmap.

static int getType(Bitmap bitmap)

Return the type as defined by OpenGL ES of the supplied bitmap, if there is one.

static void texImage2D(int target, int level, Bitmap bitmap, int border)

A version of texImage2D that determines the internalFormat and type automatically.

static void texImage2D(int target, int level, int internalformat, Bitmap bitmap, int border)

Calls glTexImage2D() on the current OpenGL context.

static void texImage2D(int target, int level, int internalformat, Bitmap bitmap, int type, int border)

A version of texImage2D() that takes an explicit type parameter as defined by the OpenGL ES specification.

static void texSubImage2D(int target, int level, int xoffset, int yoffset, Bitmap bitmap, int format, int type)

A version of texSubImage2D() that takes an explicit type parameter as defined by the OpenGL ES specification.

static void texSubImage2D(int target, int level, int xoffset, int yoffset, Bitmap bitmap)

Calls glTexSubImage2D() on the current OpenGL context.

Inherited methods

Public methods

getEGLErrorString

Added in API level 14
public static String getEGLErrorString (int error)

Return a string for the EGL error code, or the hex representation if the error is unknown.

Parameters
error int: The EGL error to convert into a String.

Returns
String An error string corresponding to the EGL error code.

getInternalFormat

Added in API level 1
public static int getInternalFormat (Bitmap bitmap)

return the internal format as defined by OpenGL ES of the supplied bitmap.

Returns
int the internal format of the bitmap.

getType

Added in API level 1
public static int getType (Bitmap bitmap)

Return the type as defined by OpenGL ES of the supplied bitmap, if there is one. If the bitmap is stored in a compressed format, it may not have a valid OpenGL ES type.

Returns
int the OpenGL ES type of the bitmap.

Throws
IllegalArgumentException if the bitmap does not have a type.

texImage2D

Added in API level 1
public static void texImage2D (int target, 
                int level, 
                Bitmap bitmap, 
                int border)

A version of texImage2D that determines the internalFormat and type automatically.

texImage2D

Added in API level 1
public static void texImage2D (int target, 
                int level, 
                int internalformat, 
                Bitmap bitmap, 
                int border)

Calls glTexImage2D() on the current OpenGL context. If no context is current the behavior is the same as calling glTexImage2D() with no current context, that is, eglGetError() will return the appropriate error. Unlike glTexImage2D() bitmap cannot be null and will raise an exception in that case. All other parameters are identical to those used for glTexImage2D(). NOTE: this method doesn't change GL_UNPACK_ALIGNMENT, you must make sure to set it properly according to the supplied bitmap. Whether or not bitmap can have non power of two dimensions depends on the current OpenGL context. Always check glGetError() some time after calling this method, just like when using OpenGL directly.

texImage2D

Added in API level 1
public static void texImage2D (int target, 
                int level, 
                int internalformat, 
                Bitmap bitmap, 
                int type, 
                int border)

A version of texImage2D() that takes an explicit type parameter as defined by the OpenGL ES specification. The actual type and internalformat of the bitmap must be compatible with the specified type and internalformat parameters.

texSubImage2D

Added in API level 1
public static void texSubImage2D (int target, 
                int level, 
                int xoffset, 
                int yoffset, 
                Bitmap bitmap, 
                int format, 
                int type)

A version of texSubImage2D() that takes an explicit type parameter as defined by the OpenGL ES specification.

Parameters
format int

texSubImage2D

Added in API level 1
public static void texSubImage2D (int target, 
                int level, 
                int xoffset, 
                int yoffset, 
                Bitmap bitmap)

Calls glTexSubImage2D() on the current OpenGL context. If no context is current the behavior is the same as calling glTexSubImage2D() with no current context, that is, eglGetError() will return the appropriate error. Unlike glTexSubImage2D() bitmap cannot be null and will raise an exception in that case. All other parameters are identical to those used for glTexSubImage2D(). NOTE: this method doesn't change GL_UNPACK_ALIGNMENT, you must make sure to set it properly according to the supplied bitmap. Whether or not bitmap can have non power of two dimensions depends on the current OpenGL context. Always check glGetError() some time after calling this method, just like when using OpenGL directly.