From 2ebdcfeee38bed8c65daa78aa7d18d8d1d93ed85 Mon Sep 17 00:00:00 2001 From: marha Date: Wed, 12 Jan 2011 20:34:04 +0000 Subject: xkeyboard-config libX11 mesalib git update 12 jan 2011 --- mesalib/docs/egl.html | 18 ++---- mesalib/docs/opengles.html | 158 ++++++++++++++++++++++----------------------- 2 files changed, 82 insertions(+), 94 deletions(-) (limited to 'mesalib/docs') diff --git a/mesalib/docs/egl.html b/mesalib/docs/egl.html index fe3fe4b77..9eb7b44cc 100644 --- a/mesalib/docs/egl.html +++ b/mesalib/docs/egl.html @@ -88,17 +88,6 @@ internal library that supports multiple APIs.

--enable-gles-overlay - -

This option enables OpenGL ES as separate internal libraries. This is an -alternative approach to enable OpenGL ES.

- -

This is only supported by egl_gallium. For systems using DRI -drivers, --enable-gles1 and --enable-gles2 are -suggested instead as all drivers will benefit.

- -

--enable-openvg

OpenVG must be explicitly enabled by this option.

@@ -148,9 +137,10 @@ may set

EGL_DRIVER -

This variable specifies a full path to an EGL driver and it forces the -specified EGL driver to be loaded. It comes in handy when one wants to test a -specific driver. This variable is ignored for setuid/setgid binaries.

This variable specifies a full path to or the name of an EGL driver. It +forces the specified EGL driver to be loaded. It comes in handy when one wants +to test a specific driver. This variable is ignored for setuid/setgid +binaries.

diff --git a/mesalib/docs/opengles.html b/mesalib/docs/opengles.html index 63cc1146a..28b0acc20 100644 --- a/mesalib/docs/opengles.html +++ b/mesalib/docs/opengles.html @@ -1,80 +1,78 @@ - - -OpenGL ES - - - - - -

OpenGL ES

- -

Mesa implements OpenGL ES 1.1 and OpenGL ES 2.0. More informations about -OpenGL ES can be found at http://www.khronos.org/opengles/.

- -

OpenGL ES depends on a working EGL implementation. Please refer to -Mesa EGL for more information about EGL.

- -

Build the Libraries

Run configure with --enable-gles-overlay and enable the Gallium driver for your hardware.
Build and install Mesa as usual.

- -Alternatively, if XCB-DRI2 is installed on the system, one can use -egl_dri2 EGL driver with OpenGL|ES-enabled DRI drivers - -

Run configure with --enable-gles1 --enable-gles2.
Build and install Mesa as usual.

- -

Both methods will install libGLESv1_CM, libGLESv2, libEGL, and one or more -EGL drivers for your hardware.

- -

Run the Demos

- -

There are some demos in progs/egl/. You can use them to test -your build. For example,

- -

-  $ cd progs/egl/eglut
-  $ make
-  $ cd ../opengles1
-  $ make
-  $ ./torus_x11
-

- -

Developers

- -

Internal Libraries

- - - - - - - -

Library Name	Used By	Enabled	OpenGL	OpenGL ES 1.x	OpenGL ES 2.x
`libmesa.a`	Classic DRI drivers	y	y	--enable-gles1	--enable-gles2
`libmesagallium.a`	Gallium EGL and DRI drivers	y	y	--enable-gles1	--enable-gles2
`libes1gallium.a`	Gallium EGL drivers	--enable-gles-overlay	n	y	n
`libes2gallium.a`	Gallium EGL drivers	--enable-gles-overlay	n	n	y

- -

Dispatch Table

- -

OpenGL ES has an additional indirection when dispatching fucntions

- -

-  Mesa:       glFoo() --> _mesa_Foo()
-  OpenGL ES:  glFoo() --> _es_Foo() --> _mesa_Foo()
-

- -

The indirection serves several purposes

- -

When a function is in Mesa and the type matches, it checks the arguments and calls the Mesa function.
When a function is in Mesa but the type mismatches, it checks and converts the arguments before calling the Mesa function.
When a function is not available in Mesa, or accepts arguments that are not available in OpenGL, it provides its own implementation.

- -

Other than the last case, OpenGL ES uses APIspec.xml to generate functions to check and/or converts the arguments.

- - - + + +OpenGL ES + + + + + +

OpenGL ES

+ +

Mesa implements OpenGL ES 1.1 and OpenGL ES 2.0. More informations about +OpenGL ES can be found at http://www.khronos.org/opengles/.

+ +

OpenGL ES depends on a working EGL implementation. Please refer to +Mesa EGL for more information about EGL.

+ +

Build the Libraries

Run configure with --enable-gles1 --enable-gles2 and enable the Gallium driver for your hardware.
Build and install Mesa as usual.

+ +Alternatively, if XCB-DRI2 is installed on the system, one can use +egl_dri2 EGL driver with OpenGL|ES-enabled DRI drivers + +

Run configure with --enable-gles1 --enable-gles2.
Build and install Mesa as usual.

+ +

Both methods will install libGLESv1_CM, libGLESv2, libEGL, and one or more +EGL drivers for your hardware.

+ +