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

Class WZGLES

java.lang.Object

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

public class WZGLES
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WZGLES.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
WZGLES()

Method Summary

Modifier and Type	Method and Description
static int	checkEglError(String caller) Deprecated. use checkForEglError(String)
static int	checkForEglError(String caller) Calls EGL14#eglGetError() and logs an error if the last EGL call produced an error
static EGLContext	createEglContext(EGLDisplay eglDisplay, int version) Create an EGLContext for the specified EGLDisplay and EGL version
static EGLContext	createEglContext(EGLDisplay eglDisplay, int version, EGLContext eglContextShared) Create an EGLContext for the specified EGLDisplay and EGL version
static EGLContext	createEglContext(EGLDisplay eglDisplay, int version, EGLContext eglContextShared, boolean recordable) Create an EGLContext for the specified EGLDisplay and EGL version
static EGLSurface	createEglWindowSurface(Object surface, EGLDisplay eglDisplay, EGLConfig eglConfig) Wraps a native Android Surface or SurfaceTexture with an EGLSurface
static void	destroyEglContext(EGLDisplay eglDisplay, EGLContext eglContext) Destroy the specified EGLContext
static EGLConfig	getEglConfig(EGLDisplay eglDisplay, int version) Returns the first matching EGLConfig for the specified EGLDisplay and version
static EGLConfig	getEglConfig(EGLDisplay eglDisplay, int version, boolean recordable) Returns the first matching EGLConfig for the specified EGLDisplay and version
static EGLConfig	getEglContextConfig(EGLDisplay eglDisplay, EGLContext eglContext) Returns the first matching EGLConfig for the specified EGLDisplay and EGLContext
static int	getEglContextVersion(EGLDisplay eglDisplay, EGLContext eglContext) Returns the EGL version for the specified EGLDisplay and EGLContext
static int	getEglError() Returns and error code produced by the last EGL call
static String	getEglErrorString(int eglError) Returns a human readable string for the most common EGL error strings
static String	getEglInfo() Deprecated. use getEglInfo(boolean) instead
static String	getEglInfo(boolean includeExtensions) Returns detailed EGL support information for the current device
static WZDataMap	getEglInfoDataMap() Returns detailed EGL support information for the current device
static EGLConfig	getEglSurfaceConfig(EGLDisplay eglDisplay, EGLSurface eglSurface) Returns the EGLConfig for the specified EGLSurface
static WZSize	getEglSurfaceSize(EGLDisplay eglDisplay, EGLSurface eglSurface) Returns the dimensions for the specified EGLSurface
static String	matrixToString(float[] matrix) Convert a 4x4 matrix stored in a float[16] array to a human readable string
static String	matrixToString(String header, float[] matrix) Convert 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

WZGLES

public WZGLES()

Method Detail

checkForEglError

public static int checkForEglError(String caller)

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

Parameters:

caller - The calling routine name 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()

Returns and 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 String getEglErrorString(int eglError)

Returns a human readable string for the most common EGL error strings

Parameters:

eglError - The egl error code

Returns:

A human readable string for the most common EGL error strings

getEglInfo

public static String getEglInfo(boolean includeExtensions)

Returns detailed EGL support information for the current device

Parameters:

includeExtensions - A flag indicating if EGL extension support information should be included

Returns:

A string containing detailed EGL support information

getEglInfoDataMap

public static WZDataMap getEglInfoDataMap()

Returns detailed EGL support information for the current device

Returns:

A WZDataMap containing detailed EGL support information

getEglInfo

public static String getEglInfo()

Deprecated. use getEglInfo(boolean) instead

matrixToString

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

Convert 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 displaying the matrix values

matrixToString

public static String matrixToString(float[] matrix)

Convert a 4x4 matrix stored in a float[16] array to a human readable string

Parameters:

matrix - A 4x4 matrix

Returns:

A human readable string displaying the matrix values

getEglConfig

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

Returns 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 or not

Returns:

The first matching EGLConfig or null if one was not found

getEglConfig

public static EGLConfig getEglConfig(EGLDisplay eglDisplay,
                                     int version)

Returns 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 one was not found

createEglContext

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

Create 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)

Create 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)

Create 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)

Returns 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 one was not found

getEglContextVersion

public static int getEglContextVersion(EGLDisplay eglDisplay,
                                       EGLContext eglContext)

Returns 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 could not be determined

destroyEglContext

public static void destroyEglContext(EGLDisplay eglDisplay,
                                     EGLContext eglContext)

Destroy the specified EGLContext

Parameters:

eglDisplay - The EGL display

eglContext - The EGL context

createEglWindowSurface

public static EGLSurface createEglWindowSurface(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 WZSize getEglSurfaceSize(EGLDisplay eglDisplay,
                                       EGLSurface eglSurface)

Returns the dimensions for 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 could not be determined

getEglSurfaceConfig

public static EGLConfig getEglSurfaceConfig(EGLDisplay eglDisplay,
                                            EGLSurface eglSurface)

Returns 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(String caller)

Deprecated. use checkForEglError(String)