Erik Faye-Lund
aa59841b64
docs: renderpass -> render pass
...
This is how it's written in the Vulkan spec, let's follow that.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29879 >
2024-06-25 10:51:27 +00:00
Eric Engestrom
364ef85a8e
docs/zink: format the envvar value as code instead of plain text
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/28516 >
2024-04-02 18:08:52 +00:00
Eric Engestrom
96e8648b32
docs: replace references to the deprecated VK_INSTANCE_LAYERS with the new VK_LOADER_LAYERS_ENABLE
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/28516 >
2024-04-02 18:08:52 +00:00
duncan.hopkins
2743adac7f
zink/apple: update docs to reflect the current status of Zink on macOS.
...
Adds extra information to the "Notes for macOS" and "Zink" documentation pages to:
1) Better describe how to build on macOS
2) Temper expectations on running Zink on macOSx
Closes: https://gitlab.freedesktop.org/mesa/mesa/-/issues/10768
Acked-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/28330 >
2024-03-22 11:56:01 +00:00
Erik Faye-Lund
ca42706dba
docs: apply some trivial redirects
...
These were found by using the linkcheck builder.
Reviewed-by: Corentin Noël <corentin.noel@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25585 >
2023-10-09 11:54:12 +00:00
Mike Blumenkrantz
1e1f58c1ac
zink: add ZINK_DEBUG=quiet
...
mainly for use with ZINK_DEBUG=optimal_keys on turnip since spamming
a warning like that constantly is pointless
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25037 >
2023-09-11 14:48:31 +00:00
Mike Blumenkrantz
4edbe8f5a0
zink: add mem debugging
...
modeled off turnip's debug infra, this adds debug printing for oom
scenarios
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/23653 >
2023-06-15 01:31:24 +00:00
Mike Blumenkrantz
6098c3f9c0
zink: add ZINK_DEBUG=nobgc
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22899 >
2023-05-09 22:16:21 +00:00
Mike Blumenkrantz
0fb5f81ab6
zink: add ZINK_DEBUG=noopt
...
it's often useful to disable optimized pipeline compiles for debugging
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22899 >
2023-05-09 22:16:21 +00:00
Mike Blumenkrantz
6d84b34359
zink: add ZINK_DEBUG=optimal_keys
...
it's otherwise very annoying to figure out why this may or may not be
available
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22854 >
2023-05-05 12:32:40 +00:00
Mike Blumenkrantz
492a1cf49e
zink: add ZINK_DEBUG=noshobj to disable EXT_shader_object
...
for debugging/testing
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22725 >
2023-04-27 01:33:17 +00:00
Erik Faye-Lund
1ca29408f1
docs/zink: clean up requirements-language
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22053 >
2023-03-21 15:42:50 +00:00
Erik Faye-Lund
adc7170d85
docs/zink: mention vk1.2 mirror-clamp feature option
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22053 >
2023-03-21 15:42:50 +00:00
Mike Blumenkrantz
270f9c0b06
zink: add ZINK_DEBUG=flushsync
...
this disables the submission thread
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22040 >
2023-03-20 22:12:40 -04:00
Erik Faye-Lund
30b456021c
docs/zink: fixup wording of the GL 4.6 requirements
...
Seems the copy-pasta was strong in this one. Whoops!
Fixes: 5deac5c156
("docs: document zink GL 4.6 requirements")
Acked-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/21813 >
2023-03-10 14:02:07 +00:00
Erik Faye-Lund
d6ce7bc020
docs/zink: remove some trailing spaces
...
These went unnoticed until now, let's fix them.
Acked-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/21813 >
2023-03-10 14:02:07 +00:00
Erik Faye-Lund
33d7592489
docs/zink: use vk-feat role for features
...
This gives us links to the features, instead of just mentioning them.
Acked-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/21813 >
2023-03-10 14:02:06 +00:00
Mike Blumenkrantz
26aedae568
zink: add ZINK_DEBUG=map
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/21425 >
2023-02-23 21:47:20 +00:00
Mike Blumenkrantz
0d445cfb7e
zink: enable renderpass optimizations by default for selected drivers
...
CI has been running this for months on turnip, so let's give it some
broader testing
also add a ZINK_DEBUG=norp for testing
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/21296 >
2023-02-14 20:06:16 +00:00
Mike Blumenkrantz
7ab5c5d36d
zink: use EXT_descriptor_buffer with ZINK_DESCRIPTORS=db
...
this should be bug-free, as it passes cts/piglit/gaming on multiple drivers,
but since it's new, it stays behind an env var for at least one release
Acked-by: Dave Airlie <airlied@redhat.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/20489 >
2023-01-03 09:20:45 -05:00
Mike Blumenkrantz
885e5a3571
Revert "zink: remove descriptor-mode selection infrastructure"
...
this would've been in-use, but khronos changes while I was on vacation
blocked a merge
This reverts commit 3f371d4e94
.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/20489 >
2023-01-03 09:19:31 -05:00
Erik Faye-Lund
8d3475ab8c
docs/zink: document missing max-image requirements
...
This should bring Zink's documentation up to speed with the previous
commit.
Reviewed-by: Jesse Natalie <jenatali@microsoft.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19780 >
2022-11-29 13:35:46 +00:00
Erik Faye-Lund
dc770eb9bb
zink: check maxImageDimension1D as well as maxImageDimension2D
...
According to the docs for PIPE_CAP_MAX_TEXTURE_2D_SIZE, it's the limit
both for 2D *and* 1D textures. So let's take the min of the two vulkan
features here instead of assuming they're the same.
Reviewed-by: Jesse Natalie <jenatali@microsoft.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19780 >
2022-11-29 13:35:46 +00:00
Erik Faye-Lund
16fd8b8324
docs/zink: update query requirements
...
These features are no longer required.
Reviewed-by: Soroush Kashani <soroush.kashani@imgtec.com >
Reviewed-by: Christian Gmeiner <christian.gmeiner@gmail.com >
Reviewed-by: Marek Olšák <marek.olsak@amd.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19750 >
2022-11-25 06:50:59 +00:00
Erik Faye-Lund
a2a0ac21e4
docs/zink: add missing required device-feature
...
Seems I forgot to add this to the list of required features.
Fixes: eb0195358c
("zink: only inspect dual-src limit if feature enabled")
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19779 >
2022-11-24 12:57:46 +00:00
Erik Faye-Lund
13bccac5a7
zink: update textureCompressionBC requirement
...
The mesa state-tracker can now emulate all formats indicated by this
feature-flag, so we don't require this for OpenGL 4.2 any more.
It's however a good idea to support for power-usage and performance
reasons, saving on memory bandwidth. So let's move it to the
gl46_optimal block instead.
Fixes: e4ff42684b
("mesa/st: enable bptc extension with fallback")
Fixes: 2ea481b2f0
("Zink: add Zink profiles file")
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19779 >
2022-11-24 12:57:46 +00:00
Erik Faye-Lund
754353c417
zink: fix incorrect requirements
...
These were in the wrong list all along.
Fixes: a466c2a783
("zink: check for stores and atomics features")
Fixes: 2644835f03
("zink: add missing required feature")
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19779 >
2022-11-24 12:57:46 +00:00
Erik Faye-Lund
4eef5628c8
docs: drop custom envvar directive
...
The custom envvar directive is strange. It overloads the global
namespace, where there's already a well-known envvar directive, but the
envvar role won't resolve to envvars defined using the custom directive.
It's not really critical to declare the type and default value here, and
many descriptions already include this. Let's just use the plain one,
and let the description take care of the details where needed.
Reviewed-by: Yonggang Luo <luoyonggang@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19593 >
2022-11-15 11:25:05 +01:00
Erik Faye-Lund
864e658c0a
docs: properly nest envvar descriptions
...
These were not nested properly, making the definitions not part of the
definition lists.
Reviewed-by: Yonggang Luo <luoyonggang@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19593 >
2022-11-15 11:25:05 +01:00
Erik Faye-Lund
3f371d4e94
zink: remove descriptor-mode selection infrastructure
...
We only support lazy descriptors these days, so having the
infrastructure around to support automatic selection of that one mode is
kinda silly.
And it's not like setting an environment variable that is never read is
going to cause any issues, so we don't even need this to avoid breaking
existing setups.
Let's just rip it out. We can reintroduce it again on the off-chance
that someone has a new clever descriptor mode they want to experiment
with.
Reviewed-by: Hoe Hao Cheng <haochengho12907@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19670 >
2022-11-14 09:46:15 +00:00
Erik Faye-Lund
ef05d28aa2
docs: fixup broken link syntax
...
Seems I got this slightly wrong when I fixed up the previous syntax
issue. Whoops, let's fix that!
Fixes: 6b3b633391
("docs/zink: fix and cleanup rst syntax")
Reviewed-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19574 >
2022-11-10 17:17:25 +01:00
Erik Faye-Lund
ba78af66c6
docs: use ext-role for GL / VK extensions
...
This makes sure that we generate proper links to all of these
extensions.
Reviewed-by: Eric Engestrom <eric@igalia.com >
Reviewed-by: Adam Jackson <ajax@redhat.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19594 >
2022-11-09 16:10:55 +00:00
Erik Faye-Lund
e5f9a9998d
docs: use anonymous links when possible
...
Anonymous links has some benefits in that it reduces the chance of
warnings when similar identifiers are used. So let's use them instead
when we can.
Reviewed-by: David Heidelberg <david.heidelberg@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19492 >
2022-11-07 10:58:12 +00:00
Erik Faye-Lund
6b3b633391
docs/zink: fix and cleanup rst syntax
...
This new section didn't use the correct RST syntax, and ended up
with a broken section in the rendered docs.
Fix the syntax, and clean things up a bit to avoid overly long lines.
Fixes: be235edfe2
("zink: add profile documentation")
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19481 >
2022-11-07 10:52:35 +00:00
Christophe
be235edfe2
zink: add profile documentation
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19192 >
2022-10-26 19:02:20 +00:00
Mike Blumenkrantz
2136047624
zink: rework ZINK_PIPELINE_LIBRARY_FORCE into ZINK_DEBUG flag
...
Reviewed-by: Dave Airlie <airlied@redhat.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/18868 >
2022-09-28 23:13:44 +00:00
Erik Faye-Lund
df58342f61
mesa/st: enable rgtc extension with fallback
...
Reviewed-by: Alyssa Rosenzweig <alyssa.rosenzweig@collabora.com >
Acked-by: Eric Engestrom <eric@igalia.com >
Tested-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/18248 >
2022-09-15 08:16:01 +00:00
Erik Faye-Lund
3454ff21e5
docs/zink: document rgtc requirement
...
OpenGL 3.0 requires RGTC support, and until we have emulation in place,
we should document that requirement.
Fixes: d50e8554b9
("zink: add feature-documentation")
Acked-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/18549 >
2022-09-13 08:15:40 +00:00
Erik Faye-Lund
6e990a2f73
docs/zink: remove bptc from required formats for gl4.2
...
We now have lowering-code in the mesa state-tracker, meaning we no
longer need this feature.
Fixes: e4ff42684b
("mesa/st: enable bptc extension with fallback")
Reviewed-by: Alyssa Rosenzweig <alyssa.rosenzweig@collabora.com >
Acked-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/18434 >
2022-09-07 08:11:31 +00:00
Mike Blumenkrantz
13d4fda841
zink: require VK_KHR_descriptor_update_template
...
it's been long enough, and there's no technical reason why drivers
shouldn't have this implemented
ZINK_DESCRIPTORS environment variable is preserved for future use
Reviewed-by: Dave Airlie <airlied@redhat.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/18065 >
2022-08-16 17:55:47 +00:00
Mike Blumenkrantz
a41ea582c4
zink: add ZINK_DEBUG=noreorder
...
this will be useful for debugging
Reviewed-by: Dave Airlie <airlied@redhat.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/17667 >
2022-07-26 21:34:59 +00:00
Mike Blumenkrantz
49688e6b8c
zink: add doc for ZINK_DEBUG=compact
...
Reviewed-by: Dave Airlie <airlied@redhat.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/17667 >
2022-07-26 21:34:59 +00:00
Erik Faye-Lund
1318a58538
docs/zink: document required VK_EXT_border_color_swizzle
...
Reviewed-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/17709 >
2022-07-25 15:57:34 +02:00
Erik Faye-Lund
d9064d3c30
docs/zink: document required VK_KHR_swapchain_mutable_format
...
Reviewed-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/17709 >
2022-07-25 15:57:31 +02:00
Erik Faye-Lund
28cbb40a98
docs/zink: correct name of extension
...
Reviewed-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/17709 >
2022-07-25 15:57:27 +02:00
Mike Blumenkrantz
6493f6ef79
zink: add an explicit ZINK_DESCRIPTOR_MODE_CACHED
...
no functional changes, but now AUTO is no longer a mode that gets used
Reviewed-by: Dave Airlie <airlied@redhat.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/17636 >
2022-07-20 04:24:19 +00:00
Mike Blumenkrantz
9172127057
zink: delete ZINK_DESCRIPTOR_MODE_NOFALLBACK
...
this was useful for testing but is going to be less useful soon
Reviewed-by: Dave Airlie <airlied@redhat.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/17636 >
2022-07-20 04:24:19 +00:00
Timur Kristóf
82e08f6b1e
zink: Enable the VK_EXT_depth_clip_enable extension.
...
Signed-off-by: Timur Kristóf <timur.kristof@gmail.com >
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/16929 >
2022-06-21 15:44:54 +00:00
Erik Faye-Lund
d8fcd699f1
docs/zink: correct requirement for tbos
...
This requirement is for ARB_texture_buffer_object_rgb32, which obviously
needs the UNIFORM_TEXEL_BUFFER bit, not SAMPLED_IMAGE.
Fixes: c3d7de47cd
("docs/zink: add GL 4.0 requirements")
Fixes: 6b38907b7f
("zink: fix feature requirement")
Acked-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/17024 >
2022-06-15 12:24:43 +00:00
Mike Blumenkrantz
0afb2e34c2
zink: more requirement docs
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/16981 >
2022-06-10 20:53:34 +00:00