Find a file
Francisco Jerez 5ed23c14da intel/isl: Define ISL_AUX_STATE_COMPRESSED_HIER_DEPTH aux state.
This state is helpful to track when resolves are needed for HiZ-CCS
non-WT surfaces, since the ISL_AUX_STATE_COMPRESSED_* states that
currently exist don't distinguish between the CCS and the HiZ surfaces
being in a non-passthrough compression state, so we would have had to
pre-emptively issue a resolve before sampling from any
ISL_AUX_STATE_COMPRESSED_* HiZ-CCS surface just in case its HiZ
surface has non-trivial contents, even if its HiZ surface is in
pass-through state and the surface only has non-trivial CCS
compression.

This commit introduces a new ISL_AUX_STATE_COMPRESSED_HIER_DEPTH state
that indicates that the hierarchical depth surface has non-trivial
contents that have to be considered to get a complete representation
of the image.  While in this state the surface may also have
fast-cleared blocks.  The pre-existing ISL_AUX_STATE_COMPRESSED_*
states now unambiguously indicate that the HiZ surface is in an
identity state, so it's unnecessary to obtain a complete
representation of the image e.g. while sampling from a HiZ-CCS depth
surface.

v2: Use more abstract aux state name instead of
    ISL_AUX_STATE_COMPRESSED_HIZ, don't transition legacy HIZ surfaces
    to new aux state on write by using COMPRESS write behavior instead
    of COMPRESS_HIZ (Nanley).
v3: Comment clarifications (Nanley).
v4: Re-apply change to transition legacy HIZ surfaces to new aux state
    on write by using COMPRESS_HIZ for consistent semantics of the aux
    state irrespective of the aux usage, this is particularly
    important because the HIZ aux usage coexists with HIZ_CCS in some
    platforms, so pretending write_behavior is just "COMPRESS" for HIZ
    as on v2 would cause the ISL_AUX_STATE_COMPRESSED_CLEAR state to
    have different meaning and require different handling depending on
    the aux usage that was used with the surface before.
v5: Additional comment clarifications, express aux_state_possible()
    result and isl_aux_prepare_access() check in terms of
    aux_usage_info::write_behavior (Nanley).  Move changes in behavior
    for ISL_AUX_STATE_CLEAR from future ISL partial resolve commit
    into this commit since the change is already required for
    correctness as part of the split of hierarchical depth states.

Acked-by: Nanley Chery <nanley.g.chery@intel.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/31139>
2026-01-27 08:52:12 +00:00
.ci-farms ci: lima farm maintenance 2026-01-21 08:27:01 +00:00
.ci-farms-disabled ci: lima farm maintenance 2026-01-21 08:27:01 +00: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: Skip dEQP-VK.wsi.direct_drm. 2026-01-26 19:42:31 +00:00
.marge/hooks ci: pipeline_message: reset empty errors 2025-01-07 05:08:10 +00:00
android android: fix building rules for i915, r300 2025-10-08 23:43:33 +02:00
bin bin/pick: When the main widget is replaced, trigger a redraw 2026-01-22 19:11:21 +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: Implement VK_QCOM_image_processing. 2026-01-27 02:00:40 +00:00
include vulkan: update spec to 1.4.340 2026-01-23 16:07:30 +00:00
licenses licenses: add missing licenses 2025-01-08 20:37:51 +00:00
src intel/isl: Define ISL_AUX_STATE_COMPRESSED_HIER_DEPTH aux state. 2026-01-27 08:52:12 +00:00
subprojects meson: specify minimal target meson version for rust subprojects 2025-12-12 17:28:49 +00:00
.clang-format-ignore ci: enforce formatting for RADV & ACO 2023-06-16 19:59:52 +00:00
.clang-format-include ethos: Initial commit of a driver for the Arm Ethos-U65 NPU. 2025-10-15 20:10:15 +00:00
.dir-locals.el
.editorconfig editorconfig: Set for glsl files 2025-11-14 19:31:17 +00:00
.git-blame-ignore-revs radv: Add re-format commit to .git-blame-ignore-revs 2025-11-12 07:55:36 +00:00
.gitattributes gitlab: Highlight .cl as C 2023-11-02 11:37:46 +00:00
.gitignore intel/mda: Add code to produce mesa debug archives 2025-09-24 23:08:45 -07:00
.gitlab-ci.yml pvr/ci: Add dEQP-VK testing for BXS-4-64 on TI AM68 SK 2026-01-20 09:19:16 +00:00
.graphqlrc.yml
.mailmap mailmap: update my name and email 2025-11-03 22:08:48 +00:00
.mr-label-maker.yml mr-label-maker: tag src/virtio/virtgpu_kumquat* as part of gfxstream 2026-01-05 17:01:39 +00:00
.shellcheckrc ci: move shellcheck options to .shellcheckrc 2024-10-24 22:43:03 +00:00
clippy.toml ci: read the MSRV from clippy.toml to avoid having too many copies to keep in sync 2025-12-20 00:13:19 +01:00
CODEOWNERS CODEOWNERS: Add KosmicKrisp owners 2025-10-21 02:28:09 +00:00
meson.build meson: add mpeg12dec as a video-codec 2026-01-20 22:42:08 +00:00
meson.options meson: add mpeg12dec as a video-codec 2026-01-20 22:42:08 +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 26.1 2026-01-21 17:56:17 +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.