com.yy.mediaframework.gles

Class WindowSurface

java.lang.Object

com.yy.mediaframework.gles.EglSurfaceBase

com.yy.mediaframework.gles.WindowSurface

All Implemented Interfaces:

IEglSurfaceBase, IWindowSurface

public class WindowSurface
extends EglSurfaceBase
implements IWindowSurface

Recordable EGL window surface.

It's good practice to explicitly release() the surface, preferably from a "finally" block.

Field Summary

Fields inherited from class com.yy.mediaframework.gles.EglSurfaceBase

mEglCore, TAG

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
void	recreate(java.lang.Object 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 com.yy.mediaframework.gles.EglSurfaceBase

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.yy.mediaframework.gles.IEglSurfaceBase

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

Constructor Detail

WindowSurface

protected 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

protected 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.

Specified by:

release in interface IWindowSurface

recreate

public void recreate(java.lang.Object 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.

Specified by:

recreate in interface IWindowSurface