Find a file
Eric Engestrom c3957860b8
Some checks are pending
macOS-CI / macOS-CI (dri) (push) Waiting to run
macOS-CI / macOS-CI (xlib) (push) Waiting to run
ci-tron: bump job template commit to get cached job templates
This also includes support for the new job cookie system, verifying that jobs
running originate from the claimed source. This is useful internally but won't
affect users, unlike the feature in the title :)

Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37609>
2025-10-08 11:04:51 +00:00
.ci-farms Revert "ci: disable Collabora's farm due to maintenance" 2025-10-06 13:00:52 +02:00
.ci-farms-disabled Revert "ci: disable Collabora's farm due to maintenance" 2025-10-06 13:00:52 +02:00
.github/workflows meson: remove unused osmesa option 2025-06-23 06:42:50 +00:00
.gitlab docs: update gitlab docs urls 2025-02-23 00:31:59 +01:00
.gitlab-ci ci/android: Make Vulkan driver replacement conditional 2025-10-08 09:25:24 +00:00
.marge/hooks ci: pipeline_message: reset empty errors 2025-01-07 05:08:10 +00:00
android android: fall back to SwiftShader’s LLVM 2025-09-29 14:49:43 -07:00
bin Revert "meson: use vcs_tag() instead of custom script" 2025-10-06 23:06:11 +00:00
build-support meson: move tsan-blacklist.txt to build-support with the other build support files 2024-05-01 07:05:12 +00:00
docs tu: Add VK_EXT_zero_initialize_device_memory 2025-10-08 10:13:35 +00:00
include vulkan: update spec to 1.4.328 2025-09-26 14:02:52 +00:00
licenses licenses: add missing licenses 2025-01-08 20:37:51 +00:00
src v3d: expose GL_KHR_shader_subgroup for v71+ 2025-10-08 10:48:41 +00:00
subprojects ci: Bump DirectX-Headers and Agility SDK dependencies to 1.618.1 2025-10-01 14:46:15 -04:00
.clang-format
.clang-format-ignore
.clang-format-include clang-format: Add src/imagination to .clang-format-include 2025-09-17 10:05:18 +00:00
.dir-locals.el
.editorconfig editorconfig: move OpenCL configuration to root 2025-08-30 22:49:08 -07:00
.git-blame-ignore-revs freedreno: Add register renaming to .git-blame-ignore-revs 2025-07-03 12:50:04 +00:00
.gitattributes
.gitignore intel/mda: Add code to produce mesa debug archives 2025-09-24 23:08:45 -07:00
.gitlab-ci.yml ci-tron: bump job template commit to get cached job templates 2025-10-08 11:04:51 +00:00
.graphqlrc.yml
.mailmap mailmap: Update for Dylan Baker 2025-09-16 19:45:15 +00:00
.mr-label-maker.yml mr-label-maker.yml: remove remaining osmesa occurrences 2025-06-23 06:42:50 +00:00
.shellcheckrc ci: move shellcheck options to .shellcheckrc 2024-10-24 22:43:03 +00:00
CODEOWNERS intel: update code owners 2025-08-31 15:38:27 +00:00
meson.build meson: static link spirv-tools for darwin 2025-10-06 15:19:55 +00:00
meson.options pvr, pco: usc program (pre-)generation boilerplate 2025-09-16 18:26:09 +00:00
README.rst docs: Match README installation guide with meson.rst 2024-07-27 11:53:53 +00:00
rustfmt.toml mesa: Add rustfmt.toml 2024-11-18 22:29:14 +00:00
VERSION VERSION: bump to 25.3 2025-07-16 13:50:24 +00:00

`Mesa <https://mesa3d.org>`_ - The 3D Graphics Library
======================================================


Source
------

This repository lives at https://gitlab.freedesktop.org/mesa/mesa.
Other repositories are likely forks, and code found there is not supported.


Build & install
---------------

You can find more information in our documentation (`docs/install.rst
<https://docs.mesa3d.org/install.html>`_), but the recommended way is to use
Meson (`docs/meson.rst <https://docs.mesa3d.org/meson.html>`_):

.. code-block:: sh

  $ meson setup build
  $ ninja -C build/
  $ sudo ninja -C build/ install

Support
-------

Many Mesa devs hang on IRC; if you're not sure which channel is
appropriate, you should ask your question on `OFTC's #dri-devel
<irc://irc.oftc.net/dri-devel>`_, someone will redirect you if
necessary.
Remember that not everyone is in the same timezone as you, so it might
take a while before someone qualified sees your question.
To figure out who you're talking to, or which nick to ping for your
question, check out `Who's Who on IRC
<https://dri.freedesktop.org/wiki/WhosWho/>`_.

The next best option is to ask your question in an email to the
mailing lists: `mesa-dev\@lists.freedesktop.org
<https://lists.freedesktop.org/mailman/listinfo/mesa-dev>`_


Bug reports
-----------

If you think something isn't working properly, please file a bug report
(`docs/bugs.rst <https://docs.mesa3d.org/bugs.html>`_).


Contributing
------------

Contributions are welcome, and step-by-step instructions can be found in our
documentation (`docs/submittingpatches.rst
<https://docs.mesa3d.org/submittingpatches.html>`_).

Note that Mesa uses gitlab for patches submission, review and discussions.