com.yy.mediaframework.gles

Class EglCore

java.lang.Object

com.yy.mediaframework.gles.EglCore

All Implemented Interfaces:

IEglCore

public final class EglCore
extends java.lang.Object
implements IEglCore

Core EGL state (display, context, config).

The EGLContext must only be attached to one thread at a time. This class is not thread-safe.

Field Summary

Fields

Modifier and Type	Field and Description
static int	FLAG_RECORDABLE Constructor flag: surface must be recordable.
static int	FLAG_TRY_GLES3 Constructor flag: ask for GLES3, fall back to GLES2 if not available.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	EglCore() Prepares EGL display and context.
protected	EglCore(java.lang.Object sharedContext, int flags) Prepares EGL display and context.

Method Summary

Modifier and Type	Method and Description
boolean	_isCurrent(android.opengl.EGLSurface eglSurface)
protected void	_makeCurrent(android.opengl.EGLSurface eglSurface) Makes our EGL context current, using the supplied surface for both "draw" and "read".
protected void	_makeCurrent(android.opengl.EGLSurface drawSurface, android.opengl.EGLSurface readSurface) Makes our EGL context current, using the supplied "draw" and "read" surfaces.
int	_querySurface(android.opengl.EGLSurface eglSurface, int what) Performs a simple surface query.
void	_setPresentationTime(android.opengl.EGLSurface eglSurface, long nsecs) Sends the presentation time stamp to EGL.
protected android.opengl.EGLSurface	createOffscreenSurface(int width, int height) Creates an EGL surface associated with an offscreen buffer.
IEglSurfaceBase	createSurfaceBase()
protected android.opengl.EGLSurface	createWindowSurface(java.lang.Object surface) Creates an EGL surface associated with a Surface.
IWindowSurface	createWindowSurface(android.view.Surface surface, boolean releaseSurface)
IWindowSurface	createWindowSurface(android.view.SurfaceHolder holder, boolean releaseSurace)
IWindowSurface	createWindowSurface(android.graphics.SurfaceTexture surfaceTexture)
protected void	finalize()
android.opengl.EGLContext	getEGLContext()
int	getGlVersion() Returns the GLES version this context is configured for (currently 2 or 3).
boolean	isCurrent(android.opengl.EGLSurface eglSurface) Returns true if our context and the specified surface are current.
boolean	isCurrent(IEglSurfaceBase eglSfBase)
static void	logCurrent(java.lang.String msg) Writes the current display, context, and surface to the log.
void	makeCurrent(IEglSurfaceBase eglSfBase)
void	makeCurrent(IEglSurfaceBase drawSurface, IEglSurfaceBase readSurface)
void	makeNothingCurrent() Makes no context current.
java.lang.String	queryString(int what) Queries a string value.
int	querySurface(android.opengl.EGLSurface eglSurface, int what) Performs a simple surface query.
int	querySurface(IEglSurfaceBase eglSfBase, int what)
void	release() Discards all resources held by this class, notably the EGL context.
protected void	releaseSurface(android.opengl.EGLSurface eglSurface) Destroys the specified surface.
void	setPresentationTime(IEglSurfaceBase eglSfBase, long nsecs)
boolean	swapBuffers(android.opengl.EGLSurface eglSurface) Calls eglSwapBuffers.
boolean	swapBuffers(IEglSurfaceBase eglSfBase)

Methods inherited from class java.lang.Object

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

Field Detail

FLAG_RECORDABLE

public static final int FLAG_RECORDABLE

Constructor flag: surface must be recordable. This discourages EGL from using a pixel format that cannot be converted efficiently to something usable by the video encoder.

See Also:

Constant Field Values

FLAG_TRY_GLES3

public static final int FLAG_TRY_GLES3

Constructor flag: ask for GLES3, fall back to GLES2 if not available. Without this flag, GLES2 is used.

See Also:

Constant Field Values

Constructor Detail

EglCore

protected EglCore()

Prepares EGL display and context.

Equivalent to EglCore(null, 0).

EglCore

protected EglCore(java.lang.Object sharedContext,
                  int flags)

Prepares EGL display and context.

Parameters:

sharedContext - The context to share, or null if sharing is not desired.

flags - Configuration bit flags, e.g. FLAG_RECORDABLE.

Method Detail

release

public void release()

Discards all resources held by this class, notably the EGL context. This must be called from the thread where the context was created.

On completion, no context will be current.

Specified by:

release in interface IEglCore

makeCurrent

public void makeCurrent(IEglSurfaceBase eglSfBase)

Specified by:

makeCurrent in interface IEglCore

makeCurrent

public void makeCurrent(IEglSurfaceBase drawSurface,
                        IEglSurfaceBase readSurface)

Specified by:

makeCurrent in interface IEglCore

swapBuffers

public boolean swapBuffers(IEglSurfaceBase eglSfBase)

Specified by:

swapBuffers in interface IEglCore

setPresentationTime

public void setPresentationTime(IEglSurfaceBase eglSfBase,
                                long nsecs)

Specified by:

setPresentationTime in interface IEglCore

isCurrent

public boolean isCurrent(IEglSurfaceBase eglSfBase)

Specified by:

isCurrent in interface IEglCore

querySurface

public int querySurface(IEglSurfaceBase eglSfBase,
                        int what)

Specified by:

querySurface in interface IEglCore

createSurfaceBase

public IEglSurfaceBase createSurfaceBase()

Specified by:

createSurfaceBase in interface IEglCore

createWindowSurface

public IWindowSurface createWindowSurface(android.view.Surface surface,
                                          boolean releaseSurface)

Specified by:

createWindowSurface in interface IEglCore

createWindowSurface

public IWindowSurface createWindowSurface(android.view.SurfaceHolder holder,
                                          boolean releaseSurace)

Specified by:

createWindowSurface in interface IEglCore

createWindowSurface

public IWindowSurface createWindowSurface(android.graphics.SurfaceTexture surfaceTexture)

Specified by:

createWindowSurface in interface IEglCore

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable

releaseSurface

protected void releaseSurface(android.opengl.EGLSurface eglSurface)

Destroys the specified surface. Note the EGLSurface won't actually be destroyed if it's still current in a context.

createWindowSurface

protected android.opengl.EGLSurface createWindowSurface(java.lang.Object surface)

Creates an EGL surface associated with a Surface.

If this is destined for MediaCodec, the EGLConfig should have the "recordable" attribute.

createOffscreenSurface

protected android.opengl.EGLSurface createOffscreenSurface(int width,
                                                           int height)

Creates an EGL surface associated with an offscreen buffer.

_makeCurrent

protected void _makeCurrent(android.opengl.EGLSurface eglSurface)

Makes our EGL context current, using the supplied surface for both "draw" and "read".

_makeCurrent

protected void _makeCurrent(android.opengl.EGLSurface drawSurface,
                            android.opengl.EGLSurface readSurface)

Makes our EGL context current, using the supplied "draw" and "read" surfaces.

_querySurface

public int _querySurface(android.opengl.EGLSurface eglSurface,
                         int what)

Performs a simple surface query.

_isCurrent

public boolean _isCurrent(android.opengl.EGLSurface eglSurface)

makeNothingCurrent

public void makeNothingCurrent()

Makes no context current.

Specified by:

makeNothingCurrent in interface IEglCore

swapBuffers

public boolean swapBuffers(android.opengl.EGLSurface eglSurface)

Calls eglSwapBuffers. Use this to "publish" the current frame.

Returns:

false on failure

_setPresentationTime

public void _setPresentationTime(android.opengl.EGLSurface eglSurface,
                                 long nsecs)

Sends the presentation time stamp to EGL. Time is expressed in nanoseconds.

isCurrent

public boolean isCurrent(android.opengl.EGLSurface eglSurface)

Returns true if our context and the specified surface are current.

querySurface

public int querySurface(android.opengl.EGLSurface eglSurface,
                        int what)

Performs a simple surface query.

queryString

public java.lang.String queryString(int what)

Queries a string value.

getGlVersion

public int getGlVersion()

Returns the GLES version this context is configured for (currently 2 or 3).

Specified by:

getGlVersion in interface IEglCore

logCurrent

public static void logCurrent(java.lang.String msg)

Writes the current display, context, and surface to the log.

getEGLContext

public android.opengl.EGLContext getEGLContext()

Specified by:

getEGLContext in interface IEglCore