1Introduction
2============
3
4The Mesa project began as an open-source implementation of the
5`OpenGL`_ specification - a system for rendering interactive 3D graphics.
6
7Over the years the project has grown to implement more graphics APIs,
8including `OpenGL ES`_, `OpenCL`_, `OpenMAX`_, `VDPAU`_, `VA-API`_,
9`XvMC`_, `Vulkan`_ and `EGL`_.
10
11A variety of device drivers allows the Mesa libraries to be used in many
12different environments ranging from software emulation to complete
13hardware acceleration for modern GPUs.
14
15Mesa ties into several other open-source projects: the `Direct Rendering
16Infrastructure`_, `X.org`_, and `Wayland`_ to provide OpenGL support on
17Linux, FreeBSD, and other operating systems.
18
19.. _OpenGL: https://www.opengl.org/
20.. _OpenGL ES: https://www.khronos.org/opengles/
21.. _OpenCL: https://www.khronos.org/opencl/
22.. _OpenMAX: https://www.khronos.org/openmax/
23.. _VDPAU: https://en.wikipedia.org/wiki/VDPAU
24.. _VA-API: https://en.wikipedia.org/wiki/Video_Acceleration_API
25.. _XvMC: https://en.wikipedia.org/wiki/X-Video_Motion_Compensation
26.. _Vulkan: https://www.khronos.org/vulkan/
27.. _EGL: https://www.khronos.org/egl/
28.. _Direct Rendering Infrastructure: https://dri.freedesktop.org/
29.. _X.org: https://x.org
30.. _Wayland: https://wayland.freedesktop.org
31
32.. toctree::
33   :maxdepth: 1
34   :caption: Documentation
35   :hidden:
36
37   self
38   history
39   developers
40   systems
41   license
42   faq
43   relnotes
44   thanks
45
46.. toctree::
47   :maxdepth: 2
48   :caption: Download and Install
49   :hidden:
50
51   download
52   install
53   precompiled
54
55.. toctree::
56   :maxdepth: 1
57   :caption: Need help?
58   :hidden:
59
60   lists
61   bugs
62
63.. toctree::
64   :maxdepth: 1
65   :caption: User Topics
66   :hidden:
67
68   shading
69   egl
70   opengles
71   envvars
72   osmesa
73   debugging
74   perf
75   perfetto
76   extensions
77   application-issues
78   viewperf
79   xlibdriver
80
81.. toctree::
82   :maxdepth: 1
83   :caption: Drivers
84   :hidden:
85
86   drivers/d3d12
87   drivers/freedreno
88   drivers/lima
89   drivers/llvmpipe
90   drivers/openswr
91   drivers/panfrost
92   drivers/svga3d
93   drivers/v3d
94   drivers/vc4
95   drivers/venus
96   drivers/zink
97
98.. toctree::
99   :maxdepth: 1
100   :caption: Developer Topics
101   :hidden:
102
103   repository
104   sourcetree
105   utilities
106   helpwanted
107   devinfo
108   codingstyle
109   submittingpatches
110   releasing
111   release-calendar
112   dispatch
113   gallium/index
114   nir/index
115   isl/index
116   android
117   macos
118   Linux Kernel Drivers <https://www.kernel.org/doc/html/latest/gpu/>
119
120.. toctree::
121   :maxdepth: 1
122   :caption: Testing
123   :hidden:
124
125   conform
126   ci/index
127
128.. toctree::
129   :maxdepth: 1
130   :caption: Links
131   :hidden:
132
133   OpenGL Website <https://www.opengl.org>
134   DRI Website <https://dri.freedesktop.org>
135   Developer Blogs <https://planet.freedesktop.org>
136
137.. toctree::
138   :maxdepth: 1
139   :caption: Hosted by:
140   :hidden:
141
142   freedesktop.org <https://www.freedesktop.org>
143