X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=docs%2Fegl.html;h=b2198e931d078035bd1f075c68150c283a2ddbde;hb=7a9246c5d72290ed8455a426801b85b54374e102;hp=ad3b850f2ad2e9be87d6d81f965f525675639df7;hpb=3293bcdc80cdfa20a2381aae2b94505bdf95d857;p=mesa.git diff --git a/docs/egl.html b/docs/egl.html index ad3b850f2ad..b2198e931d0 100644 --- a/docs/egl.html +++ b/docs/egl.html @@ -69,14 +69,18 @@ drivers will be installed to ${libdir}/egl.

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

    List the window system(s) to support. It is by default x11, -which supports the X Window System. Its argument is a comma separated string -like, for example, --with-egl-displays=x11,kms. Because an EGL -driver decides which window system to support, this example will enable two -(sets of) EGL drivers. One supports the X window system and the other supports -bare KMS (kernel modesetting).

    +

    List the native platform window system(s) to support. It is by default +x11, which supports the X Window System. Its argument is a comma +separated string like, for example, --with-egl-platforms=x11,kms. +Because an EGL driver decides which window system to support, this example will +enable two (sets of) EGL drivers. One supports the X window system and the +other supports bare KMS (kernel modesetting).

    + +

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

    • @@ -118,16 +122,10 @@ software rendering automatically.

    Use EGL

    -

    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,

    +

    Demos

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

    There are demos for the client APIs supported by EGL. They can be found in +mesa/demos repository.

    Environment Variables

    @@ -153,14 +151,14 @@ specific driver. This variable is ignored for setuid/setgid binaries.

    -
  • EGL_DISPLAY +
  • EGL_PLATFORM

    When EGL_DRIVER is not set, the main library loads all -EGL drivers that support a certain window system. EGL_DISPLAY can -be used to specify the window system and the valid values are, for example, +EGL drivers that support a certain window system. EGL_PLATFORM +can be used to specify the window system and the valid values are, for example, x11 or kms. When the variable is not set, the main library defaults the value to the first window system listed in ---with-egl-displays at configuration time. +--with-egl-platforms at configuration time.

    • @@ -184,27 +182,27 @@ variable to true forces the use of software rendering.

    There are two categories of EGL drivers: Gallium and classic.

    -

    Gallium EGL drivers supports all rendering APIs specified in EGL 1.4. The -support for optional EGL functions and EGL extensions is usually more complete -than the classic ones. These drivers depend on the egl state -tracker to build. The available drivers are

    +

    Gallium EGL drivers supports all rendering APIs specified in EGL 1.4. These +drivers depend on the egl state tracker to build. The available +drivers are

    -

    <dpy> is given by --with-egl-displays at -configuration time. There will be one EGL driver for each combination of the -displays listed and the hardware drivers enabled.

    +

    <dpy> is given by --with-egl-platforms at +configuration time. There is usually one EGL driver for each combination of +the platforms listed and the pipe drivers enabled. When the platform is pure +software or pure hardware, non-working combinations will not be built.

    -

    Classic EGL drivers, on the other hand, supports only OpenGL as its -rendering API. They can be found under src/egl/drivers/. There -are 3 of them

    +

    Classic EGL drivers, on the other hand, support only a subset of the +available rendering APIs. They can be found under +src/egl/drivers/. There are 3 of them