mesa/docs
Marek Olšák e26c28f311 radeonsi: enable ACO by default
NIR+ACO is the best SSA-based shader compiler for AMD GPUs that exists.

There are many reasons why NIR+ACO is better than LLVM, and I have a long
list that I've collected over the years, but the major ones are better GPU
performance (faster GPU memory access thanks to better clauses and
scheduling, a lot less SGPR/VGPR spilling, better loop support, slightly
smaller shader binaries), 8x lower shader compile times, and smaller memory
footprint of the IR.

It also shows that NIR is a mature SSA-based shader compiler that helps
drivers generate optimized code very quickly.

And most importantly, radeonsi has slightly better Viewperf performance
with NIR+ACO than LLVM, and that's difficult to ignore.

Reviewed-by: Qiang Yu <yuq825@gmail.com>
Reviewed-by: Pierre-Eric Pelloux-Prayer <pierre-eric.pelloux-prayer@amd.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/38070>
2025-10-29 14:11:22 +00:00
..
_extra
_exts docs: update/fix vk spec urls 2025-10-22 09:23:34 +02:00
ci docs: Update LAVA caching setup 2025-10-16 10:45:32 +00:00
drivers docs/pvr: update hardware list 2025-10-11 19:45:10 +00:00
gallium mesa: support GL_NV_representative_fragment test 2025-09-13 11:28:44 +00:00
header-stubs util: Always generate u_format_gen.h as docs need it 2025-08-21 03:19:02 +08:00
isl
mesa3d_theme
nir
relnotes radv: advertise VK_EXT_shader_uniform_buffer_unsized_array 2025-10-28 07:55:40 +01:00
spirv compiler: document SPIR-V capture + replace 2025-09-22 19:06:07 +00:00
vulkan vulkan: move internal vulkan pseudo-extensions to a common file 2025-09-01 03:50:12 +00:00
amber.rst
android.rst docs/envvars: Add section: Android System Properties 2025-10-27 19:15:19 +00:00
application-issues.rst
ARB_color_buffer_float.txt
bugs.rst
codingstyle.rst
conf.py vulkan: move internal vulkan pseudo-extensions to a common file 2025-09-01 03:50:12 +00:00
conform.rst
debugging.rst
devinfo.rst docs,ci: update mapi relocation 2025-08-06 20:35:26 +00:00
dispatch.rst
download.rst
egl.rst x11: Remove DRI2 support 2025-07-09 17:49:58 +00:00
envvars.rst radeonsi: enable ACO by default 2025-10-29 14:11:22 +00:00
extensions.rst
faq.rst
favicon.ico
favicon.svg
features.txt radv: advertise VK_EXT_shader_uniform_buffer_unsized_array 2025-10-28 07:55:40 +01:00
gitlab-ci-inc.yml docs: finish converting the docs job into a meson build job 2025-10-06 09:53:24 +00:00
gitlab-ci.yml docs/ci: always build the docs 2025-08-26 09:49:56 +00:00
gpu-perf-tracing.rst
gpuvis.rst
helpwanted.rst
history.rst
index.rst compiler: document SPIR-V capture + replace 2025-09-22 19:06:07 +00:00
install.rst docs: Use correct ICD path in install.rst 2025-10-01 11:42:23 +00:00
isaspec.rst
libGL.txt mesa: Remove unused assyntax.h and update related files 2025-08-20 16:21:27 +00:00
license.rst
lists.rst
macos.rst
meson.build util: Always generate u_format_gen.h as docs need it 2025-08-21 03:19:02 +08:00
meson.rst ci/windows: Update documents to use winget 2025-09-17 06:53:33 +00:00
opengles.rst
perf.rst
perfetto.rst
precompiled.rst
README.UVD
README.VCE
release-calendar.csv docs: update calendar for 25.3.0-rc1 2025-10-16 20:52:31 +00:00
release-calendar.rst
release-maintainers-keys.asc
releasing.rst docs/releasing: add missing "track remote staging branch" command in instructions 2025-07-16 15:29:05 +00:00
relnotes.rst docs: add release notes for 25.2.5 2025-10-15 17:17:21 +00:00
repository.rst
rust.rst mesa: define peripheral support for src/util/rust 2025-07-24 20:51:36 +00:00
rusticl.rst mesa: Bump required Rust version to 1.82 2025-08-03 10:16:20 +00:00
shading.rst docs: update khronos wiki url 2025-10-08 19:24:51 +00:00
sourcetree.rst Remove VDPAU 2025-09-10 12:33:57 +00:00
submittingpatches.rst docs: Add more details about the contribution process 2025-09-18 17:00:12 +00:00
systems.rst Remove VDPAU 2025-09-10 12:33:57 +00:00
teflon.rst rocket: Initial commit of a driver for Rockchip's NPU 2025-07-28 08:06:38 +02:00
u_trace.rst
utilities.rst
viewperf.rst
xlibdriver.rst

The software may implement third party technologies (e.g. third party
libraries) that are not licensed to you by AMD and for which you may need
to obtain licenses from other parties.  Unless explicitly stated otherwise,
these third party technologies are not licensed hereunder.  Such third
party technologies include, but are not limited, to H.264, MPEG-2, MPEG-4,
AVC, and VC-1.  

For MPEG-2 Intermediate Products: ANY USE OF THIS PRODUCT IN ANY MANNER OTHER
THAN PERSONAL USE THAT COMPLIES WITH THE MPEG-2 STANDARD IS EXPRESSLY
PROHIBITED WITHOUT A LICENSE UNDER APPLICABLE PATENTS IN THE MPEG-2 PATENT
PORTFOLIO, WHICH LICENSES IS AVAILABLE FROM MPEG LA, LLC, 6312 S. Fiddlers
Green Circle, Suite 400E, Greenwood Village, Colorado 80111 U.S.A.

WARRANTY DISCLAIMER: THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
KIND.  AMD DISCLAIMS ALL WARRANTIES, EXPRESS, IMPLIED, OR STATUTORY, INCLUDING
BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, TITLE, NON-INFRINGEMENT, THAT THE SOFTWARE WILL RUN
UNINTERRUPTED OR ERROR-FREE OR WARRANTIES ARISING FROM CUSTOM OF TRADE OR
COURSE OF USAGE.  THE ENTIRE RISK ASSOCIATED WITH THE USE OF THE SOFTWARE IS
ASSUMED BY YOU.  Some jurisdictions do not allow the exclusion of implied
warranties, so the above exclusion may not apply to You.

LIMITATION OF LIABILITY AND INDEMNIFICATION:  AMD AND ITS LICENSORS WILL NOT,
UNDER ANY CIRCUMSTANCES BE LIABLE FOR ANY PUNITIVE, DIRECT, INCIDENTAL,
INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING FROM USE OF THE SOFTWARE OR
THIS AGREEMENT EVEN IF AMD AND ITS LICENSORS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  In no event shall AMD's total liability to You
for all damages, losses, and causes of action (whether in contract, tort
(including negligence) or otherwise) exceed the amount of $100 USD.  You agree
to defend, indemnify and hold harmless AMD and its licensors, and any of their
directors, officers, employees, affiliates or agents from and against any and
all loss, damage, liability and other expenses (including reasonable
attorneys' fees), resulting from Your use of the Software or violation of the
terms and conditions of this Agreement.

U.S. GOVERNMENT RESTRICTED RIGHTS: The Software is provided with "RESTRICTED
RIGHTS." Use, duplication, or disclosure by the Government is subject to the
restrictions as set forth in FAR 52.227-14 and DFAR252.227-7013, et seq., or
its successor.  Use of the Software by the Government constitutes
acknowledgement of AMD's proprietary rights in them.

EXPORT RESTRICTIONS: The Software may be subject to export restrictions as
stated in the Software License Agreement.