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

Class WOWZGLES.EglEnv

java.lang.Object

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

Enclosing class:

WOWZGLES

public static class WOWZGLES.EglEnv
extends java.lang.Object

The class used by the GoCoder SDK to encapsulate OpenGL ES.

Constructor Summary

Constructors

Constructor and Description
EglEnv(EGLContext sharedEglContext) Creates and initializes an instance using the default EGLDisplay and creates a new EGLContext that shares resources with the specified shared EGLContext.
EglEnv(EGLContext eglContextShared, EGLSurface eglBaseSurface) Deprecated.
EglEnv(EGLContext sharedEglContext, java.lang.Object nativeSurface) Creates and initializes an instance using the default EGLDisplay, creates a new EGLContext that shares resources with the specified shared EGLContext, and wraps the specified Android surface with a newly created EGLSurface.
EglEnv(EGLContext sharedEglContext, java.lang.Object nativeSurface, boolean recordable) Creates and initializes an instance using the default EGLDisplay, creates a new EGLContext that shares resources with the specified shared EGLContext, supports the EGL_ANDROID_RECORDABLE extension, and wraps the specified Android surface with a newly created EGLSurface.
EglEnv(EGLDisplay eglDisplay, EGLContext eglContext) Creates and initializes an instance using the specified EGLDisplay and the EGLContext.
EglEnv(EGLDisplay eglDisplay, EGLContext eglContext, EGLSurface eglSurface) Creates and initializes an instance using the specified EGLDisplay, EGLContext, and EGLSurface.
EglEnv(EGLDisplay eglDisplay, EGLContext eglContext, java.lang.Object nativeSurface) Creates and initializes an instance using the specified EGLDisplay and EGLContext, and wraps the specified Android surface with an EGLSurface.
EglEnv(int eglVersion, EGLContext sharedEglContext, boolean recordable) Creates and initializes an instance using the default EGLDisplay and creates a new EGLContext that shares resources with the specified shared EGLContext.
EglEnv(int eglVersion, EGLDisplay eglDisplay, EGLContext eglContext, EGLContext sharedEglContext, java.lang.Object nativeSurface, boolean recordable) Creates and initializes an instance using the specified parameters.
EglEnv(int eglVersion, EGLDisplay eglDisplay, java.lang.Object nativeSurface, boolean recordable) Creates and initializes an instance using the specified EGL version and the specified EGL display, creates a new EGLContext, and wraps 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.
static EGLSurface	createEglSurface(EGLDisplay eglDisplay, EGLSurface eglBaseSurface, Surface nativeSurface) Deprecated.
EGLSurface	generateEglWindowSurface(java.lang.Object nativeSurface) Generates a new EGLSurface that wraps the specified native Android surface; destroys the current EGLSurface if there is one.
WOWZSize	getBaseSurfaceSize() Deprecated.
EGLSurface	getEglBaseSurface() Deprecated.
EGLConfig	getEglConfig()
EGLContext	getEglContext()
EGLDisplay	getEglDisplay()
EGLSurface	getEglSurface()
WOWZSize	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) Establishes a new shared EGLContext; destroys the current EGLContext if there is one.
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.

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,
              java.lang.Object nativeSurface,
              boolean recordable)

Creates and initializes an instance using the specified parameters.

Parameters:

eglVersion - The EGL version to use, either 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 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:

java.lang.IllegalStateException - If an error occurs during the creation process.

EglEnv

public EglEnv(EGLContext sharedEglContext,
              java.lang.Object nativeSurface,
              boolean recordable)

Creates and initializes an instance using the default EGLDisplay, creates a new EGLContext that shares resources with the specified shared EGLContext, supports the EGL_ANDROID_RECORDABLE extension, and wraps 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 isn't null and is an instance of Surface or SurfaceTexture, an EGLSurface will be 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:

java.lang.IllegalStateException - If an error occurs during the creation process.

EglEnv

public EglEnv(EGLContext sharedEglContext,
              java.lang.Object nativeSurface)

Creates and initializes an instance using the default EGLDisplay, creates a new EGLContext that shares resources with the specified shared EGLContext, and wraps 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 isn't null and is an instance of Surface or SurfaceTexture, an EGLSurface will be created to wrap the native Android surface.

Throws:

java.lang.IllegalStateException - If an error occurs during the creation process.

EglEnv

public EglEnv(EGLContext sharedEglContext)

Creates and initializes an instance using the default EGLDisplay and creates a new EGLContext that shares resources with the specified shared EGLContext.

Parameters:

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

Throws:

java.lang.IllegalStateException - If an error occurs during the creation process.

EglEnv

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

Creates and initializes an instance using the specified EGL version and the specified EGL display, creates a new EGLContext, and wraps the specified Android surface with a newly created EGLSurface.

Parameters:

eglVersion - The EGL version to use, either 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 isn't null and is an instance of Surface or SurfaceTexture, an EGLSurface will be 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:

java.lang.IllegalStateException - If an error occurs during the creation process.

EglEnv

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

Creates and initializes an instance using the default EGLDisplay and creates a new EGLContext that shares resources with the specified shared EGLContext.

Parameters:

eglVersion - The EGL version to use, either 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:

java.lang.IllegalStateException - If an error occurs during the creation process.

EglEnv

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

Creates and initializes an instance using the specified EGLDisplay, EGLContext, and 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:

java.lang.IllegalStateException - If an error occurs during the creation process.

EglEnv

public EglEnv(EGLDisplay eglDisplay,
              EGLContext eglContext,
              java.lang.Object nativeSurface)

Creates and initializes an instance using the specified EGLDisplay and EGLContext, and wraps 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 isn't null and is an instance of Surface or SurfaceTexture, an EGLSurface will be created to wrap the native Android surface.

Throws:

java.lang.IllegalStateException - If an error occurs during the creation process.

EglEnv

public EglEnv(EGLDisplay eglDisplay,
              EGLContext eglContext)

Creates and initializes an instance using the specified EGLDisplay and the 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:

java.lang.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 if one hasn't been specified or created.

getEglContext

public EGLContext getEglContext()

Returns:

The EGLContext for this instance, or EGL14#EGL_NO_CONTEXT if one hasn't been specified or created.

getEglConfig

public EGLConfig getEglConfig()

Returns:

The EGLConfig for this instance, or null if one hasn't 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 hasn't been specified or created.

getEglSurfaceSize

public WOWZSize 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 be met:

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 an android.media.MediaCodec, the contents will 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)

Establishes a new shared EGLContext; destroys the current EGLContext if there is one.

Parameters:

eglSharedContext - The shared EGLContext.

Returns:

True if successful, false if an error occurred.

generateEglWindowSurface

public EGLSurface generateEglWindowSurface(java.lang.Object nativeSurface)

Generates a new EGLSurface that wraps the specified native Android surface; destroys the current EGLSurface if there is one.

Parameters:

nativeSurface - An instance of an Android Surface or SurfaceTexture.

Returns:

The newly created EGLSurface, or EGL14.EGL_NO_SURFACE if 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 WOWZSize 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.