Collapse all Symbian^3 Product Developer Library

OpenGLES Interface Overview

The OpenGLES Interface component provides the Symbian platform with an interface to the open-source, cross-platform OpenGL ES APIs defined by the Khronos Group. The component includes the Khronos-released header files, some Symbian-specific header files, LIB, DEF and MMP files and UIDs. It does not provide any implementations of the APIs.

Variant: ScreenPlay and non-ScreenPlay.

Supported APIs

The OpenGL ES specifications are defined by the Khronos Group (http://www.khronos.org/). The following table provides links to the relevant specifications.

Specification Version	Location
OpenGL ES 1.1.10	http://www.khronos.org/registry/gles/specs/1.1/es_full_spec.1.1.10.pdf
OpenGL ES 2.0	http://www.khronos.org/files/opengles_spec_2_0.pdf

The OpenGLES Interface component includes the Khronos-released header files that conform to these specifications. The header files incorporate some minor changes, such as in-source comments.

These header files are derived from the official Khronos Subversion Repository (https://cvs.khronos.org/svn/repos/) as shown in the following table.

Specification Version	Repository
OpenGL ES 1.X	/ogles/branches/1.X/src/include/GLES/
OpenGL ES 2.0	/ogles/trunk/src/include/GLES2/

Profiles supported

The following OpenGL ES profiles are supported:

OpenGL ES 1.X Common Profile (CM)
OpenGL ES 1.X Common-Lite Profile (CL)
OpenGL ES 2.0. There is only one profile, therefore only one version exists.

Extensions supported

OpenGL ES implementations can expose implementation-specific functionality by using the standard extension mechanisms.

The OpenGL ES 1.X extensions, which are defined by Khronos, are located in /epoc32/include/GLES/glext.h.
The OpenGL ES 2.0 extensions, which are defined by Khronos, are located in /epoc32/include/GLES2/gl2ext.h.

Implementers can disable extensions by using glextplatform.h and gl2extplatform.h, respectively.

Implementers edit the Symbian-supplied /epoc32/include/GLES/glextplatform.h by defining an appropriate define guard. For example, defining GL_OES_draw_texture in glextplatform.h prevents definition of GL_TEXTURE_CROP_RECT_OES in glext.h.

Organization of file names and directories

Khronos defines the file names and directories for OpenGL ES in the Khronos API Implementers Guide.

Library files

For each profile, the OpenGLES Interface component provides a library file as shown in the following table. The library filenames are specified by Khronos.

Library Name	Usage
libGLES_CM.lib	OpenGL ES 1.1 Common Profile with EGL
libGLES_CL.lib	OpenGL ES 1.1 Common-Lite Profile with EGL
libGLESv1_CM.lib	OpenGL ES Common Profile without EGL (known as OpenGL ES 1.1 v1)
libGLESv2.lib	OpenGL ES 2.0

Note: OpenGL ES 1.1 v1 is not another version of OpenGL ES. It is instead another form of packaging for the OpenGL ES 1.1 API.

Definition files

The following definition (DEF) files are delivered by the OpenGLES Interface component in order to ensure binary compatibility.

Name and path	Usage
/epoc32/include/platform/def/<plat>/openglesu.def	OpenGL ES 1.0 with EGL (CM profile)
/epoc32/include/platform/def/<plat>/opengles11u.def	OpenGL ES 1.1 with EGL (CM profile)
/epoc32/include/platform/def/<plat>/libglesv1_cm11u.def	OpenGL ES 1.1 without EGL (CM profile)
/epoc32/include/platform/def/<plat>/libglesv2u.def	OpenGL ES 2.0

Parent topic: OpenGLES Interface Component

Related concepts

OpenGLES Collection