From 8eea050f5aed6ad8aeb64105c0e2581f0fd0b10a Mon Sep 17 00:00:00 2001 From: Chia-I Wu Date: Mon, 20 Jun 2011 11:14:56 +0900 Subject: [PATCH] docs: update EGL for changed configure options --- docs/egl.html | 45 +++++++++++++++++++++------------------------ docs/opengles.html | 19 +------------------ docs/openvg.html | 10 +++++----- 3 files changed, 27 insertions(+), 47 deletions(-) diff --git a/docs/egl.html b/docs/egl.html index fb15086679f..5b750070ca1 100644 --- a/docs/egl.html +++ b/docs/egl.html @@ -29,12 +29,14 @@ directly dispatched to the drivers.

the driver for your hardware. For example

-  $ ./configure --enable-gles2 --enable-openvg --enable-gallium-nouveau
+  $ ./configure --enable-gles1 --enable-gles2 \
+                --with-dri-drivers=... \
+                --with-gallium-drivers=...
-

The main library and OpenGL is enabled by default. The first option above -enables OpenGL ES 2.x. The second option enables -OpenVG.

+

The main library and OpenGL is enabled by default. The first two options +above enables OpenGL ES 1.x and 2.x. The last two +options enables the listed classic and and Gallium drivers respectively.

@@ -42,8 +44,8 @@ enables OpenGL ES 2.x. The second option enables

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

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

Configure Options

@@ -65,6 +67,12 @@ drivers will be installed to ${libdir}/egl.

+
  • --enable-gallium-egl + +

    Enable the optional egl_gallium driver.

    + +
    • +
  • --with-egl-platforms

    List the platforms (window systems) to support. Its argument is a comma @@ -88,15 +96,17 @@ internal library that supports multiple APIs.

    • -
  • --enable-openvg +
  • --enable-shared-glapi -

    OpenVG must be explicitly enabled by this option.

    +

    By default, libGL has its own copy of libglapi. +This options makes libGL use the shared libglapi. This +is required if applications mix OpenGL and OpenGL ES.

    • -
  • --enable-gallium-egl +
  • --enable-openvg -

    Explicitly enable or disable egl_gallium.

    +

    OpenVG must be explicitly enabled by this option.

    • @@ -220,8 +230,7 @@ distribution.

    Generally, egl_dri2 is preferred over egl_gallium when the system already has DRI drivers. As egl_gallium is loaded before egl_dri2 when both are available, egl_gallium -may either be disabled with --disable-gallium-egl or packaged -separately.

    +is disabled by default.

    Developers

    @@ -307,17 +316,5 @@ not be called with the sample display at the same time. If a driver has access to an EGLDisplay without going through the EGL APIs, the driver should as well lock the display before using it. -

    TODOs

    - - - diff --git a/docs/opengles.html b/docs/opengles.html index 742182e76a3..0fee488e1a1 100644 --- a/docs/opengles.html +++ b/docs/opengles.html @@ -34,27 +34,10 @@ 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
-
    +

    There are some demos in mesa/demos repository.

    Developers

    -

    Internal Libraries

    - - - - - -
    Library NameUsed ByEnabledOpenGLOpenGL ES 1.xOpenGL ES 2.x
    libmesa.aClassic DRI driversyy--enable-gles1--enable-gles2
    libmesagallium.aGallium EGL and DRI driversyy--enable-gles1--enable-gles2
    -

    Dispatch Table

    OpenGL ES has an additional indirection when dispatching fucntions

    diff --git a/docs/openvg.html b/docs/openvg.html index eff8c5828e2..81e50b65f36 100644 --- a/docs/openvg.html +++ b/docs/openvg.html @@ -11,7 +11,7 @@

    OpenVG State Tracker

    -The current version of the OpenVG state tracker implements OpenVG 1.0. +The current version of the OpenVG state tracker implements OpenVG 1.1.

    More informations about OpenVG can be found at @@ -26,9 +26,9 @@ Please refer to Mesa EGL for more information about EGL.

    Building the library

      -
    1. Run configure with --enable-openvg. If you do -not need OpenGL, you can add --disable-opengl to save the -compilation time.
      2. +
    2. Run configure with --enable-openvg and +--enable-gallium-egl. If you do not need OpenGL, you can add +--disable-opengl to save the compilation time.
    3. Build and install Mesa as usual.
    @@ -36,7 +36,7 @@ compilation time.

    Sample build

    A sample build looks as follows: 
    -  $ ./configure --disable-opengl --enable-openvg
+  $ ./configure --disable-opengl --enable-openvg --enable-gallium-egl
   $ make
   $ make install
    -- 2.30.2