From b416ae2023efc96be894355c1081d0113ca89dbb Mon Sep 17 00:00:00 2001 From: Erik Faye-Lund Date: Tue, 16 Mar 2021 10:44:27 +0100 Subject: [PATCH] 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 Part-of: --- docs/drivers/zink.rst | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/drivers/zink.rst b/docs/drivers/zink.rst index 7bcc852..4d986c4 100644 --- a/docs/drivers/zink.rst +++ b/docs/drivers/zink.rst @@ -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 ^^^^^^^^^^ -- 2.7.4