third_party_mesa3d/docs/opengles.rst

OpenGL ES
=========

Mesa implements OpenGL ES 1.1 and OpenGL ES 2.0. More information about
OpenGL ES can be found at https://www.khronos.org/opengles/.

OpenGL ES depends on a working EGL implementation. Please refer to
:doc:`Mesa EGL <egl>` for more information about EGL.

Build the Libraries
-------------------

#. Run ``meson configure`` with ``-D gles1=true -D gles2=true`` and
   enable the Gallium driver for your hardware.
#. Build and install Mesa as usual.

Alternatively, if XCB-DRI2 is installed on the system, one can use
``egl_dri2`` EGL driver with OpenGL|ES-enabled DRI drivers

#. Run ``meson configure`` with ``-D gles1=true -D gles2=true``.
#. Build and install Mesa as usual.

Both methods will install libGLESv1_CM, libGLESv2, libEGL, and one or
more EGL drivers for your hardware.

Run the Demos
-------------

There are some demos in ``mesa/demos`` repository.
docs: convert articles to reructuredtext This uses the previously added scripts to convert the documentation to reStructuredText, which is both easier to read offline, and can be used to generate modern HTML for online documentation. No modification to the generated results have been done. Acked-by: Eric Engestrom <eric@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> 2020-06-12 18:09:42 +00:00			`OpenGL ES`
			`=========`

			`Mesa implements OpenGL ES 1.1 and OpenGL ES 2.0. More information about`
			`OpenGL ES can be found at https://www.khronos.org/opengles/.`

docs: update internal references This time, let's use proper Sphinx roles for the referenes, so we can reference documents and inline refs. Reviewed-by: Eric Anholt <eric@anholt.net> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/5471> 2020-06-15 10:31:36 +00:00			`OpenGL ES depends on a working EGL implementation. Please refer to`
			:doc:`Mesa EGL <egl>` for more information about EGL.
docs: convert articles to reructuredtext This uses the previously added scripts to convert the documentation to reStructuredText, which is both easier to read offline, and can be used to generate modern HTML for online documentation. No modification to the generated results have been done. Acked-by: Eric Engestrom <eric@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> 2020-06-12 18:09:42 +00:00
			`Build the Libraries`
			`-------------------`

			#. Run ``meson configure`` with ``-D gles1=true -D gles2=true`` and
			`enable the Gallium driver for your hardware.`
			`#. Build and install Mesa as usual.`

			`Alternatively, if XCB-DRI2 is installed on the system, one can use`
			``egl_dri2`` EGL driver with OpenGL\|ES-enabled DRI drivers

			#. Run ``meson configure`` with ``-D gles1=true -D gles2=true``.
			`#. Build and install Mesa as usual.`

			`Both methods will install libGLESv1_CM, libGLESv2, libEGL, and one or`
			`more EGL drivers for your hardware.`

			`Run the Demos`
			`-------------`

			There are some demos in ``mesa/demos`` repository.