Erik Faye-Lund
fa41bd0687
docs: improve language in zink article
...
Turns out, this was not proper use of language!
Acked-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/15300 >
2022-03-09 16:19:16 +00:00
Erik Faye-Lund
e666134975
docs: fixup zink gl 4.3 requirements
...
The multiViewport feature isn't required for GL 4.3, it's required for
GL 4.1. Technically speaking, we could have just dropped it because we
already list the maxViewports requirement. But it seems better to be
very clear here to me.
Fixes: 29f8f21bff
("docs: document zink GL 4.3 requirements")
Acked-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/15300 >
2022-03-09 16:19:16 +00:00
Mike Blumenkrantz
7a03507f3c
zink: document ZINK_DESCRIPTORS env var
...
Reviewed-by: Dave Airlie <airlied@redhat.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/12783 >
2021-09-12 23:58:48 +00:00
Erik Faye-Lund
c905e74842
docs: update zink requirements
...
We currently require VK_EXT_line_rasterization with *all* optional
features to render all kinds of lines required. Because some (if not
all) of these can be emulated, let's make the list explicit, so it's
easy to remove items as we implement emulation.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/11795 >
2021-07-09 13:18:47 +00:00
Erik Faye-Lund
04b00a65a4
docs: update link to #zink
...
We have decided to follow what's happening with #dri-devel for #zink as
well, so let's update our link there as well.
While we're at it, let's switch the link to an anonymous link, because
we're not referring to it anywhere, so it doesn't need to be named.
Reviewed-by: Daniel Stone <daniels@collabora.com >
Reviewed-by: Adam Jackson <ajax@redhat.com >
Reviewed-by: Alyssa Rosenzweig <alyssa.rosenzweig@collabora.com >
Reviewed-by: Eric Engestrom <eric@engestrom.ch >
Reviewed-by: Jason Ekstrand <jason@jlekstrand.net >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10917 >
2021-05-24 09:21:48 +00:00
Erik Faye-Lund
be4d17ccf5
zink: correct an extension-link
...
Fixing the fix, I guess I was a bit too quick last time ;)
Fixes: 0747fb546c
("docs: fixup link to extension")
Reviewed-by: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10478 >
2021-04-27 15:02:42 +00:00
Erik Faye-Lund
4ec8533f69
zink: fix shader-image requirements
...
I mixed up the EXT and ARB version of the extensions; we actually do
require shaderStorageImageWriteWithoutFormat as well here.
Thanks to Ilia Mirkin for pointing this out.
It also seems I got really confused about what was required when writing
the docs, so let's fix that as well.
Fixes: 341332b23a
("zink: correct image cap checks")
Fixes: ecac7f3da1
("docs: add missing zink-requirement")
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10463 >
2021-04-27 11:26:07 +00:00
Mike Blumenkrantz
7888ef8c48
zink: update docs
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10458 >
2021-04-26 20:19:48 +00:00
Erik Faye-Lund
ecac7f3da1
docs: add missing zink-requirement
...
We need this feature in order to enable OpenGL 4.2 on Zink.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10456 >
2021-04-26 14:22:12 +00:00
Erik Faye-Lund
a7e95dfca5
docs: fix quoting around a few limits
...
These two were quoted differently than the other limits in this
document. Let's fix that to be consistent.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10455 >
2021-04-26 12:59:33 +00:00
Erik Faye-Lund
0747fb546c
docs: fixup link to extension
...
I accidentally missed the actual link-definition here, so let's add
that.
Fixes: ff007afce2
("zink: document requirement of VK_EXT_custom_border_color")
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10455 >
2021-04-26 12:59:33 +00:00
Erik Faye-Lund
95d9d811c9
zink: do not require vulkan memory model for shader-images
...
The claim that we require vulkan memory model's MakeAvailable and
MakeVisible semantics for image writes isn't accurate. This would be
required *if* we were already using the Vulkan memory model.
But we're using the GLSL450 memory model in those cases, which has no
such requirements.
This means that any problems on RADV due to the lack of these semantics
are RADV bugs, and should be fixed in RADV instead.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10345 >
2021-04-20 15:52:07 +00:00
Erik Faye-Lund
ff007afce2
zink: document requirement of VK_EXT_custom_border_color
...
Without this extension, we misrender when custom border colors are
used. Let's document this, and emit a warning when the extension is
missing.
Reviewed-by: Joshua Ashton <joshua@froggi.es >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10316 >
2021-04-19 19:31:36 +00:00
Erik Faye-Lund
6940d3ba05
zink: document scalarBlockLayout requirement
...
We're currently using uint arrays instead of uvec4 arrays for UBOs and
SSBOs, which requires scalarBlockLayout. Fixing this is a lot of work,
so let's just document it for now.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10127 >
2021-04-10 09:48:38 +00:00
Erik Faye-Lund
920ecbefbd
docs: clarify VK_KHR_external_memory requirement
...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9925 >
2021-03-31 08:19:24 +00:00
Erik Faye-Lund
4bf238f744
zink: do not enable unused extension
...
While we should probably use this extension at some point, we don't
currently do. So let's remove it, so the code documents the status-quo
instead of some potential future direction.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9925 >
2021-03-31 08:19:23 +00:00
Erik Faye-Lund
3b130ec75d
docs: remove zink incorrect requirement
...
Zink does not require VK_KHR_get_physical_device_properties2; we have
fallback-code in place for when that is lacking.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9925 >
2021-03-31 08:19:23 +00:00
Erik Faye-Lund
1f1e4705af
docs: remove bogus zink-requirement
...
VkPhysicalDeviceFeatures::depthClamp isn't required until GL 3.2, where
we already list it. Remove the extra entry to avoid confusion.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9925 >
2021-03-31 08:19:23 +00:00
Erik Faye-Lund
a95912e9af
zink: check for mirror-clamp extension
...
This cap depends on a device extension.
Fixes: b59d98ae5f
("zink: enable PIPE_CAP_TEXTURE_MIRROR_CLAMP_TO_EDGE")
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9803 >
2021-03-24 21:12:00 +00:00
Erik Faye-Lund
2644835f03
zink: add missing required feature
...
We check for this feature in zink_is_format_supported, so VK drivers
need to expose it to get BC textures working. Let's document the
reality.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9803 >
2021-03-24 21:12:00 +00:00
Erik Faye-Lund
a466c2a783
zink: check for stores and atomics features
...
These limits depens on feature-bits.
Fixes: 322a3d4fb0
("zink: partially enable SSBO pipe cap")
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9803 >
2021-03-24 21:12:00 +00:00
Erik Faye-Lund
215ff8246f
zink: check for depth-bias-clamp feature
...
This cap depends on a feature-bit.
Fixes: 3d7d55c2cf
("zink: enable PIPE_CAP_POLYGON_OFFSET_CLAMP")
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9803 >
2021-03-24 21:12:00 +00:00
Erik Faye-Lund
f6f2cbeb44
zink: check for pipeline statistics feature
...
This cap depends on a feature-bit.
Fixes: cb5957e13d
("zink: enable pipeline statistics cap")
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9803 >
2021-03-24 21:12:00 +00:00
Erik Faye-Lund
b416ae2023
docs: simplify format requirements
...
When I initially started writing these lists, I expected the lists to be
much less uniform in what bits were required. Turns out I was wrong, and
this ended up really neat and orderly.
I'm sure we're missing some defacto requirements here and there,
especially for the early versions. This list is based on what we check
for in version.c, and it's better than nothing.
Suggested by Mike Blumenkrantz.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9602 >
2021-03-19 14:07:42 +00:00
Erik Faye-Lund
5deac5c156
docs: document zink GL 4.6 requirements
...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9602 >
2021-03-19 14:07:42 +00:00
Erik Faye-Lund
62a27bb091
docs: document zink GL 4.5 requirements
...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9602 >
2021-03-19 14:07:42 +00:00
Erik Faye-Lund
529d5f38c3
docs: document zink GL 4.4 requirements
...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9602 >
2021-03-19 14:07:42 +00:00
Erik Faye-Lund
29f8f21bff
docs: document zink GL 4.3 requirements
...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9602 >
2021-03-19 14:07:42 +00:00
Erik Faye-Lund
73ebfcccca
docs: remove excessive quoting
...
Triple backticks doesn't mean anything in RST, so this becomes quoted
strings containing backticks. That's not what I meant here...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9602 >
2021-03-19 14:07:42 +00:00
Erik Faye-Lund
5d0509e367
docs: remove excessive wrapping
...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9602 >
2021-03-19 14:07:42 +00:00
Erik Faye-Lund
025d707903
docs: remove stray newline
...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9602 >
2021-03-19 14:07:42 +00:00
Hoe Hao Cheng
93ff47eb19
zink: enable KHR_shader_draw_parameters on Vulkan <1.2
...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9021 >
2021-02-12 21:04:24 +00:00
Erik Faye-Lund
6b233b9536
docs/zink: correct vk version for GL 4.2
...
I've gotten clarification from Khronos about this here:
https://github.com/KhronosGroup/Vulkan-Docs/issues/1437
So as it stands, we currently require Vulkan 1.2 for GL 4.2, not Vulkan
1.1. Let's update the docs to reflect this.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Reviewed-by: Hoe Hao Cheng <haochengho12907@gmail.com >
Fixes: fb65285629
("docs/zink: add GL 4.2 requirements")
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8692 >
2021-01-25 17:07:16 +00:00
Erik Faye-Lund
fb65285629
docs/zink: add GL 4.2 requirements
...
Reviewed-by: Hoe Hao Cheng <haochengho12907@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8648 >
2021-01-22 21:22:26 +00:00
Erik Faye-Lund
d0e7a7d58d
docs/zink: add GL 4.1 requirements
...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Reviewed-by: Hoe Hao Cheng <haochengho12907@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8648 >
2021-01-22 21:22:26 +00:00
Erik Faye-Lund
c3d7de47cd
docs/zink: add GL 4.0 requirements
...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Reviewed-by: Hoe Hao Cheng <haochengho12907@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8648 >
2021-01-22 21:22:26 +00:00
Erik Faye-Lund
4374e8e99f
docs/zink: fix phrasing of GL 3.3 requirements
...
These requirements aren't all about VkPhysicalDeviceFeatures, so let's
make the text reflect that.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Reviewed-by: Hoe Hao Cheng <haochengho12907@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8648 >
2021-01-22 21:22:26 +00:00
Erik Faye-Lund
02c43eb975
docs/zink: document the independentBlend requirement for GL3
...
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Reviewed-by: Hoe Hao Cheng <haochengho12907@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8648 >
2021-01-22 21:22:26 +00:00
Erik Faye-Lund
fb5d7d60e7
docs/zink: add two missing required features
...
If these features aren't supported, we'll start doing illegal stuff, so
let's document it.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Reviewed-by: Hoe Hao Cheng <haochengho12907@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8648 >
2021-01-22 21:22:26 +00:00
Erik Faye-Lund
a640588a41
docs/zink: add missing colon
...
Reviewed-by: Hoe Hao Cheng <haochengho12907@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8648 >
2021-01-22 21:22:26 +00:00
Erik Faye-Lund
8564715253
docs: document new zink-flag
...
We forgot to document this previously, so let's add it now.
Fixes: feb9462bb1
("zink: Added inbuilt debug logging from the VK_LAYER_LUNARG_standard_validation layer.")
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/7802 >
2020-11-26 20:38:07 +01:00
Erik Faye-Lund
3fee91d2e7
docs: add link to extension spec
...
We already do this for all the other VK extensions, so we might as well
do this for VK_EXT_vertex_attribute_divisor as well.
Fixes: 2ff97847d1
("docs: document zink's gl > 3.0 requirements")
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/7312 >
2020-10-27 12:56:01 +00:00
Erik Faye-Lund
2ff97847d1
docs: document zink's gl > 3.0 requirements
...
The new versions of OpenGL exposed by Zink requires additional Vulkan
features, so let's document them.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/7286 >
2020-10-26 10:49:58 +00:00
Erik Faye-Lund
be693beef1
docs: do not document required minimum
...
We already document that shaderClipDistance is required, and for that
feature to be supported maxClipDistances needs to be at least 8. So
there's no point in documenting the maxClipDistances-requirement.
Reviewed-By: Mike Blumenkrantz <michael.blumenkrantz@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/7286 >
2020-10-26 10:49:58 +00:00
Eric Anholt
313f951f1b
docs: Move the gallium driver documentation to the top level.
...
I actually had never found these, buried under Developer Topics -> Gallium
-> Drivers. Given that driver documentation contains not just gallium
driver documentation but also end-user information, bring it to a much
more prominent location between User Topics and Developer Topics at the
top level.
Reviewed-by: Erik Faye-Lund <erik.faye-lund@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/7174 >
2020-10-21 18:11:39 +00:00