com.wowza.gocoder.sdk.api.android.opengl

Class WOWZGLES

java.lang.Object

com.wowza.gocoder.sdk.api.android.opengl.WOWZGLES

public class WOWZGLES
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WOWZGLES.EglEnv The class used by the GoCoder SDK to encapsulate OpenGL ES.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_GLES_VERSION
static float[]	IDENTITY_MATRIX A 4x4 array initialized as an identity matrix.

Constructor Summary

Constructors

Constructor and Description
WOWZGLES()

Method Summary

Modifier and Type	Method and Description
static int	checkEglError(java.lang.String caller) Deprecated. Use checkForEglError(String) instead.
static int	checkForEglError(java.lang.String caller) Calls EGL14#eglGetError() and logs an error if the last EGL call produced an error.
static EGLContext	createEglContext(EGLDisplay eglDisplay, int version) Creates an EGLContext for the specified EGLDisplay and EGL version.
static EGLContext	createEglContext(EGLDisplay eglDisplay, int version, EGLContext eglContextShared) Creates an EGLContext for the specified EGLDisplay and EGL version.
static EGLContext	createEglContext(EGLDisplay eglDisplay, int version, EGLContext eglContextShared, boolean recordable) Creates an EGLContext for the specified EGLDisplay and EGL version.
static EGLSurface	createEglWindowSurface(java.lang.Object surface, EGLDisplay eglDisplay, EGLConfig eglConfig) Wraps a native Android Surface or SurfaceTexture with an EGLSurface.
static void	destroyEglContext(EGLDisplay eglDisplay, EGLContext eglContext) Destroys the specified EGLContext.
static EGLConfig	getEglConfig(EGLDisplay eglDisplay, int version) Gets the first matching EGLConfig for the specified EGLDisplay and version.
static EGLConfig	getEglConfig(EGLDisplay eglDisplay, int version, boolean recordable) Gets the first matching EGLConfig for the specified EGLDisplay and version.
static EGLConfig	getEglContextConfig(EGLDisplay eglDisplay, EGLContext eglContext) Gets the first matching EGLConfig for the specified EGLDisplay and EGLContext.
static int	getEglContextVersion(EGLDisplay eglDisplay, EGLContext eglContext) Gets the EGL version for the specified EGLDisplay and EGLContext.
static int	getEglError() Gets the error code produced by the last EGL call.
static java.lang.String	getEglErrorString(int eglError) Gets a human-readable string of the most common EGL errors.
static java.lang.String	getEglInfo() Deprecated. Use getEglInfo(boolean) instead.
static java.lang.String	getEglInfo(boolean includeExtensions) Gets detailed EGL support information for the current device.
static WOWZDataMap	getEglInfoDataMap() Gets detailed EGL support information for the current device.
static EGLConfig	getEglSurfaceConfig(EGLDisplay eglDisplay, EGLSurface eglSurface) Gets the EGLConfig for the specified EGLSurface.
static WOWZSize	getEglSurfaceSize(EGLDisplay eglDisplay, EGLSurface eglSurface) Gets the dimensions of the specified EGLSurface.
static java.lang.String	matrixToString(float[] matrix) Converts a 4x4 matrix stored in a float[16] array to a human-readable string.
static java.lang.String	matrixToString(java.lang.String header, float[] matrix) Converts a 4x4 matrix stored in a float[16] array to a human-readable string.
static int	surfaceToEGLRotation(int surfaceRotation) Converts a Surface rotation angle to an EGL-based rotation angle.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_GLES_VERSION

public static final int DEFAULT_GLES_VERSION

See Also:

Constant Field Values

IDENTITY_MATRIX

public static final float[] IDENTITY_MATRIX

A 4x4 array initialized as an identity matrix.

Constructor Detail

WOWZGLES

public WOWZGLES()

Method Detail

checkForEglError

public static int checkForEglError(java.lang.String caller)

Calls EGL14#eglGetError() and logs an error if the last EGL call produced an error.

Parameters:

caller - The name of the calling routine to log.

Returns:

The EGL error code that occurred, or EGL14#EGL_SUCCESS EGL_SUCCESS if no error occurred.

See Also:

eglGetError

getEglError

public static int getEglError()

Gets the error code produced by the last EGL call.

Returns:

The EGL error code that occurred, or EGL14#EGL_SUCCESS EGL_SUCCESS if no error occurred.

getEglErrorString

public static java.lang.String getEglErrorString(int eglError)

Gets a human-readable string of the most common EGL errors.

Parameters:

eglError - The EGL error code.

Returns:

A human-readable string for the most common EGL errors.

getEglInfo

public static java.lang.String getEglInfo(boolean includeExtensions)

Gets detailed EGL support information for the current device.

Parameters:

includeExtensions - A flag that indicates whether EGL extension support information should be included.

Returns:

A string containing detailed EGL support information.

getEglInfoDataMap

public static WOWZDataMap getEglInfoDataMap()

Gets detailed EGL support information for the current device.

Returns:

A WOWZDataMap that contains detailed EGL support information.

getEglInfo

public static java.lang.String getEglInfo()

Deprecated. Use getEglInfo(boolean) instead.

matrixToString

public static java.lang.String matrixToString(java.lang.String header,
                                              float[] matrix)

Converts a 4x4 matrix stored in a float[16] array to a human-readable string.

Parameters:

header - A header to prepend to the output.

matrix - A 4x4 matrix.

Returns:

A human-readable string that displays the matrix values.

matrixToString

public static java.lang.String matrixToString(float[] matrix)

Converts a 4x4 matrix stored in a float[16] array to a human-readable string.

Parameters:

matrix - A 4x4 matrix.

Returns:

A human-readable string that displays the matrix values.

getEglConfig

public static EGLConfig getEglConfig(EGLDisplay eglDisplay,
                                     int version,
                                     boolean recordable)

Gets the first matching EGLConfig for the specified EGLDisplay and version.

Parameters:

eglDisplay - The EGL display.

version - The EGL version.

recordable - A flag indicating whether to require the EGL_ANDROID_RECORDABLE extension.

Returns:

The first matching EGLConfig, or null if none was found.

getEglConfig

public static EGLConfig getEglConfig(EGLDisplay eglDisplay,
                                     int version)

Gets the first matching EGLConfig for the specified EGLDisplay and version.

Parameters:

eglDisplay - The EGL display.

version - The EGL version.

Returns:

The first matching EGLConfig, or null if none was found.

createEglContext

public static EGLContext createEglContext(EGLDisplay eglDisplay,
                                          int version,
                                          EGLContext eglContextShared,
                                          boolean recordable)

Creates an EGLContext for the specified EGLDisplay and EGL version.

Parameters:

eglDisplay - The EGL display.

version - The EGL version.

eglContextShared - Unless EGL14#EGL_NO_CONTEXT is specified, the newly created context will share EGL resources with the specified context.

recordable - Indicates that the newly created context should support the EGL_ANDROID_RECORDABLE extension for use with android.media.MediaCodec.

Returns:

The newly created context, or EGL14.EGL_NO_CONTEXT if an error occurred.

createEglContext

public static EGLContext createEglContext(EGLDisplay eglDisplay,
                                          int version,
                                          EGLContext eglContextShared)

Creates an EGLContext for the specified EGLDisplay and EGL version.

Parameters:

eglDisplay - The EGL display.

version - The EGL version.

eglContextShared - Unless EGL14#EGL_NO_CONTEXT is specified, the newly created context will share EGL resources with the specified context.

Returns:

The newly created context, or EGL14.EGL_NO_CONTEXT if an error occurred.

createEglContext

public static EGLContext createEglContext(EGLDisplay eglDisplay,
                                          int version)

Creates an EGLContext for the specified EGLDisplay and EGL version.

Parameters:

eglDisplay - The EGL display.

version - The EGL version.

Returns:

The newly created context, or EGL14.EGL_NO_CONTEXT if an error occurred.

getEglContextConfig

public static EGLConfig getEglContextConfig(EGLDisplay eglDisplay,
                                            EGLContext eglContext)

Gets the first matching EGLConfig for the specified EGLDisplay and EGLContext.

Parameters:

eglDisplay - The EGL display.

eglContext - The EGL context.

Returns:

The first matching EGLConfig, or null if none was found.

getEglContextVersion

public static int getEglContextVersion(EGLDisplay eglDisplay,
                                       EGLContext eglContext)

Gets the EGL version for the specified EGLDisplay and EGLContext.

Parameters:

eglDisplay - The EGL display.

eglContext - The EGL context.

Returns:

The EGL version, or -1 if the version couldn't be determined.

destroyEglContext

public static void destroyEglContext(EGLDisplay eglDisplay,
                                     EGLContext eglContext)

Destroys the specified EGLContext.

Parameters:

eglDisplay - The EGL display.

eglContext - The EGL context.

createEglWindowSurface

public static EGLSurface createEglWindowSurface(java.lang.Object surface,
                                                EGLDisplay eglDisplay,
                                                EGLConfig eglConfig)

Wraps a native Android Surface or SurfaceTexture with an EGLSurface.

Parameters:

surface - A Surface or SurfaceTexture instance to wrap with an EGLSurface.

eglDisplay - The EGL display.

eglConfig - The EGL config to use.

Returns:

The newly created EGL surface, or EGL14#EGL_NO_SURFACE if an error occurred.

getEglSurfaceSize

public static WOWZSize getEglSurfaceSize(EGLDisplay eglDisplay,
                                         EGLSurface eglSurface)

Gets the dimensions of the specified EGLSurface.

Parameters:

eglDisplay - The EGL display.

eglSurface - The EGL surface.

Returns:

The dimensions of the surface, in pixels, or null if the size couldn't be determined.

getEglSurfaceConfig

public static EGLConfig getEglSurfaceConfig(EGLDisplay eglDisplay,
                                            EGLSurface eglSurface)

Gets the EGLConfig for the specified EGLSurface.

Parameters:

eglDisplay - The EGL display.

eglSurface - The EGL surface.

Returns:

The matching EGL config.

surfaceToEGLRotation

public static int surfaceToEGLRotation(int surfaceRotation)

Converts a Surface rotation angle to an EGL-based rotation angle.

Parameters:

surfaceRotation - The rotation angle of the screen from its "natural" orientation.

Returns:

The equivalent EGL-based rotation angle.

See Also:

The getRotation() method in the Android SDK Display class

checkEglError

public static int checkEglError(java.lang.String caller)

Deprecated. Use checkForEglError(String) instead.