From 2e3c4e47842905bc7f3d506e865cc77f7463166b Mon Sep 17 00:00:00 2001 From: Chia-I Wu Date: Fri, 7 May 2010 14:13:08 +0800 Subject: docs: Update EGL and OpenGL ES docs. Update to reflect recent gles and mapi works. --- docs/egl.html | 55 ++++++++++++++++++++++++++++++++----------------------- 1 file changed, 32 insertions(+), 23 deletions(-) (limited to 'docs/egl.html') diff --git a/docs/egl.html b/docs/egl.html index e960309fc4..ad3b850f2a 100644 --- a/docs/egl.html +++ b/docs/egl.html @@ -32,13 +32,13 @@ cards.

the Gallium driver for your hardware. For example

-  $ ./configure --with-state-trackers=egl,es,vega --enable-gallium-{swrast,intel}
+  $ ./configure --enable-gles-overlay --with-state-trackers=egl,vega --enable-gallium-{swrast,intel}
-

The main library will be enabled by default. The egl state +

The main library and OpenGL is enabled by default. The first option enables +OpenGL ES 1.x and 2.x. The egl state tracker is needed by a number of EGL drivers. EGL drivers will be covered -later. The es state tracker provides OpenGL ES 1.x -and 2.x and the vega state tracker provides OpenVG +later. The vega state tracker provides OpenVG 1.x.

@@ -46,8 +46,8 @@ and 2.x and the vega state tracker provides OpenVG

In the given example, it will build and install libEGL, -libGLESv1_CM, libGLESv2, libOpenVG, and -one or more EGL drivers.

+libGL, libGLESv1_CM, libGLESv2, +libOpenVG, and one or more EGL drivers.

Configure Options

@@ -83,9 +83,26 @@ bare KMS (kernel modesetting).

  • --with-state-trackers

    The argument is a comma separated string. It is usually used to specify the -rendering APIs, like OpenGL ES or OpenVG, to build. But it should be noted -that a number of EGL drivers depend on the egl state tracker. -They will not be built without the egl state tracker.

    +rendering APIs, such as OpenVG, to build. But it should be noted that a number +of EGL drivers depend on the egl state tracker. They will +not be built without the egl state tracker.

    + +
    • + +
  • --enable-gles-overlay + +

    OpenGL and OpenGL ES are not controlled by +--with-state-trackers. OpenGL is always built. To build OpenGL +ES, this option must be explicitly given.

    + +
    • + +
  • --enable-gles1 and --enable-gles2 + +

    Unlike --enable-gles-overlay, which builds one library for each +rendering API, these options enable OpenGL ES support in OpenGL. The result is +one big library that supports multiple APIs. This is used by DRI drivers and +egl_dri2 EGL driver.

    • @@ -99,25 +116,17 @@ software rendering automatically.

    -

    OpenGL

    - -

    The OpenGL state tracker is not built in the above example. It should be -noted that the classic libGL is not a state tracker and cannot be -used with EGL (unless the EGL driver in use is egl_glx). To build -the OpenGL state tracker, one may append glx to ---with-state-trackers and manually build -src/gallium/targets/libgl-xlib/.

    -

    Use EGL

    -

    The demos for OpenGL ES and OpenVG can be found in progs/es1/, -progs/es2/ and progs/openvg/. You can use them to -test your build. For example,

    +

    There are demos for the client APIs supported by EGL. They can be found in +progs/egl/, You can use them to test your build. For example,

    -  $ cd progs/es1/xegl
+  $ cd progs/egl/eglut
+  $ make
+  $ cd ../opengles1
   $ make
-  $ ./torus
+  $ ./torus_x11

    Environment Variables

    -- cgit v1.2.3