net.rim.device.api.egl
Interface EGL12

All Superinterfaces:

EGL, EGL10, EGL11

All Known Subinterfaces:

EGL13

public interface EGL12
extends EGL11

The EGL12 interface contains the BlackBerry Java(TM) programming language bindings for EGL 1.2.

This api adds the minimal functionality required extending the base egl 1.0 and 1.1 functionality defined in JSR-239 and for supporting OpenVG 1.1.

The documentation in this interface is normative with respect to instance variable names and values, method names and signatures, and exception behavior. The remaining documentation is placed here for convenience and does not replace the normative documentation found in the EGL specification and relevant extension specifications.

EGL documentation is available at the Khronos web site.

Since:

BlackBerry API 6.0.0

Field Summary
static int	EGL_ALPHA_MASK_SIZE EGL 1.2 constant.
static int	EGL_CLIENT_APIS EGL 1.2 constant.
static int	EGL_OPENGL_ES_API EGL 1.2 constant.
static int	EGL_OPENGL_ES_BIT EGL 1.2 constant.
static int	EGL_OPENVG_API EGL 1.2 constant.
static int	EGL_OPENVG_BIT EGL 1.2 constant.
static int	EGL_RENDERABLE_TYPE EGL 1.2 constant.

Fields inherited from interface javax.microedition.khronos.egl.EGL11

EGL_BACK_BUFFER, EGL_BIND_TO_TEXTURE_RGB, EGL_BIND_TO_TEXTURE_RGBA, EGL_CONTEXT_LOST, EGL_MAX_SWAP_INTERVAL, EGL_MIN_SWAP_INTERVAL, EGL_MIPMAP_LEVEL, EGL_MIPMAP_TEXTURE, EGL_NO_TEXTURE, EGL_TEXTURE_2D, EGL_TEXTURE_FORMAT, EGL_TEXTURE_RGB, EGL_TEXTURE_RGBA, EGL_TEXTURE_TARGET

Fields inherited from interface javax.microedition.khronos.egl.EGL10

EGL_ALPHA_SIZE, EGL_BAD_ACCESS, EGL_BAD_ALLOC, EGL_BAD_ATTRIBUTE, EGL_BAD_CONFIG, EGL_BAD_CONTEXT, EGL_BAD_CURRENT_SURFACE, EGL_BAD_DISPLAY, EGL_BAD_MATCH, EGL_BAD_NATIVE_PIXMAP, EGL_BAD_NATIVE_WINDOW, EGL_BAD_PARAMETER, EGL_BAD_SURFACE, EGL_BLUE_SIZE, EGL_BUFFER_SIZE, EGL_CONFIG_CAVEAT, EGL_CONFIG_ID, EGL_CORE_NATIVE_ENGINE, EGL_DEFAULT_DISPLAY, EGL_DEPTH_SIZE, EGL_DONT_CARE, EGL_DRAW, EGL_EXTENSIONS, EGL_FALSE, EGL_GREEN_SIZE, EGL_HEIGHT, EGL_LARGEST_PBUFFER, EGL_LEVEL, EGL_MAX_PBUFFER_HEIGHT, EGL_MAX_PBUFFER_PIXELS, EGL_MAX_PBUFFER_WIDTH, EGL_NATIVE_RENDERABLE, EGL_NATIVE_VISUAL_ID, EGL_NATIVE_VISUAL_TYPE, EGL_NONE, EGL_NON_CONFORMANT_CONFIG, EGL_NOT_INITIALIZED, EGL_NO_CONTEXT, EGL_NO_DISPLAY, EGL_NO_SURFACE, EGL_PBUFFER_BIT, EGL_PIXMAP_BIT, EGL_PRESERVED_RESOURCES, EGL_READ, EGL_RED_SIZE, EGL_SAMPLES, EGL_SAMPLE_BUFFERS, EGL_SLOW_CONFIG, EGL_STENCIL_SIZE, EGL_SUCCESS, EGL_SURFACE_TYPE, EGL_TRANSPARENT_BLUE_VALUE, EGL_TRANSPARENT_GREEN_VALUE, EGL_TRANSPARENT_RED_VALUE, EGL_TRANSPARENT_RGB, EGL_TRANSPARENT_TYPE, EGL_TRUE, EGL_VENDOR, EGL_VERSION, EGL_WIDTH, EGL_WINDOW_BIT

Method Summary
boolean	eglBindAPI(int api) Sets the current rendering api.
int	eglQueryAPI() Used to obtain the value of the currently bound client api.
boolean	eglWaitClient() Complete all client execution prior to subsequent native rendering calls.

Methods inherited from interface javax.microedition.khronos.egl.EGL11

eglBindTexImage, eglReleaseTexImage, eglSurfaceAttrib, eglSwapInterval

Methods inherited from interface javax.microedition.khronos.egl.EGL10

eglChooseConfig, eglCopyBuffers, eglCreateContext, eglCreatePbufferSurface, eglCreatePixmapSurface, eglCreateWindowSurface, eglDestroyContext, eglDestroySurface, eglGetConfigAttrib, eglGetConfigs, eglGetCurrentContext, eglGetCurrentDisplay, eglGetCurrentSurface, eglGetDisplay, eglGetError, eglInitialize, eglMakeCurrent, eglQueryContext, eglQueryString, eglQuerySurface, eglSwapBuffers, eglTerminate, eglWaitGL, eglWaitNative

Field Detail

EGL_ALPHA_MASK_SIZE

static final int EGL_ALPHA_MASK_SIZE

EGL 1.2 constant.

See Also:

Constant Field Values

Since:

BlackBerry API 6.0.0

EGL_CLIENT_APIS

static final int EGL_CLIENT_APIS

EGL 1.2 constant.

See Also:

Constant Field Values

Since:

BlackBerry API 6.0.0

EGL_OPENGL_ES_API

static final int EGL_OPENGL_ES_API

EGL 1.2 constant.

See Also:

Constant Field Values

Since:

BlackBerry API 6.0.0

EGL_OPENVG_API

static final int EGL_OPENVG_API

EGL 1.2 constant.

See Also:

Constant Field Values

Since:

BlackBerry API 6.0.0

EGL_RENDERABLE_TYPE

static final int EGL_RENDERABLE_TYPE

EGL 1.2 constant.

See Also:

Constant Field Values

Since:

BlackBerry API 6.0.0

EGL_OPENGL_ES_BIT

static final int EGL_OPENGL_ES_BIT

EGL 1.2 constant.

See Also:

Constant Field Values

Since:

BlackBerry API 6.0.0

EGL_OPENVG_BIT

static final int EGL_OPENVG_BIT

EGL 1.2 constant.

See Also:

Constant Field Values

Since:

BlackBerry API 6.0.0

Method Detail

eglBindAPI

boolean eglBindAPI(int api)

Sets the current rendering api. This should be called before creating client api contexts and called in between changes in the current client rendering api.

Parameters:

api - The api to bind for. Must be EGL_OPENGL_ES_API or EGL_OPENVG_API.

Returns:

true if the api specified was successfully bound as current.

Since:

BlackBerry API 6.0.0, EGL12

eglQueryAPI

int eglQueryAPI()

Used to obtain the value of the currently bound client api.

Returns:

The currently bound client api, EGL_OPENGL_ES_API or EGL_OPENVG_API.

Since:

BlackBerry API 6.0.0, EGL12

eglWaitClient

boolean eglWaitClient()

Complete all client execution prior to subsequent native rendering calls.

Client rendering calls made prior to eglWaitClient are guaranteed to be executed before native rendering calls made after eglWaitClient. The same result can be achieved using eglWaitGL,glFinish for OpenGL ES or using vgFinish using OpenVG.

eglWaitClient is ignored if there is no current EGL rendering context.

Errors

false is returned if eglWaitClient fails, true otherwise.

EGL_BAD_NATIVE_SURFACE is generated if the surface associated with the current context has a native window or pixmap, and that window or pixmap is no longer valid.

Returns:

true if the operation succeeds.

Since:

BlackBerry API 6.0.0, EGL12