summaryrefslogtreecommitdiff
path: root/docs/index.rst
blob: 79571e07916401148bc501c60dc07115019c9f8d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
Introduction
============

The Mesa project began as an open-source implementation of the
`OpenGL`_ specification - a system for rendering interactive 3D graphics.

Over the years the project has grown to implement more graphics APIs,
including `OpenGL ES`_, `OpenCL`_, `OpenMAX`_, `VDPAU`_, `VA-API`_,
`XvMC`_, `Vulkan`_ and `EGL`_.

A variety of device drivers allows the Mesa libraries to be used in many
different environments ranging from software emulation to complete
hardware acceleration for modern GPUs.

Mesa ties into several other open-source projects: the `Direct Rendering
Infrastructure`_, `X.org`_, and `Wayland`_ to provide OpenGL support on
Linux, FreeBSD, and other operating systems.

.. _OpenGL: https://www.opengl.org/
.. _OpenGL ES: https://www.khronos.org/opengles/
.. _OpenCL: https://www.khronos.org/opencl/
.. _OpenMAX: https://www.khronos.org/openmax/
.. _VDPAU: https://en.wikipedia.org/wiki/VDPAU
.. _VA-API: https://en.wikipedia.org/wiki/Video_Acceleration_API
.. _XvMC: https://en.wikipedia.org/wiki/X-Video_Motion_Compensation
.. _Vulkan: https://www.khronos.org/vulkan/
.. _EGL: https://www.khronos.org/egl/
.. _Direct Rendering Infrastructure: https://dri.freedesktop.org/
.. _X.org: https://x.org
.. _Wayland: https://wayland.freedesktop.org

.. toctree::
   :maxdepth: 1
   :caption: Documentation
   :hidden:

   self
   history
   developers
   systems
   license
   faq
   relnotes
   thanks

.. toctree::
   :maxdepth: 2
   :caption: Download and Install
   :hidden:

   download
   install
   precompiled

.. toctree::
   :maxdepth: 1
   :caption: Need help?
   :hidden:

   lists
   bugs

.. toctree::
   :maxdepth: 1
   :caption: User Topics
   :hidden:

   shading
   egl
   opengles
   envvars
   osmesa
   debugging
   perf
   perfetto
   extensions
   application-issues
   viewperf
   xlibdriver

.. toctree::
   :maxdepth: 1
   :caption: Drivers
   :hidden:

   drivers/d3d12
   drivers/freedreno
   drivers/lima
   drivers/llvmpipe
   drivers/openswr
   drivers/panfrost
   drivers/v3d
   drivers/vc4
   drivers/venus
   drivers/vmware-guest
   drivers/zink

.. toctree::
   :maxdepth: 1
   :caption: Developer Topics
   :hidden:

   repository
   sourcetree
   utilities
   helpwanted
   devinfo
   codingstyle
   submittingpatches
   releasing
   release-calendar
   dispatch
   gallium/index
   android
   macos
   Linux Kernel Drivers <https://www.kernel.org/doc/html/latest/gpu/>

.. toctree::
   :maxdepth: 1
   :caption: Testing
   :hidden:

   conform
   ci/index

.. toctree::
   :maxdepth: 1
   :caption: Links
   :hidden:

   OpenGL Website <https://www.opengl.org>
   DRI Website <https://dri.freedesktop.org>
   Developer Blogs <https://planet.freedesktop.org>

.. toctree::
   :maxdepth: 1
   :caption: Hosted by:
   :hidden:

   freedesktop.org <https://www.freedesktop.org>