Class WindowSurface

java.lang.Object
com.banuba.sdk.internal.gl.EglSurfaceBase
com.banuba.sdk.internal.gl.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 Details

    • 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 Details

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