com.wowza.gocoder.sdk.api.gles

Class WindowSurface

java.lang.Object

com.wowza.gocoder.sdk.api.gles.EglSurfaceBase

com.wowza.gocoder.sdk.api.gles.WindowSurface

public class WindowSurface
extends EglSurfaceBase

Recordable EGL window surface. It's good practice to explicitly release the surface, preferably from a "finally" block.

Constructor Summary

Constructors

Constructor and Description
WindowSurface(EglCore eglCore, Surface surface, boolean releaseSurface) Associates an EGL surface with the native window surface.
WindowSurface(EglCore eglCore, SurfaceTexture surfaceTexture) Associates an EGL surface with the SurfaceTexture.

Method Summary

Modifier and Type	Method and Description
void	recreate(EglCore newEglCore) Re-creates the EGLSurface using the new EglBase.
void	release() Releases any resources associated with the EGL surface and, if configured to do so, with the Surface as well.

Methods inherited from class com.wowza.gocoder.sdk.api.gles.EglSurfaceBase

createOffscreenSurface, createWindowSurface, getEglSurface, getHeight, getWidth, makeCurrent, makeCurrentReadFrom, releaseEglSurface, saveFrame, setPresentationTime, swapBuffers

Methods inherited from class java.lang.Object

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

Constructor Detail

WindowSurface

public WindowSurface(EglCore eglCore,
                     Surface surface,
                     boolean releaseSurface)

Associates an EGL surface with the native window surface. Set releaseSurface to true if you want the Surface to be released when release() is called. This is convenient, but can interfere with framework classes that expect to manage the Surface themselves. For example, if you release a SurfaceView's Surface, the surfaceDestroyed() callback won't fire.

WindowSurface

public WindowSurface(EglCore eglCore,
                     SurfaceTexture surfaceTexture)

Associates an EGL surface with the SurfaceTexture.

Method Detail

release

public void release()

Releases any resources associated with the EGL surface and, if configured to do so, with the Surface as well. Doesn't require the surface's EGL context to be current.

recreate

public void recreate(EglCore newEglCore)

Re-creates the EGLSurface using the new EglBase. The caller should have already freed the old EGLSurface with releaseEglSurface().

This is useful to update the EGLSurface associated with a Surface, for example, to share with a different EGLContext, which can only be done by tearing down and recreating the context. (That's handled by the caller; this just creates a new EGLSurface for the Surface we were handed earlier.)

If the previous EGLSurface isn't fully destroyed, for example, it's still current on a context somewhere, the create call will fail with complaints from the Surface about already being connected.