com.android.grafika.gles

Class EglCore

java.lang.Object

com.android.grafika.gles.EglCore

public final class EglCore
extends Object

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

Constructor and Description
EglCore() Prepares EGL display and context.
EglCore(EGLContext sharedContext, int flags) Prepares EGL display and context.

Method Summary

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

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

public EglCore()

Prepares EGL display and context.

Equivalent to EglCore(null, 0).

EglCore

public EglCore(EGLContext 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.

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

releaseSurface

public void releaseSurface(EGLSurface eglSurface)

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

createWindowSurface

public EGLSurface createWindowSurface(Object surface)

Creates an EGL surface associated with a Surface.

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

createOffscreenSurface

public EGLSurface createOffscreenSurface(int width,
                                         int height)

Creates an EGL surface associated with an offscreen buffer.

makeCurrent

public void makeCurrent(EGLSurface eglSurface)

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

makeCurrent

public void makeCurrent(EGLSurface drawSurface,
                        EGLSurface readSurface)

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

makeNothingCurrent

public void makeNothingCurrent()

Makes no context current.

swapBuffers

public boolean swapBuffers(EGLSurface eglSurface)

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

Returns:

false on failure

setPresentationTime

public void setPresentationTime(EGLSurface eglSurface,
                                long nsecs)

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

isCurrent

public boolean isCurrent(EGLSurface eglSurface)

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

querySurface

public int querySurface(EGLSurface eglSurface,
                        int what)

Performs a simple surface query.

queryString

public 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).

logCurrent

public static void logCurrent(String msg)

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