X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=docs%2Fegl.html;h=2bc8f2372728822c69d6275ef71559b949b6df0e;hb=6d13d1aadb3d70eaea7b67ee9ae2651c2b29fbda;hp=bc21c6c4894fc9fcc2537e9561f97209f805f701;hpb=b0a929960384ffebf3b4f693fa0db4231ed897d4;p=mesa.git diff --git a/docs/egl.html b/docs/egl.html index bc21c6c4894..2bc8f237272 100644 --- a/docs/egl.html +++ b/docs/egl.html @@ -18,8 +18,8 @@

The current version of EGL in Mesa implements EGL 1.4. More information about EGL can be found at - -http://www.khronos.org/egl/.

+ +https://www.khronos.org/egl/.

The Mesa's implementation of EGL uses a driver architecture. The main library (libEGL) is window system neutral. It provides the EGL @@ -44,7 +44,7 @@ the driver for your hardware. For example

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.

+options enables the listed classic and Gallium drivers respectively.

@@ -77,21 +77,21 @@ drivers will be installed to ${libdir}/egl.

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

List the platforms (window systems) to support. Its argument is a comma -separated string such as --with-egl-platforms=x11,drm. It decides +separated string such as --with-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 main library to decide the native platform.

The available platforms are x11, drm, wayland, surfaceless, android, -and haiku. The android platform -can only be built as a system component, part of AOSP, while the -haiku platform can only be built with SCons. +and haiku. +The android platform can either be built as a system +component, part of AOSP, using Android.mk files, or +cross-compiled using appropriate configure options. +The haiku platform can only be built with SCons. Unless for special needs, the build system should select the right platforms automatically.

@@ -130,44 +130,13 @@ mesa/demos repository.

runtime

-
EGL_DRIVERS_PATH
-
- -

By default, the main library will look for drivers in the directory where -the drivers are installed to. This variable specifies a list of -colon-separated directories where the main library will look for drivers, in -addition to the default directory. This variable is ignored for setuid/setgid -binaries.

- -

This variable is usually set to test an uninstalled build. For example, one -may set

- -
-  $ export LD_LIBRARY_PATH=$mesa/lib
-  $ export EGL_DRIVERS_PATH=$mesa/lib/egl
-
- -

to test a build without installation

- -
- -
EGL_DRIVER
-
- -

This variable specifies a full path to or the name of an EGL driver. It -forces the 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_PLATFORM

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

+--with-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 @@ -199,6 +168,7 @@ the X server directly using (XCB-)DRI2 protocol.

This driver can share DRI drivers with libGL.

+

Packaging