From c6320c5eb20d1ab20ad7800aceedc5dd8762dfeb Mon Sep 17 00:00:00 2001 From: Chia-I Wu Date: Thu, 28 Oct 2010 17:25:07 +0800 Subject: [PATCH] docs: Update egl and openvg docs. --- docs/egl.html | 47 ++++++++++++++++++----------------------------- docs/openvg.html | 29 ++++++++++------------------- 2 files changed, 28 insertions(+), 48 deletions(-) diff --git a/docs/egl.html b/docs/egl.html index d38f2dd7b7d..cc6462d9787 100644 --- a/docs/egl.html +++ b/docs/egl.html @@ -32,14 +32,14 @@ cards.

the Gallium driver for your hardware. For example

-  $ ./configure --enable-gles-overlay --with-state-trackers=egl,vega --enable-gallium-intel
+  $ ./configure --enable-gles-overlay --enable-openvg --enable-gallium-intel

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 vega state tracker provides OpenVG -1.x.

+OpenGL ES 1.x and 2.x. The second option enables +OpenVG. +

+
  • Build and install Mesa as usual.
    • @@ -84,19 +84,10 @@ only be built with SCons.

    -
  • --with-state-trackers - -

    The argument is a comma separated string. It is usually used to specify the -rendering APIs, such as OpenVG, to build. But it is also used to specify -egl state tracker that egl_gallium depends on.

    - -
    • -
  • --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.

    +

    OpenGL is built by default. To build OpenGL ES, this option must be +explicitly given.

    • @@ -108,6 +99,12 @@ one big library that supports multiple APIs.

    +
  • --enable-openvg + +

    OpenVG must be explicitly enabled by this option.

    + +
    • +

    Use EGL

    @@ -141,7 +138,8 @@ specific driver. This variable is ignored for setuid/setgid binaries.

    egl_gallium dynamically loads hardware drivers and client API modules found in EGL_DRIVERS_PATH. Thus, specifying this variable -alone is not sufficient for egl_gallium for uninstalled build.

    +alone is not sufficient for egl_gallium for an uninstalled +build.

    @@ -177,7 +175,7 @@ variable to true forces the use of software rendering.

    This driver is based on Gallium3D. It supports all rendering APIs and hardwares supported by Gallium3D. It is the only driver that supports OpenVG. -The supported platforms are X11, KMS, FBDEV, and GDI.

    +The supported platforms are X11, DRM, FBDEV, and GDI.

    @@ -193,16 +191,8 @@ is not available in GLX or GLX extensions.

    This driver supports the X Window System as its window system. It functions as a DRI2 driver loader. Unlike egl_glx, it has no dependency on -libGL. It talks to the X server directly using DRI2 protocol.

    - - -
  • egl_dri - -

    This driver lacks maintenance and does not build. It is similiar -to egl_dri2 in that it functions as a DRI(1) driver loader. But -unlike egl_dri2, it supports Linux framebuffer devices as its -window system and supports EGL_MESA_screen_surface extension. As DRI1 drivers -are phasing out, it might eventually be replaced by egl_dri2.

    +libGL. It talks to the X server directly using (XCB-)DRI2 +protocol.

    • @@ -295,7 +285,6 @@ should as well lock the display before using it.