X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=docs%2Fegl.html;h=ee9bf355d7c5f50e229b63425e4942d8a23366bc;hb=3418f74a945c6bed80567beac68f3770f5c23466;hp=47582672944f8ba1ed7a178582afcb177f75d532;hpb=68071822f74384053905d7e5821de8b293f453eb;p=mesa.git diff --git a/docs/egl.html b/docs/egl.html index 47582672944..ee9bf355d7c 100644 --- a/docs/egl.html +++ b/docs/egl.html @@ -28,18 +28,17 @@ cards.

  1. -

    Run configure with the desired state trackers and enable -the Gallium driver for your hardware. For example

    +

    Run configure with the desired client APIs and enable +the driver for your hardware. For example

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

    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.

    +

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

    +
  2. Build and install Mesa as usual.
    3. @@ -72,39 +71,43 @@ drivers will be installed to ${libdir}/egl.

  3. --with-egl-platforms

    List the platforms (window systems) to support. Its argument is a comma -seprated string such as --with-egl-platforms=x11,kms. It decides +seprated string such as --with-egl-platforms=x11,drm. It decides the platforms a driver may support. The first listed platform is also used by the main library to decide the native platform: the platform the EGL native types such as EGLNativeDisplayType or EGLNativeWindowType defined for.

    -

    The available platforms are x11, kms, +

    The available platforms are x11, drm, fbdev, and gdi. The gdi platform can -only be built with SCons.

    +only be built with SCons. Unless for special needs, the build system should +select the right platforms automatically.

    4. -
  4. --with-state-trackers +
  5. --enable-gles1 and --enable-gles2 -

    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.

    +

    These options enable OpenGL ES support in OpenGL. The result is +one big library that supports multiple APIs.

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

    +

    This option enables OpenGL ES as separate libraries. This is an alternative +approach to enable OpenGL ES. It is only supported by +egl_gallium.

    7. -
  7. --enable-gles1 and --enable-gles2 +
  8. --enable-openvg -

    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.

    +

    OpenVG must be explicitly enabled by this option.

    + +
    9. + +
  9. --enable-gallium-egl + +

    Explicitly enable or disable egl_gallium.

    10. @@ -139,10 +142,6 @@ binaries.

    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.

    -

    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.

    -
  10. EGL_PLATFORM @@ -150,7 +149,12 @@ alone is not sufficient for egl_gallium for uninstalled build.

    This variable specifies the native platform. The valid values are the same as those for --with-egl-platforms. When the variable is not set, the main library uses the first platform listed in ---with-egl-platforms as the native platform

    +--with-egl-platforms as the native platform.

    + +

    Extensions like EGL_MESA_drm_display define new functions to +create displays for non-native platforms. These extensions are usually used by +applications that support non-native platforms. Setting this variable is +probably required only for some of the demos found in mesa/demo repository.

    11. @@ -173,11 +177,19 @@ variable to true forces the use of software rendering.

    EGL Drivers

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