Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public final class

GLUtils

extends Object
java.lang.Object
   ↳ android.opengl.GLUtils

Class Overview

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 type, int border)
A version of texImage2D() that takes an explicit type parameter as defined by the OpenGL ES specification.
static void texImage2D (int target, int level, int internalformat, Bitmap bitmap, int border)
Calls glTexImage2D() on the current OpenGL context.
static void texSubImage2D (int target, int level, int xoffset, int yoffset, Bitmap bitmap)
Calls glTexSubImage2D() on the current OpenGL context.
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.
[Expand]
Inherited Methods
From class java.lang.Object

Public Methods

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 The EGL error to convert into a String.
Returns
  • An error string corresponding to the EGL error code.

public static int getInternalFormat ( Bitmap bitmap)

Added in API level 1

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

Returns
  • the internal format of the bitmap.

public static int getType ( Bitmap bitmap)

Added in API level 1

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
  • the OpenGL ES type of the bitmap.
Throws
IllegalArgumentException if the bitmap does not have a type.

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

Added in API level 1

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

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

Added in API level 1

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.

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

Added in API level 1

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.

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

Added in API level 1

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.

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

Added in API level 1

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