net.rim.device.api.egl
Interface EGL12

All Superinterfaces:
EGL, EGL10, EGL11

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





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.