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>
This commit is contained in:
Erik Faye-Lund 2021-03-16 10:44:27 +01:00 committed by Marge Bot
parent 5deac5c156
commit b416ae2023

View File

@ -113,11 +113,11 @@ supported:
* `VK_KHR_maintenance2`_
* `VK_KHR_vulkan_memory_model`
* Formats features:
* Formats requiring ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``:
* ``VK_FORMAT_R32G32B32_SFLOAT``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_R32G32B32_SINT``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_R32G32B32_UINT``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_R32G32B32_SFLOAT``
* ``VK_FORMAT_R32G32B32_SINT``
* ``VK_FORMAT_R32G32B32_UINT``
OpenGL 4.1
^^^^^^^^^^
@ -146,12 +146,12 @@ supported:
* `VK_KHR_shader_draw_parameters`_
* Formats features:
* Formats requiring ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``:
* ``VK_FORMAT_BC7_UNORM_BLOCK``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_BC7_SRGB_BLOCK``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_BC6H_SFLOAT_BLOCK``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_BC6H_UFLOAT_BLOCK``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_BC7_UNORM_BLOCK``
* ``VK_FORMAT_BC7_SRGB_BLOCK``
* ``VK_FORMAT_BC6H_SFLOAT_BLOCK``
* ``VK_FORMAT_BC6H_UFLOAT_BLOCK``
OpenGL 4.3
^^^^^^^^^^
@ -164,23 +164,23 @@ supported:
* ``robustBufferAccess``
* ``multiViewport``
* Formats features:
* Formats requiring ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``:
* ``VK_FORMAT_R8G8B8A8_UNORM``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_R8G8B8A8_SRGB``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_R16_UNORM``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_R16G16_UNORM``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_R16_SNORM``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_R16G16_SNORM``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_D32_SFLOAT_S8_UINT``: ``VK_FORMAT_FEATURE_SAMPLED_IMAGE_BIT``
* ``VK_FORMAT_R8G8B8A8_UNORM``
* ``VK_FORMAT_R8G8B8A8_SRGB``
* ``VK_FORMAT_R16_UNORM``
* ``VK_FORMAT_R16G16_UNORM``
* ``VK_FORMAT_R16_SNORM``
* ``VK_FORMAT_R16G16_SNORM``
* ``VK_FORMAT_D32_SFLOAT_S8_UINT``
OpenGL 4.4
^^^^^^^^^^
For OpenGL 4.4 support, the following additional format features needs to
be supported:
For OpenGL 4.4 support, the following additional format needs to support
``VK_FORMAT_FEATURE_VERTEX_BUFFER_BIT``:
* ``VK_FORMAT_B10G11R11_UFLOAT_PACK32``: ``VK_FORMAT_FEATURE_VERTEX_BUFFER_BIT``
* ``VK_FORMAT_B10G11R11_UFLOAT_PACK32``
OpenGL 4.5
^^^^^^^^^^