blob: ffece71db0dc4a550a135d9a9e35be050d664011 [file] [log] [blame]
Erik Faye-Lund0b4f51212020-01-30 19:27:17 +01001Introduction
2============
Erik Faye-Lund4d066832020-06-12 20:09:42 +02003
Erik Faye-Lund0b4f51212020-01-30 19:27:17 +01004The Mesa project began as an open-source implementation of the
Erik Faye-Lund7b547722020-11-20 13:58:40 +01005`OpenGL`_ specification - a system for rendering interactive 3D graphics.
Erik Faye-Lund4d066832020-06-12 20:09:42 +02006
Erik Faye-Lund0b4f51212020-01-30 19:27:17 +01007Over the years the project has grown to implement more graphics APIs,
Erik Faye-Lund7f155a62020-11-20 14:01:27 +01008including `OpenGL ES`_, `OpenCL`_, `OpenMAX`_, `VDPAU`_, `VA API`_,
Erik Faye-Lunde3047762020-11-20 14:20:47 +01009`XvMC`_, `Vulkan`_ and `EGL`_.
Erik Faye-Lund4d066832020-06-12 20:09:42 +020010
Erik Faye-Lund0b4f51212020-01-30 19:27:17 +010011A 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.
Erik Faye-Lund4d066832020-06-12 20:09:42 +020014
Erik Faye-Lund0b4f51212020-01-30 19:27:17 +010015Mesa ties into several other open-source projects: the `Direct Rendering
Erik Faye-Lund7b547722020-11-20 13:58:40 +010016Infrastructure`_ and `X.org`_ to provide OpenGL support on Linux, FreeBSD
Erik Faye-Lund0b4f51212020-01-30 19:27:17 +010017and other operating systems.
Erik Faye-Lund7b547722020-11-20 13:58:40 +010018
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/
Erik Faye-Lunde3047762020-11-20 14:20:47 +010027.. _EGL: https://www.khronos.org/egl/
Erik Faye-Lund7b547722020-11-20 13:58:40 +010028.. _Direct Rendering Infrastructure: https://dri.freedesktop.org/
29.. _X.org: https://x.org
Erik Faye-Lund893a30e2020-11-20 14:29:00 +010030
31.. toctree::
32 :maxdepth: 1
33 :caption: Documentation
34 :hidden:
35
36 self
37 history
38 developers
39 systems
40 license
41 faq
42 relnotes
43 thanks
44
45.. toctree::
46 :maxdepth: 2
47 :caption: Download and Install
48 :hidden:
49
50 download
51 install
52 precompiled
53
54.. toctree::
55 :maxdepth: 1
56 :caption: Need help?
57 :hidden:
58
59 lists
60 bugs
61
62.. toctree::
63 :maxdepth: 1
64 :caption: User Topics
65 :hidden:
66
67 shading
68 egl
69 opengles
70 envvars
71 osmesa
72 debugging
73 perf
74 extensions
75 application-issues
76 viewperf
77 xlibdriver
78
79.. toctree::
80 :maxdepth: 1
81 :caption: Drivers
82 :hidden:
83
84 drivers/d3d12
85 drivers/freedreno
86 drivers/llvmpipe
87 drivers/openswr
Alyssa Rosenzweigdaf339a2020-12-14 19:04:27 -050088 drivers/panfrost
Erik Faye-Lund893a30e2020-11-20 14:29:00 +010089 drivers/v3d
90 drivers/vc4
91 drivers/vmware-guest
92 drivers/zink
93
94.. toctree::
95 :maxdepth: 1
96 :caption: Developer Topics
97 :hidden:
98
99 repository
100 sourcetree
101 utilities
102 helpwanted
103 devinfo
104 codingstyle
105 submittingpatches
106 releasing
107 release-calendar
108 sourcedocs
109 dispatch
110 gallium/index
111 android
Alyssa Rosenzweige7977b82021-04-10 07:44:14 +0530112 macos
Erik Faye-Lund893a30e2020-11-20 14:29:00 +0100113 Linux Kernel Drivers <https://www.kernel.org/doc/html/latest/gpu/>
114
115.. toctree::
116 :maxdepth: 1
117 :caption: Testing
118 :hidden:
119
120 conform
121 ci/index
122
123.. toctree::
124 :maxdepth: 1
125 :caption: Links
126 :hidden:
127
128 OpenGL Website <https://www.opengl.org>
129 DRI Website <https://dri.freedesktop.org>
130 Developer Blogs <https://planet.freedesktop.org>
131
132.. toctree::
133 :maxdepth: 1
134 :caption: Hosted by:
135 :hidden:
136
137 freedesktop.org <https://www.freedesktop.org>