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

Class WZGLES.EglEnv

java.lang.Object

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

Enclosing class:

WZGLES

public static class WZGLES.EglEnv
extends Object

The class used by the GoCoder SDK to encapsulate OpenGL ES

Constructor Summary

Constructors

Constructor and Description
EglEnv(EGLContext sharedEglContext) Construct a new instance using the default EGLDisplay and create a new EGLContext that shares resource with the specified shared EGLContext and supports the EGL_ANDROID_RECORDABLE extension
EglEnv(EGLContext eglContextShared, EGLSurface eglBaseSurface) Deprecated.
EglEnv(EGLContext sharedEglContext, Object nativeSurface) Construct a new instance using the default EGLDisplay and create a new EGLContext that shares resource with the specified shared EGLContext supports the EGL_ANDROID_RECORDABLE extension and wrap the specified Android surface with a newly created EGLSurface
EglEnv(EGLContext sharedEglContext, Object nativeSurface, boolean recordable) Construct a new instance using the default EGLDisplay and create a new EGLContext that shares resource with the specified shared EGLContext and wrap the specified Android surface with a newly created EGLSurface
EglEnv(EGLDisplay eglDisplay, EGLContext eglContext) Construct a new instance using the specified EGLDisplay and the specified EGLContext
EglEnv(EGLDisplay eglDisplay, EGLContext eglContext, EGLSurface eglSurface) Construct a new instance using the specified EGLDisplay and the specified EGLContext and the specified EGLSurface
EglEnv(EGLDisplay eglDisplay, EGLContext eglContext, Object nativeSurface) Construct a new instance using the specified EGLDisplay and the specified EGLContext wrap the specified Android surface with an EGLSurface
EglEnv(int eglVersion, EGLContext sharedEglContext, boolean recordable) Construct a new instance using the default EGLDisplay and create a new EGLContext that shares resource with the specified shared EGLContext
EglEnv(int eglVersion, EGLDisplay eglDisplay, EGLContext eglContext, EGLContext sharedEglContext, Object nativeSurface, boolean recordable) Construct a new instance using the specified parameters
EglEnv(int eglVersion, EGLDisplay eglDisplay, Object nativeSurface, boolean recordable) Construct a new instance using the specified EGL version and the specified EGL display and create a new EGLContext wrap the specified Android surface with a newly created EGLSurface

Method Summary

Modifier and Type	Method and Description
boolean	copySurfaceContents(EGLSurface sourceSurface, int surfaceWidth, int surfaceHeight) Copies the content of the specified EGLSurface to this instance's EGLSurface For this operation to be supported, the following conditions must apply: This EglEnv instance's EGLContext must have been created with EGL version 3. This EglEnv instance's EGLContext must have been created by specifying the same EGLContext on which the source EGLSurface was created as a shared context An EGLSurface must have been created for this EglEnv instance
static EGLSurface	createEglSurface(EGLDisplay eglDisplay, EGLSurface eglBaseSurface, Surface nativeSurface) Deprecated.
EGLSurface	generateEglWindowSurface(Object nativeSurface) Generate a new EGLSurface that wraps the specified native Android surface.
WZSize	getBaseSurfaceSize() Deprecated.
EGLSurface	getEglBaseSurface() Deprecated.
EGLConfig	getEglConfig()
EGLContext	getEglContext()
EGLDisplay	getEglDisplay()
EGLSurface	getEglSurface()
WZSize	getEglSurfaceSize()
int	getEglVersion()
Surface	getNativeSurface() Deprecated.
int	getTextureId() Deprecated. do not use EglEnv to track texture ids
boolean	makeCurrent() Binds this instance to the current rendering thread
boolean	makeCurrent(EGLSurface readSurface) Binds this instance to the current rendering thread and the specified read surface
boolean	makeNothingCurrent() Unbinds this EglEnv instance from the current rendering thread
void	release() Releases the EGL resources associated with thie EglEnv instance
void	releaseSurface() Releases any current EGLSurface for this EglEnv instance
boolean	setNativeSurface(Surface nativeSurface) Deprecated. Use generateEglWindowSurface(java.lang.Object) instead
boolean	setPresentationTime(long nanoseconds) Sets the presentation time for a rendered frame on this EglEnv instance's EGLSurface
boolean	setSharedEglContext(EGLContext eglSharedContext) Establish a new shared EGLContext.
void	setTextureId(int textureId) Deprecated. do not use EglEnv to track texture ids
boolean	swapBuffers() Posts the contents of this EglEnv instance's EGLSurface to the native Android surface If the native surface is associated with a android.media.MediaCodec the contents will then be processed by the active encoder or decoder

Methods inherited from class java.lang.Object

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

Constructor Detail

EglEnv

public EglEnv(int eglVersion,
              EGLDisplay eglDisplay,
              EGLContext eglContext,
              EGLContext sharedEglContext,
              Object nativeSurface,
              boolean recordable)

Construct a new instance using the specified parameters

Parameters:

eglVersion - The EGL version to use (currently supported values: 2 or 3)

eglDisplay - The EGL display. If EGL14#EGL_NO_DISPLAY is specified the value EGL14#EGL_DEFAULT_DISPLAY will be used.

eglContext - The EGL context. If EGL14#EGL_NO_CONTEXT is specified, an EGLContext will be created

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

nativeSurface - If this is not null and is an instance of Surface or SurfaceTexture, an EGLSurface will be automatically created to wrap the native Android surface

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

Throws:

IllegalStateException - If an error occurs during the creation process

EglEnv

public EglEnv(EGLContext sharedEglContext,
              Object nativeSurface,
              boolean recordable)

Construct a new instance using the default EGLDisplay and create a new EGLContext that shares resource with the specified shared EGLContext and wrap the specified Android surface with a newly created EGLSurface

Parameters:

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

nativeSurface - If this is not null and is an instance of Surface or SurfaceTexture, an EGLSurface will be automatically created to wrap the native Android surface

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

Throws:

IllegalStateException - If an error occurs during the creation process

EglEnv

public EglEnv(EGLContext sharedEglContext,
              Object nativeSurface)

Construct a new instance using the default EGLDisplay and create a new EGLContext that shares resource with the specified shared EGLContext supports the EGL_ANDROID_RECORDABLE extension and wrap the specified Android surface with a newly created EGLSurface

Parameters:

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

nativeSurface - If this is not null and is an instance of Surface or SurfaceTexture, an EGLSurface will be automatically created to wrap the native Android surface

Throws:

IllegalStateException - If an error occurs during the creation process

EglEnv

public EglEnv(EGLContext sharedEglContext)

Construct a new instance using the default EGLDisplay and create a new EGLContext that shares resource with the specified shared EGLContext and supports the EGL_ANDROID_RECORDABLE extension

Parameters:

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

Throws:

IllegalStateException - If an error occurs during the creation process

EglEnv

public EglEnv(int eglVersion,
              EGLDisplay eglDisplay,
              Object nativeSurface,
              boolean recordable)

Construct a new instance using the specified EGL version and the specified EGL display and create a new EGLContext wrap the specified Android surface with a newly created EGLSurface

Parameters:

eglVersion - The EGL version to use (currently supported values: 2 or 3)

eglDisplay - The EGL display. If EGL14#EGL_NO_DISPLAY is specified the value EGL14#EGL_DEFAULT_DISPLAY will be used.

nativeSurface - If this is not null and is an instance of Surface or SurfaceTexture, an EGLSurface will be automatically created to wrap the native Android surface

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

Throws:

IllegalStateException - If an error occurs during the creation process

EglEnv

public EglEnv(int eglVersion,
              EGLContext sharedEglContext,
              boolean recordable)

Construct a new instance using the default EGLDisplay and create a new EGLContext that shares resource with the specified shared EGLContext

Parameters:

eglVersion - The EGL version to use (currently supported values: 2 or 3)

sharedEglContext - 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 EGL_ANDROID_RECORDABLE for use with android.media.MediaCodec

Throws:

IllegalStateException - If an error occurs during the creation process

EglEnv

public EglEnv(EGLDisplay eglDisplay,
              EGLContext eglContext,
              EGLSurface eglSurface)

Construct a new instance using the specified EGLDisplay and the specified EGLContext and the specified EGLSurface

Parameters:

eglDisplay - The EGL display. If EGL14#EGL_NO_DISPLAY is specified the value EGL14#EGL_DEFAULT_DISPLAY will be used.

eglContext - The EGL context. If EGL14#EGL_NO_CONTEXT is specified, an EGLContext will be created

eglSurface - The EGL surface.

Throws:

IllegalStateException - If an error occurs during the creation process

EglEnv

public EglEnv(EGLDisplay eglDisplay,
              EGLContext eglContext,
              Object nativeSurface)

Construct a new instance using the specified EGLDisplay and the specified EGLContext wrap the specified Android surface with an EGLSurface

Parameters:

eglDisplay - The EGL display. If EGL14#EGL_NO_DISPLAY is specified the value EGL14#EGL_DEFAULT_DISPLAY will be used.

eglContext - The EGL context. If EGL14#EGL_NO_CONTEXT is specified, an EGLContext will be created

nativeSurface - If this is not null and is an instance of Surface or SurfaceTexture, an EGLSurface will be automatically created to wrap the native Android surface

Throws:

IllegalStateException - If an error occurs during the creation process

EglEnv

public EglEnv(EGLDisplay eglDisplay,
              EGLContext eglContext)

Construct a new instance using the specified EGLDisplay and the specified EGLContext

Parameters:

eglDisplay - The EGL display. If EGL14#EGL_NO_DISPLAY is specified the value EGL14#EGL_DEFAULT_DISPLAY will be used.

eglContext - The EGL context. If EGL14#EGL_NO_CONTEXT is specified, an EGLContext will be created

Throws:

IllegalStateException - If an error occurs during the creation process

EglEnv

public EglEnv(EGLContext eglContextShared,
              EGLSurface eglBaseSurface)

Deprecated.

Method Detail

getEglDisplay

public EGLDisplay getEglDisplay()

Returns:

The EGLDisplay for this instance or EGL14#EGL_NO_DISPLAY of one has not been specified or created

getEglContext

public EGLContext getEglContext()

Returns:

The EGLContext for this instance or EGL14#EGL_NO_CONTEXT of one has not been specified or created

getEglConfig

public EGLConfig getEglConfig()

Returns:

The EGLConfig for this instance or null if one has not been established

getEglVersion

public int getEglVersion()

Returns:

The EGL version for this instance (2 or 3)

getEglSurface

public EGLSurface getEglSurface()

Returns:

The EGLSurface for this instance or EGL14#EGL_NO_SURFACE has not been specified or created

getEglSurfaceSize

public WZSize getEglSurfaceSize()

makeCurrent

public boolean makeCurrent()

Binds this instance to the current rendering thread

Returns:

true if successful, false if an error occurred

See Also:

eglMakeCurrent

makeCurrent

public boolean makeCurrent(EGLSurface readSurface)

Binds this instance to the current rendering thread and the specified read surface

Returns:

true if successful, false if an error occurred

See Also:

eglMakeCurrent

makeNothingCurrent

public boolean makeNothingCurrent()

Unbinds this EglEnv instance from the current rendering thread

Returns:

true if successful, false if an error occurred

See Also:

eglMakeCurrent

copySurfaceContents

public boolean copySurfaceContents(EGLSurface sourceSurface,
                                   int surfaceWidth,
                                   int surfaceHeight)

Copies the content of the specified EGLSurface to this instance's EGLSurface For this operation to be supported, the following conditions must apply:

1. This EglEnv instance's EGLContext must have been created with EGL version 3.
2. This EglEnv instance's EGLContext must have been created by specifying the same EGLContext on which the source EGLSurface was created as a shared context
3. An EGLSurface must have been created for this EglEnv instance

Parameters:

sourceSurface - The source EGLSurface

surfaceWidth - The width of the source EGLSurface

surfaceHeight - The height of the source EGLSurface

Returns:

true if successful, false if an error occurred

setPresentationTime

public boolean setPresentationTime(long nanoseconds)

Sets the presentation time for a rendered frame on this EglEnv instance's EGLSurface

Parameters:

nanoseconds - the frame's presentation time, in nanoseconds

Returns:

true if successful, false if an error occurred

See Also:

ANDROID_presentation_time

swapBuffers

public boolean swapBuffers()

Posts the contents of this EglEnv instance's EGLSurface to the native Android surface If the native surface is associated with a android.media.MediaCodec the contents will then be processed by the active encoder or decoder

Returns:

true if successful, false if an error occurred

See Also:

eglSwapBuffers

setSharedEglContext

public boolean setSharedEglContext(EGLContext eglSharedContext)

Establish a new shared EGLContext. Note that the current EGLContext will be destroyed first.

Parameters:

eglSharedContext - The shared EGLContext

Returns:

true if successful, false if an error occurred

generateEglWindowSurface

public EGLSurface generateEglWindowSurface(Object nativeSurface)

Generate a new EGLSurface that wraps the specified native Android surface. Note that any current EGLSurface will be destroyed first.

Parameters:

nativeSurface - An instance of an Android Surface or SurfaceTexture

Returns:

The newly created EGLSurface or EGL14.EGL_NO_SURFACE is an error occurred

releaseSurface

public void releaseSurface()

Releases any current EGLSurface for this EglEnv instance

release

public void release()

Releases the EGL resources associated with thie EglEnv instance

getEglBaseSurface

public EGLSurface getEglBaseSurface()

Deprecated.

getBaseSurfaceSize

public WZSize getBaseSurfaceSize()

Deprecated.

getNativeSurface

public Surface getNativeSurface()

Deprecated.

getTextureId

public int getTextureId()

Deprecated. do not use EglEnv to track texture ids

setTextureId

public void setTextureId(int textureId)

Deprecated. do not use EglEnv to track texture ids

createEglSurface

public static EGLSurface createEglSurface(EGLDisplay eglDisplay,
                                          EGLSurface eglBaseSurface,
                                          Surface nativeSurface)

Deprecated.

setNativeSurface

public boolean setNativeSurface(Surface nativeSurface)

Deprecated. Use generateEglWindowSurface(java.lang.Object) instead