io.cine.android.streaming.gles

Class WindowSurface

java.lang.Object

io.cine.android.streaming.gles.EglSurfaceBase

io.cine.android.streaming.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.

Field Summary

Fields inherited from class io.cine.android.streaming.gles.EglSurfaceBase

mEglCore, TAG

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
void	recreate(EglCore newEglCore) Recreate 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 io.cine.android.streaming.gles.EglSurfaceBase

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

Methods inherited from class java.lang.Object

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

Constructor Detail

WindowSurface

public WindowSurface(EglCore eglCore,
             android.view.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 (e.g. if you release a SurfaceView's Surface, the surfaceDestroyed() callback won't fire).

WindowSurface

public WindowSurface(EglCore eglCore,
             android.graphics.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).

Does not require that the surface's EGL context be current.

recreate

public void recreate(EglCore newEglCore)

Recreate the EGLSurface, using the new EglBase. The caller should have already freed the old EGLSurface with releaseEglSurface().

This is useful when we want to update the EGLSurface associated with a Surface. For example, if we want 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, e.g. it's still current on a context somewhere, the create call will fail with complaints from the Surface about already being connected.